Description
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.00 |
Change History: |
|
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 |