Foswiki archived release

alert This release is superseded by Foswiki 2.1.7. Visit the download page.

See Release Dates for the complete list of available releases.

Highlights of this release

For users:

  • More than 160 bug fixes and improvements relative to 1.1.3
  • Foswiki user defined macros now support parameters - See Macro Parameters
  • Updated JQuery 1.7.1 allows new possibilities for smart user interaction for the application developer
  • Enhanced SpreadSheetPlugin with new functions
  • Enhancements to how you can format the emails sent by Foswiki

For administrators:

  • Support for sending Email (SMTP) over SSL adds support for gmail and other providers.
  • New email test function in configure makes it easier to verify configuration before registering users.
  • Support for S/MIME signed email
  • .htpasswd Password migration feature allows passwords to migrate to a stronger hash without invalidating existing passwords.
  • Optional obfuscating logger strips IP addresses for privacy (required in some regulatory domains)
Foswiki 1.1.4 - built 20 Dec 2011.


GPG Signatures and MD5 checksums are provided for verifying the integrity of the files for the primary download packages.

File GPG MD5 Description
download Foswiki-1.1.4.tgz GPG MD5 tar gz version of Foswiki
download GPG MD5 zip version of Foswiki

Upgrade packages

If you already have an earlier version of Foswiki 1.1.X installed, you can extract an upgrade package on top of the installation. The major.minor part of the release should not be changed by an upgrade package.

ALERT! Upgrade packages must not be used to upgrade older releases.

File GPG MD5 Description
download Foswiki-upgrade-1.1.4.tgz GPG MD5 upgrade tar gz version of Foswiki
download GPG MD5 upgrade zip version of Foswiki

<blockquote class="foswikiAlert"> *This release has not been built yet!*  This is a draft of the release announcement.  If you want an early start to testing, see Development.GitBasedInstall.</blockquote>

