Foswiki archived release

See Release Dates for the complete list of available releases.

Highlights of this release

• First patch to major new Foswiki release
  • 28 fixes and 3 enhancements
• Hundreds enhancements relative to 1.1.9
• Incorporates 49 "Feature proposals"
• After in-depth security review, improvements made in 15 areas.
• UTF-8 Core. Foswiki now uses utf-8 internally for comprehensive international character set support.
• Foswiki virtual machine updated to Ubuntu LTS 14.04.

See ReleaseNotes02x00 for complete release notes.

For users:

• New "Natural Edit" TML editor helps users learn the Topic Markup Language
• New "block indent" TML markup ( Multiple of 3 spaces, :(colon) (space) indented text )
• HomePagePlugin adds individualized homepage on login.
• More realistic edit "preview" includes active links.
• SubscribePlugin allows one-click subscribe for topic change notifications
• Old EditTablePlugin has been replaced by the EditRowPlugin. This plugin provides enhanced capabilities and client-side sorting of tables.
• Greatly improved support for international character sets.

For administrators:

• New pluggable Store backend, and Plain File store available: higher performing and eliminates use of RCS.
• New pluggable ACL processing with Read only and Admin only access settings
• Simpler initial installation and bootstrap of settings.
• internal admin login can be eliminated, avoiding use of shared passwords.
• New configure interface requires JavaScript
• New command-line configuration tool available
• UpdatesPlugin alerts admin when updated extensions are available.
• FastCGI and mod_perl supported "out of the box".
• Simpler web server configuration: No need to apply special protection to configure script.

Translation status

As of this release,

• Czech, Danish, French, German and Italian are >99% complete.
• Traditional Chinese is >93% complete.
• Dutch, Norwegian, and Portuguese (Brazil) are 70-88% complete.
• Other languages are 60% complete or lower.
• A new translation has been added: Klingon, 95% translated.

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.1.tgz	GPG	MD5	tar gz version of Foswiki
Foswiki-2.0.1.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.1.tgz	GPG	MD5	upgrade tar gz version of Foswiki
Foswiki-upgrade-2.0.1.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 FoswikiRelease02x00x01. 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.2

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

