ReleaseNotesXWiki10Beta6

Last modified by Thomas Mortagne on 2017/03/24

Release Notes for XWiki 1.0 Beta 6

The 1.0 Beta 6 version is mostly a bug fix release but with several nice enhancements as listed below.

Invalid macro parameters used for the [toc] macro. Cause: [Failed to validate bean: [must be greater than or equal to 1]]. Click on this message for details.

Changes from 1.0 Beta 5

  • Lots of bugs fixed
  • XWiki skins have been renamed using bird names: the old xwiki10b1 is now albatross, the old default skin is now dodo and the old xwiki10 skin is now finch
  • New rename feature to rename pages and all backlinks leading the page to rename. There are some known limitations:
    • backlinks have to be turned on (they are turned on by default but if you have turned them off, rename will not rename backlinks and you'll have to turn them on again to benefit from this feature)
    • backlinks in objects attached to pages are not currently renamed
    • backlinks are saved when a page is saved thus it may happen with a clean XWiki database that backlinks are not saved. In this special case, you can call the following in a page to refresh all links (you'll need to be admin to do this):
$xwiki.refreshLinks()
  • New check box interface for tags. The Tag feature now supports 3 interfaces: a list of tags separated by commas or pipes symbols, a checkbox list of tags to select/unselect and point-and-click list of tags to select/unselect.
  • New Text Analyzer plugin. 
  • Upgraded to Velocity 1.5 final
  • Improved PDF output
  • Rename method renamed from Document.renameDocument() to Document.rename()
  • GraphViz plugin is now off by default and needs to be enabled in xwiki.cfg
  • Added possibility to restrict the possible languages available on a given wiki
  • New Blog panel available that lists all blog categories
  • New footnote macro. In addition the Albatross skin has been modified to display automatically footnotes added with this macro.

See the full list of changes.

Known issues

Migrating from versions prior or equal to XWiki 1.0 Beta 4

This is only for users using a custom web.xml file. We have changed slightly the way to configure XWiki. Namely we have changed the way XWiki is initialized. Before we were initializing Velocity by using the VelocityViewServlet in web.xml. This has been removed and we've added a InitializationServletContextListener class to perform all required XWiki initializations (right now we're only initializing Velocity). Thus you'll need to do the following starting from 1.0 beta 5 onwards:

  1. Remove the VelocityViewServlet from your web.xml
  2. Add the following 2 elements to your web.xml: context-param, listener. Here's an example:
<web-app>
...
 <description>XWiki Application</description>

 <!-- Define context level parameters for XWiki's initialization -->
 <context-param>
   <param-name>org.apache.velocity.properties</param-name>
   <param-value>/WEB-INF/velocity.properties</param-value>
   <description>Velocity's configuration</description>
 </context-param>

 <filter>
...
 </filter-mapping>

 <!-- XWiki's initialization is done in a Servlet Context Listener. This is where we set up
       everything that should be initialized prior to XWiki servicing requests. For example this
       is where we initialize Velocity. -->
 <listener>
   <listener-class>com.xpn.xwiki.web.InitializationServletContextListener</listener-class>
 </listener>

   <servlet>
...

In addition if you're upgrading an existing installation make sure you remove previous version of the Velocity JARs located in xwiki/WEB-INF/lib (Velocity and Velocity-Tools) and replace them with the new versions (Velocity 1.5 Beta 2 and Velocity-Tools 1.3) which can be found in the standalone distribution (the .exe or .tar.gz version)

Make sure you check the additional migration notes for the specific version you're migrating from below.

Migration from 1.0 Beta 2, Beta 3, Beta 4 or Beta 5

  • Start by making a backup of your current database.
  • Plug your new XWiki install to point to your database.

Migration from 1.0 Beta 1

  • Start by making a backup of your current database.
  • Plug your new XWiki install to point to your database.
  • In order to be able to let users switch from "simple" to "advanced" modes, you should import the new XWiki.XWikiUsers and XWiki.XWikiUserSheet pages in your wiki. You can do that by importing the full XAR and then selecting only that page to be imported in the Import tab of the Administration view.
  • You should also reimport the Panels Application since several bugs have been fixed.

Migration from 0.9.x versions

  • Start by making a backup of your current database.
  • Then there are 2 possible use cases:
    • You want to keep your existing skin. In that case, simply install the new version and point it to your existing database.
    • You want to use the new 1.0 skin with your current database. In that case, install the new version and point it to your existing database. Then start XWiki and import the Panels XAR (this is required as the new skin makes use of them). Last, go to your wiki Administration page and in the skin section, enter "xwiki10b1".
  • In order to be able to let users switch from "simple" to "advanced" modes, you should import the new XWiki.XWikiUsers and XWiki.XWikiUserSheet pages in your wiki. You can do that by importing the full XAR and then selecting only that page to be imported in the Import tab of the Administration view.

Contact us on the mailing list if you're experiencing any problem. Just make sure you have your current database backed up before you do anything.

About

About

Support

Platform

User Guide

Admin Guide

Developer Guide

Projects

XWiki

Extensions

Other

Contribute

Status

Practices

Under the Hood

Get Involved

Get Connected