Question: How can I re-build my Wiki Users topic?

Answer

ALERT! Under normal circumstances, there should be no need to rebuild your Wiki Users topic.

Sometimes, the Wiki Users topic maintained by Topic User Mapping Contrib may not reflect the true list of users registered on your Foswiki installation. This most commonly happens when:
  • You deleted or renamed users and forgot to edit the Wiki Users topic, or
  • You migrated a TWiki installation and accumulated new registrations on the new Wiki Users topic before you had a chance to initialise it with the old list from the old TWikiUsers topic.

Assuming your wiki is configured to use Topic User Mapping Contrib, the script below should refresh your Wiki Users topic with an accurate list of users. It uses the USERINFO macro, which protects user information from ordinary users - so this topic needs to be viewed with admin privileges in order for it to be useful.

Usage Notes:
  • The data is populated by searching for topics in Users containing a User Form.
  • "User Topics" that are unknown to the password manager will be added, appearing as a line with the WikiName but no username. These lines can be deleted.
    • Ex: BadRegistration - - 02 Mar 2012 - 23:50
  • There must not be any embedded blank lines in the list. The Mapper will detect the first blank line as the end of the list, adding entries after that line.

%STARTSECTION{"WIKIUSERS"}%
%FORMAT{"A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z" 
    type="string" 
    format="   * $item - <a name='$item'>- - - -</a> $percentINCLUDE{
        \"%TOPIC%\"
        section=\"USERS\"
        letter=\"$item\"
    }$percent" 
}% 
%ENDSECTION{"WIKIUSERS"}%

%STARTSECTION{"USERS"}%%SEARCH{
    "name=~'^%letter%.*' AND (form.name~'*UserForm')"
    type="query"
    web="%USERSWEB%"
    nonoise="on"
    separator="$n"
    header="$n"
    format="   * $topic - $percentUSERINFO{
        \"$topic\"
        format=\"$dollarusername\"
    }$percent - $createdate"
}%%ENDSECTION{"USERS"}% 

Back to: FrequentlyAskedQuestion
Related Topics: Foswiki:Support.Faq27, Topic User Mapping Contrib, Wiki Users, Admin Documentation Category
Topic revision: r1 - 13 Mar 2015, ProjectContributor
 

This site is powered by FoswikiCopyright © by the contributing authors. All material on this site is the property of the contributing authors.
Ideas, requests, problems regarding Foswiki? Send feedback