Revision history for IntegrationWithphpBB3


Revision [21728]

Last edited on 2012-05-20 21:13:27 by BrianKoontz [link to new phpbb3 bridge]
Additions:
<<
Sajaki has posted an updated PHPBB3 to WikkaWiki bridge here: https://github.com/Sajaki/Wikkamod
<<
::c::
Deletions:
<<Sajaki has posted an updated PHPBB3 to WikkaWiki bridge here: https://github.com/Sajaki/Wikkamod<<::c::


Revision [21727]

Edited on 2012-05-20 21:12:26 by BrianKoontz [link to new phpbb3 bridge]
Additions:
<<Sajaki has posted an updated PHPBB3 to WikkaWiki bridge here: https://github.com/Sajaki/Wikkamod<<::c::
Deletions:
<<Sajaki has posted an updated PHPBB3 -> WikkaWiki bridge here: https://github.com/Sajaki/Wikkamod<<::c::


Revision [21726]

Edited on 2012-05-20 21:11:58 by BrianKoontz [posted link to new bridge]
Additions:
<<Sajaki has posted an updated PHPBB3 -> WikkaWiki bridge here: https://github.com/Sajaki/Wikkamod<<::c::


Revision [21179]

Edited on 2010-04-25 14:55:07 by MartinLuelf [fixed some more errors and unclear instructions]
Additions:
$base_url_path = preg_replace('/wikka\.php/', '', $_SERVER['SCRIPT_NAME']);%%
%%(php) // USERS
/**
* see http://wikkawiki.org/WikkaWithphpBB3
*/
/**
* see http://wikkawiki.org/WikkaWithphpBB3
*/
/**
/**
/**
* @return true => Member, false => Not Member
function GetUser() { global $phpbb_username; return ($phpbb_username != 'anonymous') ? $this->LoadUser($this->getOwnWikkaName($phpbb_username)) : NULL ;}
Create /wikka/plugins/templates/default/ . Copy all folders inside /wikka/templates/default/ to /wikka/plugins/templates/default/ . Create the file footer.php with the following content:
Inside the css folder delete all global Elements and append a #wikiwrapper before any id-referrence in every css file.
||wikka_template_path||plugins/templates||remove //templates// as they contain the original templates, which are not compatible wit the output through phpBB||
<link href="wikka/plugins/templates/default/css/wikka.css" rel="stylesheet" type="text/css" />%%
===/wikka/images/*===
Move all images to /images
Deletions:
$base_url_path = preg_replace('/wiki\.php/', '', $_SERVER['SCRIPT_NAME']);%%
// USERS
function LoadUser($name, $password = 0) { return $this->LoadSingle("select * from ".$this->config['table_prefix']."users where name = '".mysql_real_escape_string($name)."' ".($password === 0 ? "" : "and password = '".mysql_real_escape_string($password)."'")." limit 1"); }
function LoadUsers() { return $this->LoadAll("select * from ".$this->config['table_prefix']."users order by name"); }%%
// USERS
function GetUser() { global $phpbb_username; return ($phpbb_username != 'Anonymous') ? $this->getOwnWikkaName($phpbb_username) : NULL ;}
Create the file (and folders in path) with the following content:
Delete all global Elements and append a #wikiwrapper before any id-referrence
%%(php;1;wiki.php)
<link href="wikka/plugins/templates/default/css/wikka.css" rel="stylesheet" type="text/css" />
<link href="wikka/plugins/templates/default/css/print.css" rel="stylesheet" type="text/css" />%%


Revision [21178]

Edited on 2010-04-24 10:53:52 by MartinLuelf [Links broke table structure, added a link formatting around the URL]
Additions:
||base_url||[[http://example.com/wiki.php?wakka=]]||Change wakka.php to wiki.php and insert your domain/path||
||user_prefix||ForumUser_||**New option:** Most of my (already existing) usernames are no WikiWords but Wikka requires Usernames to be WikiWords so we put a (WikiWords)prefix before every username to be safe.||
Deletions:
||base_url||http://example.com/wiki.php?wakka=||Change wakka.php to wiki.php and insert your domain/path||
||user_prefix||ForumUser_||**New option:** Most of my (already existing) usernames are no WikiWords but Wikka requires Usernames to be a WikiWord so we put a (WikiWord)prefix before every username to be safe.||


Revision [21177]

Edited on 2010-04-24 10:47:16 by MartinLuelf [Some cleanup and better formatting]
Additions:
====Versions:====
**Wikka:** 1.2 (other versions //might// work as well)
**phpBB:** 3.0.7-PL1 (all versions with major release 3.0 //should// work, newer major releases (e.g. 3.1.*) //might// work. phpBB2 or phpBB4 //won't// work without modification)
At the time of writing (2010-04-23) these are the newest stable Versions.
Download a phpBB Release and unzip it to your document root (I will use / to reffer to this folder from now on). Get a Wikka Release and unzip it in a subfolder called /wikka. Run both Setups.
$base_url_path = preg_replace('/wiki\.php/', '', $_SERVER['SCRIPT_NAME']);%%
$user = $wakka->GetUser();%%
Create the file (and folders in path) with the following content:
Create the file with the following content:
Original wikka.css (just the first lines):
%%(css)
%%(css)
|=|Option|=|Value|=|Comment|=|
||base_url||http://example.com/wiki.php?wakka=||Change wakka.php to wiki.php and insert your domain/path||
||theme||default||If you prepared more templates with the steps from above you can choos a different one, but unchanged templates won't work out of the box.||
||allow_user_registration||0||We don't want wiki-only users thats whats this page is about||
||user_prefix||ForumUser_||**New option:** Most of my (already existing) usernames are no WikiWords but Wikka requires Usernames to be a WikiWord so we put a (WikiWord)prefix before every username to be safe.||
||user_table||phpbb3_users||**New option:** phpBBs usertable||
||user_group_table||phpbb3_user_group||**New option:** phpBBs usergrouptable||
||group_table||phpbb3_groups||**New option:** phpBBs grouptable||
||admin_users||ForumUser_master||Change this to your (forum) Admin account name. Don't forget to add the user_prefix, so in this case my Forum admin is called //master// inside Wikka this useraccount will be called //ForumUser_master//||
Create the file with the following content
%%(php;1;wiki.php)
%%(html4strict)
%%(html4strict)
%%(html4strict)
====How to use====
===Visit your Page / Wiki===
===Group Permissions===
You can give access to single Users just by putting their Names into the ACL just as usual (Remember to use the user_prefix, too). You can also put ~Groupname into the ACL which gives the selected rights to every confirmed Member of the phpBB Group //Groupname//. You can also prevent access to a certain group by negating it. E.g. put !kiddies into the ACL and all Members of //kiddies// can't acces the page.
===URLRewrite===
Up to now I did not have a detailed look at URLRewrite so if youre not sure what to do leave it disabled (leave /wikka/.htaccess untouched and set //rewrite_mode// to //0// in your /wikka/wikka.conf.php . If you are fammiliar with rewriting and want to enable it, please do so and document your steps in this wikipage.
===Language===
As you might have noticed, english is not my native language so if someone who is more familiar with it can have a closer look at this document to wipe out typos or strange grammar, thanks in advance!
- Make the large codeblocks smaller (use a scrollbar), especially the wikka.css file (any idea, how to do this?)
- Try to reproduce the modification, to validate its completness
Deletions:
>>**Works with versions:** Wikka: 1.1.6.5 through 1.2 and phpBB3.*
I worked with Wikka V1.2 and phpBB V3.0.7-PL1 which are - at the time of writing (2010-04-23) - the newest stable Versions.
>>
Download a phpBB Release and unzip it to your document root (I will use / to reffer this folder from now on). Get a Wikka Release and unzip it in a subfolder called /wikka/
%%
// END phpBB3 Integration
%%
$user = $wakka->GetUser();
%%
// END phpBB3 Integration
%%
Finally, find:
%%
And replace with:
%%
Create folders and file
Create:
Original wikka.css:
%%
%%
'base_url' => 'http://example.com/wiki.php?wakka=' Change wakka.php to wiki.php
'theme' => 'default' If you prepared more templates with the steps from above you can choos a different one, but unchanged templates won't work out of the box.
'allow_user_registration' => '0' We don't want wiki-only users thats whats this page is about
Create these new options
'user_prefix' => 'ForumUser_' most of my (already existing) usernames are no WikiWords. Wikka requires WikiWords as Usernames so we put a (WikiWord)prefix before every username to be safe.
'user_table' => 'phpbb3_users' phpBBs usertable
'user_group_table' => 'phpbb3_user_group' phpBBs usergrouptable
'group_table' => 'phpbb3_groups' phpBBs grouptable
And change your Adminaccount name to user_prefix+your phpBBUsername eg:
'admin_users' => 'ForumUser_v1tzl1'
%%
%%
%%
====So long====
You can give access to single Users just by putting their Names into the ACL just as usual (Remember to use the user_prefix, too). You can also put ~Groupname into the ACL which works like every confirmed Member of the phpBB Group "Groupname" is on a single Line in the ACL. You can also prevent access to a certain group by negating it. E.g. put !kiddies into the ACL and all Members of Kiddies can't acces the page (expect you also put their explicit username (without negation) onto the ACL, as wikka only goes throug the list up to the first yes, or no result. So Wikka will stop at the username and will never reach the Group statement)
Up to now I did not have a detailed look at URLRewrite so if youre not sure what to do leave it disabled (leave /wikka/.htaccess untouched and set 'rewrite_mode' => '0' in your /wikka/wikka.conf.php
If you are fammiliar with rewriting and want to enable it, please do so and document your steps in this wikipage. Thats what OpenSource is about ;)
Thats all for today, tomorrow I will try to reproduce this mod just with this page to be sure that I did not skip any section. As you might have noticed, english is not my native language so if someone who is more familiar with it can have a closer look at this document to wipe out typos or strange grammar, thanks in advance!
- General cleanup
- Put the required config values in a table
- Make the large codeblocks smaller (use a scrollbar), especially the wikka.css file
- Find out at which step the Installation Process of Wikka and phpBB would fit in best
- Try to reproduce the mod, to validate its completness
- Add more comments for better documentation of the code and modification steps


Revision [21176]

Edited on 2010-04-22 20:43:19 by MartinLuelf [Copied the Structure of WikkaWithphpBB3 and did not change the title - changed now]
Additions:
=====Integrating Wikka into PHPBB 3.x=====
Deletions:
=====Using Wikka PHPBB 3.x=====


Revision [21175]

The oldest known version of this page was created on 2010-04-22 20:41:50 by MartinLuelf [Copied the Structure of WikkaWithphpBB3 and did not change the title - changed now]
Valid XHTML :: Valid CSS: :: Powered by WikkaWiki