Changeset 6847

Timestamp:

03/22/10 14:51:45 (2 years ago)

Author:

MichaelDaum

Message:

Item8746: cleaned up Main.SitePreferences; hide EDITPREFERENCES if PreferencePlugin is disabled; rewording initial help text; added most common site-level customizations

File:

• trunk/core/data/Main/SitePreferences.txt (modified) (1 diff)

trunk/core/data/Main/SitePreferences.txt

@@ -1 @@
-%META:TOPICINFO{author="ProjectContributor" date="1231502400" format="1.1" version="1.1"}%
----+!! %MAKETEXT{"Local customisations of site-wide preferences"}%
+%META:TOPICINFO{author="micha" date="1269269181" format="1.1" version="1.2"}%
+---+!! %TOPIC%
 
-<div class="foswikiHelp">%ICON{"info"}% %MAKETEXT{"Site-level preferences are located in [_1], however this [_2] prefs topic has override priority and should be used for local customisations. This allows for easier upgrades as you don't need to worry about the shipped preferences clobbering yours. It's easier to keep a handle on if you only copy over the settings you actually change." args="[[%SYSTEMWEB%.DefaultPreferences]], [[%USERSWEB%.%TOPIC%]]"}% </div>
+%ICON{"help"}% 
+%MAKETEXT{
+   "Foswiki's default preferences are located in [_1], however settings defined here have override priority and should be used for local customisations."
+   args="[[%SYSTEMWEB%.DefaultPreferences]]"
+}%
 
-%EDITPREFERENCES{"%SYSTEMWEB%/DefaultPreferencesForm"}%
-%IF{"$ SCRIPTNAME != 'viewauth%SCRIPTSUFFIX%'" then="<span class='foswikiGrayText'>%MAKETEXT{"Quick edit of existing preferences (edit the topic text to set new preferences)"}%</span>" }%
+%TOC%
 
-<!-- Preferences start here -->
 
-   * =FINALPREFERENCES= locks site-level preferences that are *not* allowed to be overridden by [[%WEBPREFSTOPIC%]] or user preferences:
-      * Set FINALPREFERENCES = ATTACHFILESIZELIMIT, PREVIEWBGIMAGE, WIKITOOLNAME, WIKIHOMEURL, ALLOWROOTCHANGE, DENYROOTCHANGE, USERSWEB, SYSTEMWEB, DOCWEB
+<div class="%IF{"not context PreferencesPluginEnabled" then="foswikiHidden"}%">
+%EDITPREFERENCES{"%SYSTEMWEB%.DefaultPreferencesForm"}%
+</div>
+
+---++ Appearance
+
+Customize logo and tooltip texts:
+
+   * Set WIKILOGOIMG = %PUBURL%/%SYSTEMWEB%/ProjectLogos/foswiki-logo.png
+   * Set WIKILOGOALT = Powered by Foswiki, The Free and Open Source Wiki
+   * Set WIKILOGOURL = %SCRIPTURL{"view"}%/%USERSWEB%/%HOMETOPIC%
+
+Give your site a specific name:
+
+   * Set WIKITOOLNAME = Foswiki
+
+
+Customize your [[http://en.wikipedia.org/wiki/Favicon][favicon]]:
+
+   * Set FAVICON = %PUBURLPATH%/%SYSTEMWEB%/ProjectLogos/favicon.ico
+
+
+---++ Finalisation
+=FINALPREFERENCES= locks site-level preferences that are *not* allowed to be overridden by [[%WEBPREFSTOPIC%]] or user preferences:
+
+   * Set FINALPREFERENCES = ATTACHFILESIZELIMIT, PREVIEWBGIMAGE, WIKITOOLNAME, WIKIHOMEURL, ALLOWROOTCHANGE, DENYROOTCHANGE, USERSWEB, SYSTEMWEB, DOCWEB
+
    
 <!-- Keep this as a security measure:
+
    * Set ALLOWTOPICCHANGE = AdminGroup
    * Set ALLOWTOPICRENAME = AdminGroup