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: Comma delimited list of IP addresses; possible to use partial addresses ending in a dot
    • Set WHITELIST =,
  • 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: 46 for IP address
  • Message for users on BLACKLIST and BANLIST: Set BLACKLISTMESSAGE = Your IP address 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
  • 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:

Security Settings

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

Related topics: TWiki.TWikiPreferences, TWikiVariables, TWikiAccessControl

Edit | Attach | Watch | Print version | History: r3 < r2 < r1 | Backlinks | Raw View | More topic actions
Topic revision: r3 - 2011-05-04 - SanderO
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 2008-2017 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback