Release Notes for XWiki 1.0 Beta 5

Release Notes for XWiki 1.0 Beta 5

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

Changes from 1.0 Beta 4

• Lots of bugs fixed
• Added support for parametrizing document resource bundles (See internationalizing XWiki applications)
• Upgrade to Velocity 1.5 Beta 2 and Velocity Tools 1.3 (Velocity 1.5 Beta 2 release notes)
• Security: prevents instantiating random classes in Velocity
• Improved user profile sheet
• Add Calendar interface to edit and delete events
• Charting plugin is functional again
• Made Calendar and User profiles use Microformats (hCard and hCalendar)
• Allow putting Velocity code in CSS and Javascript skin files
• Improved Calendar plugin
• Store the panel state (expanded/collapsed) for each user
• Experimental: Backend implementation for rename (renames the document + all backlinks). There's no GUI yet (planned for Beta 6). To try it out, you can call the following in Velocity:

$xwiki.getDocument("Space1.MyPageToRename").renameDocument("Space2.MyNewName")

See the full list of changes.

Known issues

• Bugs we know about
• If you follow the procedure for Installing the XWiki WAR manually and XAR importing, Administration -> Preferences screen will contain just labels without editable fields, due to XAR import bug. To solve it, open object editor for XWikiPreferences (e.g. http://localhost:8080/xwiki/bin/edit/XWiki/XWikiPreferences?editor=object) and assign XWikiPreferences class. Default values could be copied from standalone installation.

Migrating from any previous version

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

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 or Beta 4

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