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

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

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