Foswiki Release 2.1.0

Foswiki - The Free and Open Source Wiki

Foswiki is an enterprise collaboration and information sharing tool targeted for professional use in many types of organizations: from small businesses to multi-nationals, from one-product open source groups, to worldwide research networks.

Foswiki is a wiki: fundamentally, a website with editable web pages. It looks like a normal web site but it encourages contributions, edits, updates, questions, and answers from its users. It's a powerful way of enabling a community to communicate asynchronously using intranet and public Internet websites. Foswiki is simple to learn and use. It aims to provide a transparent way for you to publish and exchange your ideas with others over the web and eliminates the one-webmaster syndrome of outdated intranet content.

Foswiki is a structured wiki with tools that enable users without programming skills to build powerful yet simple applications to process information and support workflows. Developers can extend the functionality of Foswiki with plugins.

Foswiki is backwards compatible with content generated on all previous Foswiki versions, and even content and many plugins from TWiki installations (Foswiki ships with a TWikiCompatibilityPlugin, thus enabling most extensions made for TWiki to work in Foswiki. TWiki® is a registered trademark of Peter Thoeny.)

Foswiki is released under the GNU General Public License.

Foswiki Releases

  • Foswiki 1.0.0, the first Foswiki was released on 09 Jan 2009.
  • Foswiki 1.0.1, 1.0.2 and 1.0.3 were released internally in the development community, but were never publicly released.
  • Foswiki 1.0.4 was built 19 Mar 2009. It is a patch release with more than 120 bug fixes relative to 1.0.0 and only very few minor enhancements.
  • Foswiki 1.0.5 was built 25 Apr 2009. It is a patch release with more than 150 bug fixes relative to 1.0.0 and a few enhancements. This patch release further enhances the robustness and the security of the Foswiki software.
  • Foswiki 1.0.6 was built 21 Jun 2009. It is a patch release with more than 200 bug fixes relative to 1.0.0 and some enhancements. This version introduces a major enhancement in security against Cross-Site Request Forgery. Further more a central translation framework got introduced which ease the translation process and enables all users to contribute to translations.
  • Foswiki 1.0.7 was built 20 Sep 2009. It is a patch release with more than 240 bug fixes relative to 1.0.0 and some enhancements. This release fixes some serious issues introduced by the CSRF fix and the redirect cache fix in 1.0.6. Major enhancement that also fixes many annoying editor bugs is the upgrade of the Tiny MCE editor to version 3.2.2.
  • Foswiki 1.0.8 was built 29 Nov 2009. It is a patch release with more than 280 bug fixes relative to 1.0.0 and some enhancements. This release fixes a short list of quite annoying old bugs incl a bug that prevented efficient use of MailerContrib for producing newsletters. The Wysiwyg editor has been upgraded with the latest Tiny MCE editor release 3.2.7.
  • Foswiki 1.0.9 was built 17 Jan 2010. It is a patch release with more than 320 bug fixes relative to 1.0.0 and several enhancements. This release fixes many bugs in the Wysiwyg editor, bugs related to more advanced wiki applications and bugs in the Plugin API. It contains several bug fixes and enhancements related to security and spam fighting.
  • Foswiki 1.0.10 was built 08 Sep 2010 as a patch release with more than 410 bug fixes relative to 1.0.0. It is assumed to be the last 1.0.X release.
  • Foswiki 1.1.0 was built 04 Oct 2010. It is a release with more than 270 bug fixes relative to 1.0.10 and more than 680 bug fixes relative to 1.0.0. And the release adds more than 100 enhancements. Foswiki 1.1.0 introduces jQuery Javascript user interface framework, improved topic history display, new QUERY and FORMAT macros, better user interfaces for groups, much improved WYSIWYG editor, facelift of the default skin, much improved configure tool, and many more enhancements.
  • Foswiki 1.1.1 was built 25 Oct 2010. It is a release that fixes some important bugs that were introduced in 1.1.0. It is highly recommended that all running 1.1.0 upgrade to 1.1.1.
  • Foswiki 1.1.2 was built 09 Nov 2010. It is a release that fixes some very important bugs incl. a security related bug. Installations running 1.1.0 and 1.1.1 should be upgraded to 1.1.2
  • Foswiki 1.1.3 was built 16 Apr 2011. It is a release that fixes more than 150 bugs. jQuery has been updated to 1.4.3. The default PatternSkin has some usability improvements.
  • Foswiki 1.1.4 was built 20 Dec 2011. It is a release that fixes some very important including some security related issues. It contains 143 fixes and 27 enhancements. jQuery has been updated to 1.7.1.
  • Foswiki 1.1.5 was built 10 Apr 2012. It is a release that fixes some very important issues including some security related issues. It contains 100 fixes and 20 enhancements.
  • Foswiki 1.1.6 was built 02 Dec 2012. It is a release that fixes some important issues including some minor security related issues. It contains 94 fixes and 27 enhancements.
  • Foswiki 1.1.7 was built 01 Feb 2013. It is a release that fixes CVE-2012-6329 and CVE-2012-6330. It contains 20 fixes and 4 enhancements.
  • Foswiki 1.1.8 was built 28 Feb 2013. It is a release that fixes CVE-2013-1666. It contains 4 fixes.
  • Foswiki 1.1.9 was built 18 Nov 2013. It is a release that contains 44 fixes and 4 enhancements..
  • Foswiki 1.1.10 was built 23 Nov 2015. It is a release that contains 8 fixes and 8 enhancements.
  • Foswiki 2.0.0 was built on 04 Jul 2015. It is a release that contains 312 fixes and 157 enhancements, and closes 59 Feature Requests.
  • Foswiki 2.0.1 was built on 03 Aug 2015. It is a release that contains 28 fixes and 3 enhancements.
  • Foswiki 2.0.2 was built on 01 Oct 2015. It is a release that contains 65 fixes and 5 enhancements.
  • Foswiki 2.0.3 was built on 15 Nov 2015. It is a release that contains 17 fixes and 1 enhancement.
  • Foswiki 2.1.0 was built on 02 Feb 2016. It is a release that contains 37 fixes and 14 enhancements. It closes 7 Feature Requests.

