Foswiki archived release

See Release Dates for the complete list of available releases.

Highlights of this release

• 17 fixes and 1 enhancements
• Major performance bug fixed in EditRowPlugin and in Foswiki rendering.
• Several "Severity 3" security issues fixed. Documented in tasks per the Foswiki security process.

See ReleaseNotes02x00 for complete release notes. See FoswikiRelease02x00x00 for highlights of the 2.0 release.

For administrators:

• Security fixes:
  • Tasks.Item13796 SpreadSheet CALC/CALCULATE macro can insert unencoded < and >

Translation status

As of this release,

• Traditional Chinese, Danish, French, German and Italian are >99% complete.
• Czech is >96% complete.
• Dutch, Norwegian, Portuguese (Brazil) and Ukrainian are 70-88% complete.
• Other languages are 60% complete or lower.

For more details on translation status, see Foswiki:Community.TranslationTeam and Foswiki's Weblate translation server. Foswiki is now using continuous translation, so contributions at any time are very helpful. Foswiki thanks the Translators for their Herculean efforts. If you are interesting in helping with the translation, please contact foswiki-translations@lists.sourceforge.net.

Download

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

File	GPG	MD5	Description
Foswiki-2.0.3.tgz	GPG	MD5	tar gz version of Foswiki
Foswiki-2.0.3.zip	GPG	MD5	zip version of Foswiki
Foswiki-2.0.3-vmware.zip	GPG	MD5	VM Image (instructions)

Upgrade packages

These packages can be used to upgrade Foswiki Release 2.0.0 or newer. See #Upgrade_Instructions for further information

Upgrade packages must not be used to upgrade older releases.

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

%STARTSECTION{"download-none"}%
<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>
%ENDSECTION{"download-none"}%

%STARTSECTION{"download-topic"}%
%INCLUDE{"Download.FoswikiReleaseViewTemplate" section="download"
  release="%FORMFIELD{"Release" topic="%BASETOPIC%"}%"
  url="%PUBURLPATH%/%BASEWEB%/%BASETOPIC%"
  upgraded=""
  upgrade=""
}%
%ENDSECTION{"download-topic"}%

%STARTSECTION{"download-topic-upgrade"}%
%INCLUDE{"Download.FoswikiReleaseViewTemplate" section="download"
  release="%FORMFIELD{"Release" topic="%BASETOPIC%"}%"
  url="%PUBURLPATH%/%BASEWEB%/%BASETOPIC%"
  upgraded="upgrade-"
  upgrade="upgrade"
}%
%ENDSECTION{"download-topic-upgrade"}%

%STARTSECTION{"download-sourceforge"}%
%INCLUDE{"Download.FoswikiReleaseViewTemplate" section="download"
  release="%FORMFIELD{"Release" topic="%BASETOPIC%"}%"
  url="http://sourceforge.net/projects/foswiki/files/foswiki/%FORMFIELD{"Release" topic="%BASETOPIC%"}%"
  upgraded=""
  upgrade=""
}%
%ENDSECTION{"download-sourceforge"}%

%STARTSECTION{"download-sourceforge-upgrade"}%
%INCLUDE{"Download.FoswikiReleaseViewTemplate" section="download"
  release="%FORMFIELD{"Release" topic="%BASETOPIC%"}%"
  url="http://sourceforge.net/projects/foswiki/files/foswiki/%FORMFIELD{"Release" topic="%BASETOPIC%"}%"
  upgraded="upgrade-"
  upgrade="upgrade"
}%
%ENDSECTION{"download-sourceforge-upgrade"}%

%STARTSECTION{"download-github"}%
%INCLUDE{"Download.FoswikiReleaseViewTemplate" section="download"
  release="%FORMFIELD{"Release" topic="%BASETOPIC%"}%"
  url="https://github.com/foswiki/distro/releases/download/%FORMFIELD{"ReleaseTag" topic="%BASETOPIC%"}%"
  upgraded=""
  upgrade=""
}%
%ENDSECTION{"download-github"}%

%STARTSECTION{"download-github-upgrade"}%
%INCLUDE{"Download.FoswikiReleaseViewTemplate" section="download"
  release="%FORMFIELD{"Release" topic="%BASETOPIC%"}%"
  url="https://github.com/foswiki/distro/releases/download/%FORMFIELD{"ReleaseTag" topic="%BASETOPIC%"}%"
  upgraded="upgrade-"
  upgrade="upgrade"
}%
%ENDSECTION{"download-github-upgrade"}%

