Foswiki Release 1.0.0 - 09 Jan 2009

On this page:

Foswiki - The Free and Open Source Wiki

Foswiki is an enterprise collaboration and information sharing tool targeted for professional use in many types of companies: from small businesses to large organizations.

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.

It is a structured wiki with tools that enables 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 the old TWiki project under a new name. Restrictions on the use of the TWiki brand resulted in many of its developers continuing the project under the new Foswiki name. Foswiki is backwards compatible with all content from older TWiki installations. Foswiki 1.0.0 ships with a TWikiCompatibilityPlugin installed and activated by default, thus enabling most extensions made for TWiki to work under Foswiki. Foswiki is released under the GNU General Public License.

Pre-installed Extensions

Foswiki 1.0.0 is shipped with the following:

New Features Highlights

Security Updates

Foswiki is much more secure than TWiki 4.2.4.

Upgrading From TWiki 4.2

Foswiki is compatible with content of TWiki releases up to and including 4.2, as part of its design.

As part of the creation of the Foswiki project, the Foswiki community is evaluating all of the hundreds of extensions that are available for TWiki. All that are working are ported over to the Foswiki name space. Many of them are being enhanced through the removal of bugs and security vulnerabilities, resulting in better, more functional plugins for Foswiki. The most popular plugins are already ported and more are added every day.

Terminology changes in Foswiki

As part of the first Foswiki product release, various topics and terms were changed to avoid using the TWiki brand name and to more accurately reflect their purpose, including the following:

TWiki term Foswiki term
TWiki variable Macro
preference(s) variable preference setting, or macro when referring to expansion of same
TWiki form Data form
TWiki Plugin Plugin
TWiki Template Skin Template
Topic Template Template Topic
TWiki Markup Language (TML) Topic Markup Language (TML)
TWiki Application Wiki Application

Topic names changed in System web (former TWiki web)

Old name New name
ATasteOfTWiki BeginnersStartHere
TWikiAccessControl AccessControl
TWikiAddOns ContributedAddOns
TWikiContribs Contribs
TWikiContributor ProjectContributor
TWikiCss CascadingStyleSheets
TWikiDocGraphics DocumentGraphics
TWikiDocumentation CompleteDocumentation
TWikiDownload DownloadSources
TWikiEditingShorthand EditingShorthand
TWikiEnhancementRequests EnhancementRequests
TWikiFaqTemplate FaqTemplate
TWikiFAQ FrequentlyAskedQuestions
TWikiForms DataForms
TWikiGlossary GlossaryOfTerms
TWikiHistory ReleaseHistory
TWikiInstallationGuide InstallationGuide
TWikiJavascripts JavascriptFiles
TWikiLogos ProjectLogos
TWikiMetaData MetaData
TWikiPlugins Plugins
TWikiPreferences DefaultPreferences
TWikiReferenceManual ReferenceManual
TWikiRegistration UserRegistration
TWikiReleaseNotes04x02 ReleaseNotes01x00
TWikiRenderingShortcut RenderingShortcut
TWikiScripts CommandAndCGIScripts
TWikiShorthand ShortHand
TWikiSiteTools SiteTools
TWikiSkinBrowser SkinBrowser
TWikiSkins Skins
TWikiSystemRequirements SystemRequirements
TWikiTemplates SkinTemplates
TWikiTemplates TemplateTopics
TWikiTopics TopicsAndWebs
TWikiTutorial TwentyMinuteTutorial
TWikiUpgradeGuide UpgradeGuide
TWikiUserAuthentication UserAuthentication
TWikiUsersGuide UsersGuide
TWikiVariablesQuickStart MacrosQuickStart
TWikiVariables Macros
TWikiWebsTable WebsTable
TWikiRegistrationAgent RegistrationAgent

TWikiPlannedFeatures, TWikiReleaseNotes04x00, TWikiSite, and WhatDoesTWikiStandFor have been removed.

Topic names changed in System web (former TWiki web)

Old name New name
TWikiAdminGroup AdminGroup
TWikiGroupTemplate GroupTemplate
TWikiPreferences SitePreferences
TWikiGroups WikiGroups
TWikiContributor ProjectContributor
TWikiUsers WikiUsers
TWikiGuest WikiGuest
TWikiRegistrationAgent RegistrationAgent
TWikiAdminUser AdminUser

Note that the change from TWikiAdminGroup to AdminGroup has no practical implication when upgrading from TWiki to Foswiki. The topics with an ALLOW setting set to TWikiAdminGroup will still prevent users from accessing or editing and the AdminGroup members can edit anything. You must however make sure the TWikiAdminGroup topic exists in the Main web and that it is protected against editing: when migrating, make sure it is copied over from the old Main web along with all other user and group topics.