Pre-installed Extensions

Foswiki 2.1 is shipped with the following:
  • Plugins: AutoViewTemplatePlugin, CommentPlugin, ConfigurePlugin, EditRowPlugin, EmptyPlugin, HistoryPlugin, HomePagePlugin, InterwikiPlugin, JQueryPlugin, NatEditPlugin, PreferencesPlugin, PubLinkFixupPlugin, RenderListPlugin, SlideShowPlugin, SmiliesPlugin, SpreadSheetPlugin, SubscribePlugin, TablePlugin, TinyMCEPlugin, TwistyPlugin, UpdatesPlugin, WysiwygPlugin
  • Contribs: CompareRevisionsAddOn, FamFamFamContrib, FastCGIEngineContrib, JEditableContrib, JSCalendarContrib, JsonRpcContrib, MailerContrib, ModPerlEngineContrib, PlainFileStoreContrib, RCSStoreContrib, TipsContrib, TopicUserMappingContrib
  • Skins: PatternSkin
  • Compatibility support - TWikiCompatibilityPlugin

Known issues

For up-to-date information, see Known issues of Foswiki 2.1

Use of non-default {Store}{Encoding}

WARNING About {Store}{Encoding}: If you intend to use high-bit characters in attachment filenames (such as umlauts and accents), then links to these attachments on Foswiki pages will not work on a non-utf-8 Store without modification. This is because Foswiki works internally using Unicode, but the store saves files to disk using your chosen {Store}{Encoding}. Running the Store with other than utf-8 encoding is considered a transitional step and not recommended for long-term operation. The strongly recommended solution is to convert your store to UTF8 at the earliest opportunity.

A partial workaround is implemented in the PubLinkFixupPlugin This Plugin will attempt to rewrite broken links. This generally gets linked images and other attachments working. However the TinyMCEPlugin is still unable to render image links while editing a topic.

See Item13696 for up-to-date details.

Important changes in Foswiki 2.1


The %HTTP% and %HTTPS% macros are deprecated and will be removed in a future release. These macros now restrict the available information to the Accept-language and User-Agent headers. The list of available headers is now configurable.

API Change

The Foswiki API version is incremented to version 2.4 in Foswiki 2.1.0. Foswiki 2.1 permits template names using Unicode characters.

