NewUserPlugin

Description

Powered by WikiRing Consultants

This plugin is of use in those cases where users are registered and authenticated externally, for example using LDAP. So users are not registered natively using its own registration workflow and therefore don't have a user topic in the Main web. This plugin fills that gap and creates a user's topic if it does not yet exist.

Settings

You can customize the template that is used to create a new user topic by setting the NEWUSERTEMPLATE preference variable (e.g. in SitePreferences):

• Set NEWUSERTEMPLATE = NewLdapUserTemplate?

If not set, it defaults to NewUserTemplate. This plugin comes with an example template, NewLdapUserTemplate? , to illustrate how to extract user data from an LDAP directory and integrate the information into the user's topic dynamically. You will need to install the Foswiki:Extensions/LdapNgPlugin and the Foswiki:Extensions/GluePlugin to make use of it.

Syntax

During topic creation the following variables in the NEWUSERTEMPLATE are expanded:

• $nop:
• %WIKINAME%:
• %<nop<USERNAME%
• %WIKIUSERNAME%
• %EXPAND{...}%
• %STARTEXPAND% ... %STOPEXPAND%

To expand additional VARIABLES, you can use the %EXPAND{}% or %STARTEXPAND% ... %STOPEXPAND%= syntax. All percent signs have to be escaped by $percnt, deeper recursion levels may use $dollar, too.

Example:

%EXPAND{$percntGMTIME{"$year-$mo-$day"}$percnt}%

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.

Plugin Info

This work is partly funded by

• T+T Hennerich GmbH
• Trivadis AG

Plugin Author:	Michael Daum
Copyright ©:	2006-2009, Michael Daum http://michaeldaumconsulting.com
License:	GPL (GNU General Public License)
Release:	v2.10
Version:	4919 (2009-09-14)
Change History:
13 Sep 2009	creating user homepages as RegistrationAgent
05 May 2009	also expand %25WIKINAME%25 and friends
24 Apr 2009	converted to foswiki plugin
18 Feb 2009	homepages are only created if we can get a WikiUserName that is a proper WikiWord
15 Sep 2008	Oliver Krueger: added EXPAND feature, removed noise in debug.txt
11 Jun 2008	added %STARTEXPAND%, %STOPEXPAND% to expand TML during topic creation
12 Feb 2008	remove leading/trailing whitespaces from NEWUSERTEMPLATE filename
09 Jan 2008	fixed spelling error
03 Jan 2008	fixed default values for NEWUSERTEMPLATE, clearing unset LDAP attributes
23 Oct 2007	work around infinite loop in combination with ActionTrackerPlugin
17 Sep 2007	replace usernames in formtemplates as well as in the topic text
18 Dec 2006	initial release
Dependencies:	None
Plugin Home:	Foswiki:Extensions/NewUserPlugin
Support:	Foswiki:Support/NewUserPlugin