FAQRebuildingWikiUsersTopic < System

<blockquote class="foswikiHelp">%X% Under normal circumstances, there should be no need to rebuild your %USERSWEB%.WikiUsers topic.</blockquote>

Sometimes, the %USERSWEB%.WikiUsers topic maintained by %SYSTEMWEB%.TopicUserMappingContrib 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 %USERSWEB%.WikiUsers topic, or
   * You migrated a TWiki installation and accumulated new registrations on the new %USERSWEB%.WikiUsers 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 %SYSTEMWEB%.TopicUserMappingContrib, the script below should refresh your %USERSWEB%.WikiUsers topic with an accurate list of users. It uses the [[%SYSTEMWEB%.VarUSERINFO][USERINFO]] macro, which protects user information from ordinary users - so this topic needs to be viewed with [[%SYSTEMWEB%.AccessControl#The_Super_Admin_Group][admin privileges]] in order for it to be useful.

Usage Notes:
   * The data is populated by searching for topics in %USERSWEB% containing a UserForm.
   * "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.

%TWISTY{showlink="Show code..."}%
<!--%JQREQUIRE{"chili"}%-->
<verbatim class="tml">
%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 - &lt;a name='$item'&gt;- - - -&lt;/a&gt; $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"}% 
</verbatim>

%ENDTWISTY%

<sticky>
<form action="%SCRIPTURLPATH{"save"}%/%USERSWEB%/WikiUsers" method="post">
<textarea name="text" rows="20" cols="80">
%INCLUDE{"UsersTemplate" section="header"}%
%IF{ "$USERNAME ingroup 'AdminGroup'" then="$percntINCLUDE{\"%TOPIC%\" section=\"WIKIUSERS\"}$percnt"
         else="
VIEW THIS TOPIC AS AN ADMIN TO CREATE THE USER LIST

" }%
%INCLUDE{"UsersTemplate" section="footer"}%
</textarea>

<input type="submit" value="Update %USERSWEB%.<nop>WikiUsers"/> </form>
</sticky>

System.FAQForm edit

TopicClassification	FrequentlyAskedQuestion
Topic Summary	How can I re-build my WikiUsers topic?
Interested Parties
Related Topics	Foswiki:Support.Faq27, TopicUserMappingContrib, WikiUsers, AdminDocumentationCategory

This topic: System > WebHome > UsersGuide > FrequentlyAskedQuestions > FAQRebuildingWikiUsersTopic
Topic revision: 17 Jul 2012, ProjectContributor (raw view)

Copyright © CC-BY-SA by the contributing authors. All material on this collaboration platform is copyrighted under CC-BY-SA by the contributing authors unless otherwise noted.
Ideas, requests, problems regarding Foswiki? Send feedback