Foswiki Release 2.1.1

Foswiki - The Free and Open Source Wiki

Foswiki is an enterprise collaboration and information sharing tool targeted for professional use in many types of organizations: from small businesses to multi-nationals, from one-product open source groups, to worldwide research networks.

Foswiki is a wiki: fundamentally, a website with editable web pages. It looks like a normal web site but it encourages contributions, edits, updates, questions, and answers from its users. It's a powerful way of enabling a community to communicate asynchronously using intranet and public Internet websites. Foswiki is simple to learn and use. It aims to provide a transparent way for you to publish and exchange your ideas with others over the web and eliminates the one-webmaster syndrome of outdated intranet content.

Foswiki is a structured wiki with tools that enable users without programming skills to build powerful yet simple applications to process information and support workflows. Developers can extend the functionality of Foswiki with plugins.

Foswiki is backwards compatible with content generated on all previous Foswiki versions, and even content and many plugins from TWiki installations (Foswiki ships with a TWikiCompatibilityPlugin, thus enabling most extensions made for TWiki to work in Foswiki. TWiki® is a registered trademark of Peter Thoeny.)

Foswiki is released under the GNU General Public License.

Foswiki Releases

  • Foswiki 1.0.0, the first Foswiki was released on 09 Jan 2009.
  • Foswiki 1.0.1, 1.0.2 and 1.0.3 were released internally in the development community, but were never publicly released.
  • Foswiki 1.0.4 was built 19 Mar 2009. It is a patch release with more than 120 bug fixes relative to 1.0.0 and only very few minor enhancements.
  • Foswiki 1.0.5 was built 25 Apr 2009. It is a patch release with more than 150 bug fixes relative to 1.0.0 and a few enhancements. This patch release further enhances the robustness and the security of the Foswiki software.
  • Foswiki 1.0.6 was built 21 Jun 2009. It is a patch release with more than 200 bug fixes relative to 1.0.0 and some enhancements. This version introduces a major enhancement in security against Cross-Site Request Forgery. Further more a central translation framework got introduced which ease the translation process and enables all users to contribute to translations.
  • Foswiki 1.0.7 was built 20 Sep 2009. It is a patch release with more than 240 bug fixes relative to 1.0.0 and some enhancements. This release fixes some serious issues introduced by the CSRF fix and the redirect cache fix in 1.0.6. Major enhancement that also fixes many annoying editor bugs is the upgrade of the Tiny MCE editor to version 3.2.2.
  • Foswiki 1.0.8 was built 29 Nov 2009. It is a patch release with more than 280 bug fixes relative to 1.0.0 and some enhancements. This release fixes a short list of quite annoying old bugs incl a bug that prevented efficient use of MailerContrib for producing newsletters. The Wysiwyg editor has been upgraded with the latest Tiny MCE editor release 3.2.7.
  • Foswiki 1.0.9 was built 17 Jan 2010. It is a patch release with more than 320 bug fixes relative to 1.0.0 and several enhancements. This release fixes many bugs in the Wysiwyg editor, bugs related to more advanced wiki applications and bugs in the Plugin API. It contains several bug fixes and enhancements related to security and spam fighting.
  • Foswiki 1.0.10 was built 08 Sep 2010 as a patch release with more than 410 bug fixes relative to 1.0.0. It is assumed to be the last 1.0.X release.
  • Foswiki 1.1.0 was built 04 Oct 2010. It is a release with more than 270 bug fixes relative to 1.0.10 and more than 680 bug fixes relative to 1.0.0. And the release adds more than 100 enhancements. Foswiki 1.1.0 introduces jQuery Javascript user interface framework, improved topic history display, new QUERY and FORMAT macros, better user interfaces for groups, much improved WYSIWYG editor, facelift of the default skin, much improved configure tool, and many more enhancements.
  • Foswiki 1.1.1 was built 25 Oct 2010. It is a release that fixes some important bugs that were introduced in 1.1.0. It is highly recommended that all running 1.1.0 upgrade to 1.1.1.
  • Foswiki 1.1.2 was built 09 Nov 2010. It is a release that fixes some very important bugs incl. a security related bug. Installations running 1.1.0 and 1.1.1 should be upgraded to 1.1.2
  • Foswiki 1.1.3 was built 16 Apr 2011. It is a release that fixes more than 150 bugs. jQuery has been updated to 1.4.3. The default PatternSkin has some usability improvements.
  • Foswiki 1.1.4 was built 20 Dec 2011. It is a release that fixes some very important including some security related issues. It contains 143 fixes and 27 enhancements. jQuery has been updated to 1.7.1.
  • Foswiki 1.1.5 was built 10 Apr 2012. It is a release that fixes some very important issues including some security related issues. It contains 100 fixes and 20 enhancements.
  • Foswiki 1.1.6 was built 02 Dec 2012. It is a release that fixes some important issues including some minor security related issues. It contains 94 fixes and 27 enhancements.
  • Foswiki 1.1.7 was built 01 Feb 2013. It is a release that fixes CVE-2012-6329 and CVE-2012-6330. It contains 20 fixes and 4 enhancements.
  • Foswiki 1.1.8 was built 28 Feb 2013. It is a release that fixes CVE-2013-1666. It contains 4 fixes.
  • Foswiki 1.1.9 was built 18 Nov 2013. It is a release that contains 44 fixes and 4 enhancements..
  • Foswiki 1.1.10 was built 23 Nov 2015. It is a release that contains 8 fixes and 8 enhancements.
  • Foswiki 2.0.0 was built on 04 Jul 2015. It is a release that contains 312 fixes and 157 enhancements, and closes 59 Feature Requests.
  • Foswiki 2.0.1 was built on 03 Aug 2015. It is a release that contains 28 fixes and 3 enhancements.
  • Foswiki 2.0.2 was built on 01 Oct 2015. It is a release that contains 65 fixes and 5 enhancements.
  • Foswiki 2.0.3 was built on 15 Nov 2015. It is a release that contains 17 fixes and 1 enhancement.
  • Foswiki 2.1.0 was built on 02 Feb 2016. It is a release that contains 37 fixes and 14 enhancements. It closes 7 Feature Requests.
  • Foswiki 2.1.1 was built on 30 Apr 2016. It is a release that contains 36 fixes and 21 enhancements.
  • Foswiki 2.1.2 was built on 2 May 2016. It is a release that contains 1 fix.

