Differences

This shows you the differences between two versions of the page.

--- mantisbt:issue:8253 [2007/11/07 07:10] – Description continued but not completed Silbaer
+++ mantisbt:issue:8253 [2010/05/04 09:08] (current) – rattkin
@@ Line 1: / Line 1: @@
 ====== Improved Mantis/DokuWiki integration ======
-FIXME  **This description is not complete! Please come back in a few days.** FIXME
+FIXME I think, the description is a little bit clumsy. Please correct.  --- //[[Timo.Falk@neumag.saurer.com|Silbaer]] 2007/11/08 06:44//
 The following description works with mantis version 1.1.0rc2 and dokuwiki version 2007-06-26b. It based on [[mantisbt:issue:7075:integration_with_dokuwiki|this]] description, but extend the integration.
+You can get all these files from [[http://www.mantisbt.org/bugs/view.php?id=8277|issue 8253]] too. But save your original files:!:
 ===== Dokuwiki =====
@@ Line 12: / Line 14: @@
 ==== Mantis Syntax Plug-in ====
+If you only want links back to mantis, there is no need for a systax plugin. You can use interwiki shortcuts to create links back to mantis (see [[http://wiki.splitbrain.org/wiki:discussion:bugtracking|here]]). But I used a configuration setting from the syntax plugin in the mantis authentication class and perhaps there are other improvements in the future, so here is it.
+The syntax plugin based an the plugin from Victor Boctor, but I changed the syntax. Now it uses **{** like almost all other plugins instead of **~**.
 For the syntax-plugin with support for the dokuwiki admin panel, you have to create several files:
@@ Line 32: / Line 37: @@
 /**
  * A plug-in that hyper links references to Mantis issues.  References
- * to Mantis issues should use the following format: ~~Mantis:123~~.
+ * to Mantis issues should use the following format: {{Mantis:123}}.
  *
  * All DokuWiki plugins to extend the parser/rendering mechanism
@@ Line 149: / Line 154: @@
 === dokuwiki\lib\plugins\mantis\images\bug.gif  ===
-A Picture with a little bug, placed in front of the bug links. The file is grabed from dokuwiki.org
+A [[http://wiki.splitbrain.org/lib/images/interwiki/bug.gif|Picture]]  with a little bug, placed in front of the bug links. The file is grabed from [[http://wiki.splitbrain.org/wiki:discussion:bugtracking|this]] dokuwiki page.
 === dokuwiki\lib\plugins\mantis\lang\en\settings.php  ===
@@ Line 166: / Line 171: @@
 ==== Mantis Template ====
+Go to DokuWiki settings and configure mantis URL at the bottom of the setup page.
 Copy the default template (dokuwiki/lib/tpl/default/) into a new folder called //mantis//.
@@ Line 356: / Line 362: @@
 ?>
 </code>
+==== Authorisation Configuration ====
+Create ''dokuwiki\conf\acl.auth.php'' with the code below.
+<code php>
+# acl.auth.php
+# <?php exit()?>
+# Don't modify the lines above
+#
+# Access Control Lists
+#
+# Editing this file by hand shouldn't be necessary. Use the ACL
+# Manager interface instead.
+#
+# If your auth backend allows special char like spaces in groups
+# or user names you need to urlencode them (only chars <128, leave
+# UTF-8 multibyte chars as is)
+#
+# none   0
+# read   1
+# edit   2
+# create 4
+# upload 8
+# delete 16
+*	@VIEWER		1
+*	@REPORTER	2
+*	@DEVELOPER	8
+*	@MANAGER	8
+*	@ADMINISTRATOR	8
+*	@ALL		0
+</code>
 ==== Redirect dokuwiki login/logout ====
@@ Line 1687: / Line 1727: @@
 </code>
+===== Configuration =====
+==== Dokuwiki ====
+Log in as administrator, go to the admin panel and configure the mantis syntax plugin and the authentication backend.
+:!: You have to config the filepath and URL to your mantis in the syntax plugin  **before** you activate the mantis authentication backend! :!:
+==== Mantis ====
+Include this in your mantis configuration. Adjust the paths so it match your install.
+<code php>
+#####################
+# Wiki Integration
+#####################
+# Wiki Integration Enabled?
+$g_wiki_enable = ON;
+# Wiki Engine
+$g_wiki_engine = 'dokuwiki';
+# Wiki namespace to be used as root for all pages relating to this mantis installation.
+$g_wiki_root_namespace = 'mantis';
+# URL under which the wiki engine is hosted.  Must be on the same server.
+$g_wiki_engine_url = $t_protocol . '://' . $t_host . '/dokuwiki/';
+# CSS file
+$g_css_include_file = '/mantis/css/default.css';
+</code>