none
[openafs-wiki.git] / TWiki / WebPreferences.mdwn
1 ## <a name="%WEB% Web Preferences"></a> %WEB% Web Preferences
2
3 The following settings are **_web preferences_** of the [[%WEB%|WEB/WebHome]] web. These preferences overwrite the **_site-level preferences_** in [[TWikiPreferences]], and can be overwritten by **_user preferences_** (your personal topic, eg: [[TWikiGuest]] in the [[Main|Main/WebHome]] web).
4
5 **_Preferences:_**
6
7 - List of topics of the %WIKITOOLNAME%.%WEB% web:
8   - Set WEBTOPICLIST = [[Welcome|Main/WelcomeGuest]] | [[Register|Main/TWikiRegistration]] | [[Changes|Main/WebChanges]] | [[Topics|Main/WebTopicList]] | [[Index|Main/WebIndex]] | [[Search|Main/WebSearch]] | Go <input name="topic" size="16" type="text" />
9
10 - Web specific background color: (Pick a lighter one of the [[StandardColors]])
11   - Set WEBBGCOLOR = #FFE0B0
12
13 - List this web in the [[SiteMap]]:
14   - If yes, Set SITEMAPLIST = `on`, and add the "what" and "use to..." description for the site map. Make sure to list only links that include the name of the web, e.g. %WEB%.Topic links.
15   - Set SITEMAPLIST = on
16   - Set SITEMAPWHAT = [[Welcome|WEB/WelcomeGuest]], [[Registration|WEB/TWikiRegistration]], and other %WEB%.StartingPoints; TWiki history &amp; Wiki style; All the docs...
17   - Set SITEMAPUSETO = ...discover TWiki details, and how to start your own site.
18
19 - Exclude web from a `web="all"` search: (Set to `on` for hidden webs)
20   - Set NOSEARCHALL =
21
22 - Prevent automatic linking of [[WikiWords]] and acronyms (if set to `on`); link WikiWords (if empty); can be overwritten by web preferences:
23   - Set NOAUTOLINK =
24   - **_Note:_** Use the `[[...][...]]` syntax to link topics in case you disabled WikiWord linking. The `<noautolink> ... </noautolink>` syntax can be used to prevents links within a block of text.
25
26 - Default template for new topics and form(s) for this web:
27   - [[WebTopicEditTemplate]]: Site-level default template for new topics
28   - [[TWikiForms]]: How to enable form(s)
29   - Set WEBFORMS =
30
31 - Users or groups who **_are not_** / **_are_** allowed to **_view_** / **_change_** / **_rename_** topics in the %WEB% web: (See [[TWikiAccessControl]])
32   - Set DENYWEBVIEW =
33   - Set ALLOWWEBVIEW =
34   - Set DENYWEBCHANGE =
35   - Set ALLOWWEBCHANGE =
36   - Set DENYWEBRENAME =
37   - Set ALLOWWEBRENAME =
38
39 - Users or groups allowed to change or rename this %TOPIC% topic: (I.e. [[TWikiAdminGroup]])
40   - Set ALLOWTOPICCHANGE =
41   - Set ALLOWTOPICRENAME = [[TWikiAdminGroup]]
42
43 - Web preferences that are **not** allowed to be overridden by user preferences:
44   - Set FINALPREFERENCES = NOSEARCHALL, WIKIWEBMASTER, WEBCOPYRIGHT, WEBTOPICLIST, DENYWEBVIEW, ALLOWWEBVIEW, DENYWEBCHANGE, ALLOWWEBCHANGE, DENYWEBRENAME, ALLOWWEBRENAME
45
46 **_Notes:_**
47
48 - A preference is defined as: <br />`6 spaces * Set NAME = value`<br /> Example:
49   - Set WEBBGCOLOR = #FFFFC0
50 - Preferences are used as [[TWikiVariables]] by enclosing the name in percent signs. Example:
51   - When you write variable `%WEBBGCOLOR%` , it gets expanded to `%WEBBGCOLOR%` .
52 - The sequential order of the preference settings is significant. Define preferences that use other preferences first, i.e. set `WEBCOPYRIGHT` before `WIKIWEBMASTER` since `%WEBCOPYRIGHT%` uses the `%WIKIWEBMASTER%` variable.
53 - You can introduce new preferences variables and use them in your topics and templates. There is no need to change the %WIKITOOLNAME% engine (Perl scripts).
54
55 **_Related Topics:_**
56
57 - [[TWikiPreferences]] has site-level preferences.
58 - [[TWikiUsers]] has a list of user topics. User topics can have optional user preferences.
59 - [[TWikiVariables]] has a list of common `%VARIABLES%`.
60 - [[TWikiAccessControl]] explains how to restrict access by users or groups.