Hello all,
i tried to use this mod to integrate mantis in my board. I had to do some things to bring it to work...
First, make sure that you haven't downloaded the file poyntesm specified in his first post in this thread - it's a (more) buggy release. Download it through svn (
https://svn.sourceforge.net/svnroot/phpbbmantis), then you will have less to do.
Done this, I installed the mod like described in the install instructions. works great, the instructions are easy to understand and they fit the code. But after this, opening bugs/ in your webbrowser will fail. I spend hours to bring it to work then and wrote a report about what i've done; here it is. For all those who want to use mantis bugtracker in their board.
--- Start Tutorial ----
After installing phpBB mantis MOD it didn't work. There are several things you got to do after that to bring it to work.
First, I got the error message, that there is a file strings_english.txt missing.
----
Warning: lang_load(/home/www/me/html/phpBB/bugs/../language/strings_english.txt): failed to open stream: No such file or directory in /home/www/me/html/phpBB/bugs/core/lang_api.php on line 39
----
This error you'll get for every language you set in your phpbb profile. These files can be found in the original mantis distribution. Download the mantis distribution (
http://www.mantisbt.org). Now question is, which release. It's hard to answer this, because I don't want to recommend to download older releases. The release of mantis used in the MOD seems to be around <= 1.0.0, based on this by poyntesm:
---- see
http://www.phpbb.com/community/viewtopi ... 2#p1979602
I will update to 1.0 once it is out. I am just working through the sessions stuff. Then it will be ready. The language stuff is now complete
----
Because I didn't want to go through endless changelogs I took the newest version (1.2.0a2 in my case) and it worked for me so far.
Once you've downloaded the mantis package, just put it somewhere on your desktop. You won't need to install it. Extract/Open the downloaded folder and move to directoy called "lang". There are some files like "strings_LANGUAGE.txt"-Files. Copy these files (clipboard); you can just take the ones you need for your board (You can also copy all the files, of course). Destination will be the folder "languages" in your phpbb-root directory. In my case it was /home/www/me/html/phpBB/languages/ on my server. The error disappears.
Depending, if you specified some other table prefix for your phpbb tables than "phpbb_", you might geht the following error when opening /bugs/ in your webbrowser:
----
SQL Error : 1146 Table 'DB.phpbb_users' doesn't exist
----
Fixing this is done by moving to your /bugs/ directory and opening file "config.inc.php". Here you can make very much useful configurations for your bugtracker, please have a look at the documentation on
http://www.mantisbt.org/manual/manual.configuration.php. One change you have to do is now looking for this line:
----
$g_mantis_user_table = 'phpbb_users';
----
Here you specify which is your user table. Check out your phpbb database and watch out for a table that ends with 'users'. Put the name of the table in $g_mantis_user_table in bugs/config.inc.php and save it. E.g.
----
$g_mantis_user_table = 'myprefix_users';
----
This is also a good opportunity to set other bugtracker configs like admin e-mail address or the window title.
If you have specified an own theme, make sure that every theme has the file "overall_bug_header.tpl" (templates/TEMPLATENAME/overall_bug_header.tpl)
in it. You find this file in the phpBB mantis MOD ZIP in root/templates/subSilver/. Copy the file in
in every theme you want to use for your board. Customize it afterwards, if needed.
Not doing this will cause this error:
----
Template->make_filename(): Error - file overall_bug_header.tpl does not exist
----
Edit the file overall_bug_header.tpl to modify the look of the bugtracker. This is important, because the file is optimised for subsilver template.
When you open your bugs/ dir now in webbrowser, it looks quite nice. But images and css might not be there - why? Because you made relative paths in your template files.
----
<img src="templates/TEMPLATENAME/images/icon_mini_groups.gif" width="12" height="13" border="0" alt="{L_USERGROUPS}" hspace="3" />
----
This is good when you open your forum directly, then the image/css paths are right. But we're in bugs/, so seen from this directory, they're not right. To fix this, you have to change every path to an image/cssfiles/jsfile/etcfile in your template files to its absolute path. If your board is in the root of your domain, this is done by adding a slash (/):
----
<img src="/templates/TEMPLATENAME/images/icon_mini_groups.gif" width="12" height="13" border="0" alt="{L_USERGROUPS}" hspace="3" />
----
For e.g. it's in
www.example.org/phpbb/ you do this:
----
<img src="/phpbb/templates/TEMPLATENAME/images/icon_mini_groups.gif" width="12" height="13" border="0" alt="{L_USERGROUPS}" hspace="3" />
----
We're not finished yet
As poyntesm developped for his own website, the mod has (unfortunately) some code lines, which refer to mod phpgarage (by poyntesm). Not having this mod will cause the following error:
----
SQL Error : 1146 Table 'DB.GARAGE_QUARTERMILE_TABLE' doesn't exist
----
To get around this error you could install phpgarage mod or this:
Open file bugs/core/html_api.php and look for passages enclosed by
//-- mod start : Garage ----------------------------------------------------------------------------------------------------
//-- add
and
//-- mod finish : Garage ---------------------------------------------------------------------------------------------------
In my html_api.php there were two of them, one small and one large (about 50 lines of code). Delete the code between and the mod-limiters too.
Open bugs/ then in your browser and it seems to work.
--- End tutorial ---
Phew... And sorry for my English
Hope this helps someone.
Greetings,
jeko
http://dominiquesandoz.ch