Introduction

TWiki-5.0.0 released on 2010-05-29 is a major release introducing usability enhancements, feature enhancements, and adds extensions to strengthen TWiki as an enterprise collaboration platform.

New Features Highlights

• Security Enhancements
  • Configure script requires authentication to reduce exposure of internal system settings.
  • The twiki root directory is no longer HTML doc enabled, reducing the odds of exposing data due to webserver misconfiguration.
• Usability Enhancements
  • New TopMenuSkin with pulldown menus for better usability and corporate/modern look&feel.
  • Attach multiple files at once, useful when attaching many files.
  • Pre-installed TagMePlugin, useful to tag topics to quickly access content in a large TWiki.
  • Upgraded TinyMCEPlugin to latest TinyMCE 3.2.4.1 for better WYSIWYG editing experience.

• TWiki Application Platform Enhancements
  • Pre-installed JQueryPlugin, adding a lightweight cross-browser JavaScript library designed to simplify the client-side scripting of HTML.
  • Improvements to ENCODE, IF, URLPARAM, WEB and WEBLIST variables.
• Search Enhancements
  • Query syntax with array size, useful to query TWiki forms and attachments.
  • Query syntax can be used in format parameter of search, giving more control over formatting.
• Miscellaneous Feature Enhancements
  • Adding 51 new TWikiDocGraphics icons, and 11 updated icons.
  • The TWiki doc graphics library is now aware of image size and is cached for speed.

• Plugin Enhancements
  • SpreadSheetPlugin: Improvements to $TIME() and $NOP() functions.

• • HeadlinesPlugin: New touch parameter in HEADLINES variable to alert users via e-mail notification of news updates
  • API: New TWiki::Func::buildWikiWord function

See the full list of new features and bug fixes further below.

Pre-installed Extensions

• Plugins: CommentPlugin, EditTablePlugin, EmptyPlugin, HeadlinesPlugin, InterwikiPlugin, JQueryPlugin, PreferencesPlugin, RenderListPlugin, SlideShowPlugin, SmiliesPlugin, SpreadSheetPlugin, TablePlugin, TinyMCEPlugin, TagMePlugin, TWikiNetSkinPlugin, TwistyPlugin, WysiwygPlugin
• Contribs: BehaviourContrib, JSCalendarContrib, MailerContrib, TipsContrib, TWikiUserMappingContrib, TwistyContrib
• Skins: ClassicSkin, PatternSkin, TopMenuSkin, TWikiNetSkin,

Note: JQueryPlugin, TagMePlugin and TopMenuSkin are new in TWiki-5.0.0.

Deprecation Notices

• From TWiki 5.0 on, the ClassicSkin is deprecated and will be removed in a future release.

• From TWiki 4.2 on, the %MAINWEB% and %TWIKIWEB% variables have been deprecated. For compatibility reasons they are unlikely to ever be removed completely, but you should use the %USERSWEB% and %SYSTEMWEB% variables instead.

• From TWiki 4.2 on, functions TWiki::Func::getOopsUrl and TWiki::Func::permissionsSet have been declared deprecated. There is no plan to remove them yet.

• From TWiki 4.0 on, the syntax "* Set DENYTOPICVIEW = " (nothing) in a topic means deny noone. Even if ALLOWTOPICVIEW is set to people or group setting DENYTOPICCHANGE to nothing means allow anyone. You have to remove the DENYTOPICVIEW or comment it out to have the ALLOWTOPICVIEW working. The reason for this behavior is that it enables limiting access to an entire web by setting a blank DENYTOPICVIEW setting. Same rule applies for DENYTOPICCHANGE and DENYTOPICRENAME. The rule does not apply for access rights defined for webs. Ie. "*Set DENYWEBCHANGE = " does not allow anyone to edit topics in the web. There has been strong oppinions against the syntax "* Set DENYTOPICXXXX = " meaning giving all access. So please be warned that we will change the syntax to a more transparent and logical syntax in future but we will ensure that it is still possible to secure a web and open up individual topics in future also.

Notes for TWiki Administrators and Wiki Champions

Upgrade From Earlier Releases

Follow the TWikiUpgradeGuide to install TWiki and migrate data from your existing TWiki.

The new TopMenuSkin adds pulldown menus for better usability and corporate/modern look&feel. This skin is based on the PatternSkin, which used the WebLeftBar in each web for navigation. The TopMenuSkin has a new WebTopBar that defines the menu structure in each web. A default menu is shown in case WebTopBar is missing, so you do not need to add a WebTopBar topic to all your existing webs. See TopMenuSkin#WebSpecific instructions in case you need a customized menu structure in a web.

TWiki-5.0.0 Major Release - Details

Enhancements

TWikibug:Item2756	Log viewfile activity
TWikibug:Item2927	Topic moved message too visible
TWikibug:Item4875	Add javascript function 'makeSafeForTableEntry'
TWikibug:Item5916	Add isempty operator to IF Variable
TWikibug:Item5936	Rename twiki script to twiki_cgi
TWikibug:Item6014	Integration of SortedHeadPlugin into core TWiki
TWikibug:Item6246	Security: twiki root directory should not be exposed as html doc root
TWikibug:Item6315	HeadlinesPlugin: New touch parameter for HEADLINES variable
TWikibug:Item6334	TinyMCEPlugin: Upgrade plugin to latest TinyMCE 3.2.4.1
TWikibug:Item6364	SpreadSheetPlugin: SpreadSheetPlugin Nop Function Enhancement
TWikibug:Item6365	Forms: Forms Should Evaluate the Size Field

TWikibug:Item6385	Func/Plugins/Renderer: New TWiki::Func::buildWikiWord Function
TWikibug:Item6393	TWikiUserMappingContrib: Ability to pre-populate TWiki registration form fields with URL parameters
TWikibug:Item6396	Query syntax with array size for TWiki forms and attachments
TWikibug:Item6397	Query syntax in search format: $query(...)
TWikibug:Item6403	ENCODE and URLPARAM Variables with new "moderate" encoding
TWikibug:Item6404	URLPARAM with $br and $n variables in newline parameter
TWikibug:Item6410	configure: Access control of configure script: Configuration only after authentication
TWikibug:Item6413	TopMenuSkin: Initial version of TopMenuSkin with pulldown menus for better usability and corporate/modern look&feel
TWikibug:Item6424	Format Parameter for WEB variable
TWikibug:Item6425	Support Updated Universal Wiki Edit Button
TWikibug:Item6428	MANIFEST: Add TopMenuSkin and JQueryPlugin to distribution
TWikibug:Item6429	WEBLIST variable with limit parameter
TWikibug:Item6436	JQueryPlugin: Rename too generic JQueryPlugin variables
TWikibug:Item6441	Multiple File Upload Feature to TWiki
TWikibug:Item6450	Docs: Simplify site map: Keep SITEMAPWHAT setting and remove SITEMAPUSETO setting
TWikibug:Item6451	Docs: Add recent changes box to every WebHome
TWikibug:Item6453	PatternSkin: Don't use red color in topic action, implies red-links
TWikibug:Item6462	Define background color variables in TWikiPreferences
TWikibug:Item6472	SpreadSheetPlugin: Support DOY (Day of Year) in time parsing of TIME function
TWikibug:Item6473	MANIFEST: Add TagMePlugin to 5.0 distribution

Fixes

