JoomlaUsersContrib Contrib Package

tested with Joomla 1.0.13 and 1.5

This Contrib enables you to replace the Foswiki 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 Foswiki 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, Foswiki will also attempt (has worked on joomla 1.3, but not reliably) to use the Joomla 'remember me' cookie - though this requires the Foswiki and Joomla host names to be the same.

Over-ride Foswiki authentication using only the Joomla sessions If there is no Joomla Session cookie, Foswiki will use the Guest user. NOTE: you will need to specify a Joomla Login UI URL for Foswiki to redirect to to authenticate

• $Foswiki::cfg{Plugins}{JoomlaUser}{JoomlaAuthOnly} = $FALSE;

Joomla Login UI URL for Foswiki to redirect to to authenticate - used if JoomlaAuthOnly is set to true

• $Foswiki::cfg{Plugins}{JoomlaUser}{JoomlaAuthURL} = 'http://Joomla/blog?return=Extensions.JoomlaUsersContrib';

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 Joomla's

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

Installation Instructions

You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server.

Open configure, and open the "Extensions" section. Use "Find More Extensions" to get a list of available extensions. Select "Install".

If you have any problems, or if the extension isn't available in configure, then you can still install manually from the command-line. See http://foswiki.org/Support/ManuallyInstallingExtensions for more help.

• set Foswiki::Users::JoomlaUserMapping as your UserMapping in configure's Security section
• set Foswiki::LoginManager::JoomlaLogin 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 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.

Contrib Info

Plugin Author:	Foswiki:Main.SvenDowideit - of fosiki.com - WikiRing.com
Copyright:	© 2006-2011, SvenDowideit@fosiki.com
License:	GPL 3 (GNU General Public License)
Dependencies:	Name Version Description Foswiki::Contrib::DbiContrib >0 Simplifies database communications to Foswiki DBD::mysql >=3.0000 (and its pre-requisites) MySQL driver for the Perl5 Database Interface (DBI)
Version:	11510 (2011-04-20)
Change History:
20 Mar 2011	Fixed crash in command line invocation, AnupamSaha from OnSumaye Web Solutions added JoomlaAuthURL setting
29 Mar 2011	loosened up the tests for using the joomla remember me cookies for joomla 1.5
30 Jul 2010	add support for joomla session cookie auto login, and rewrite some to bring back foswiki 1.0.x compatibility
14 Aug 2009	rename login template from login.joomla.tmpl to loginjoomla.tmpl to enable user skins
1 Aug 2009	update to work with Joomla 1.3 and 1.5, migrate to the more modern Foswiki:Extensions.DbiContrib
Mar 2009	port to Foswiki
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://foswiki.org/Extensions/JoomlaUsersContrib

-- SvenDowideit@fosiki.com