%STARTSECTION{"download"}%
%TABLE{sort="off"}%
| *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%/Foswiki-%upgraded%%release%.zip][%ICON{download}% Foswiki-%upgraded%%release%.zip]] | [[%url%/Foswiki-%upgraded%%release%.zip.asc][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"}%

%STARTSECTION{"upgrade-header"}%
---++ Upgrade packages

%IF{"'%BASETOPIC%'/UpgradeFrom=''" 
   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.

%ENDSECTION{"upgrade-header"}%

Getting help & providing feedback

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

• The IRC channel
• foswiki-discuss mailing list
• Support forum
• Paid support

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

• File a new task for bug reports
• Create, review or comment on feature proposals to help influence the future of Foswiki
• Chat with other users, developers, translators, and testers on our friendly IRC channel
• If E-mail is more your thing, try our foswiki-discuss mailing list

Known issues

The following issues have been reported against FoswikiRelease02x00x03. Tasks in "Closed" or "Waiting for Release" state will be fixed in the next release.

Major issues of Foswiki, to be fixed in: 2.1.0

The following "urgent" issues have been marked for resolution in Foswiki 2.1.0

Id	Summary	Component	Current State
Item11609 12 years	No information how to un-set a topic parent distro:2b68b3537ba8 distro:82917bcbe34c	FoswikiTemplates, FoswikiUsability	Closed
Item13875 8 years	Configure fails to perserve permissions when backing up config. distro:f48cf75412c0 distro:a02777055213	Configure	Closed
Item13880 8 years	TML rendered in head and script zones causes malformed html in WebCreateNewTopic distro:59dfcf9b1da2 distro:2e2d916fcb89 distro:4554e77fccb1 distro:9643396c3b97 distro:f3e49f321afb	FoswikiRender	Closed
Item13890 8 years	bulk_copy ignores --latest option distro:22951feee989 distro:df2ae3811d17	FoswikiTools	Closed
Item13891 8 years	bulk_copy.pl does not copy user information for attachment histories distro:9f4fae1042d1 distro:fb08bb208176	FoswikiTools	Closed
Item13896 8 years	TWISTY incorrectly used in Sandbox.WebHome, generates broken HTML. distro:896f2223c8ea distro:68f4ea394eee distro:82c52ebf9f35 distro:b88b12c39f88 distro:d9eec82de3d1 distro:ffeb3c24c37e distro:e48a024b80cf distro:0d86fb132645	TwistyPlugin	Closed
Item13898 8 years	JQueryAjaxHelper jumpbox code does not work with short URLs distro:9e87a977ea13 distro:f9f0d083cd6f distro:08e6036b2d25 distro:dd130a3594af distro:600d07d068fe distro:1718fedc3eda distro:ff2e27f64a85 distro:e76143bc605e distro:3519e0fadd08 distro:a5a1b02e6e24 distro:ed1c8343acb1	JQueryPlugin	Closed
Item13899 8 years	save: ignores new topic text if it is empty distro:cb452f8c6282 distro:0059ff1063ff	FoswikiUISave	Closed
Item13900 8 years	Logout redirects to wrong path when ForceDefaultHostUrl is enabled. distro:f645de43ab42 distro:5441fa24675a	LoginManager	Closed
Item13903 8 years	Redirect for authentication breaks utf8 topic names. distro:a6625849a3c6 distro:6a6dd465b462	LoginManager	Closed
Item13913 8 years	CLI scripts broken on windows. setlib.cfg issues "require CGI" which sets binmode on STDIN and breaks prompts. distro:89cb46c0fb4e distro:ed9fb9d47f4a	FoswikiTools, Configure	Closed
Item13926 8 years	ModPerlEngineContrib is not backwards compatible with Foswiki 1.1.x distro:6b2851af0ad9 distro:a08ec3c07e8d distro:4332a3bc13b0 distro:43e40751de48	ModPerlEngineContrib	Closed

Installation

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

Upgrade Instructions

• 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/Foswiki-upgrade-2.x.x.zip
cd tools
./configure --save

• After upgrade, restart the web server, clear the foswiki page cache, clear your browser cache.
• If things are not fully working, verify file system permissions and ownership. See System.InstallationGuide#Step_2:_Confirm_file_and_directory_ownership_and_permissions

If upgrading from Foswiki 2.0.0, all working/tmp/cgisess_* files must be deleted. All users will have to log in after the upgrade. (This change was introduced in Foswiki 2.0.1.)

Upgrading from Foswiki Version 1.x.x

There are a number of significant changes that require action before migrating data from an old release. Carefully review the release notes.

• JavaScript is now required for many operations.
• New default PlainFileStore cannot coexist with existing RCS revision files. If new store is selected, a conversion script must be run.
• Foswiki now defaults to utf-8, Before importing data, you must either match previous encoding, or convert the data from the old store to the new character encoding.
• Empty DENY rules must be changed to ALLOW * wildcards. Or the old feature must be enabled in the configuration.
• Sessions use IP Matching by default. If your site supports roaming / mobile users or is behind a proxy, this must be disabled.
• Installation process has changed. Do not visit bin/configure as your first URL. Go directly to your default view url and then follow the link to configure.
• Foswiki no longer ships with CPAN perl modules. Install CPAN prerequisites using your local system package manager, or cpanm
• Perl 5.8.8 is the minimum perl release. Perl 5.20 or higher is recommended.
• Foswiki now predominantly uses 'single quotes' in generated HTML, and "double quotes" in macros. The change to singe quotes in generated HTML may require some rework of Foswiki macros.
• Some versions of CGI should be avoided (especially 4.10-4.13) to prevent corruption of international characters in topics when utf-8 is enabled.

License

• 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 http://www.gnu.org/copyleft/gpl.html

Release Details

• Build date 2015-11-15
• Publish date 2015-11-15
• Built from github commit df22d2532f