TWikibug:Item3030	TWiki::Func::saveAttachment saves a lot of garbage in META
TWikibug:Item3379	BuildScripts: TWiki tarball violates unwritten packaging standard
TWikibug:Item5241	Docs: Document log action of renameweb, viewfile, changepasswd, renamepasswd in TWikiSiteTools topic
TWikibug:Item5295	Use inline CSS instead of font tag to avoid malformed HTML for common user input
TWikibug:Item5803	Make the trunk/core a first class 'contrib' that can be built separately from its normal release INCLUDEs
TWikibug:Item5965	Docs: Document 't' parameter of edit
TWikibug:Item6012	POST data lost without previous login (query cache mechanism not 100%)
TWikibug:Item6088	WysiwygPlugin: The Perl modules do not have fully qualified names and wrong convention/or error in the name of the file/module name.
TWikibug:Item6259	Docs: Prevent GUI-based rename of TWiki web and Main web
TWikibug:Item6267	FORMFIELD expands $title to field name if $title exists in field value
TWikibug:Item6276	CommentPlugin: Cannot specify percentBRpercent for newline value
TWikibug:Item6300	Trash topic: New topic name "Web/SubwebTopicName" is not a WikiWord
TWikibug:Item6313	HeadlinesPlugin: Non-forgiving element matching "link"
TWikibug:Item6324	EditTablePlugin: Editing table 1 removes EDITCELL tag from the other table
TWikibug:Item6331	WYSIWYG mode destroys CSS code
TWikibug:Item6354	TwistyPlugin: Unexpected behaviour using TWISTY on a VARCACHEd page
TWikibug:Item6366	TinyMCEPlugin: %RED% - colors syntax lost while WYSYWYG editor used to save the topics
TWikibug:Item6372	TWikiUserMappingContrib: More robust WikiWord build in TWikiRegistration
TWikibug:Item6378	Plugin API: Issues with beforeSaveAttachment plugin dispatch
TWikibug:Item6379	Configure: Correct a configure bug where a defined empty string '' is converted into 'NOT SET'
TWikibug:Item6386	PatternSkin: breadcrumb shows improper topic if used in top bar
TWikibug:Item6398	Registration fails if Main web locked down due to UserForm not accessible
TWikibug:Item6399	Diff page shows author as "Main.FirstLast", should be "FirstLast" with link
TWikibug:Item6401	TWikiUserMappingContrib: ASSERT prevents TWiki::Users::TWikiUserMapping from being subclassed
TWikibug:Item6405	TablePlugin: Table sorting incorrect for numbers with decimal places
TWikibug:Item6406	TablePlugin: Table sorting incorrect for negative numbers
TWikibug:Item6414	TablePlugin: Column with ISO dates does not sort properly
TWikibug:Item6416	PatternSkin: Only Two Pages Print in FF 3.6
TWikibug:Item6417	TWikiUserMapping: LDAP users can't login if UserMappingManager 'TWiki::Users::TWikiUserMapping' is used
TWikibug:Item6426	Add Universal Wiki Edit Button logo to Edit Button
TWikibug:Item6430	Topic action buttons point to included topic instead of current topic
TWikibug:Item6438	%META with new topic parameter; fix for %META using current web.topic scope, but base topic's meta data
TWikibug:Item6443	Docs: Document ! in Regular Expressions docs
TWikibug:Item6448	Installed Plugins list should link to disabled plugins.
TWikibug:Item6454	configure: Configure script fails if twiki/lib in non-standard location
TWikibug:Item6466	configure: Garbled configure screen after showing error message
TWikibug:Item6469	In access denied message, TWikiAdminGroup links to current web instead of Main web
TWikibug:Item6474	MailerContrib: mailnotify fails due to non-existing _alert method

TWiki Release 5.0.0 (Helsinki), 2010-05-29

Introduction

TWiki-5.0.0 released on 2010-05-29 is a major release introducing usability enhancements, feature enhancements, and adds extensions to strengthen TWiki as an enterprise collaboration platform.

It is highly recommended to upgrade to TWiki-5.0.0. Users will find this release much more stable and secure in daily use.

New Features Highlights

• Security Enhancements
  • Configure script requires authentication to reduce exposure of internal system settings.
  • The twiki root directory is no longer HTML doc enabled, reducing the odds of exposing data due to webserver misconfiguration.
• Usability Enhancements
  • New TopMenuSkin with pulldown menus for better usability and corporate/modern look&feel.
  • Attach multiple files at once, useful when attaching many files.
  • Pre-installed TagMePlugin, useful to tag topics to quickly access content in a large TWiki.
  • Upgraded TinyMCEPlugin to latest TinyMCE 3.2.4.1 for better WYSIWYG editing experience.
• TWiki Application Platform Enhancements
  • Pre-installed JQueryPlugin, adding a lightweight cross-browser JavaScript library designed to simplify the client-side scripting of HTML.
  • Improvements to ENCODE, IF, URLPARAM, WEB and WEBLIST variables.
• Search Enhancements
  • Query syntax with array size, useful to query TWiki forms and attachments.
  • Query syntax can be used in format parameter of search, giving more control over formatting.
• Miscellaneous Feature Enhancements
  • Adding 51 new TWikiDocGraphics icons, and 11 updated icons.
  • The TWiki doc graphics library is now aware of image size and is cached for speed.
• Plugin Enhancements
  • SpreadSheetPlugin: Improvements to $TIME() and $NOP() functions.
  • HeadlinesPlugin: New touch parameter in HEADLINES variable to alert users via e-mail notification of news updates
  • API: New TWiki::Func::buildWikiWord function

See the full list of new features and bug fixes further below.

Pre-installed Extensions

TWiki-5.0.0 ships with:

• Plugins: CommentPlugin, EditTablePlugin, EmptyPlugin, HeadlinesPlugin, InterwikiPlugin, JQueryPlugin, PreferencesPlugin, RenderListPlugin, SlideShowPlugin, SmiliesPlugin, SpreadSheetPlugin, TablePlugin, TinyMCEPlugin, TagMePlugin, TWikiNetSkinPlugin, TwistyPlugin, WysiwygPlugin
• Contribs: BehaviourContrib, JSCalendarContrib, MailerContrib, TipsContrib, TWikiUserMappingContrib, TwistyContrib
• Skins: ClassicSkin, PatternSkin, TopMenuSkin, TWikiNetSkin,

