Foswiki archived release

See Release Dates for the complete list of available releases.

Highlights of this release

• 65 fixes and 5 enhancements
• Major performance bug fixed in Query search. Some sites have seen 350% improvement.
• Several "Severity 3" security issues fixed. Documented in tasks per the Foswiki security process.
• Configuration wizard added to incorporate manually installed extensions and check for configuration errors from the command line.

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

For users:

• Several significant compatibility fixes to the EditRowPlugin make it much more viable as a replacement for the EditTablePlugin

For administrators:

• Security fixes:
  • Tasks.Item13741 addresses URLPARAM encoding. Topic review recommended.
  • Tasks.Item13764 addresses guest commenting. Topic review recommended.
  • Tasks.Item13739 login and registration field encoding.
  • Tasks.Item13772 edit script parameter encoding.

Translation status

As of this release,

• Traditional Chinese, Danish, French, German and Italian are >99% complete.
• Czech is >96% complete.
• Dutch, Norwegian, and Portuguese (Brazil) 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.2.tgz	GPG	MD5	tar gz version of Foswiki
Foswiki-2.0.2.zip	GPG	MD5	zip version of Foswiki

Upgrade packages

If you already have an earlier version of Foswiki 2.0.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.

Upgrade packages must not be used to upgrade older releases.

File	GPG	MD5	Description
Foswiki-upgrade-2.0.2.tgz	GPG	MD5	upgrade tar gz version of Foswiki
Foswiki-upgrade-2.0.2.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

There are still limitations with the store conversion script bulk_copy.pl in Foswiki 2.0.1. Carefully review the limitations documented in the UpgradeGuide before converting your store.

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

Major issues of Foswiki, to be fixed in: 2.0.3

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

Id	Summary	Component	Current State
Item13519 9 years	Foswiki should clearly report missing dependencies. Don't crash with 500 Internal Server Error. distro:b3ebab2baa48 distro:3b31eb52e2bc distro:4b424853d4c2 distro:1fc7340f4a00 distro:0987542d7058	Configure	Closed
Item13816 9 years	Configure doesn't work on IE9, IE does not support console.log or console.debug.	ConfigurePlugin	Closed
Item13817 9 years	EditRowPlugin performance issues with tables > 100 rows. distro:b8d4648f340a distro:71ec7495ddf1 distro:07dfb9bd5441	EditRowPlugin	Closed
Item13830 9 years	Attachments with special characters (umlauts) in Foswiki 2.0.2 with mod_perl, reported as missing or empty file. distro:072e35817178 distro:c9bf5a4f67a1 distro:8b8a83b0d915	ModPerlEngineContrib	Closed
Item13834 9 years	EditRowPlugin cannot edit cells that contain Umlauts and other non-ASCII characters. distro:5c91079656f2	EditRowPlugin	Closed
Item13837 9 years	Foswiki::Func::getScriptUrl() generates broken URL if any parameters contain embedded # characters. distro:4bc7094810ad	FoswikiFunc	Closed
Item13839 9 years	UserMapping: validateRegistrationField is too strict on usernames - unable to add users containing underscore. distro:f853dd1b0a1f	UserMapping	Closed
Item13845 9 years	bulk_copy.pl fails to copy Support.WebPreferences topic if RcsWrap is in use. distro:876a2396b8e9 distro:494cf991e023	FoswikiTools	Closed
Item13850 9 years	Uninitialized variable trying to remove a undefined user from a group. distro:c8cb7ef1e48d	GROUPINFO	Closed
Item13852 9 years	CommentPlugin should warn about COMMENT permissions. distro:5a38853fd6a5 distro:275ba8a0b1d9	CommentPlugin	Closed

Upgrade Instructions

Upgrade packages are provided Foswiki 2.0.0-1. In-place upgrade from any release prior to Foswiki 2.0.0 is not recommended. Foswiki 1.x installation should install Foswiki 2.0.2 as a new release, configure, and then migrate data to the new installation.

• See System.UpgradeGuide for the latest upgrade information.
• See System.SystemRequirements for the latest System Requirements.

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

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-09-30
• Publish date 2015-09-30
• Built from github commit bc1f1f1317