create new tag
view all tags

User Subwebs

TWiki provides each user with their own topic having their information and configuration. You may want to provide each user with a subweb Main/FirstLast having a topic having the user's information and configuration.


On a TWiki site having thousands of webs, web accountability is crucial. Each web needs to have clearly defined owners so that TWiki admins can take actions such as deletion of unused webs.

On a TWiki site having thousands of users, the Public web needs to be locked down to prevent random topics from accumulating. For that, a user should be able to have only FirstLast, FirstLastLeftBar, and FirstLastBookmarks topics on the Main web. This is inconvenient for users who want to have more topics for their personal use.

You may allow users to have a web for their personal use, but that would be messy on a large site - webs for personal use and team use co-existing at the same level. If you have thousands of top level webs (non subweb) and thousands of users, then you may end up having much more top level webs than otherwise.

If users have Main/FirstLast subwebs instead of Main.FirstLast topics, it would be a good compromise between accountability, convenience, and tidiness of the site.

How it works

In general, if the TopLevel/SecondLevel subweb exists, TopLevel.SecondLevel becomes a link to TopLevel/SecondLevel.WebHome. As such, if the user FirstLast has the subweb Public/FirstLast, Public.FirstLast becomes the link to Public/FirstLast.WebHome.

If user subwebs are enabled, user configration is read first from the user's subweb. If it fails, the user's topic is tried. This way, you can have some users having their subwebs while the other users having user topics.

Please note that a user's topic and the subweb of the same user cannot coexist. Because you cannot create the subweb TopLevel/SecondLevel if the topic TopLevel.SecondLevel exists. (SubwebAndTopicNames)


User subweb creation

If your TWiki site requires user registration, the registration mechanism needs to create the user's subweb instead of topic.

If there is no user registration on your TWiki site, there needs to be a mechanism to create a user subweb preferably on their own.

TWiki configuration

Needless to say, user subwebs requires $TWiki::cfg{EnableHierarchicalWebs} to be true in lib/LocalSite.cfg. Otherwise, you cannot use subwebs period.

To enable user subwebs, you need to set $TWiki::cfg{UserSubwebs}{Enabled} to true.

You may want to suppress Public.WebPreferences to be read before the preferences of a user subweb is read. If so, you need to set $TWiki::cfg{UserSubwebs}{IgnoreParentPrefs} to true. You may want to do so because users may not be happy with their user subwebs affected by changes in the Public web's preferences. In most cases, they can override preferences set in Public, still users need to do something to maintain their user subsites behavior.

You can specify the topic name containing user preferences by $TWiki::cfg{UserSubwebs}{UserPrefsTopicName}, which is WebHome by default.

Customize web creation/deletion/rename permission

If all of the following are true, you need to have an appropriate canCreateWeb($cUID, $web) object method in the user mapping manager class.
  • Your TWiki doesn't have user registration
  • You lock down the Public web for tidyness
  • You want to have users create their subwebs on their own

At the same time, you should have an appropriate canRenameWeb($cUID, $oldWeb, $newWeb) object method in the user mapping manager class to have users delete/rename their subwebs on their own.

Related Topics: AdminDocumentationCategory, SubwebAndTopicNames, AllowWebCreateByUserMappingManager, LargeSite

Edit | Attach | Watch | Print version | History: r3 < r2 < r1 | Backlinks | Raw View | Raw edit | More topic actions

Physics WebpagesRHUL WebpagesCampus Connect • Royal Holloway, University of London, Egham, Surrey TW20 0EX; Tel/Fax +44 (0)1784 434455/437520

Topic revision: r3 - 23 Jan 2017 - TWikiContributor

This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 1999-2024 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding RHUL Physics Department TWiki? Send feedback
Note: Please contribute updates to this topic on TWiki.org at TWiki:TWiki.UserSubwebs.