Note: JQueryPlugin, TagMePlugin and TopMenuSkin are new in TWiki-5.0.0.

Deprecation Notices

• From TWiki 5.0 on, the ClassicSkin is deprecated and will be removed in a future release.

• From TWiki 4.2 on, the %MAINWEB% and %TWIKIWEB% variables have been deprecated. For compatibility reasons they are unlikely to ever be removed completely, but you should use the %USERSWEB% and %SYSTEMWEB% variables instead.

• From TWiki 4.2 on, functions TWiki::Func::getOopsUrl and TWiki::Func::permissionsSet have been declared deprecated. There is no plan to remove them yet.

• From TWiki 4.0 on, the syntax "* Set DENYTOPICVIEW = " (nothing) in a topic means deny noone. Even if ALLOWTOPICVIEW is set to people or group setting DENYTOPICCHANGE to nothing means allow anyone. You have to remove the DENYTOPICVIEW or comment it out to have the ALLOWTOPICVIEW working. The reason for this behavior is that it enables limiting access to an entire web by setting a blank DENYTOPICVIEW setting. Same rule applies for DENYTOPICCHANGE and DENYTOPICRENAME. The rule does not apply for access rights defined for webs. Ie. "*Set DENYWEBCHANGE = " does not allow anyone to edit topics in the web. There has been strong oppinions against the syntax "* Set DENYTOPICXXXX = " meaning giving all access. So please be warned that we will change the syntax to a more transparent and logical syntax in future but we will ensure that it is still possible to secure a web and open up individual topics in future also.

Notes for TWiki Administrators and Wiki Champions

Upgrade From Earlier Releases

Follow the TWikiUpgradeGuide to install TWiki and migrate data from your existing TWiki.

The new TopMenuSkin adds pulldown menus for better usability and corporate/modern look&feel. This skin is based on the PatternSkin, which used the WebLeftBar in each web for navigation. The TopMenuSkin has a new WebTopBar that defines the menu structure in each web. A default menu is shown in case WebTopBar is missing, so you do not need to add a WebTopBar topic to all your existing webs. See TopMenuSkin#WebSpecific instructions in case you need a customized menu structure in a web.

TWiki-5.0.0 Major Release - Details

TWiki-5.0.0 was built from SVN http://svn.twiki.org/svn/twiki/branches/TWikiRelease05x00 revision r18860 (2010-05-29)

Enhancements

TWikibug:Item2756	Log viewfile activity
TWikibug:Item2927	Topic moved message too visible
TWikibug:Item4875	Add javascript function 'makeSafeForTableEntry'
TWikibug:Item5916	Add isempty operator to IF Variable
TWikibug:Item5936	Rename twiki script to twiki_cgi
TWikibug:Item6014	Integration of SortedHeadPlugin into core TWiki
TWikibug:Item6246	Security: twiki root directory should not be exposed as html doc root
TWikibug:Item6315	HeadlinesPlugin: New touch parameter for HEADLINES variable
TWikibug:Item6334	TinyMCEPlugin: Upgrade plugin to latest TinyMCE 3.2.4.1
TWikibug:Item6364	SpreadSheetPlugin: SpreadSheetPlugin Nop Function Enhancement
TWikibug:Item6365	Forms: Forms Should Evaluate the Size Field
TWikibug:Item6380	TWiki.TWikiDocGraphics: TWiki Doc Graphics: Adding search path, icon size defined in topics, adding cache
TWikibug:Item6381	TWiki.TWikiDocGraphics: 51 new TWiki Doc Graphics images for TWiki 5.0.0
TWikibug:Item6385	Func/Plugins/Renderer: New TWiki::Func::buildWikiWord Function
TWikibug:Item6393	TWikiUserMappingContrib: Ability to pre-populate TWiki registration form fields with URL parameters
TWikibug:Item6396	Query syntax with array size for TWiki forms and attachments
TWikibug:Item6397	Query syntax in search format: $query(...)
TWikibug:Item6403	ENCODE and URLPARAM Variables with new "moderate" encoding
TWikibug:Item6404	URLPARAM with $br and $n variables in newline parameter
TWikibug:Item6410	configure: Access control of configure script: Configuration only after authentication
TWikibug:Item6413	TopMenuSkin: Initial version of TopMenuSkin with pulldown menus for better usability and corporate/modern look&feel
TWikibug:Item6424	Format Parameter for WEB variable
TWikibug:Item6425	Support Updated Universal Wiki Edit Button
TWikibug:Item6428	MANIFEST: Add TopMenuSkin and JQueryPlugin to distribution
TWikibug:Item6429	WEBLIST variable with limit parameter
TWikibug:Item6436	JQueryPlugin: Rename too generic JQueryPlugin variables
TWikibug:Item6441	Multiple File Upload Feature to TWiki
TWikibug:Item6450	Docs: Simplify site map: Keep SITEMAPWHAT setting and remove SITEMAPUSETO setting
TWikibug:Item6451	Docs: Add recent changes box to every WebHome
TWikibug:Item6453	PatternSkin: Don't use red color in topic action, implies red-links
TWikibug:Item6462	Define background color variables in TWikiPreferences
TWikibug:Item6472	SpreadSheetPlugin: Support DOY (Day of Year) in time parsing of TIME function
TWikibug:Item6473	MANIFEST: Add TagMePlugin to 5.0 distribution

