Documentation TOC » Features » Wiki » Wiki Plugin » PluginRealnamelist

Plugin Realnamelist

This Wiki Plugin creates a list of users showing their real names and allows subsetting by Group name. The "admin" user and/or users whose login contains the string "test" can be excluded from the list shown. The list can either be in table format, or in a string. In the latter case a separator can be specified.

Plugin Realnamelist

Usage and Parameters

To use this plugin in a wiki page, use the syntax:

{REALNAMELIST(sep= , max= , sort=asc|desc, layout= , link= , exclude= )}groupname{REALNAMELIST}

Parameter	Accepted values	Default	Effect	Required?
sep	any string in double quotes	comma	effect - only if parameter layout=>table is not specified - is the value that will be used in a string list of names, each name separated from the next by this value.	n
max	number	none	maximum number of users listed	n
sort	asc\|desc	asc	sorts list in alphabetic order. For users without a real name their login name will be shown at the top of the list, in italics.	n
layout	table	list format	if specified, list is in table format, one name per line. Else list is in string format each name separated from the next by the value of parameter sep.	n
exclude	admin\|test\|admin-test\|test-admin	none	if specified, will exclude user(s) whose loginId (not real name) contains either/or the strings "admin" and/or "test" even if these users belong, e.g. to the group specified.	n
link	\|userpage userinfo userpref	none	username will link to this page	n
groupname (between tags)	any string	if missing all users in this tiki will be included in the list.	if specified, only users who belong to a group or groups whose groupname contains the string specified will be included in the list.	n

Note

Users without real names come first with their user names in italics.

Examples

Ascending with table layout

This code,

{REALNAMELIST(sort=asc, layout=table)}DocTwoAdmins{REALNAMELIST}

Would produce on this site:

users in group(s) containing DocTwoAdmins:
dthacker
lindon
mlpvolt
nyloth
slordjette
xavidp
Jean-François B.
luciash d' being
Marc Laporte
Mike

Descending list layout and links

This code,

{REALNAMELIST(sort=asc, link=userinfo)}DocTwoAdmins{REALNAMELIST}

Would produce on this site:
dthacker, lindon, mlpvolt, nyloth, slordjette, xavidp, Jean-François B., luciash d' being, Marc Laporte, Mike, Mose, Nelson, Olaf-Michael Stefanov, Rick