Id	Summary	Component	Current State
Item13560 9 years	configure does not set initial values when extensions are installed with an external package manager. distro:00c9e7389753 distro:921ed8f9164e distro:9a3b4612bfff distro:ed3aabefa0fd distro:b8a7893cfa4a distro:69baaf25c3f5 distro:e597e35ec868 distro:242a57cf630d distro:5088ec2bd570 distro:1f7f01184216 distro:2804659007c4 distro:e54f9dfa39fc distro:b2b931647f3c distro:c4703e9e5341	ConfigurePlugin	Closed
Item13561 9 years	PERL type configuation settings lose their formatting when LocalSite.cfg is saved. distro:90dd7ce46dad	ConfigurePlugin	Closed
Item13570 9 years	EditRowPlugin does not work on page with TABLE macro. distro:45bceb5d9e7c distro:956a65673331 distro:b99811da932a distro:e0f5ba59ba75 distro:ab48972c1f9d distro:cc3e182967a4 distro:581bd6e6910a TablesContrib:ee2f9bed9785 TablesContrib:198175cb59a4 distro:01df15f83db2 distro:21c9304cb9b9 distro:24a5f4d2f4ba distro:346900b82757	EditRowPlugin	Closed
Item13583 9 years	Login form populated with incorrect path info. distro:526290089f8d distro:d2517b1846e8	FoswikiRequestCache	Closed
Item13593 9 years	Foswiki 2.0 is 350% slower doing query SEARCH compared to 1.1.9. distro:4e7a76058509		Closed
Item13598 9 years	Error renaming a symlinked web using Support.PlainFile Store. distro:0d134479ea0a	PlainFileStoreContrib	Closed
Item13601 9 years	Page cache pollution by illegal path components. distro:774bdbec99f1		Closed
Item13609 9 years	bulk_copy.pl fails on perl 5.10.1 - Encode constants are not exported. distro:9573c58df395	FoswikiTools	Closed
Item13625 9 years	AutoViewTemplatePlugin: reports Invalid template name ( Warning: Can't find named section viewtemplate in topic...) when used in "section" mode and no section exists. distro:40b77a99bee7	AutoViewTemplatePlugin	Closed
Item13629 9 years	Hide "Title" field in natedit when unused. distro:bd824876d6f2	NatEditPlugin	Closed
Item13649 9 years	BuildContrib not properly copying copyright information releasing an extension distro:04dca6d946c4 distro:9a922343a75f distro:994f94b51310		Closed
Item13654 9 years	Foswiki::Func::saveFile was changed in Foswiki 2.0 to use utf-8 encoding. distro:9de4992f3125	FoswikiFunc	Closed
Item13667 9 years	Templates with leading comments disturb jquery-ui. distro:f4be8f0aae09	JQueryPlugin	Closed
Item13672 9 years	EditRowPlugin not working on mod_perl systems. distro:fe563ecb6684	EditRowPlugin	Closed
Item13676 9 years	Add jquery-2.1.4 and 1.11.3 to cure a Safari bug.	JQueryPlugin	Closed
Item13685 9 years	SlideShowPlugin no longer allows scrolling down when the page is a little longer than the display. distro:3d2b20b3eada	SlideShowPlugin	Closed
Item13688 9 years	TablePlugin injected css is overwritten by the default style sheets disabling any table attributes. distro:4f23f566902b	TablePlugin	Closed
Item13692 9 years	EditRowPlugin puts the edit button the wrong place when EDITTABLE comes before TABLE.	EditRowPlugin	Closed
Item13693 9 years	EditRowPlugin deletes macros from text area fields. distro:4b02c483c597	EditRowPlugin	Closed
Item13696 9 years	Some attachments can be unreachable with non-UTF8 store encoding. distro:bd1370ecab3f distro:62c2f1e8e1a7 distro:0f499eb41281 distro:bcb6ce91455c distro:8d379427bad8 distro:3918c7a3632f	FoswikiStore	Closed
Item13697 9 years	With iso-8859-1 store, it's possible to create unreachable topics and attachments. distro:8366b8a2cdbc distro:9ec1ba127a17 distro:47f2d3e6a6e5 distro:59642e42a30c distro:bca91a0f39b7	FoswikiStore, PlainFileStoreContrib, RCSStoreContrib	Closed
Item13698 9 years	Unable to move attachments if target topic is not a Support.WikiWord. distro:1e1b92d9f8d6	FoswikiUIRename, FoswikiUsability	Closed
Item13707 9 years	PatternSkin themes are not working. distro:a2c2200c80bb distro:0d9b34a1bc05 distro:f046d4d5ada7	PatternSkin	Closed
Item13710 9 years	JQueryPlugin (6.13) version of jquery.foswiki.js fails in 1.1.9 installation. Support.BuildContrib corrupts compressed javascript. distro:775498952344 distro:18ecebad2da7	BuildContrib, JQueryPlugin	Closed
Item13711 9 years	EditRowPlugin makes Support.TablePlugin apply its formatting to the wrong column. distro:aeb5dd16a31e	EditRowPlugin	Closed
Item13714 9 years	EditRowPlugin adding and deleting rows fails in TestCases/TestCaseEditTableJavaScript. distro:f6384ff6dc43 distro:aeb5dd16a31e	EditRowPlugin	Closed
Item13715 9 years	EditRowPlugin does not always handle the EDITTABLE macro correctly case 2. distro:aeb5dd16a31e	EditRowPlugin	Closed
Item13717 9 years	EditRowPlugin creates massive copies of macros when you edit tables. distro:aeb5dd16a31e	EditRowPlugin	Closed
Item13720 9 years	EditRowPlugin make the headline sort mark up the wrong column as the sorted. distro:aeb5dd16a31e	EditRowPlugin	Closed
Item13721 9 years	Return Support.EditTablePlugin to the 2.0.2 MANIFEST. distro:5c536a685a95	EditRowPlugin, EditTablePlugin	Closed
Item13728 9 years	Rename fails across symlinked directories in RCS Store. distro:bca91a0f39b7 distro:3d80f8f7f141	RCSStoreContrib	Closed
Item13730 9 years	EditTablePlugin uses unescaped braces and calls CGI::param in list context. distro:94795ea1422f distro:f1cee9837ffc	EditTablePlugin	Closed
Item13745 9 years	Set+ Unset+ save script arguments are unusable from the CLI engine. distro:d6e008e71bf4	FoswikiEngine	Closed
Item13765 9 years	EditRowPlugin Support.TestCaseEditTableMacrosInSettings removes content of footer and label type cells. distro:9a00e20b3b31	EditRowPlugin	Closed

Upgrade Instructions

In-place upgrade to Foswiki Release 2.0.1 from any release prior to Foswiki 2.0.0 is not recommended. Install Foswiki 2.0.1 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-08-03
• Publish date 2015-08-03
• Built from github commit 918f8c72f2