Fixes

TWikibug:Item3030	TWiki::Func::saveAttachment saves a lot of garbage in META
TWikibug:Item3379	BuildScripts: TWiki tarball violates unwritten packaging standard
TWikibug:Item5241	Docs: Document log action of renameweb, viewfile, changepasswd, renamepasswd in TWikiSiteTools topic
TWikibug:Item5295	Use inline CSS instead of font tag to avoid malformed HTML for common user input
TWikibug:Item5803	Make the trunk/core a first class 'contrib' that can be built separately from its normal release INCLUDEs
TWikibug:Item5965	Docs: Document 't' parameter of edit
TWikibug:Item6012	POST data lost without previous login (query cache mechanism not 100%)
TWikibug:Item6088	WysiwygPlugin: The Perl modules do not have fully qualified names and wrong convention/or error in the name of the file/module name.
TWikibug:Item6259	Docs: Prevent GUI-based rename of TWiki web and Main web
TWikibug:Item6267	FORMFIELD expands $title to field name if $title exists in field value
TWikibug:Item6276	CommentPlugin: Cannot specify percentBRpercent for newline value
TWikibug:Item6300	Trash topic: New topic name "Web/SubwebTopicName" is not a WikiWord
TWikibug:Item6313	HeadlinesPlugin: Non-forgiving element matching "link"
TWikibug:Item6324	EditTablePlugin: Editing table 1 removes EDITCELL tag from the other table
TWikibug:Item6331	WYSIWYG mode destroys CSS code
TWikibug:Item6354	TwistyPlugin: Unexpected behaviour using TWISTY on a VARCACHEd page
TWikibug:Item6366	TinyMCEPlugin: %RED% - colors syntax lost while WYSYWYG editor used to save the topics
TWikibug:Item6372	TWikiUserMappingContrib: More robust WikiWord build in TWikiRegistration
TWikibug:Item6378	Plugin API: Issues with beforeSaveAttachment plugin dispatch
TWikibug:Item6379	Configure: Correct a configure bug where a defined empty string '' is converted into 'NOT SET'
TWikibug:Item6386	PatternSkin: breadcrumb shows improper topic if used in top bar
TWikibug:Item6398	Registration fails if Main web locked down due to UserForm not accessible
TWikibug:Item6399	Diff page shows author as "Main.FirstLast", should be "FirstLast" with link
TWikibug:Item6401	TWikiUserMappingContrib: ASSERT prevents TWiki::Users::TWikiUserMapping from being subclassed
TWikibug:Item6405	TablePlugin: Table sorting incorrect for numbers with decimal places
TWikibug:Item6406	TablePlugin: Table sorting incorrect for negative numbers
TWikibug:Item6414	TablePlugin: Column with ISO dates does not sort properly
TWikibug:Item6416	PatternSkin: Only Two Pages Print in FF 3.6
TWikibug:Item6417	TWikiUserMapping: LDAP users can't login if UserMappingManager 'TWiki::Users::TWikiUserMapping' is used
TWikibug:Item6426	Add Universal Wiki Edit Button logo to Edit Button
TWikibug:Item6430	Topic action buttons point to included topic instead of current topic
TWikibug:Item6438	%META with new topic parameter; fix for %META using current web.topic scope, but base topic's meta data
TWikibug:Item6443	Docs: Document ! in Regular Expressions docs
TWikibug:Item6448	Installed Plugins list should link to disabled plugins.
TWikibug:Item6454	configure: Configure script fails if twiki/lib in non-standard location
TWikibug:Item6466	configure: Garbled configure screen after showing error message
TWikibug:Item6469	In access denied message, TWikiAdminGroup links to current web instead of Main web
TWikibug:Item6474	MailerContrib: mailnotify fails due to non-existing _alert method

Related Topic: TWikiHistory, TWikiInstallationGuide, TWikiUpgradeGuide