Pre-installed Extensions

Foswiki 2.1 is shipped with the following:
  • Plugins: AutoViewTemplatePlugin, CommentPlugin, ConfigurePlugin, EditRowPlugin, EmptyPlugin, HistoryPlugin, HomePagePlugin, InterwikiPlugin, JQueryPlugin, NatEditPlugin, PreferencesPlugin, PubLinkFixupPlugin, RenderListPlugin, SlideShowPlugin, SmiliesPlugin, SpreadSheetPlugin, SubscribePlugin, TablePlugin, TinyMCEPlugin, TwistyPlugin, UpdatesPlugin, WysiwygPlugin
  • Contribs: CompareRevisionsAddOn, FamFamFamContrib, FastCGIEngineContrib, JEditableContrib, JSCalendarContrib, JsonRpcContrib, MailerContrib, ModPerlEngineContrib, PlainFileStoreContrib, RCSStoreContrib, TipsContrib, TopicUserMappingContrib
  • Skins: PatternSkin
  • Compatibility support - TWikiCompatibilityPlugin

Known issues

For up-to-date information, see Known issues of Foswiki 2.1

Use of non-default {Store}{Encoding}

WARNING About {Store}{Encoding}: If you intend to use high-bit characters in attachment filenames (such as umlauts and accents), then links to these attachments on Foswiki pages will not work on a non-utf-8 Store without modification. This is because Foswiki works internally using Unicode, but the store saves files to disk using your chosen {Store}{Encoding}. Running the Store with other than utf-8 encoding is considered a transitional step and not recommended for long-term operation. The strongly recommended solution is to convert your store to UTF8 at the earliest opportunity.

A partial workaround is implemented in the PubLinkFixupPlugin This Plugin will attempt to rewrite broken links. This generally gets linked images and other attachments working. However the TinyMCEPlugin is still unable to render image links while editing a topic.

See Item13696 for up-to-date details.

Important changes in Foswiki 2.1.1

Page Caching

The Foswiki PageCache has added another index on the dependencies table. After installing this update, you should issue the refresh=all option to drop the foswiki cache tables, and allow them to be recreated. This will create the new index.

JQuery