When you upgrade from TWiki, copy the old TWikiUsers topic to WikiUsers and manually add the AdminUser, ProjectContributor, and RegistrationAgent users.

Your old Main.TWikiPreferences settings must be copied to the new Main.SitePreferences topic.

Important Changes since TWiki 4.2.3

If this release had been a TWiki release it would have been 4.3.0

Since the fork of Foswiki happened while TWiki 4.2.3 was the current release, all changes since this release are listed below.

Fixes

Item109 Rename all topics that have the T-word in them
Item110 Replace all occurences of TWiki in core, docs and default plugins with System
Item113 Rebrand css classes from twikiXxxxx to foswikiXxxxxx
Item115 Delete ClassicSkin
Item116 Rebrand javascript classes
Item124 undefined ICONTOPIC causes crash
Item125 Search error 'grep for \btest\b failed..
Item128 Error in oopsmore
Item136 remove pattern skin css classes from default skin - replace with twiki* ready for re-brand
Item137 Register show user's a failure when sendmail returns non-zero
Item1607 TOC does not distinguish two headlines that have the same text
Item168 Review all SEARCH statements in the docco & convert to query or more contemporary TML
Item191 remove the stupid kids from pattern skin
Item203 Rebrand the TipsContrib
Item205 Replace all TWiki webnames to System
Item206 Linking to Supplemental Documents
Item212 stop url(http://... something.png) from being made into a html link, so inline images in css style isn't terminal
Item217 Replace module/plugin of message at the top of source files
Item218 Change the links in plugins to foswiki.org
Item221 Change Interwiki links in docs to Foswiki
Item230 lib/CPAN/lib missing in INC path
Item244 nonwikiword is never really checked
Item2525 TablePlugin produces bad links for sorting when using "short" URLs
Item254 add -Autoconf to pseudo-install.pl
Item264 Rebrand pattern skin
Item265 Rebranding EditTablePlugin for Foswiki
Item267 Update file table in plugins that contains TWiki directories
Item273 Rename twiki.tmpl -> foswiki.tmpl
Item295 Replacing TWiki with Foswiki in core docs and default plugins
Item297 viewfile can't be used as a dropin replacement for {pubUrl}, and when viewfile fails it redirects to an oops mess
Item300 Rebranding root-level documentation
Item308 Preview renders a zero byte page when topic uses a view_template
Item309 Checkpoint save fotgets edit_template
Item312 Main.UserForm does not override TWiki.UserForm
Item314 Potential inadvertant linking on registration completion page
Item318 if you have a trailing / on your url, foswiki assumes all preceeding parts of the URL are webnames
Item319 Rewrite all SEARCH's in the distributed topics to use querySearch
Item327 Rebranding TablePlugin
Item328 Rebranding SmiliesPlugin for Foswiki
Item347 Rebranding SpreadSheetPlugin
Item367 Rebranding RenderListPlugin
Item370 Replace the favicon to Foswiki - and make the default setting come from System.ProjectLogos
Item375 Eliminate use of URLPARAM in docs so it becomes an XSS trap
Item384 Improve function getElementsByClassName
Item385 Improve layout attachment button and form header. Add attachment counter
Item391 QUERYPARAMSTRING and TOC only url encodes parameter values but not the names
Item393 Add default safe encoding for QUERYPARAMS and add "safe" type to ENCODE
Item401 OSX fails unit tests - notably UTF8 seg faults.
Item405 ORIGURL used in template login used for example for reset password is an XSS attach vector
Item406 WebSearch does not work with quoted word strings.
Item407 WebRss and Atom search does not work with quotes words
Item417 Undefined subroutine &Foswiki::Users:: ApacheHtpasswdUser::ListIterator called
Item418 Rebranding SlideShowPlugin
Item41 Remove the duplicate TAG topics - like VarREVINFO and VarREVINFO2
Item444 Adding a anchor "foswikiTOC" for the TOC to be able to jump up to it
Item4463 Template Path is wrong for Skin customization using topics
Item462 Improved user interface and interaction on the topic that is shown when a topic does not exist
Item471 WebSearch and WebSearchAdvanced keep moveing the user to the TWiki web, rather than staying where the users asked to be
Item474 PreferencesPlugin does not understand Local
Item4835 SpreadSheetPlugin functions SUBSTITUTE and REPLACE cannot return number 0 or empty string
Item4868 Bulk Register fails if Main web is Set ALLOWWEBCHANGE = TWikiAdminGroup
Item486 Beginners start here has obsolete content
Item4906 Filename of attachments containing a wikiword inside ( ) messes up the file attachment table and other UI
Item491 UserListByPhotograph moved to Image Gallery plugin
Item5006 Interwiki rule: change Bugs: to Foswikitask:, and Rev: to Foswikirev:
Item509 Remove un-needed pub/WebPreferences/logo.gif files which are not used and still TWiki logos
Item510 Wysiwyg editor takes the background colour for the html body for the editor instead of applying a white background.
Item511 Twisty on login screen creates slightly invalid markup
Item5176 %SCRIPTSUFFIX is added twice in TOC links
Item529 fix_local_links needs to point to foswiki.org
Item5350 NONWIKIWORDFLAG is not resolved
Item5351 WebCreateNewTopic filters out international characters
Item5406 Don't let a skin update break existing left bars and top bar
Item541 calling search bin with no empty search string results in white screen instead of response
Item5453 value of "0" improperly handled as param to ENCODE and SPACEOUT
Item5637 Move languages.cache to Working where webserver has permission to write so we can leave Locales read only
Item567 LoginManager not working with IP matching because of code error in Foswiki's interface to CGI::Session
Item569 ENCODE turns the value 0 into empty string ''
Item570 SPACEOUT fails if value or separator are the string 0
Item5848 Number of topics resulting from 2 SEARCH's onthe same topic seems in error (and seems to be duplicated too.
Item5852 Split out operators into seperate modules, so that extensions can plug in new operators.
Item5859 Plugin does not work if using NTLM
Item5900 PatternSkinCustomization and WysiwygPlugin still mention kupu and COMPOSER
Item5910 %TOC variable creates links with unnecessary query string
Item5922 $formfield data not being displayed in formatted searches
Item5926 Topics with Chinese in UTF8 destroys page view in Internet Explorer
Item5937 move initialization of SwitchBoard to TWiki.spec
Item5939 Rogue

below on every topic in every web

Item5943 TWikiRegistrationAgent should be in the admin group
Item5944 The padding:1px for textareas makes it hard to place the cursor at the begining of a line
Item5957 htdigest format password file gets stomped on password or email change/reset
Item5961 WysiwygPlugin and TWiki's odd idea of needing a space before *'s causes user surprise.
Item5965 Document `t' parameter of edit
Item5967 viewfile sees dots in file names as a web separator
Item5979 add non-alarmist PerlOnRedHatIsSlow detection to configure
Item5991 JSCalendarContrib does not work correctly in IE7
Item5994 turn on taint mode in configure and fix the problems
Item599 Get a Foswiki working in Windows with strawberry perl
Item6000 Changes tracked by loginname not wikiname
Item6005 EditTable Changes "label"-formatted cell in unexpected way
Item6006 redirectCgiQuery doesn't handle fragments properly & needs minor tweak
Item6014 Integration of SortedHeadPlugin into core (Process Add To Head Adds)
Item6022 ENCODE{} treats % as safe character
Item6026 With header format emtpy table is initialized with one column only
Item602 Release tarball could be in a subdirectory
Item6031 TablePlugin date sorting is broken.
Item6039 Preview does not respect VIEW_TEMPLATE
Item6041 TinyMCE bug with Firefox 3 and bulleted lists
Item6043 TWiki::Sandbox::sysCommand leads to errors with Extensions.FastCGIEngineContrib
Item6050 statistics script fails when cuid is not == login name (as login is whats in the log files...)
Item6054 No longer possible to have a twisty on one line without linebreak
Item6060 configure's get more extensions seems to require LWP
Item6061 TWiki::Func::getContext docco
Item6062 EditTablePlugin destroys verbatim-tags
Item6066 MailerContrib makes an assumption that cuid == loginname
Item6072 Can't call method "generate" on unblessed reference at lib/TWiki/Plugins/WysiwygPlugin/HTML2TML/Node.pm line 630.
Item6083 configure hostname warning is case sensitive
Item6089 backslash at end of line inside verbatim and pre being used as line continuation
Item6095 Registration confirmation page fails to display when user confirmation e-mail can't be sent
Item6108 add docco for customising the registration emails.
Item629 Unable to access root docs on some installations of Apache.
Item649 Only see TWiki as a valid web if TWikiCompatibilityPlugin is installed and enabled.
Item661 Copy edits to Foswiki release 1.0.0 documentation
Item667 Add WebChangesForAllWebs to System web in the release
Item669 VarADDTOHEAD topic appears to be missing
Item67 Any topic that contains a webform that does not exist, causes the topic to be uneditable.
Item681 can't access system webs like _default
Item8003 TWiki.SmiliesPlugin TOPIC variable not used for images
Item94 SubscribePlugin trips up on missing _alert()

Enhancements

Item39 Add a query search option to webSearchAdvanced
Item4875 Add javascript function 'makeSafeForTableEntry'
Item3647 Usability: Control over variable expansion in topic templates
Item1873 Need Copy topic, not just move and rename
Item381 Add linkclass to style Twisty links
Item5916 Add IsEmpty To IF conditions


Related Topic: ReleaseHistory