Foswiki archived release

This release is superseded by Foswiki 2.1.6. Visit the download page.

See Release Dates for the complete list of available releases.

Contents

Download Foswiki 1.2.0_Beta_1 from sourceforge
- Other downloads/installers
Getting help & providing feedback
Known issues
Upgrade Instructions
Installation
Upgrade Instructions
License
Release Details
Tools

Highlights of this release

Major new Foswiki release
257 bugfixes, and 129 enhancements relative to 1.1.9
Incorporates 47 "Feature proposals"
After in-depth security review, improvements made in 15 areas.

See ReleaseNotes01x02 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.
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 Help Wanted!

As of this release,

Italian translation is 100% complete
French and Czech are >99% complete
German is >97%
Danish is >90%
Other languages are 60% complete or lower.

For more details on translation status, see Foswiki:Community.TranslationTeam and Foswiki's Weblate translation server. Foswiki thanks the Translators for their Herculean efforts. If you are interesting in helping with the translation, please contact foswiki-translations@lists.sourceforge.net.

Security alerts or advisories apply to this release:

This release is vulnerable to the above alerts. Instructions on how to mitigate these issues are described in the alert details.

Download Foswiki 1.2.0_Beta_1 from sourceforge

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

File	GPG	MD5	Description
Foswiki-1.2.0_Beta_1.tgz	GPG	MD5	tar gz version of Foswiki
Foswiki-1.2.0_Beta_1.zip	GPG	MD5	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-%upgraded%%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-%upgraded%%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"}%

Other downloads/installers

None at this time

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 on freenode
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 FoswikiRelease01x02x00Beta1. Tasks in "Closed" or "Waiting for Release" state will be fixed in the next Beta.

Item13345 (Closed): "any" pragma is deprecated in CGI-4.14 - MailerContrib.pm was missed, needed fix.
Item13351 (Closed): ACL Converter had left-over debug code, restricts topics processed tools/convertTopicSettings.pl only updates topics containing TestTopic in the topic name. Hotfix in the task item.
Item13355 (Closed): Formfield titles not expanding macros - Country selector in user form broken.
Item13357 (Closed): Configure issues installing older extensions - Some config.spec definitions cause crash.
Item13358 (Closed): Extension installer fails with multiple Taint errors installing / removing extensions. (Only an issue if ASSERTS are enabled, and Taint::Runtime is installed).
Item13359 (No Action Required): Crash in Configure/Query.pm after installing extension - Extension is usable after refreshing configure.
Item13365 (Closed): forcenewrevision checkbox is not working

Upgrade Instructions

In-place upgrade to Foswiki Release 1.2.0 from older releases is not recommended. Install Foswiki 1.2.0 as a new release, configure, and then migrate data to the new installation.

See System.UpgradeGuide01x02 for the latest upgrade information.
See System.SystemRequirements01x02 for the latest System Requirements.

Caution: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.18 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.

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

Upgrade packages are not available for this release. Install as a new release and migrate the configuration and data.

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