This release updates to a newer maintenance version of JQuery. You should visit bin/configure and select the updated versions of JQuery.

New CPAN dependency, and foswiki.org changes

Due to upstream changes, the Perl LWP package has been split into two packages. You may need to install LWP::Protocol::https for https support in extension installation and accessing remote sites with the INCLUDE macro.

Important changes in Foswiki 2.1

Deprecations

The %HTTP% and %HTTPS% macros are deprecated and will be removed in a future release. These macros now restrict the available information to the Accept-language and User-Agent headers. The list of available headers is now configurable.

API Change

The Foswiki API version is incremented to version 2.4 in Foswiki 2.1.0. Foswiki 2.1 permits template names using Unicode characters.

New Perl CPAN dependencies!

Foswiki now requires CPAN:Email::MIME. Foswiki will be unable to send email without this module. SystemRequirements has more details on CPAN dependencies and package names for most *nix distributions.

Enhanced Registration form

The registration form now accepts the parameter templatename to override the default NewUserTemplate. In addition the registration topics have been restructured to permit multiple custom registration pages. Customization of the registration form is greatly simplified.

Easier to restrict access to the System web.

Some sites prefer to block access to the System web documentation for guest users. Duplicated content can result in lowered search engine rank, so it is advantageous to restrict access to the System web. Foswiki now includes ALLOWTOPICVIEW settings for critical system topics that are required for guest access.

Changes in permitted characters in topic and attachment names.

Foswiki has split the topic and attachment name filters. The topic name filter has become more restrictive. Attachment names now permit embedded spaces, and attachments with spaces will no longer be renamed to underscores. If you would prefer to use the old behavior, enable $Foswiki::cfg{AttachmentReplaceSpaces}.

Action Required: The colon (:) has been removed from the list of legal characters permitted in topic names. The colon was in conflict with the InterWiki links. If your existing topic use the colon in topic names, you should remove the colon from the configuration setting $Foswiki::cfg{NameFilter}.

Improvements in International Character Set support

Foswiki 2.1 has further improved support for utf-8 based character sets. Topics and data forms can use utf-8 characters. They will be properly rendered and preserved during edit. The Foswiki core has been fully converted to utf-8 and unicode. All encoding / decoding is done "at the edge", when reading from / writing to the Foswiki store.

  • Foswiki 2.1 International support
    • Emails sent by Foswiki now fully support International Character Sets.
    • Foswiki now uses NFC Normalization of Unicode characters. This greatly improves compatibility with Operating Systems like OSX which use NFD form characters by default.
    • Template names are no longer restricted to ASCII characters.

  • Foswiki 2.0 International support
    • New sites will use utf-8 by default. Internationalizaiton should just work.
    • Sites migrating data from a previous installation have two choices:
      • Set {Store}{Encoding} to match the previous ={Site}{CharSet}. (Default was iso-8859-1)
      • Migrate the data to utf-8 by using the tools/bulk_copy.pl script. This is the recommended solution.
    • Support for Locales is still known to have issues. {UseLocales} should not be enabled in the configuration.

ALERT! ACTION REQUIRED If you are upgrading an existing system, you should review the existing data and determine if migration to utf-8 should be performed. See the UpgradeGuide for more details. Note that the topic and attachment name filters no longer filter international characters, so migration to utf-8 is strongly recommended.

Due to the extensive internal changes, extensions may require changes for compatibility with this release.

Translation Status

As of this release,
  • Italian and Ukrainian are 100% complete.
  • Traditional Chinese, French and German are >99% complete.
  • Czech, Danish are >95% complete.

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

Foswiki Release 2.1 Details

New Features

AddConcatOptionToAttrs Add +"more" and key+"more" options to Foswiki::Attrs
CompleteMIMESupportInEmail Wrap all outgoing mails into uniform and safe MIME envelope.
CustomNewUserTemplates Enhance register script to specify a templatetopic param instead of hard-coded 'NewUserTemplate'
DeprecateHTTPandHTTPS Deprecate and restrict System.VarHTTP and System.VarHTTPS macros due to security concerns
MakeItEasierToBlockSystemWebGuestAccess Simplify hiding the System web documentation.
MakeZonesLessIntrusive Make zones less intrusive, especially for non-HTML output
SplitTopicAttachmentNameFilters Separate the topic and attachment name filters, allow spaces in attachment names, remove colon from Topic names.

