← Back to branch summary

~ubuntu-branches/ubuntu/natty/moin/natty-updates

« back to all changes in this revision

Viewing changes to wiki/underlay/pages/HelpOnUserHandling/revisions/00000001

  • Committer: Bazaar Package Importer
  • Author(s): Jonas Smedegaard
  • Date: 2008-06-22 21:17:13 UTC
  • mfrom: (0.9.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20080622211713-fpo2zrq3s5dfecxg
Tags: 1.7.0-3
Simplify /etc/moin/wikilist format: "USER URL" (drop unneeded middle
CONFIG_DIR that was wrongly advertised as DATA_DIR).  Make
moin-mass-migrate handle both formats and warn about deprecation of
the old one.

Show diffs side-by-side

added added

removed removed

Lines of Context:
wiki/underlay/pages/HelpOnUserHandling/revisions/00000001
1
 
##master-page:HelpTemplate
2
 
##master-date:Unknown-Date
 
1
## Please edit system and help pages ONLY in the master wiki!
 
2
## For more information, please see MoinMoin:MoinDev/Translation.
 
3
##master-page:
 
4
##master-date:
 
5
#acl -All:write Default
3
6
#format wiki
4
7
#language en
5
8
 
6
 
[[TableOfContents]]
 
9
<<TableOfContents>>
7
10
 
8
11
= How to maintain your user data =
9
12
 
10
 
User data is stored in directory data/user in files that have the user id as filename. The files with the appendix .trail contain a history of what pages the user visited last.
 
13
User data is stored in directory data/user in files that have the user id as filename.
11
14
 
12
 
To speed up processing, MoinMoin may also generate some data structures that get saved to disk as *.pickle file - these are internal data structures and you must not edit those files. If you are in doubt whether such a *.pickle file is correct or up-to-date, then just delete it and it will be re-generated automatically by moin. If you run a persistent (non-cgi) moin, maybe better restart MoinMoin after deleting the pickle.
 
15
To speed up processing, MoinMoin also maintains a mapping from user name to user id and saves it under `<cache_dir>/.../user/name2id` - these are internal data structures and you must not change those files. If you are in doubt whether name2id is correct or up-to-date, then just delete it and it will be re-generated automatically by moin. If you run a persistent (non-cgi) moin, restart MoinMoin.
13
16
 
14
17
== Disable a user account ==
15
18
 
16
 
You can disable a user account if you are logged in as a superuser (see HelpOnSuperUser) and choose to login to the account of the user via the superuser preferences (so than you will be the user to be deleted) and choose "Disable this account forever" in the preferences. After that you should logoff.
 
19
You can disable a user account if you are logged in as a superuser (see HelpOnSuperUser) and choose to switch to the account of the user via the superuser preferences (so that you will temporarily be logged in as the user to be deleted) and choose "Disable this account forever" in the preferences. After that you should log out to be logged in as yourself again.
17
20
 
18
21
== Removing a user account ==
19
22
You can remove a user by deleting his user file (and other files that are named with that userid prefix).
20
23
 
21
24
Be aware that if you do that, you will destroy the edit history of that user. Moin won't be able to show this user in page history, because this user id will then be unknown. So better disable an account rather than removing it. After user data is deleted, MoinMoin may still think the user exists due to the user cache in data/cache/user/name2id.  Deleting this file purges the cache and should fix this problem.
22
25
 
23
 
== One wiki for user home pages ==
24
 
 
25
 
Yyou can set the value {{{user_homewiki}}} to have one wiki where all the user home pages are stored. Useful if you have many users. You could even link to nonwiki "user pages" if the wiki username is in the target URL.
26
 
 
27
 
== Merging userbases ==
28
 
 
29
 
You can merge two different wiki user bases to one. You can copy all those user files from one wiki to the other, but you should make sure that no user exists twice. The username can be found at "name=" in a user file.
 
26
== Sharing user accounts in wiki farms ==
 
27
On single wikis you don't do anything special, each wiki will have a separate `data/user/` directory and nothing will be shared.
 
28
In a wiki farm with two or more wikis you can share user accounts and data. Add to farmconfig.py 
 
29
{{{
 
30
user_dir = '/farm/user' # common user directory for all farm wikis
 
31
}}}
 
32
if you want that all farm wikis share user accounts, or put the respective absolute path name of the shared user directory in the wikiconfig.py file of the wikis, you want them to share data.
 
33
Make sure that all of your wikis have some unique interwiki name set in their wikiconfig.py files:
 
34
{{{
 
35
interwikiname = "WikiOne"  # others: WikiTwo, WikiThree or whatever you like
 
36
}}}
 
37
Do also add the interwiki names of all farm wikis to the interwiki lists of the wikis so that the wikis can resolve these new names. If you don't set interwiki names, page trail, page subscriptions and quicklinks won't work properly.
 
38
 
 
39
In farmconfig.py you can also set the value {{{user_homewiki}}} to have one wiki where all the user home pages are stored. This could be useful if you have many users. You could even link to nonwiki "user pages" if the wiki username is in the target URL. See HelpOnConfiguration for more on that.
 
40
 
 
41
/!\ If you don't set a unique interwiki name, MoinMoin might not work correctly. You also should strongly avoid changing the interwiki name.