JoomlaUsersContrib Contrib Package

REQUIRES TWiki 4.2 later, and tested with Joomla 1.0.13

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

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

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

By selecting JoomlaLogin? , TWiki will also attempt to use the Joomla 'remember me' cookie - though this requires the TWiki and Joomla host names to be the same.

Settings

Settings are in lib/LocalSite.cfg. the TWiki 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 TWiki User and Groups System with Joomla's

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

Installation Instructions

Download the ZIP file from the Plugin web (see below)

Unzip JoomlaUsersContrib.zip in your twiki installation directory. Content:

File:	Description:
`data/TWiki/JoomlaUsersContrib.txt`	Plugin doc page
`lib/TWiki/Contrib/JoomlaUsersContrib.pm`	Plugin Perl module
`lib/TWiki/LoginManager/JoomlaLogin.pm`	use Joomla cookie for session initilaisation
`lib/TWiki/Users/JoomlaUserMapping.pm`	get User and Group information from Joomla Database

Run JoomlaUsersContrib_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 TWiki::Users::JoomlaUserMapping as your UserMapping? in configure's Security section
set TWiki::LoginManager::JoomlaLogin as your LoginManager? in configure's Security section
set none as your PasswordManager? in configure's Security section
set the {TWikiAdminGroup} in the configure security section to one of the Joomla groups (such as Super Administrator)
configure JoomlaUsersContrib from the User Managers / Joomla User Manager section in configure
- this needs a dbi connection string to your Joomla database, and a valid username and password for it.
Test if the installation was successful:
- enter sample here
- see also Sandbox.PluginTestJoomlaUsersContrib?

Contrib Info

Plugin Author:

TWiki:Main.SvenDowideit - of fosiki.com -

WikiRing.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:

138

Change History:

Sep 2008

updated to 4.2.1 mapping, and fixed for Joomla 1.0.13 - where the password salts were changed

Nov 2007

updated to TWiki 4.2, and released

2006

Initial version (not public)

Home:

http://TWiki.org/cgi-bin/view/Plugins/JoomlaUsersContrib

Feedback: