TWiki Variables » Search » Category: Users & Authentication

BUBBLESIG -- show bubble box and user signature with profile picture icon

• Syntax: %BUBBLESIG{WikiName}% or %BUBBLESIG{WikiName - YYYY-MM-DD}%
• The parameter can be either just the WikiName of a user, or by convention the WikiName followed by a dash and the date
• Example:
  -- %BUBBLESIG{TWikiGuest - 2026-01-21}%
• Expands to:
  -- TWiki Guest - 2026-01-21
• Category: EditingAndContentUpdateVariables, FormattingAndRenderingVariables, UsersAndAuthenticationVariables
• Related: USERREPORT, USERSIG, UserList, UserReports (this topic)

GEOLOOKUP -- lookup geo location by IP address or domain name

• The %GEOLOOKUP{}% variable is handled by the GeoLookupPlugin
• Syntax: %GEOLOOKUP{"host" format="..."}%
• Parameters:

  Parameter	Description	Default
  "..."	Host IP address or host name	none, required
  format="..."	Format of geolocation. Supported variables: • $latitude: Latitude • $longitude: Longitude • $city: City name • $region: Region name • $country_name: Country name • $country_code: Two letter country code • $postal_code: Postal code (USA only) • $metro_code: Metropolitan code (USA only) • $area_code: Telephone area code (USA only)	"$city, $region, $country_name"

• Example: %GEOLOOKUP{"75.52.124.86"}% shows default format (city, region, country code)
• Example: %GEOLOOKUP{"75.52.124.86" format="$latitude, $longitude"}% shows comma separated Latitude and Longitude
• Category: AdministrationVariables, ApplicationsAndComponentsVariables, DevelopmentVariables, SecurityAndAccessControlVariables, UsersAndAuthenticationVariables
• Related: GeoLookupPlugin (this topic)

RECENTVISITOR -- show statistics of recent visitors to the TWiki site

• The %RECENTVISITOR{}% variable is handled by the RecentVisitorPlugin
• Most recent visit of an individual:
  • Syntax: %RECENTVISITOR{"user" name="..." format="..."}%
  • Parameters:

    Parameter	Description	Default
    "user" or action="user"	Recent visit of an individual report	(none)
    name="..."	WikiName of person	(currently logged in user)
    format="..."	Format of report. Supported tokens: • $date - date of last visit • $time - time of last visit (GMT) • $ago - how long ago • $ip - IP address (only shown to non-administrators if enabled in configure) • $n, $nop, $quot, $percnt, $dollar - standard FormatTokens.	"Last seen $ago ago"
    notfound="..."	Message shown if user is not found.	"Never seen"

• Report of recent visitors:
  • Syntax: %RECENTVISITOR{"recent" format="..."}%
  • Parameters:

    Parameter	Description	Default
    "recent" or action="recent"	Report of recent visitors	(none)
    format="..."	Format of each line of the report. Supported tokens: • $username - login name of user • $wikiname - WikiName of user • $wikusername - WikiName prefixed with Main web name • plus above tokens.	"   * $wikiusername last seen $ago ago"
    separator="..."	Separator between lines. Standard FormatTokens are expanded.	"$n" (newline)
    limit="..."	Limit the number of lines.	"10"

• Examples:
  • %RECENTVISITOR{"user" name="TWikiAdminUser"}% - show most recent visit of TWikiAdminUser.
  • %RECENTVISITOR{"recent" format="| $wikiusername | $ago ago |}% - show 10 most recent visitors.
• Category: AdministrationVariables, UsersAndAuthenticationVariables
• Related: RecentVisitorPlugin (this topic)

USERREPORT -- show user reports with profile pictures

• Show various user reports documented in UserReports
• Syntax: %USERREPORT{ action="..." ... }%
• Overview of actions with parameters:

  Report	action=	Parameters
  Show a simple list of registered users	"user_list"	search, limit, sort, reverse
  Show the profile picture image of a user	"profile_picture"	user, height, width, title
  Show slim, one line height user boxes	"slim_box_start" "slim_box" or "slim_box_list" "slim_box_end"	style user, style users, style none
  Show small, two line height user boxes	"small_box_start" "small_box" or "small_box_list" "small_box_end"	style user, style users, style none
  Show users in business card format	"business_card_start" "business_card" or "business_card_list" "business_card_end"	style user, style users, style none
  Show a selector to pick a user, for use in HTML forms	"select_one_user"	name, selected, users
  Show rows of checkboxes to select users, for use in HTML forms	"select_users"	name, selected, users, colums, style

• Example: %USERREPORT{ action="user_list" search="jane" limit="5" }%
• Category: AdministrationVariables, DevelopmentVariables, UsersAndAuthenticationVariables
• Related: BUBBLESIG, SEARCH, USERSIG, UserList, UserReports (this topic)

USERSIG -- show user signature with profile picture icon

• Syntax: %USERSIG{WikiName}% or %USERSIG{WikiName - YYYY-MM-DD}%
• The parameter can be either just the WikiName of a user, or by convention the WikiName followed by a dash and the date
• Example:
  -- %USERSIG{TWikiGuest - 2026-01-21}%
• Expands to:
  -- TWiki Guest - 2026-01-21
• Category: EditingAndContentUpdateVariables, FormattingAndRenderingVariables, UsersAndAuthenticationVariables
• Related: BUBBLESIG, USERREPORT, UserList, UserReports (this topic)

Total: 5 variables

Related Topics: TWikiVariables, TWikiVariablesSearch, TWikiVariablesQuickStart