%INCLUDE{"Download.FoswikiReleaseViewTemplate" section="download"
  release="%FORMFIELD{"Release" topic="%BASETOPIC%"}%"

%INCLUDE{"Download.FoswikiReleaseViewTemplate" section="download"
  release="%FORMFIELD{"Release" topic="%BASETOPIC%"}%"

%INCLUDE{"Download.FoswikiReleaseViewTemplate" section="download"
  release="%FORMFIELD{"Release" topic="%BASETOPIC%"}%"
  url="{"Release" topic="%BASETOPIC%"}%"

%INCLUDE{"Download.FoswikiReleaseViewTemplate" section="download"
  release="%FORMFIELD{"Release" topic="%BASETOPIC%"}%"
  url="{"Release" topic="%BASETOPIC%"}%"

%INCLUDE{"Download.FoswikiReleaseViewTemplate" section="download"
  release="%FORMFIELD{"Release" topic="%BASETOPIC%"}%"
  url="{"ReleaseTag" topic="%BASETOPIC%"}%"

%INCLUDE{"Download.FoswikiReleaseViewTemplate" section="download"
  release="%FORMFIELD{"Release" topic="%BASETOPIC%"}%"
  url="{"ReleaseTag" topic="%BASETOPIC%"}%"

| *File* | *GPG* | *MD5* | *Description* |
| [[%url%/Foswiki-%upgraded%%release%.tgz][%ICON{download}% Foswiki-%upgraded%%release%.tgz]] | [[%url%/Foswiki-%upgraded%%release%.tgz.asc][GPG]] | [[%url%/Foswiki-%release%.md5][MD5]] | %upgrade% tar gz version of Foswiki |
| [[%url%/][%ICON{download}%]] | [[%url%/][GPG]] | [[%url%/Foswiki-%release%.md5][MD5]] | %upgrade% zip version of Foswiki |%IF{"'%upgraded%'='' and '%FORMFIELD{"VMImage" topic="%BASETOPIC%"}%'='1'" then="
| [[%url%/Foswiki-%release%-vmware.%FORMFIELD{"VMFormat" topic="%BASETOPIC%"}%][%ICON{download}% Foswiki-%release%-vmware.%FORMFIELD{"VMFormat" topic="%BASETOPIC%"}%]] | [[%url%/Foswiki-%release%-vmware.%FORMFIELD{"VMFormat" topic="%BASETOPIC%"}%.asc][GPG]] | [[%url%/Foswiki-%release%-vmware.md5][MD5]] | [[Support.VirtualMachineImages][VM Image (instructions)]] |"}%%ENDSECTION{"download"}%

---++ Upgrade packages

   else="These packages can be used to upgrade __Foswiki Release %FORMFIELD{"UpgradeFrom" topic="%BASETOPIC%"}% or newer__. See [[#Upgrade_Instructions]] for further information"
   then="If you already have an earlier version of Foswiki %FORMFIELD{"ReleaseMajor" topic="%BASETOPIC%"}%.%FORMFIELD{"ReleaseMinor" topic="%BASETOPIC%"}%.X installed, you can extract an upgrade package on top of the installation. The =major.minor= part of the release should not be changed by an upgrade package."}%

%X% Upgrade packages must not be used to upgrade older releases.


Getting help & providing feedback

Don't forget to use the upgrade or installation guides. If you need help, there are several options:

We want to hear from you! Especially if you have noticed a bug, have some ideas we could use, or just want to contribute:

  • You can upgrade 1.1.0, 1.1.1, 1.1.2, 1.1.3 and any 1.1.4 Beta or RC to to 1.1.4 using the upgrade package
  • Jump to: Installation and Upgrade details
  • GPG Signatures and MD5 checksums are provided for verifying the integrity of the files for the primary download packages.

Important changes since Foswiki 1.1.3

Foswiki 1.1.3 MetaData issues.

Foswiki 1.1.3 may have changed some MetaData to contain fully-qualified (with web name prefix) values. This may adversely impact QuerySearch.

In Foswiki 1.1.4 this problem has been fixed by Item10874, however, users upgrading from 1.1.3 may wish to review the following information to determine if they need to take action on their existing SEARCHes or DataForm topics.
IDEA! Please note, you may be unaffected by Item10874 if:

  • You have never used Foswiki 1.1.3
  • You are not QuerySearching MetaData for exact topic-only (without web prefix) values, or
  • Your users are not adding or changing DataForms on their topics via the edit screen's "add/change form" button, or
  • Your installation is using Foswiki:Extensions.NatEditPlugin

Email enhancements

Significant enhancements were made to the Foswiki email implementation. These changes increase our compatibility with email services like Google's gmail, add enterprise features like S/MIME signed mail, and add a test facility to help the administrator better diagnose email problems before testing registration.

  • Implement SSL support, which adds direct support for gmail.
  • Implement S/MIME support for signed email using either sendmail or the Net::SMTP methods.
  • Add configure parameter to select GMT or Servertime in generated email messages
  • Implement an Email test function in configure.

Email address linking improvements.

Several tasks made major changes to rendering of email addresses in Foswiki topics:
  • Spaces may now be included in the query string of mailto link, such as a ?subject= parameter
  • Auto-linking of email addresses in most common formats now work more reliably
  • Fixed bug where an Email address followed by a dot generates email link with dot included

Password Authentication enhancements

Item9164 and Item10962

The PasswordManager Foswiki::Users::HtpasswdUser has been enhanced with an AutoDetect mode to detect the format of the stored password and to validate old passwords using the stored form instead of the encoding configured in {Htpasswd}{Encoding}. Enable this new feature by setting the configuration parameter {Htpasswd}{AutoDetect} to enabled.
  • With this change, it is now possible to migrate to an alternate password Encoding without invalidating existing user passwords.
  • The performance of has been improved by up to 30% with large .htpasswd files
  • A new encryption mode - apache-md5 has been added. This official Apache variation on MD5 encoding is compatible with the passwords generated by the htpasswd -m command.
  • The encoding previously labeled md5 has been renamed to htdigest-md5 and is compatible with the encoding generated by the Apache htdigest command. The config setting will be modified by a config checker the first time you run configure after upgrade. It is recommended to save your configuration.
    • Note that it is also now possible to modify the {AuthRealm} setting without invalidating existing passwords.
  • Cross-platform compatibility issues between Linux, Apple OSX and MS Windows have been resolved and .htpasswd files should be portable regardless of the selected encoding.
  • The Crypt::PasswdMD5 CPAN module is required for the apache-md5 encoding, as well as for better cross-platform compatibility.

ALERT! Note: It is strongly recommended that sites using the old default "crypt" encoding migrate to a stronger method. The crypt method truncates passwords at 8 characters and silently discards the rest. For the highest security, choose htdigest-md5 encoding with Apache htdigest authentication. If using Template authentication, if possible use a SSL client connection - HTTPS.

New version of JQuery - 1.7.1

Foswiki has been updated to include JQuery 1.7.1, and this is now the default version of JQuery. After installing Foswiki 1.1.4, be sure to visit bin/configure and verify that the JQuery Plugin is configured to use this version. The autocomplete and TextboxList JQuery plugins have some backwards compatibility issues.


  • Fixed link text containing email address
  • TablePlugin no longer generates empty tfoot when there are footer rows
  • The crypt-md5 encoding in HtPasswd made cross-platform compatible
  • Move/rename now finds backlinks followed by underscore
  • Username field in Login is now correctly aligned in Internet Explorer
  • Form with all hidden fields now hidden in view
  • Up and Down Arrow-Keys in wiki edit now working with Firefox 4
  • Complex searches could fail with deep recursion
  • ApacheLogin threw 403 instead of 401 to unauthenticated users with rest, viewfile, rdiff and compare scripts
  • bin/changes output could be corrupted
  • SEARCHDEFAULTTTYPE no longer referenced
  • Email address autolinking fixed
  • Could not copy attachments under a different user
  • Could not save attachments with a "0" comment
  • Rename now handling anchored links
  • TOPICLIST bugfix handling web= parameter
  • Form fields of type date could not be edited with pop-up calendar
  • Documented remaining core tools scripts in System/CommandAndCGIScripts
  • Configuration checker for DataDir could be confused by some installation locations.
  • API call Foswiki::Func::renderText cannot return a result which is a "0" zero
  • CompareRevisionsAddOn caused illegal {SwitchBoard} value in Foswiki configuration (affects ApacheLogin users)
  • Some radio buttons on WebSearch behaved erratically when clicked on the label
  • Deprecated (before/after)AttachmentSaveHanders were actually deleted.
  • Can't extract metadata stored in html5 data- attributes
  • REST validation error code doesn't agree with response body
  • Using "Add/change form" button saved fully-qualified Web.Topic name even if WEBFORMS = Topic
  • Package installer reported succeeded even when it failed.
  • FORMAT macro's $web token strips '/' char from web names
  • Eliminated "Use of uninitialized" log warnings in Foswiki::Query, Foswiki::Time
  • Use regular search output on Sandbox home
  • TablePlugin: Setting none as databg or headerbg takes the preference color setting instead of no color
  • Enable query search to list fields that don't have the attribute hidden set
  • Wiki [[ syntax did not fully support mailto
  • Adding incorrect user to a group kills WikiGroups
  • Loss of metadata when an admin user updates an attachment's properties
  • LocalSite.cfg supports specifications relative to other definitions, but configure broke them.
  • TwistyPlugin tried to fetch defunct/missing jquery.twisty.css
  • Edit help is incorrect when WYSIWYG excluded due to topic content.
  • Configure {Htpasswd}{Encoding} defaults to crypt which throws a warning, without any guidance for what alternative to choose or why
  • Calling Foswiki::Func::saveAttachment() can destroy the topic content
  • Perl 5.14 qw deprecation broke configure.
  • RenderListPlugin examples failed
  • TablePlugin: Could not change TABLEATTRIBUTES when used in persistent perl installations
  • In forms select element created with select+values does not handle empty select string
  • Missing undocumented web parameter in FORMFIELD
  • Could not confirm validation request of CSRF protection if validation method is 'embedded' - no buttons displayed
  • FORMFIELD can't default to zero
  • FORMFIELD does not read values from txt file causing manually edited changes to not be displayed until next edit and save
  • Foswiki::Time shouldn't be trying to convert undefined $epochSeconds
  • Made "logged in as admin" alert less ugly
  • Date field was not formatted according to JSCALENDARCONTRIB_FORMAT setting
  • TOC did not remove manual links properly
  • Email address followed by a dot generated email link with dot included
  • Trailing spaces breaks LISTUNIQUE in SpreadSheetPlugin
  • Table should sort if sort is off but initsort has a column number
  • CSS class foswikiMakeVisible for elements other than span and div does not work
  • SlideShowPlugin must urlencode both the name and value of query parameters
  • Saving an attachment stores "save attachment" string in version history, instead of the attachment comment
  • WebNotify gives different results if trailing spaces present on line
  • PlainFile logger rotates logs on localtime, not gmtime.
  • PreferenceSettings examples don't work when included in Macros topic.
  • REGISTRATIONGROUPS does not work. Users are not added to the groups, and the documentation is confusing.
  • Core table rendering issues found with tfoot, and table fails to end previous list. (Not seen if TablePlugin is enabled.)
  • Restructure statistics documentation, resolve an issue were statistics not generated for subwebs.
  • can't attach filenames with unicode chars in it
  • Images referenced in square bracket link text are not rendered
  • typo in lib/Foswiki/ causing all (cached) pages to be delivered with a Last-Modified: header set to 01 Jan 1970
  • Add to warnings reported by {AuthScripts} checker. Warn if statistics unprotected. Warn to confirm apache config if not using TemplateLogin
  • Extensions list in configure jumped around
  • Improved difference presentation in change notification emails (partial fix)
  • Add documentation for template tokens
  • When installing an extension, the logs should be saved
  • Don't show the EmptyPlugin in configure's list of plugins to enable


  • Preference variables now support parameters
  • Implement re-usable way to set default text of input fields
  • Update to JQuery 1.7.1 and make it the default version
  • Offer no-column stylesheet for fatwilly theme
  • SpreadSheetPlugin added new functions: SPLIT, HEXENCODE, HEXDECODE, BITXOR, XOR, LISTNONEMPTY, WHILE, isodate formats and DOY - Day of Year dates
  • Performance of language translations can be improved by using compressed .mo files instead of .po files
  • Support for SMTP over SSL
  • Support for S/MIME
  • New setting for servertime in email headers
  • Allow IP addresses to be supressed from logs
  • Add history support to jquery.tabpane
  • JQuery enhancements: Updating jquery.metadata to support html5 attributes, move to jquery.ui.autocomplete, update and add a better default skin for the flv player, make theming of jquery-ui pluggable, and new foswiki jquery-ui theme. Also deprecate JQuery shake module - It is included in the jquery-ui effect stack.
  • Configure now shows expanded values for parameters
  • Configure now has a function to test the email configuration
  • New option to search subwebs via the WebSearch UI


New Installations or Upgrade from Foswiki 1.0

Please refer to the INSTALL.html file which can be found the downloaded tgz/zip. It is a copy of the System.InstallationGuide

Upgrade from Foswiki 1.1.x

  • ALERT! Do not upgrade in-place from Foswiki 1.0 to 1.1. Install a new copy of Foswiki for a 1.0 upgrade.
  • ALERT! Do not copy a 1.0.x lib/LocalSite.cfg file into 1.1. Reconfigure using bin/configure

Before you start

  • Make a backup of your Foswiki installation
  • Review your Apache configuration for any ExpiresDefault setting for client side caching. If client caching is in use, decrease the expires time to a short duration and delay the upgrade until existing browser client cache has expired.
  • Review the ReleaseNotes01x01 and JQueryMigrationGuide carefully for any issues that might apply to your installation.
  • Review the list of files in the upgrade tgz or zip file. If your installation has modified files shipped in the upgrade package, you need to decide if you want to use the new versions.

Doing the upgrade

  • Copy the contents of the upgrade tgz or zip file onto your installation
    • To expand the tar file in-place over an existing installation, use tar --strip-components=1 -xvzpf Foswiki-upgrade-1.1.4.tgz The strip-components operand will remove the top-level directory from the extracted files.
  • Update file ownership and permissions- See SettingFileAccessRightsLinuxUnix
  • Restart Apache
  • Visit bin/configure
    • Address any warnings or errors reported by the new configuration checkers
    • Go to the Extensions, JQuery tab.
      • Select the 1.7.1 version of jquery,
      • ensure that a JQuery theme has been selected
      • Disable any JQuery plugins flagged as obsolete
  • If you use the Foswiki Cache, be sure to refresh the cache. See System.PageCaching#Refreshing_the_cache

Language Translation Status

Czech, Danish, Dutch, French, German, Norwegian, Portuguese (Brazil), Swedish
Italian, Polish
Chinese (Taiwan), Russian, Spanish

For other translations see Foswiki's Pootle translation server.


Please refer to the INSTALL.html which can be found the downloaded tgz/zip. It can be also found on in the System.InstallationGuide

Upgrade Instructions

In-place upgrade from any release prior to Foswiki 1.1.0 is not recommended. Older Foswiki installations should install Foswiki as a new release, configure, and then migrate data to the new installation.
  • See System.UpgradeGuide for details on upgrading from older versions of Foswiki
  • See System.SystemRequirements for the latest System Requirements.
  • Be sure to take a backup!
  • The upgrade packages excludes files "commonly" modified, for example, WebHome, WebPreferences, AdminGroup, etc. If your installation has modified other topics, or template files, those updates will be lost!
  • If you use tar, then you can extract the upgrade package on top of your installation by using: (Be sure to run this as your web server user to avoid changing file ownership.)
cd /var/www/foswiki
tar --strip-components=1 -zxf /path/to/Foswiki-upgrade-2.x.x.tgz
cd tools
./configure --save
  • Similarly, if you are using the zip upgrade package, then
cd /var/www/foswiki
unzip -o /path/to/
cd tools
./configure --save


  • This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
  • This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  • See the GNU General Public License for more details, published at

Release Details

Topic revision: r17 - 11 Feb 2012, PaulHarvey
The copyright of the content on this website is held by the contributing authors, except where stated elsewhere. See Copyright Statement. Creative Commons License    Legal Imprint    Privacy Policy