Differences

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

--- mantisbt:issue:7075:integration_with_dokuwiki [2012/04/28 18:38] – added getUserData(); needed for dokuwikis e-mail subscription mrends
+++ mantisbt:issue:7075:integration_with_dokuwiki [2015/02/13 18:11] (current) – Use InterWiki syntax for MantisBT bug links dregad
@@ Line 1: / Line 1: @@
+====== Integrating DokuWiki with Mantis ======
+===== Disclaimer =====
+This document describes the steps needed to integrate DokuWiki with Mantis.
+The method described here was originally tested with mantis version 1.1.0rc2 and dokuwiki rc2009-12-02,
+and should work with subsequent versions (modulo bugs).
+It may work with older versions of mantis provided you make the File Changes described below.
+----
+===== Integration Functionality =====
+The integration between Mantis and DokuWiki so far achieves the following:
+  * Customises DokuWiki to honour Mantis authentication (i.e. single sign-on).
+  * Customises DokuWiki authorisation based on Mantis access levels (i.e. groups).
+  * Adds a Wiki link on the issue view simple/advanced pages to their corresponding Wiki issue page.
+  * Adds a Wiki menu option which maps to the corresponding project Wiki page, or general page in case of "All Projects".
+  * Provides a way for Wiki pages to link to Mantis issues, e.g. [[Mantis>7075]].
+  * Correctly manages HTTP Authentication. See ([[mantis>12458]]).
+===== Tips =====
+Following are some tips that are of interest to Mantis / DokuWiki integration:
+  * To define a template for all Wiki pages within a namespace, create ''_template.txt'' in the namespace folder (namespace is located into the DOKUWIKI_ROOT/data/mantis directory).  All pages created within this namespace will use the contents of the templates as a start point.  This will affect the way the Wiki is structured.   For example, if all issues within a project have a namespace, then they can all share one template, if there is a namespace per category, then there can be a template per category.  The exact structure to be used should be configurable through Mantis configuration. However, the actual structure currently implemented is described in a tip later on in this section.
+  * The Wiki menu links in Mantis are equivalent to internal links for ''mantis:project:'' where:
+    * ''mantis'' is the value of ''$g_wiki_root_namespace'' from ''config_inc.php'' (note that this is not configurable per-project, it is specifically looked up as a global)
+    * ''project'' is the name of the current project, or nothing for ''ALL PROJECTS'' (ie. you get just ''mantis:'' which resolves to ''mantis:start'' if your [[doku>config:startpage|start]] config setting is still the install default)
+  * The View Issue Details Wiki links in Mantis are equivalent to internal links for ''mantis:project:issue:NNNN'' where:
+    * ''mantis'' and ''project'' are as described above for that Mantis project
+    * ''issue'' is just that word "issue" and is the namespace for all issues in this project
+    * ''NNNN'' is the numeric ID of the Mantis issue without leading zeros, and is a page, not a namespace
+  * How Wiki access levels are determined: The Mantis auth backend included below takes the namespace containing the object being accessed, extracts the 2nd component, and looks it up in a flat list of Mantis projects. If there is a match, that project's access level is used, and if not, the global (ALL PROJECTS) access level is used. This means that ''mantis:project:'' and ''mantis:subproject:'' both get the access level of those Mantis projects, but ''mantis:project:subproject:'' gets the access level of ''project'', AND ''playground:project:'' also gets the access level of ''project'' even though it has nothing to do with the ''$g_wiki_root_namespace'' used by the various Wiki links on the Mantis side. This allows you to implement any number of areas in your wiki that use Mantis projects for access control, with the restriction that all namespaces must be of the form ''top_level:mantis_project:*'' (ie. any namespace just under a top-level namespace which matches a Mantis project name will use that project access level for itself and its child namespaces).
+  * Another consequence of the simplistic code here is that it fails to adjust when ''$g_wiki_root_namespace'' is an empty string. In that case, the mapping function on the Mantis side omits the ''mantis:'' component in the Wiki namespace string, thus popping the flat project list up to the top level. But then the auth backend code below fails to find it, and every project Wiki link from Mantis takes you to a place that has only global access levels and your project access settings appear to be ignored. Of course, if you create a namespace just under any top level namespace with a Mantis project's name, that will continue to work fine.
+  * Rename (if necessary) your projects and subprojects so that all their names are legal [[doku>pagename]] identifiers. Otherwise the access level code will fail to map Wiki namespaces back into Mantis projects, and users will get global access levels instead of their project access level.
+  * DokuWiki will see groups for each combination of Mantis project and access level that exist for the current user. For example:
+<code>
+my_namespace:my_project:* @ALL                 0
+my_namespace:my_project:* @MYPROJECT_VIEWER    1
+my_namespace:my_project:* @MYPROJECT_DEVELOPER 8
+</code>
+===== Mantis Configuration =====
+Add the following configuration items to ''config_inc.php'' and customize them for your installation.
+Copy the corresponding block from ''config_defaults_inc.php'' if your mantis version is recent enough to have it.
+Note however that the list of valid wiki engines may be out of date; as of 1.2.6 the correct list is in the switch statement in ''core/wiki_api.php''.
+<code php>
+	#####################
+	# Wiki Integration
+	#####################
+	# Wiki Integration Enabled?
+	$g_wiki_enable = OFF;
+	# 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 . '/%wiki_engine%/';
+</code>
+Tip: If you are using different subdomains (eg. mantis lives at: bugs.example.com and doku lives at wiki.example.com)
+then you need to make the cookies accessible to both subdomains.
+In your mantis ''config_inc.php'', set
+<code php>        $g_wiki_engine_url = 'http://wiki.example.com/';
+        $g_cookie_domain = '.example.com';   // So wiki and bugs can share cookie info
+</code>
+Don't forget to change g_wiki_enable to ON later once you are done setting up DokuWiki.
+===== DokuWiki Steps =====
+==== Installation ====
+Install [[http://www.dokuwiki.org|DokuWiki]] and make sure it is working properly.  This involves making sure that you can create pages, edit them, view them, etc.
+==== Core Configuration ====
+Add/modify the configuration values show below in your DokuWiki installation.
+Recent versions (eg. 2011-05-25a "Rincewind") can have these in ''dokuwiki\conf\local.protected.php'', but older versions will have to put them in a file that may be overwritten later.
+Use ''dokuwiki\conf\local.php'' if you do not use the Admin interface's config plugin (it will delete manually added lines!).
+Otherwise use ''dokuwiki\conf\dokuwiki.php'' where the default settings are located, but beware this will get overwritten during updates, so you will need to manually merge changes.
+In fact a fix is needed to implement the two settings to the config page. (fix in form of plugin is already done here http://www.mantisbt.org/wiki/doku.php/mantisbt:issue:8253 but contains other changes)
+<code php>
+#
+# Add the following lines:
+#
+define( 'MANTIS_ROOT', 'c:/inetpub/wwwroot/mantisbt/' );  // file path to Mantis, must terminate with /
+define( 'MANTIS_URL', 'http://localhost/mantisbt/' );     // url to Mantis, must terminate with /
+#
+# Once you have inc\auth\mantis.class.php created, modify the following configuration options to match the values below.
+# With modern versions of dokuwiki, the bundled config plugin can set these values, otherwise uncomment them here.
+#
+# $conf['useacl']       = 1;                // Use Access Control Lists to restrict access?
+# $conf['authtype']     = 'mantis';         // which authentication backend should be used
+# $conf['defaultgroup'] = 'VIEWER';         // Default groups new Users are added to
+# $conf['superuser'] = '@ADMINISTRATOR';    // allows mantis administrator to access dokuwiki admin area
+#
+# If selecting the mantis auth backend results in fatal errors from redeclaration of utf8 functions, uncomment this:
+#
+# require_once( MANTIS_ROOT . 'core.php' );
+</code>
+(utf8 redeclaration error reference: http://www.mantisbt.org/bugs/view.php?id=11769)
+==== Authorisation Configuration ====
+Add the following to the end of ''acl.auth.php'':
+<code>
+*	@VIEWER		1
+*	@REPORTER	2
+*	@UPDATER	4
+*	@DEVELOPER	8
+*	@MANAGER	16
+*	@ADMINISTRATOR	16
+</code>
+This will get you started. See the Tips section above for information about per-project group mappings.
+==== Mantis Authentication Backend (Single Sign-On) ====
+Create ''dokuwiki\inc\auth\mantis.class.php'' with the code below.
+<code php dokuwiki\inc\auth\mantis.class.php>
+<?php
+/**
+ * Mantis auth backend
+ *
+ * Uses external Trust mechanism to check against Mantis'
+ * user cookie.
+ * 13/12/2009 ~ @Tiago Gomes:
+ * added modifications to make possible to set project related user rights.(http://www.mantisbt.org/bugs/view.php?id=8249)
+ * added modifications so that mantis support logging in/out from DokuWiki’s login page (http://www.mantisbt.org/bugs/view.php?id=8277)
+ *
+ *
+ * @author    Victor Boctor (http://www.futureware.biz)
+ *
+ */
+require_once( MANTIS_ROOT . 'core.php' );
+#dbg($GLOBALS);
+class auth_mantis extends auth_basic {
+    /**
+     * Constructor.
+     *
+     * Sets additional capabilities and config strings
+     */
+    function auth_mantis(){
+        $this->cando['external'] = true;
+        $this->cando['logoff' ] = true; // module has a logoff method
+    }
+    /**
+     * Authenticates the user using Mantis APIs.
+     */
+    function trustExternal($user,$pass,$sticky=false){
+        global $USERINFO;
+        global $conf;
+        $ValidUser = false;
+        // Manage HTTP authentication with Negotiate protocol enabled
+        $user = auth_prepare_username($user);
+	$pass = auth_prepare_password($pass);
+        // This is necessary in all cases where Authorization HTTP header is always set
+	if(auth_is_user_authenticated())
+	{
+	    $user='';
+	}
+        // Has a user name been provided?
+        if ( !empty ( $user ) )
+        {
+            // User name provided, so login via form in progress...
+            // Are the specified user name and password valid?
+            if ( auth_attempt_login ( $user, $pass, $sticky ) )
+            {
+                // Credential accepted...
+                $_SERVER['REMOTE_USER'] = $user; // Set the user name (makes things work...)
+                $ValidUser = true; // Report success.
+            }
+            else
+            {
+                // Invalid credentials
+                        if ( !$silent )
+                {
+                    msg ( $lang [ 'badlogin' ], -1 );
+                }
+                $ValidUser = false;
+            }
+        }
+        else
+        {
+            // No user name provided.
+            // Is a user already logged in?
+            if ( auth_is_user_authenticated ( ) )
+            {
+                // Yes, a user is logged in, so set the globals...
+                // is it a media display or a page?
+                if (isset($_REQUEST['media'])) {
+                    //media
+                    $t_project_name = explode( ':', getNS( getID("media",false) ) );
+                } else {
+                    // normal page
+                    $t_project_name = explode( ':', getNS( getID() ) );
+                }
+                $t_project_id = project_get_id_by_name( $t_project_name[1] );
+                $t_access_level = access_get_project_level( $t_project_id );
+                $t_access_level_string = strtoupper( MantisEnum::getLabel( config_get( 'access_levels_enum_string' ),  $t_access_level ) ); // mantis 1.2.0rc
+                // $t_access_level_string = strtoupper( get_enum_to_string( config_get( 'access_levels_enum_string' ),  $t_access_level ) );
+                $t_access_level_string_ex = strtoupper( $t_project_name[1] ) . '_' . $t_access_level_string;
+                $USERINFO['grps'] = array( $t_access_level_string, $t_access_level_string_ex );
+                $USERINFO[ 'pass' ] = current_user_get_field ( 'password' );
+                $USERINFO[ 'name' ] = current_user_get_field ( 'username' );
+                $USERINFO[ 'mail' ] = current_user_get_field ( 'email' );
+                $_SERVER[ 'REMOTE_USER' ] = $USERINFO[ 'name' ];
+                $_SESSION[ $conf[ 'title' ]][ 'auth' ][ 'user' ] = $USERINFO[ 'name' ];
+                $_SESSION[ $conf[ 'title' ]][ 'auth' ][ 'info' ] = $USERINFO;
+                $ValidUser = true;
+            }
+            else
+            {
+                $ValidUser = false;
+            }
+        }
+        // Is there a valid user login?
+        if ( true != $ValidUser )
+        {
+            // No, so make sure any existing authentication is revoked.
+            auth_logoff ( );
+        }
+        return $ValidUser;
+    }
+    /**
+     * Logout from Mantis
+     */
+    function logOff(){
+        auth_logout();
+    }
+    /**
+     * Get user data
+     * (needed for e-mail subscriptions)
+     *
+     * @author Martin Arends http://www.web-gestaltung.de
+     */
+    function getUserData($user)
+    {
+      $data = array();
+      $t_user_id = user_get_id_by_name( $user );
+      if (isset($_REQUEST['media'])) {
+          //media
+          $t_project_name = explode( ':', getNS( getID("media",false) ) );
+      } else {
+          // normal page
+          $t_project_name = explode( ':', getNS( getID() ) );
+      }
+      $t_project_id   = project_get_id_by_name( $t_project_name[1] );
+      $t_access_level = access_get_project_level( $t_project_id, $t_user_id );
+      $t_access_level_string    = strtoupper( MantisEnum::getLabel( config_get( 'access_levels_enum_string' ),  $t_access_level ) );
+      $t_access_level_string_ex = strtoupper( $t_project_name[1] ) . '_' . $t_access_level_string;
+      $data['name'] = $user;
+      $data['grps'] = array( $t_access_level_string, $t_access_level_string_ex );
+      $data['mail'] = user_get_email( $t_user_id );
+      return $data;
+    }
+}
+</code>
+This codes already contains the following mods:
+  * [[http://www.mantisbt.org/bugs/view.php?id=8249|Issue 8249]] which makes it possible to set project related user rights.
+  * Support logging in/out from DokuWiki's login page [[http://www.mantisbt.org/bugs/view.php?id=8277|Issue 8277]]
+If you want the original code, you can see the wiki history
+==== Mantis Syntax Plug-in ====
+This plugin is to be placed in ''dokuwiki\lib\plugins\mantis\syntax.php''.
+Create the ''mantis'' subdirectory under ''plugins'' if necessary.
+<code php dokuwiki\lib\plugins\mantis\syntax.php>
+<?php
+/**
+ * Mantis Plugin: Hyperlinks references to Mantis Issues
+ *
+ * @license    GPL 2 (http://www.gnu.org/licenses/gpl.html)
+ * @author     Victor Boctor (http://www.futureware.biz)
+ */
+if(!defined('DOKU_INC')) define('DOKU_INC',realpath(dirname(__FILE__).'/../../').'/');
+if(!defined('DOKU_PLUGIN')) define('DOKU_PLUGIN',DOKU_INC.'lib/plugins/');
+require_once(DOKU_PLUGIN.'syntax.php');
+/**
+ * A plug-in that hyper links references to Mantis issues.  References
+ * to Mantis issues should use the following format: ~~Mantis:123~~.
+ *
+ * All DokuWiki plugins to extend the parser/rendering mechanism
+ * need to inherit from this class
+ */
+class syntax_plugin_mantis extends DokuWiki_Syntax_Plugin {
+    /**
+     * return some info
+     */
+    function getInfo(){
+        return array(
+            'author' => 'Victor Boctor',
+            'email'  => 'vboctor at users . sourceforge . net',
+            'date'   => '2006-05-18',
+            'name'   => 'Mantis Issues Plugin',
+            'desc'   => 'Support References to Mantis Issues',
+            'url'    => 'http://www.futureware.biz',
+        );
+    }
+    /**
+     * What kind of syntax are we?
+     */
+    function getType(){
+        return 'substition';  # typo is intentional
+    }
+    /**
+     * What about paragraphs?
+     */
+    function getPType(){
+        return 'normal';
+    }
+    /**
+     * Where to sort in?
+     */
+    function getSort(){
+        return 156;
+    }
+    /**
+     * Connect pattern to lexer
+     */
+    function connectTo($mode) {
+        $this->Lexer->addSpecialPattern('~~Mantis:[0-9]+~~', $mode, 'plugin_mantis');
+    }
+    /**
+     * Handle the match
+     */
+    function handle($match, $state, $pos, &$handler){
+        $match = substr( $match, 9, -2 ); // strip "~~Mantis:" from start and "~~" from end
+        return array( strtolower( $match ) );
+    }
+    /**
+     * Create output
+     */
+    function render($format, &$renderer, $data) {
+        if ( $format == 'xhtml' ) {
+			$renderer->externallink( MANTIS_URL . 'view.php?id=' . $data[0], $data[0] );
+            return true;
+        }
+        return false;
+    }
+}
+</code>
+===== Mantis File Changes for versions before 1.1.0rc2 =====
+If you use mantis 1.1.0rc2 (or later), the following steps are already done and you just need to set
+<code>	$g_wiki_enable = ON;</code>
+in your ''config_inc.php''.
+If you use a mantis version which is older than 1.1.0rc2 please check if any of the changes below still need to be done.
+==== wiki_api.php ====
+Create ''mantis/core/wiki_api.php'' with the following content:
+<code php mantis/core/wiki_api.php>
+<?php
+	# Mantis - a php based bugtracking system
+	# Copyright (C) 2000 - 2002  Kenzaburo Ito - kenito@300baud.org
+	# Copyright (C) 2002 - 2006  Mantis Team   - mantisbt-dev@lists.sourceforge.net
+	# This program is distributed under the terms and conditions of the GPL
+	# See the README and LICENSE files for details
+	# --------------------------------------------------------
+	# $Id: $
+	# --------------------------------------------------------
+	require_once( dirname( __FILE__ ) . DIRECTORY_SEPARATOR . 'helper_api.php' );
+	require_once( dirname( __FILE__ ) . DIRECTORY_SEPARATOR . 'utility_api.php' );
+	require_once( dirname( __FILE__ ) . DIRECTORY_SEPARATOR . 'database_api.php' );
+	require_once( dirname( __FILE__ ) . DIRECTORY_SEPARATOR . 'authentication_api.php' );
+	require_once( dirname( __FILE__ ) . DIRECTORY_SEPARATOR . 'gpc_api.php' );
+	require_once( dirname( __FILE__ ) . DIRECTORY_SEPARATOR . 'access_api.php' );
+	require_once( dirname( __FILE__ ) . DIRECTORY_SEPARATOR . 'project_api.php' );
+	require_once( dirname( __FILE__ ) . DIRECTORY_SEPARATOR . 'wiki_' . config_get( 'wiki_engine' ) . '_api.php' );
+	# ----------------------
+	# Calls a function with the specified name (not including prefix) and given the array
+	# of parameters supplied.  An example prefix is "wiki_dokuwiki_".
+	function wiki_call( $p_function, $p_args_array ) {
+		$t_function = 'wiki_' . config_get_global( 'wiki_engine' ) . '_' . $p_function;
+		return call_user_func_array( $t_function, $p_args_array );
+	}
+	# ----------------------
+	# Checks if the Wiki feature is enabled or not.
+	function wiki_is_enabled() {
+		return config_get( 'wiki_enable' ) == ON;
+	}
+ 	# ----------------------
+	# Ensures that the wiki feature is enabled.
+	function wiki_ensure_enabled() {
+		if ( !wiki_is_enabled() ) {
+			access_denied();
+		}
+	}
+	# ----------------------
+	# Gets the wiki URL for the issue with the specified id.
+	function wiki_get_url_for_issue( $p_issue_id ) {
+		return wiki_call( 'get_url_for_issue', array( $p_issue_id ) );
+	}
+	# ----------------------
+	# Gets the wiki URL for the project with the specified id.  The project id can be ALL_PROJECTS.
+	function wiki_get_url_for_project( $p_project_id ) {
+		return wiki_call( 'get_url_for_project', array( $p_project_id ) );
+	}
+?>
+</code>
+==== wiki_dokuwiki_api.php ====
+Create ''mantis/core/wiki_dokuwiki_api.php'' with the following content:
+<code php mantis/core/wiki_dokuwiki_api.php>
+<?php
+	# Mantis - a php based bugtracking system
+	# Copyright (C) 2000 - 2002  Kenzaburo Ito - kenito@300baud.org
+	# Copyright (C) 2002 - 2006  Mantis Team   - mantisbt-dev@lists.sourceforge.net
+	# This program is distributed under the terms and conditions of the GPL
+	# See the README and LICENSE files for details
+	# --------------------------------------------------------
+	# $Id: $
+	# --------------------------------------------------------
+	# ----------------------
+	# Gets the URL for the page with the specified page id.  This function is used
+	# internally by this API.
+	function wiki_dokuwiki_get_url_for_page_id( $p_page_id ) {
+		$t_root_url = config_get_global( 'wiki_engine_url' );
+		$t_root_namespace = config_get( 'wiki_root_namespace' );
+		if ( is_blank( $t_root_namespace ) ) {
+			$t_page_id = $p_page_id;
+		} else {
+			$t_page_id = $t_root_namespace . ':' . $p_page_id;
+		}
+		return $t_root_url . 'doku.php?id=' . urlencode( $t_page_id );
+	}
+	# ----------------------
+	# Gets the page id for the specified issue.  The page id can then be converted
+	# to a URL using wiki_dokuwiki_get_url_for_page_id().
+	function wiki_dokuwiki_get_page_id_for_issue( $p_issue_id ) {
+		$c_issue_id = db_prepare_int( $p_issue_id );
+		$t_project_id = bug_get_field( $p_issue_id, 'project_id' );
+		$t_project_name = project_get_name( $t_project_id );
+		# create a namespace for the project to contain all project documentation.
+		# create within it a namespace for issues.  This is to allow the creation of a _template.txt
+		# file to act as the template for issues belonging to this project.
+		return $t_project_name . ':issue:' . $c_issue_id;
+          # when using a different language you also could use the translation of 'issue' instead
+          # but when working in a multilingual environment this will lead to different namespaces for each language
+          # (which may be intentional or not). Maybe one should make it configurable one day
+          #    return $t_project_name . ':' . lang_get( 'bug' ) . ':' . $c_issue_id;
+	}
+ 	# ----------------------
+	# Gets the page url for the specified issue id.
+	function wiki_dokuwiki_get_url_for_issue( $p_issue_id ) {
+		return wiki_dokuwiki_get_url_for_page_id( wiki_dokuwiki_get_page_id_for_issue( $p_issue_id ) );
+	}
+	# ----------------------
+	# Gets the page id for the specified project.  The project id can be ALL_PROJECTS
+	# The page id can then be converted to URL using wiki_dokuwiki_get_url_for_page_id().
+	function wiki_dokuwiki_get_page_id_for_project( $p_project_id ) {
+		$t_home = 'start';
+		if ( $p_project_id == ALL_PROJECTS ) {
+			return $t_home;
+		} else {
+			$t_project_name = project_get_name( $p_project_id );
+			return $t_project_name . ':' . $t_home;
+		}
+	}
+ 	# ----------------------
+	# Get URL for the specified project id.  The project is can be ALL_PROJECTS.
+	function wiki_dokuwiki_get_url_for_project( $p_project_id ) {
+		return wiki_dokuwiki_get_url_for_page_id( wiki_dokuwiki_get_page_id_for_project( $p_project_id ) );
+	}
+?>
+</code>
+==== html_api.php ====
+Add the following with the rest of the includes:
+<code php>
+require_once( $t_core_dir . 'wiki_api.php' );
+</code>
+In the ''print_menu()'' function, add the following code after the code which prints the Docs button (the block with the "Project Documentation Page" comment).
+<code php>
+# Project Wiki
+if ( wiki_is_enabled() ) {
+	$t_current_project = helper_get_current_project();
+	$t_menu_options[] = '<a href="wiki.php?type=project&id=' . $t_current_project . '">' . lang_get( 'wiki' ) . '</a>';
+}
+</code>
+Add the following function:
+<code php>
+# --------------------
+# Print a button to create a wiki page
+function html_button_wiki( $p_bug_id ) {
+	if ( ON == config_get( 'wiki_enable' ) ) {
+		if ( access_has_bug_level( config_get( 'update_bug_threshold' ), $p_bug_id ) ) {
+			html_button( 'wiki.php',
+						 lang_get_defaulted( 'Wiki' ),
+						 array( 'id' => $p_bug_id, 'type' => 'issue' ),
+						 'get' );
+		}
+	}
+}
+</code>
+Update ''html_button()'' to the following implementation:
+<code php>
+# --------------------
+# Print an html button inside a form
+function html_button ( $p_action, $p_button_text, $p_fields = null, $p_method = 'post' ) {
+	$p_action		= urlencode( $p_action );
+	$p_button_text	= string_attribute( $p_button_text );
+	if ( null === $p_fields ) {
+		$p_fields = array();
+	}
+	if ( strtolower( $p_method ) == 'get' ) {
+		$t_method = 'get';
+	} else {
+		$t_method = 'post';
+	}
+	PRINT "<form method=\"$t_method\" action=\"$p_action\">\n";
+	foreach ( $p_fields as $key => $val ) {
+		$key = string_attribute( $key );
+		$val = string_attribute( $val );
+		PRINT "	<input type=\"hidden\" name=\"$key\" value=\"$val\" />\n";
+	}
+	PRINT "	<input type=\"submit\" class=\"button\" value=\"$p_button_text\" />\n";
+	PRINT "</form>\n";
+}
+</code>
+==== lang/strings_english.txt ====
+Add the following at the end of the file but before the PHP end block (?>):
+<code php>
+# wiki related strings
+$s_wiki = 'Wiki';
+</code>
+==== wiki.php ====
+Create wiki.php file in Mantis root folder:
+<code php wiki.php>
+<?php
+	require_once( 'core.php' );
+	$t_core_path = config_get( 'core_path' );
+	require_once( $t_core_path . 'wiki_api.php' );
+	$f_id = gpc_get_int( 'id' );
+	$f_type = gpc_get_string( 'type', 'issue' );
+	if ( $f_type == 'project' ) {
+		project_ensure_exists( $f_id );
+		$t_url = wiki_get_url_for_project( $f_id );
+	} else {
+		bug_ensure_exists( $f_id );
+		$t_url = wiki_get_url_for_issue( $f_id );
+	}
+	print_header_redirect( $t_url );
+?>
+</code>
+==== bug_view_*_page.php ====
+Add the following code before the <td> tag that comes before the "<!-- prev/next links -->" comment in both bug_view_page.php and bug_view_advanced_page.php.
+<code php>
+<span class="small">
+    <?php print_bracket_link( 'wiki.php?id='.$f_bug_id, lang_get( 'wiki' ) ) ?>
+</span>
+</code>