New Perl CPAN dependencies!

Foswiki now requires CPAN:Email::MIME. Foswiki will be unable to send email without this module. SystemRequirements has more details on CPAN dependencies and package names for most *nix distributions.

Enhanced Registration form

The registration form now accepts the parameter templatename to override the default NewUserTemplate. In addition the registration topics have been restructured to permit multiple custom registration pages. Customization of the registration form is greatly simplified.

Easier to restrict access to the System web.

Some sites prefer to block access to the System web documentation for guest users. Duplicated content can result in lowered search engine rank, so it is advantageous to restrict access to the System web. Foswiki now includes ALLOWTOPICVIEW settings for critical system topics that are required for guest access.

Changes in permitted characters in topic and attachment names.

Foswiki has split the topic and attachment name filters. The topic name filter has become more restrictive. Attachment names now permit embedded spaces, and attachments with spaces will no longer be renamed to underscores. If you would prefer to use the old behavior, enable $Foswiki::cfg{AttachmentReplaceSpaces}.

Action Required: The colon (:) has been removed from the list of legal characters permitted in topic names. The colon was in conflict with the InterWiki links. If your existing topic use the colon in topic names, you should remove the colon from the configuration setting $Foswiki::cfg{NameFilter}.

Improvements in International Character Set support

Foswiki 2.1 has further improved support for utf-8 based character sets. Topics and data forms can use utf-8 characters. They will be properly rendered and preserved during edit. The Foswiki core has been fully converted to utf-8 and unicode. All encoding / decoding is done "at the edge", when reading from / writing to the Foswiki store.

  • Foswiki 2.1 International support
    • Emails sent by Foswiki now fully support International Character Sets.
    • Foswiki now uses NFC Normalization of Unicode characters. This greatly improves compatibility with Operating Systems like OSX which use NFD form characters by default.
    • Template names are no longer restricted to ASCII characters.

  • Foswiki 2.0 International support
    • New sites will use utf-8 by default. Internationalizaiton should just work.
    • Sites migrating data from a previous installation have two choices:
      • Set {Store}{Encoding} to match the previous ={Site}{CharSet}. (Default was iso-8859-1)
      • Migrate the data to utf-8 by using the tools/ script. This is the recommended solution.
    • Support for Locales is still known to have issues. {UseLocales} should not be enabled in the configuration.

ALERT! ACTION REQUIRED If you are upgrading an existing system, you should review the existing data and determine if migration to utf-8 should be performed. See the UpgradeGuide for more details. Note that the topic and attachment name filters no longer filter international characters, so migration to utf-8 is strongly recommended.

Due to the extensive internal changes, extensions may require changes for compatibility with this release.

Translation Status

As of this release,
  • Italian and Ukrainian are 100% complete.
  • Traditional Chinese, French and German are >99% complete.
  • Czech, Danish are >95% complete.

For more details on translation status, see TranslationTeam and Foswiki's Weblate translation server. Foswiki thanks the Translators for their efforts. If you are interesting in helping with the translation, please contact

Foswiki Release 2.1 Details

New Features

AddConcatOptionToAttrs Add +"more" and key+"more" options to Foswiki::Attrs
CompleteMIMESupportInEmail Wrap all outgoing mails into uniform and safe MIME envelope.
CustomNewUserTemplates Enhance register script to specify a templatetopic param instead of hard-coded 'NewUserTemplate'
DeprecateHTTPandHTTPS Deprecate and restrict System.VarHTTP and System.VarHTTPS macros due to security concerns
MakeItEasierToBlockSystemWebGuestAccess Simplify hiding the System web documentation.
MakeZonesLessIntrusive Make zones less intrusive, especially for non-HTML output
SplitTopicAttachmentNameFilters Separate the topic and attachment name filters, allow spaces in attachment names, remove colon from Topic names.