Fixes

Item10916 Pencils disappear after row move when both js and non-js controls are present.
Item11609 No information how to un-set a topic parent.
Item12067 Removing members via WikiGroups not possible when login name different from WikiName.
Item12569 Sorting in tableplugin is wrong in German.
Item13405 Unicode Normalisation.
Item13677 regression: extension tabs in configure aren't sorted alphabetically anymore.
Item13699 Mail sending fails when non-latin text in utf8 is being sent.
Item13857 Mac OS X RCS "not found" by configure.
Item13860 UploadFilter isn't blocking HTML attachments.
Item13863 FileAttachment: generated filenames are not correct foswiki 2.0.3 mod_cgi, utf-8 store when uploaded from OS X.
Item13865 Configure file permissions checker detects ,pfv directories as possible webs.
Item13869 FoswikiServerInformation warns about undefined variables.
Item13870 RCSStoreContrib configure check error by syntax shell command error in RCSChecker.pm.
Item13875 Configure fails to perserve permissions when backing up config.
Item13877 Certificate wizards not functional, always generates CSR, dependencies not documented.
Item13880 TML rendered in head and script zones causes malformed html in WebCreateNewTopic.
Item13881 Table header problem in unicode named web/topic.
Item13885 PatternSkin should be backwards compatible to Foswiki 1.1.
Item13886 Default id="foswikiTOC" creates illegal duplicate CSS IDs when multiple TOC macros are present.
Item13889 Processing of dynamically generated META in a new topic template is displayed as plain text until saved.
Item13890 bulk_copy ignores --latest option.
Item13891 bulk_copy.pl does not copy user information for attachment histories.
Item13893 Performance fixes for Foswiki 2.0.4.
Item13894 RcsStore double-encodes utf8 comments into the attachment revision log.
Item13896 TWISTY incorrectly used in Sandbox.WebHome, generates broken HTML.
Item13898 JQueryAjaxHelper jumpbox code does not work with short URLs.
Item13899 save: ignores new topic text if it is empty.
Item13900 Logout redirects to wrong path when ForceDefaultHostUrl is enabled.
Item13903 Redirect for authentication breaks utf8 topic names.
Item13906 EditRowPlugin create table row without spaces.
Item13912 perldoc does not process bulk_copy.pl correctly because of missing POD marker.
Item13913 CLI scripts broken on windows. setlib.cfg issues "require CGI" which sets binmode on STDIN and breaks prompts.
Item13917 NameFilter not working on 2.0 / 2.1 if configure reset to default is used.
Item13924 Old style UserRegistration pages not working on 2.1 beta 1.
Item13925 Leading spaces in DefaultUrlHost causes malformed URL links.
Item13926 ModPerlEngineContrib is not backwards compatible with Foswiki 1.1.x.
Item13927 Configure rcs checker crashes if configured command is not found.

Enhancements

Item12560 NameFilter should reject colon, conflicts with Interwiki links. Restructure filters to improve flexibility.
Item13436 Adding the class parameter to the TablePlugin.
Item13444 Foswiki::Net::getExternalResource does a poor job of parsing URLs.
Item13553 Add form-definition-table template.
Item13554 Foswiki doesn't work with accented Template names.
Item13594 Implement feature AddConcatOptionToAttrs.
Item13848 Deprecate, and restrict HTTP and HTTPS macros.
Item13849 Implement MakeZonesLessIntrusive.
Item13854 Implemement MakeItEasierToBlockSystemWebGuestAccess.
Item13864 Implement CustomNewUserTemplates - Registration can override the template for the user topic.
Item13866 Add a file permission fixer script to tools.
Item13867 bin/upload failed from the command line.
Item13874 Don't encode URLs in links inserted by Upload.
Item13914 rewriteshebang should use setlib, don't make user enter -I ../lib.

Foswiki Release 2.1.1 Details

Fixes

