====== Ticketlinker Plugin ======

---- plugin ----
description: Provides basic integration with the Cerberus Helpdesk system
author     : Dominik Smatana
email      : dominiks@users.sourceforge.net
type       : syntax
lastupdate : 2007-08-04
compatible : 2007-06-26
depends    : 
conflicts  : 
similar    : 
tags       : embed

downloadurl: https://downloads.sourceforge.net/project/ticket-linker/DokuWiki%20plugin_%20Ticket%20linker/Version%201.0.0/ticketlinker.zip?r=https%3A%2F%2Fsourceforge.net%2Fprojects%2Fticket-linker%2Ffiles%2Flatest%2Fdownload&ts=1527697879

http://sourceforge.net/project/showfiles.php?group_id=200661&package_id=240866
sourcerepo : http://sourceforge.net/p/ticket-linker/code/HEAD/tree/dokuwiki-plugin/trunk/ticketlinker/
----

Main page: http://sourceforge.net/projects/ticket-linker/

===== Installation =====
Search and install the plugin using the [[plugin:extension|Extension Manager]] or manually with the download from the [[http://sourceforge.net/projects/ticket-linker/files/DokuWiki%20plugin_%20Ticket%20linker/Version%201.0.0/ticketlinker.zip/download|SourceForge Mirror]]. Refer to [[:Plugins]] on how to install plugins manually. 

All versions of the plugin:\\ http://sourceforge.net/projects/ticket-linker/files/DokuWiki%20plugin_%20Ticket%20linker/


===== Configuration =====

After installation you have to set these configuration options in your Admin -> Configuration Settings:

**ticketMaskLength** 

Length of ticket mask (e.g. 13)

**cerberusUrl**

Full URL path to your Cerberus installation, see example:

<code>
https://www.domain.tld/agents/display.php?ticket=
</code>


===== Usage =====

Every occurrence of

<code>
ticket#
</code>

will be processed - following 13 (configurable) characters will be used as ticket mask. Example:

<code>
ticket#XXX-12345-123
</code>

will be rendered as

<code>
<a href="https://www.domain.tld/agents/display.php?ticket=XXX-12345-123" target="_blank" title="Ticket #XXX-12345-123">#XXX-12345-123</a>
</code>

===== Change log =====

  * Version 1.0.0 (2007-08-04)
    * initial version
    * only masked tickets are supported
    * tested with Cerberus 2.7.0


===== ToDo's =====

  * implement support for [[plugin:extension|extension manager]] automatic installation (how?)
  * provide default values for configuration parameters (how?)
  * rewrite source code according to DokuWiki [[:development#coding_style|coding style]]


===== Comments =====

For this kind of things, I find it simple to use [[interwiki|interwiki links]].
in your interwiki.conf, just add
  bug      http://mybugtracker.com/?id=
then link to your bugs with
  [[bug>the_bug_id]]
It will even appear with the icon you'll set for the 'bug' prefix.
 --- //[[christophegragnic@yahoo.fr|Christophe Gragnic]] 2007-12-06 08:11//