Foswiki Release 2.1.0

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

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

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!

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}.

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.

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

Item12067	Removing members via WikiGroups not possible when login name different from WikiName.
Item12569	Sorting in tableplugin is wrong in German.
Item13405	Unicode Normalisation.
Item13699	Mail sending fails when non-latin text in utf8 is being sent.
Item13857	Mac OS X RCS "not found" by configure.
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.
Item13880	TML rendered in head and script zones causes malformed html in WebCreateNewTopic.
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.

The following fixes will also be incorporated into Foswiki 2.0.4

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.
Item13677	regression: extension tabs in configure aren't sorted alphabetically anymore.
Item13860	UploadFilter isn't blocking HTML attachments.
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.
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.
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.
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.
Item13867	bin/upload failed from the command line.
Item13874	Don't encode URLs in links inserted by Upload.

The following enhancements will also be included in Foswiki 2.0.4

Item13553	Add form-definition-table template.
Item13866	Add a file permission fixer script to tools.
Item13914	rewriteshebang should use setlib, don't make user enter -I ../lib.

---

Related Topic: ReleaseHistory