PhpBB3UsersContrib Contrib Package

tested with phpBB3 v3.0.4

This Contrib enables you to replace the Foswiki User and Groups system with a read only access to the User and Groups in a phpBB3 Database. Registration of new users and their association with Groups is then only handled by phpBB3, making it possible to remove the distributed Main web.

You are advised to use the same same host for Foswiki and the phpBB3 Database, otherwise user query performance (happens every request) will severely degrade the response time.

NOTE: for performance reasons, the phpBB3 Registered Users group is not brought into the system. The other groups may cause performance degradation if they have too many members

Settings

Settings are in lib/LocalSite.cfg. the Foswiki configure script does not currently display the non-core options, but should also not remove them. See the Installation Instructions below for details.

• One line description:
  • Set SHORTDESCRIPTION = replace the Foswiki User and Groups System with phpBB3's

• Name of the perl package
  • Set STUB = authenticate using the phpBB3 users - disable registration.

Installation Instructions

• Run PhpBB3UsersContrib_installer.pl to automatically check and install other modules that this module depends on. You can also do this step manually. Dependencies:

  Name	Version	Description
  DBIx::SQLEngine	>=0.93	(and its pre-requisites) Extends DBI with High-Level Operations
  DBD::mysql	>=3.0000	(and its pre-requisites) MySQL driver for the Perl5 Database Interface (DBI)

• set Foswiki::Users::PhpBB3UserMapping as your UserMapping in configure's Security section
• set Foswiki::LoginManager::PhpBB3Login as your LoginManager in configure's Security section
• set none as your PasswordManager in configure's Security section
• set the {AdminGroup} in the configure security section to one of the phpBB3 groups (such as ADMINISTRATORS)
• configure PhpBB3UsersContrib from the User Managers / phpBB3 User Manager section in configure
  • this needs a DBI connection string to your phpBB3 database, and a valid username and password for it.
• Test if the installation was successful:
  • see also Sandbox.PluginTestPhpBB3UsersContrib

Contrib Info

Plugin Author:	Foswiki:Main.WillNorris - WikiRing.com
Copyright:	© 2008 Isaac Lin, © 2009 Will Norris Based on Foswiki:Extensions.JoomlaUsersContrib © 2006-2009, SvenDowideit@fosiki.com
License:	GPL (GNU General Public License)
Dependencies:	Name Version Description DBIx::SQLEngine >=0.93 (and its pre-requisites) Extends DBI with High-Level Operations DBD::mysql >=3.0000 (and its pre-requisites) MySQL driver for the Perl5 Database Interface (DBI)
Version:	$Rev$
Change History:
13 Mar 2009	support for phpBB2 passwords
12 Mar 2009	group and admin support
11 Mar 2009	convert from Foswiki:Extensions.JoomlaUsersContrib
Home:	http://foswiki.org/Extensions/PhpBB3UsersContrib
Support:	http://foswiki.org/Support/PhpBB3UsersContrib