Item12067 Removing members via WikiGroups not possible when login name different from WikiName.
Item12569 Sorting in tableplugin is wrong in German.
Item13405 Unicode Normalisation.
Item13699 Mail sending fails when non-latin text in utf8 is being sent.
Item13857 Mac OS X RCS "not found" by configure.
Item13863 FileAttachment: generated filenames are not correct foswiki 2.0.3 mod_cgi, utf-8 store when uploaded from OS X.
Item13865 Configure file permissions checker detects ,pfv directories as possible webs.
Item13880 TML rendered in head and script zones causes malformed html in WebCreateNewTopic.
Item13917 NameFilter not working on 2.0 / 2.1 if configure reset to default is used.
Item13924 Old style UserRegistration pages not working on 2.1 beta 1.

The following fixes will also be incorporated into Foswiki 2.0.4

Item10916 Pencils disappear after row move when both js and non-js controls are present.
Item11609 No information how to un-set a topic parent.
Item13677 regression: extension tabs in configure aren't sorted alphabetically anymore.
Item13860 UploadFilter isn't blocking HTML attachments.
Item13869 FoswikiServerInformation warns about undefined variables.
Item13870 RCSStoreContrib configure check error by syntax shell command error in
Item13875 Configure fails to perserve permissions when backing up config.
Item13877 Certificate wizards not functional, always generates CSR, dependencies not documented.
Item13881 Table header problem in unicode named web/topic.
Item13885 PatternSkin should be backwards compatible to Foswiki 1.1.
Item13886 Default id="foswikiTOC" creates illegal duplicate CSS IDs when multiple TOC macros are present.
Item13889 Processing of dynamically generated META in a new topic template is displayed as plain text until saved.
Item13890 bulk_copy ignores --latest option.
Item13891 does not copy user information for attachment histories.
Item13893 Performance fixes for Foswiki 2.0.4.
Item13894 RcsStore double-encodes utf8 comments into the attachment revision log.
Item13896 TWISTY incorrectly used in Sandbox.WebHome, generates broken HTML.
Item13898 JQueryAjaxHelper jumpbox code does not work with short URLs.
Item13899 save: ignores new topic text if it is empty.
Item13900 Logout redirects to wrong path when ForceDefaultHostUrl is enabled.
Item13903 Redirect for authentication breaks utf8 topic names.
Item13906 EditRowPlugin create table row without spaces.
Item13912 perldoc does not process correctly because of missing POD marker.
Item13913 CLI scripts broken on windows. setlib.cfg issues "require CGI" which sets binmode on STDIN and breaks prompts.
Item13925 Leading spaces in DefaultUrlHost causes malformed URL links.
Item13926 ModPerlEngineContrib is not backwards compatible with Foswiki 1.1.x.
Item13927 Configure rcs checker crashes if configured command is not found.


Item12560 NameFilter should reject colon, conflicts with Interwiki links. Restructure filters to improve flexibility.
Item13436 Adding the class parameter to the TablePlugin.
Item13444 Foswiki::Net::getExternalResource does a poor job of parsing URLs.
Item13554 Foswiki doesn't work with accented Template names.
Item13594 Implement feature AddConcatOptionToAttrs.
Item13848 Deprecate, and restrict HTTP and HTTPS macros.
Item13849 Implement MakeZonesLessIntrusive.
Item13854 Implemement MakeItEasierToBlockSystemWebGuestAccess.
Item13864 Implement CustomNewUserTemplates - Registration can override the template for the user topic.
Item13867 bin/upload failed from the command line.
Item13874 Don't encode URLs in links inserted by Upload.

The following enhancements will also be included in Foswiki 2.0.4

Item13553 Add form-definition-table template.
Item13866 Add a file permission fixer script to tools.
Item13914 rewriteshebang should use setlib, don't make user enter -I ../lib.

Related Topic: ReleaseHistory
Topic revision: r1 - 03 Feb 2016, UnknownUser

  • User Reference
  • BeginnersStartHere
  • EditingShorthand
  • Macros
  • MacrosQuickReference
  • FormattedSearch
  • QuerySearch
  • DocumentGraphics
  • SkinBrowser
  • InstalledPlugins

  • Admin Maintenance
  • Reference Manual
  • AdminToolsCategory
  • InterWikis
  • ManagingWebs
  • SiteTools
  • DefaultPreferences
  • WebPreferences

This site is powered by FoswikiCopyright © by the contributing authors. All material on this site is the property of the contributing authors.
Ideas, requests, problems regarding DAMASK? Send feedback