You are here: Foswiki>Download Web>FoswikiRelease01x01x04 (11 Feb 2012, PaulHarvey)Edit Attach

Foswiki archived release

This release is superseded by Foswiki 2.1.8. 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.

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

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.1.4.tgz	GPG	MD5	tar gz version of Foswiki
Foswiki-1.1.4.zip	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.

Upgrade packages must not be used to upgrade older releases.

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

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

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 form.name 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.

Please note, you may be unaffected by Item10874 if:

You have never used Foswiki 1.1.3

You are not QuerySearching form.name 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 HtpasswdUser.pm 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.

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.

Fixes

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/PageCache.pm 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

Enhancements

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 jquery.media 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

Installation

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

Do not upgrade in-place from Foswiki 1.0 to 1.1. Install a new copy of Foswiki for a 1.0 upgrade.

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.
- See Development/BuildingARelease#Make_upgrade_packages for the list of files excluded from the upgrade.
- If your installation has been extensively modified, see HowDoIUpgradeSafelyACustomizedFoswikiInstallation for an alternative upgrade procedure.

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

100%: Czech, Danish, Dutch, French, German, Norwegian, Portuguese (Brazil), Swedish
95%: Italian, Polish
90%: Chinese (Taiwan), Russian, Spanish

For other translations see Foswiki's Pootle translation server.

Set ALLOWTOPICCHANE = MaintainGroup

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

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/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