====== 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: http://sourceforge.net/project/showfiles.php?group_id=200661&package_id=240866
----

^  Download | http://sourceforge.net/project/showfiles.php?group_id=200661&package_id=240866 |
^  Main page | http://sourceforge.net/projects/ticket-linker/ |

===== Installation =====

  * download [[http://sourceforge.net/project/showfiles.php?group_id=200661&package_id=240866|ticketlinker.zip]]
  * unzip into your lib/plugins/ folder:

<code>
lib/plugins/ticketlinker/syntax.php
lib/plugins/ticketlinker/conf/metadata.php
</code>




===== 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:plugin|plugin 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//