wiki:AccountManagerPlugin/WikiMacros

Version 2 (modified by hasienda, 2 years ago) (diff)

add current state of AccountManagerPlugin

Wiki macros provided by AccountManagerPlugin

Since r11327 (acct_mgr-0.4) the plugin offers some macros for TracWiki.

Syntax

UserQuery
Wiki macro listing users that match certain criteria.

This macro accepts a comma-separated list of keyed parameters, in the form "key=value". Valid keys:

  • perm -- show only that users, a permission action given by value has been granted to
  • locked -- retrieve users, who's account has/has not been locked
  • format -- output style: 'count', 'list' or comma-separated values (default)
  • nomatch -- replacement wiki markup that is displayed, if there's no match and output style isn't 'count' either

'count' is also recognized without prepended key name. Other non-keyed parameters are:

  • name -- forces replacement of maching username with their corresponding full names, if available
  • email -- append email address to usernames, if available

Related issues

#6616 Invalid entries for usernames in table - originally wontfix, moved over from UserStatsMacro
#9852 Embed some user information in TracWiki - initial and primary development ticket

Development notes

Because I favor added-value over rather uncontrolled growth of Trac plugins I aim at integration of related plugins, addressing their outstanding issues too. See #9852 for more reasons, why I think this is especially a good idea in this case.

WikiStatsPlugin

Featured macros

  • Stats(Username) | Stats() -- Stats for an individual: prints wiki edit and attachment statistics for a specified user or as a table for all wiki users
  • PageCount -- prints a count of the number of pages in the wiki
  • UserCount -- prints a count of the number of users in the wiki (acct_mgr plugin with the db backend required)

Issues

  • Pending No results
  • Resolved

    #3874
    Error: no such function: IF
    #5715
    No documentation on WikiMacros page
    #7630
    Inquiring as to maintainership status

Translation

WikiStatsPlugin macroAccountManagerPlugin macro
UserCount UserQuery(count)
no limitation regarding suitable user stores

UserStatsMacro

Featured macros

  • UserStats -- wiki table with all user names, last login timestamp, and the number of days that have passed since the last login

Issues

  • Pending

    #4237
    Provide more useful feedback if a user has never logged in
    #4238
    Allow ability to "colourize" 'How long ago' column
    #4239
    Add ability to generate additional [wiki:username] links for each user
    #4379
    [Patch] Show user's full name in addition to user login
    #5640
    Better readability for 'How long ago' column
    #6142
    Option to hide accounts that are not active

  • Resolved

    #6143
    Adoption request
    #6316
    "import datetime" breaks RecentChanges
    #6419
    "How long ago" time does not update
    #9806
    Plugin needs a license

Translation

WikiStatsPlugin macroAccountManagerPlugin macro
UserStats planned, see #9852