Local customisations of site-wide preferences

Info Site-level preferences are located in TWiki.TWikiPreferences, however this Main.TWikiPreferences 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.

Quick edit of existing preferences (edit the topic text to set new preferences)

Site Specific Site-wide Preferences

  • favicon: Attach a favicon.ico to a web's WebPreferences or add a FAVICON setting to WebPreferences
    • Set FAVICON = /twiki/pub/TWiki/WebPreferences/faviconCT.ico
  • Set the Logo in the upper left corner of the website
    • Set WIKILOGOIMG = chlamhoechst175x50.gif
  • BlackListPlugin
  • General settings
  • One line description, is shown in the TextFormattingRules topic:
    • Set SHORTDESCRIPTION = Utility to keep malicious users away from a public TWiki site
  • Debug plugin: (See output in data/debug.txt)
    • Set DEBUG = 0
  • Log access of blacklist and spam list activities: (0 or 1)
    • Set LOGACCESS = 1
  • Access restriction:
  • WHITELIST, BLACKLIST and BANLIST settings
  • WHITELIST: Comma delimited list of IP addresses; possible to use partial addresses ending in a dot
    • Set WHITELIST = 127.0.0.1, 130.37.210.210
  • BLACKLIST: Comma delimited list of IP addresses; possible to use partial addresses ending in a dot
    • Set BLACKLIST =
  • BANLIST configuration, comma delimited list of:
    1. Points for registration
    2. Points for each save and upload
    3. Points for view and other actions
    4. Points for view raw
    5. Threshold to add to BANLIST
    6. Measured over time (in seconds)
    • Set BANLISTCONFIG = 10, 5, 1, 5, 120, 300
    • Your current score: 1 for IP address 54.87.47.251
  • Message for users on BLACKLIST and BANLIST: Set BLACKLISTMESSAGE = Your IP address 54.87.47.251 is black listed at the TWiki web site due to excessive access or suspicious activities. Please contact site administrator info@chlamydiaeNOSPAM.com if you got on the list by mistake.

Search Settings

  • Default type for search, one of: keyword (for search engine like syntax), regex (for RegularExpression search), or literal (for verbatim search)
    • Set SEARCHDEFAULTTYPE = keyword
  • Default for %<nop>SEARCH{}% variable, one of: keyword, regex, or literal
    • Set SEARCHVARDEFAULTTYPE = literal
  • Stop words, e.g., common words and characters to exclude from a keyword search:
    • Set SEARCHSTOPWORDS = a, all, am, an, and, any, as, at, b, be, by, c, d, e, for, from, g, h, how, i, i'm, i.e., in, is, isn't, it, it's, its, j, k, l, m, n, o, of, on, or, p, q, r, s, t, that, that's, the, this, to, u, v, w, was, wasn't, what, what's, when, where, who, who's, will, with, x, y, z

E-mail Settings

  • 'Mail this topic' mailto: link - can be included in topics, templates or skins

  • 'Mail this topic' link text
    • Set MAILTHISTOPICTEXT = Send a link to this page

Final Preferences

  • FINALPREFERENCES locks site-level preferences that are not allowed to be overridden by WebPreferences or user preferences:
    • Set FINALPREFERENCES = ATTACHFILESIZELIMIT, PREVIEWBGIMAGE, WIKITOOLNAME, WIKIHOMEURL, ALLOWROOTCHANGE, DENYROOTCHANGE, TWIKILAYOUTURL, TWIKISTYLEURL, TWIKICOLORSURL, USERSWEB, SYSTEMWEB, DOCWEB, BLACKLISTPLUGIN

Security Settings

  • Only TWiki administrators are allowed to change this topic:
  • Disable WYSIWYG editor for this preferences topic only:
    • Local TINYMCEPLUGIN_DISABLE = on

Related topics: TWiki.TWikiPreferences, TWikiVariables, TWikiAccessControl

Topic revision: r3 - 2011-05-04 - SanderO
 
This site is powered by the TWiki collaboration platformCopyright © 2008-2014 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback