.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ============== Troubletickets ============== :Author: Kasper Skårhøj :Created: 2002-11-01T00:32:00 :Changed by: Christian Bülter :Changed: 2013-11-27T15:56:07.423285866 :Email: buelter@kennziffer.com :Info 2: :Info 3: :Info 4: .. _Troubletickets: Troubletickets ============== Extension Key: ke\_troubletickets Copyright 2007-2013, Christian Buelter, < `buelter@kennziffer.com `_ > Design: Christos Keramitsis, `_ > Revised for version 1.4.0 This document is published under the Open Content License available from http://www.opencontent.org/opl.shtml The content of this document is related to TYPO3 \- a GNU/GPL CMS/Framework available from www.typo3.com .. _Table-of-Contents: Table of Contents ----------------- **Troubletickets 1** **Introduction 1** **Features 1** **Screenshots 2** **Installation 4** **Quickstart 4** **Configuration 6** **Customization and Styling 6** **Backend module 7** **API 7** **jQuery / jQueryUI 7** **Known problems 7** **Planned features 7** **Commercial support 7** **Changelog 8** .. _Introduction: Introduction ------------ Manage your troubletickets, tasks or todo-lists or use the extension as a bugtracker, helpdesk or project management tool. Assign tickets to users, define observers, receive email notifications and group tickets into categories and projects. Comes with a modern layout and full documentation and is easy to install. The extension is very flexible. The configuration is completely done by change the HTML template, the CSS definitions and typoscript. For example, you may create a template where a user sees only very few fields (for example “title” and “description”), so that he does not get confused by too many options. This is useful if you want to use the extension as a helpdesk tool where users should be able to create new tickets without any further knowledge af the extension or it's behavior. On the other hand it's powerful enough to serve as a project management tool. This extension depends on logged in frontend users, therefore you will have to log in in the frontend in order to use the extension. Needs PHP 5.3 now since version 1.5. .. _Features: Features -------- - Tickets can have owners, responsible users and observers. - Role concept: Creating a ticket defines you as the owner, tickets have to be assigned to responsible users and may be observerd by observers. - Each ticket has a title, status, category, billing type, priority, a responsible users, to do until-date, planned from-date, fields for planned and actual time effort, general effort, description, internal additional information. - Files can be attached to tickets. - Tickets can be commented. - A history of each ticket is shown in the frontend. - Notifications emails are sent on changes. - CSV export in the frontend is build in. - Access control: Only owners, responsible users and observers may see and edit a ticket. Additionally one ore ticket administrators can be defined which have access to all tickets in the frontend. - Internal fields: Some fields are only visible for “internal users”: planned from-date, planned time effort, actual time effort, additional information. This concept is useful for companies who want to use the extension as a helpdesk or project management tool and want to keep track of planned and actual efforts. Furthermore the “planned from”-date helps you to organize your work and you can internally comment tickets using the internal “additional information” field. - A backend module provides the administrator with a overview and statistical analysis of all tickets. - Ajax-driven, sortable ToDo-Lists can be created in tickets, this is useful for splitting large tickets into a clear structure - A progress bar shows the ticket status; the progress is calculated by the ToDo entries .. _Screenshots: Screenshots ----------- |img-1| |img-2| |img-3| |img-4| .. _Installation: Installation ------------ Use the Extension Manager to import ke\_troubletickets from the TYPO3 Extension Repository and install it. Include the “static template” of the extension in your main template (Edit template → “Click here to edit whole template record” → “Include static (from extension)”. Protect your files with naw\_securedl You should consider using the extension “naw\_securedl” to protect your file attachments from unauthorized access! Date2cal and Datepicker In order to use the date2cal-datepicker in the frontend, you will have to install date2cal 7.3.0 or greater. If you don't install date2cal, you'll get an alternative datepicker. It's recommended to install date2cal. .. _Quickstart: Quickstart ---------- Create a page for the Troubletickets plugin. If you want, you can create a sysfolder for the tickets and categories etc. You may also use the same page you put the plugin on. If you have different customers / projects etc. it's recommended to use the same page for the plugin and the troubletickets data. You will have to log in in order to use the extension, therefore you will need a sysfolder with at least one usergroup and one ore more frontend users and a page with the “Login”-extension (which comes with TYPO3). |img-5| You will need at least one category. Open the “Troubletickets” sysfolder (or whatever page you store your data on) and create one ore more troubleticket categories. Select the “Troubletickets” page you created as the “Page for Singleview”. |img-6| |img-7| Open the Troubletickets page and insert the “Trouble Ticket System” Plugin. |img-8| Open the plugin and configure it. Use the sysfolder you created as the “starting point”. In the first tab (“General settings”) check the option “Use all categories ...”. |img-9| In the second tab, select a user group for “Responsible users” and “Observers”. You may want to select also one or more ticket administrators (these users see all the tickets, not only the ones they are assigned to, e.g. the project manager) and one or more internal users (these users are allowed to see and edit special “internal fields” each ticket has, e.g. „time used“). |img-10| That's all. You may now use Troubletickets in the frontend of your website. FAQ Who is the owner? The user who creates a ticket is automatically the owner. You can define that the owner is selectable in the frontend. Have a look at the typoscript configuration „formFieldList.5“. Who will get notifications? Emails are sent to owners, responsible users and observers whenever a ticket has been changed. Every user will get notifications only if the didn't make the change by himself. You can activate emails beeing sent to the editing user himself by plugin.tx\_ketroubletickets\_pi1.sendNotificationsToSelf = 1 By default a notification will be send on every change. You can change the flexform options in order to send notifications - on every change - only on status change - never - Let the user decide that per ticket in the frontend. - defined by typoscript. Have a look at the typoscript configuration „email\_notifications“. .. _Configuration: Configuration ------------- Please have a look at pi1/static/setup.txt in the extension folder. The typoscript setup is well documented. .. _Make-owner-selectable-in-the-frontend: Make owner selectable in the frontend ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ By default the owner is set automatically when creating a new ticket and must not be changed when updating a ticket. You can change this behaviour by replacing ###FIELD\_OWNER\_FEUSER### with ###VALUE\_OWNER\_FEUSER### In the HTML template (line 46 in the current version of the shipped default template). And add this typoscript to your typoscript template: plugin.tx\_ketroubletickets\_pi1 { formFieldList { 5 { name = owner\_feuser type = feuserSelect orderBy = username lastNameFirst = 1 prefillWithCurrentUserIfEmpty = 1 writeAccessOnlyForUserGroup = flexformFieldForUsergroupToChoseFrom = owner\_group\_to\_choose\_from size = 1 multiple = 0 required = 1 addCurrentUserToList = 1 doNotSaveInDB = 0 } } } .. _Customization-and-Styling: Customization and Styling ------------------------- Please have a look at the res/ folder in the extension folder. You will find CSS, HTML and image files there. To modify them, copy them to your fileadmin/ folder and point the appropriate typoscript settings to the new files. .. _Backend-module: Backend module -------------- After installing the extension, you will find a new backend module (“Web” → “Troubletickets”). You may use it to get an overview of all tickets, tickets a certain user is responsibe for, all open tickets etc. (see “Screenshots”). .. _API: API --- Yet, only a very basic API is implemented. You may get the data of a ticket, check for permissions (does the currently logged in user have permissions to view / edit a ticket) and link to a ticket. Here's an example which should get you started: // example: creating a link to a ticket using ke\_troubletickets api// and taking troubletickets permission into account $ticketUid = 123;if (t3lib\_extMgm::isLoaded('ke\_troubletickets')) {r equire\_once(t3lib\_extMgm::extPath('ke\_troubletickets').'lib/class.t x\_ketroubletickets\_lib.php');$this->troubleticketsLib = t3lib\_div::makeInstance('tx\_ketroubletickets\_lib');$ticketData = $this->troubleticketsLib->getTicketData($ticketUid);if ($this->trouble ticketsLib->checkPermissionForTicket($ticketData['uid'])) {$url = $this->troubleticketsLib->getLinkToTicket\_URL($ticketData);$content .= '' . $ticketData['title'] . '';} else {$content = 'No permission.';}} .. _jQuery-jQueryUI: jQuery / jQueryUI ----------------- The jQuery and the jQueryUI framework is included into the form view by default. These frameworks are needed for the ToDo-List feature. If you don't want them to be included you can disable it by the following TYPOScript Settings: plugin.tx\_ketroubletickets\_pi1.includeJQuery = 0 plugin.tx\_ketroubletickets\_pi1.includeJQueryUI = 0 .. _Known-problems: Known problems -------------- - Layout problems have been reported when the Doctype is not “XHTML 1.0 Transitional” but “HTML 4.01”. - Problems with extension “perfectlightbox” have been reported. - With TYPO3 6.0 Beta2 the extension manager does not create the upload folder. You'll have to create the directory uploads/tx\_ketroubletickets by yourself. Please use the bugtracker on forge.typo3.org: http://forge.typo3.org/projects/show/extension-ke\_troubletickets .. _Planned-features: Planned features ---------------- - Open and edit tickets by sending an email. - Send cronjob based notifications for tickets which have become overdue. .. _Commercial-support: Commercial support ------------------ Commercial support is available. Please have a look at `www.keworks.de `_ . There's also a premium version with ajax basad relations, iCal-Export and time recording. .. _Changelog: Changelog --------- Please see „ChangeLog“ file in extension folder. |img-11| Troubletickets - 8 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.jpeg .. :align: left .. :border: 0 .. :height: 456 .. :id: Grafik7 .. :name: Grafik7 .. :width: 487 .. |img-2| image:: img-2.jpeg .. :align: left .. :border: 0 .. :height: 227 .. :id: Grafik8 .. :name: Grafik8 .. :width: 509 .. |img-3| image:: img-3.jpeg .. :align: left .. :border: 0 .. :height: 184 .. :id: Grafik9 .. :name: Grafik9 .. :width: 489 .. |img-4| image:: img-4.jpeg .. :align: left .. :border: 0 .. :height: 243 .. :id: Grafik10 .. :name: Grafik10 .. :width: 489 .. |img-5| image:: img-5.jpeg .. :align: left .. :border: 0 .. :height: 76 .. :id: Grafik1 .. :name: Grafik1 .. :width: 159 .. |img-6| image:: img-6.jpeg .. :align: left .. :border: 0 .. :height: 188 .. :id: Grafik3 .. :name: Grafik3 .. :width: 170 .. |img-7| image:: img-7.jpeg .. :align: left .. :border: 0 .. :height: 170 .. :id: Grafik4 .. :name: Grafik4 .. :width: 302 .. |img-8| image:: img-8.jpeg .. :align: left .. :border: 0 .. :height: 63 .. :id: Grafik2 .. :name: Grafik2 .. :width: 546 .. |img-9| image:: img-9.jpeg .. :align: left .. :border: 0 .. :height: 392 .. :id: Grafik5 .. :name: Grafik5 .. :width: 275 .. |img-10| image:: img-10.jpeg .. :align: left .. :border: 0 .. :height: 477 .. :id: Grafik6 .. :name: Grafik6 .. :width: 316 .. |img-11| image:: img-11.png .. :align: left .. :border: 0 .. :height: 32 .. :id: Graphic1 .. :name: Graphic1 .. :width: 102