none
[openafs-wiki.git] / TWiki / TWikiPreferences.mdwn
1 **%WIKITOOLNAME% Site-Level Preferences**
2
3 The following settings are **_site-level preferences_** , e.g. affecting all users in all %WIKITOOLNAME% webs. These preferences can be overwritten by **_web preferences_** (topic [[WebPreferences]] in each %WIKITOOLNAME% web) and **_user preferences_** (your personal topic, i.e. [[TWikiGuest]] in the %WIKITOOLNAME%.Main web)
4
5 **_Preferences:_**
6
7 - List of %WIKITOOLNAME% webs: (the first line of a topic; to add a web see [[TWikiDocumentation]] and [[TWikiWebsTable]])
8   - Set WIKIWEBLIST = [%WIKITOOLNAME%](%WIKIHOMEURL%) . \{ [Main](http://www.dementia.org/twiki//view/Main/WebHome) | [TWiki](http://www.dementia.org/twiki//view/TWiki/WebHome) | [Know](http://www.dementia.org/twiki//view/Know/WebHome) | [Test](http://www.dementia.org/twiki//view/Test/WebHome) \}
9
10 - List of topics of a web: (the second line of a topic, is overwritten by web preferences)
11   - Set WEBTOPICLIST = %WEB% . \{ [Home](WebHome) | [Changes](WebChanges) | [Index](http://www.dementia.org/twiki//search/%WEB%/?scope=topic&regex=on&search=.*) | [Search](WebSearch) | Go <input name="topic" size="16" type="text" />
12  \}
13
14 - Copyright notice:
15   - Set WEBCOPYRIGHT = <font>Copyright © 2000 by the contributing authors. \\nAll material on this collaboration tool is the property of the contributing authors. <br /> \\nIdeas, requests, problems regarding %WIKITOOLNAME%? [Send](mailto:?subject=%WIKITOOLNAME% Feedback) feedback. </font>
16
17 - Exclude web from a `web="all"` search: (Set to `on` for hidden webs; is overwritten by web preferences)
18   - Set NOSEARCHALL =
19
20 - Web specific background color: (is overwritten by web preferences)
21   - Set WEBBGCOLOR = #C0C0C0
22
23 - [[PreviewBackground]] image:
24   - Set PREVIEWBGIMAGE = ![previewbg.gif](http://www.dementia.org/twiki//view/TWiki/PreviewBackground/previewbg.gif)
25
26 - Background color of non existing topic: ( default `cornsilk` or `#FFFFCE` )
27   - Set NEWTOPICBGCOLOR = #FFFFCE
28
29 - Font color of non existing topic: ( default `#0000FF` )
30   - Set NEWTOPICFONTCOLOR = #0000FF
31
32 - Horizontal size of text edit box: (can be overwritten by user preferences)
33   - Set EDITBOXWIDTH = 70
34
35 - Vertical size of text edit box: (can be overwritten by user preferences)
36   - Set EDITBOXHEIGHT = 15
37
38 - Default state of the **_Release edit lock_** ([[UnlockTopic]]) check box in preview. Checkbox is initially checked if `Set RELEASEEDITLOCKCHECKBOX = checked="checked"`, or unchecked if empty. If checked, make sure to click on <u>Edit</u> to do more changes; do **not** go back in your browser to the edit page, or you risk that someone else will edit the topic at the same time: (can be overwritten by user preferences)
39   - Set RELEASEEDITLOCKCHECKBOX =
40
41 - Default state of the **_Minor Changes, Don't Notify_** ([[DontNotify]]) check box in preview. Check box is initially checked if `Set DONTNOTIFYCHECKBOX = checked="checked"`, or unchecked if empty: (can be overwritten by user preferences)
42   - Set DONTNOTIFYCHECKBOX =
43
44 - Default state of the **_link_** check box in the attach file page. Checkbox is initially checked if `Set ATTACHLINKBOX = checked="checked"`, or unchecked if empty (`Set ATTACHLINKBOX =`). If checked, a link is created to the attached file at the end of the topic: (can be overwritten by user preferences)
45   - Set ATTACHLINKBOX =
46
47 - Wiki webmaster email address:
48   - Set WIKIWEBMASTER = <webmaster@your.company>
49
50 - Mail host for outgoing mail. This is used for [[TWikiNotificationOfChanges]] if Perl module <code>**Net::SMTP**</code> is installed. If not, sendmail is used instead (defined by <code>**$mailProgram**</code> in <code>**TWiki.cfg**</code>). Examples: `mail.your.company` or `localhost`
51   - Set SMTPMAILHOST = mail
52
53 - http-equiv meta tags for **_view_**, **_rdiff_**, **_attach_**, **_search\*_** scripts:
54
55           * Set HTTP_EQUIV_ON_VIEW =
56
57 - http-equiv meta tags for **_edit_** script. Example to expire immediately: <br />`Set HTTP_EQUIV_ON_EDIT = <meta http-equiv="Expires" content="%GMTIME{"$day $month, $year - $hour:$min:$sec"}% GMT">`
58
59           * Set HTTP_EQUIV_ON_EDIT =
60
61 - http-equiv meta tags for **_preview_** script:
62
63           * Set HTTP_EQUIV_ON_PREVIEW =
64
65 - Users or groups allowed to change this %TOPIC% topic: (I.e. [[TWikiAdminGroup]])
66   - Set ALLOWTOPICCHANGE =
67
68 - Site-level preferences that are **not** allowed to be overridden by [[WebPreferences]] and user preferences:
69   - Set FINALPREFERENCES = PREVIEWBGIMAGE, WIKIWEBMASTER, MAILHOST
70
71 **_Plugin Preferences:_**
72
73 - Installed [[TWikiPlugins]]: To enable/disable plugins, move them between ACTIVEPLUGINS and INACTIVEPLUGINS. Specify a comma separated list of plugin topics; the name of the web **_must_** be specified (i.e. <code>**TWiki.DefaultPlugin, TWiki.AnOtherPlugin**</code>)
74   - Set ACTIVEPLUGINS = [[DefaultPlugin]]
75   - Set INACTIVEPLUGINS = [[EmptyPlugin]]
76
77 - Preferences of [[DefaultPlugin]]:
78   - Allow depreciated `%INCLUDE:"topic"%` syntax: (`0` or `1`)
79     - Set DEFAULTPLUGIN\_OLDINCLUDE = 1
80
81 **_Notes:_**
82
83 - A preference is defined as: <br />`6 spaces * Set NAME = value`<br /> Example:
84   - Set WEBBGCOLOR = #FFFFC0
85 - Preferences are used as [[TWikiVariables]] by enclosing the name in percent signs. Example:
86   - When you write variable `%WEBBGCOLOR%` , it gets expanded to `%WEBBGCOLOR%` .
87 - 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.
88 - You can introduce new variables and use them in your topics and templates. There is no need to change the %WIKITOOLNAME% engine (Perl scripts).
89
90 **_Related Topics:_**
91
92 - [[WebPreferences]] has preferences of the %WIKITOOLNAME%.%WEB% web.
93 - [[TWikiUsers]] has a list of user topics. User topics can have optional user preferences.
94 - [[TWikiVariables]] has a list of common `%VARIABLES%` .
95 - [[TWikiAccessControl]] explains how to restrict access by users or groups.