Welcome, Registration, and other StartingPoints; Foswiki history & Wiki style; All the docs...
Edit | Attach | New | Raw | Delete | History | Print | Tools
You are here: System » NewUserPlugin

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):

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

Plugin Author: Michael Daum
Copyright ©: 2006-2009, Michael Daum http://michaeldaumconsulting.com
License: GPL (GNU General Public License)
Plugin Version: v2.01
Change History:  
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
spacer
Copyright © 2014 Atomikos BVBA. Transaction Management for Extreme Transaction Processing and SOA Environments serving ISV, Commercial, OEM and Open Source Markets
Site map RSS ATOM