JoomlaUsersContrib Contrib Package

REQUIRES TWiki 4.2 beta3 or later.

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 severly 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 degredation if they have too many members

By selecting JoomlaLogin, TWiki will also attempt to use the Joomla 'remember me' cookie - though this reqires the TWiki and Joomla hostnames 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 = TWiki::Contrib::JoomlaUsersContrib

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 distributedINFORMATION.com
Copyright:	© 2006-2007, SvenDowideit@wikiringPLEASENOSPAM.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:
Nov 2007	updated to TWiki 4.2, and released
2006	Initial version (not public)
Home:	http://uhm1yw1p2k7baemmv4.roads-uae.org/cgi-bin/view/Plugins/JoomlaUsersContrib
Feedback:	http://uhm1yw1p2k7baemmv4.roads-uae.org/cgi-bin/view/Plugins/JoomlaUsersContribDev
Appraisal:	http://uhm1yw1p2k7baemmv4.roads-uae.org/cgi-bin/view/Plugins/JoomlaUsersContribAppraisal

Related Topics: TWikiPreferences

-- SvenDowideit@distributedINFORMATIONPLEASENOSPAM.com