Item975 BulkRegistration should work with ApacheLogin.
Item13795 Redundant url params generated by %SCRIPTURLPATH macro.
Item13941 %EDITTABLE macro visible in print mode.
Item13944 Foswiki::Func::addToHEAD (deprecated in 2010) breaks with Foswiki 2.1 Zones rewrite.
Item13945 Software error with Perl 5.10. Can't find Ascii Unicode entity.
Item13947 Issues in Store Implementaton and Cache Implementation checkers.
Item13950 Refresh cache needs better controls, to minimize bot clicks.
Item13957 TinyMCEPlugin does not handle indent correctly.
Item13958 The indent feature with colon does not render an empty line.
Item13960 Wysiwyg editor cannot right align a table cell if the content of the cell is a "0".
Item13975 Do a deep merge gathering foswikiPreferences.
Item13989 When you disable guest sessions you also disable all registration and reset of password.
Item13995 Search $changes renders a simple summary.
Item13997 Incorrect assumption about encodings in Foswiki::Store.
Item14000 Wrong row is deleted by EditRowPlugin in full table edit mode.
Item14004 EditRowPlugin textarea doesn't honor the dimensions.
Item14008 Configure checker should warn/error if AutoAttachPubFiles is used with PlainFile store.
Item14010 Add mime type for woff2.
Item14011 Make sure HTTP2 is always compressing HTML.
Item14012 Prevent page caching under certain conditions.
Item14013 Make sure zones are stable when reloading a page.
Item14014 Comment plugin unable to use template files in hierarchical webs in Foswiki 2.1.
Item14022 All internal links should be changed to https://foswik.org to avoid redirects.
Item14024 JQueryPlugin (v6.32) might not initialise correctly with current JSON (v2.90) / JSON-XS (v3.02) modules w/o allow_nonref.
Item14025 JsonRpcContrib requires allow_nonref (when using JSON-XS v3.02).
Item14032 INCLUDE doesn't rewrite other webs' links in 2.1.
Item14035 Plain file logger fails to rotate the log.
Item14037 PageCache needs an index on the to_topic field.
Item14038 PageCache generates too many dependencies on System.ParentList.
Item14039 System.SkinBrowser takes too long to render due to Search performance.
Item14042 Typo in JQueryPlugin defaults causes missing jquery version.
Item14049 Configure hangs if URL has a trailing slash.
Item14050 Link to missing topic in WelcomeGuest.
Item14051 Page cache not respecting the Host URL.
Item14053 Registration confirmation emails BCC the Webmaster. Causes too much noise.
Item14055 If beforeUploadHandler modifies an attachment, it is recorded with the wrong size.

Enhancements

Item13970 Modernize BUTTON.
Item13971 Add latest jquery and remove some outdated versions.
Item13972 Update fontawesome and extend %JQICON to be able to use fontawesome icons.
Item13973 Deprecate bgiframe and media jquery plugins.
Item13974 Update jquery.form to latest upstream version.
Item13976 Update localScroll, scrollTo and serialScroll.
Item13977 Update JQuery maskedInput.
Item13978 Update JQuery masonry and externalize imagesLoaded module.
Item13979 Update jquery.migrate.
Item13980 Update jquery.queryObject.
Item13981 Update jquery.render.
Item13982 Update jquery.sprintf.
Item13983 Update jquery.stars.
Item13984 Update jquery superfish.
Item13985 Update jquery.tabpane.
Item13996 BulkRegistration should process the AddToGroups field.
Item14005 Custom registration needs to pass user template name to email templates.
Item14028 Add jquery-1.12.1 / jquery-2.2.1.
Item14042 Add jquery-1.12.3 / jquery-2.2.3.
Item14047 Simplify the htaccess configuration examples.
Item4992 Work out how to translate Javascript strings.

Foswiki Release 2.1.2 Details

Fixes

Item14061 Non-admin users are unable to refresh the page cache using the refresh query param. It's silently ignored.


Related Topic: ReleaseHistory
Topic revision: r1 - 03 May 2016, UnknownUser

  • User Reference
  • BeginnersStartHere
  • EditingShorthand
  • Macros
  • MacrosQuickReference
  • FormattedSearch
  • QuerySearch
  • DocumentGraphics
  • SkinBrowser
  • InstalledPlugins

  • Admin Maintenance
  • Reference Manual
  • AdminToolsCategory
  • InterWikis
  • ManagingWebs
  • SiteTools
  • DefaultPreferences
  • WebPreferences

This site is powered by FoswikiCopyright © by the contributing authors. All material on this site is the property of the contributing authors.
Ideas, requests, problems regarding Foswiki? Send feedback