XWiki Enterprise 2.6 Release Candidate 1

Last modified by Thomas Mortagne on 2023/10/13
Contents

First release candidate of the XWiki Enterprise 2.6 version (Roadmap).

There are some important bugs in this release:

  • Due to recent changes in the CSS styling, several UI sections are broken on IE browsers:
    • Internet Explorer 6 : Login screen is not visible.
    • Internet Explorer 7 : Bad display of Wiki Preferences, the Comments tab content, the user profile; the Wysiwyg and Class editors cannot be properly used.
  • The new Recent Activity feature fails to display on August, September, and any 8th and 9th of the month.

These issues will be fixed in the next version.

New and Noteworthy (since XWiki Enterprise 2.5)

Revamped Recent Activity Dashboard

  • Overhaul of the Recent Changes section of the Dashboard:
    • New UI
    • Support for more events compared to the previous Recent Changes: annotations, comments, document deletion
    • It's now called Recent Activity (was called Recent Changes)

    activityMacro

Icon/Emoticon Support

  • Added a syntax in the experimental XWiki Syntax 2.1 for inserting an icon from the XWiki Icon Set.

    Usage:
    image:icon:<icon name>
    Example:
    image:icon:accept

  • Added the ability to map characters to an icon in any XWiki Syntax (edit xwiki.properties to modify or add new mappings).

    Default mappings:

    CharactersResult
    :)http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/emoticon_smile.gif
    :(http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/emoticon_unhappy.gif
    :Phttp://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/emoticon_tongue.gif
    :Dhttp://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/emoticon_grin.gif
    ;)http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/emoticon_wink.gif
    (y)http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/thumb_up.gif
    (n)http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/thumb_down.gif
    (i)http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/information.gif
    (/)http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/accept.gif
    (x)http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/cancel.gif
    (!)http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/error.gif
    (+)http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/add.gif
    (-)http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/delete.gif
    (?)http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/help.gif
    (on)http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/lightbulb.gif
    (off)http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/lightbulb_off.gif
    (*)http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/star.gif
  • Box Macro's image parameter now support referencing an icon.

    Example:
    {{box image="icon:accept"}}
    Some content
    {{/box}}

Auto linking of WikiWords

  • Added ability to automatically create wiki links on Wiki Words (not enabled by default, to enable edit xwiki.properties).

New Recent Activity Macro

Miscellaneous

For developers

  • Added new event types: add/update/delete comment/annotation/attachment

    The classes will change package during the 2.6 RC2 release.

  • Added ability to define in xwiki.properties which Rendering Transformations to execute when rendering a document.
  • Replace Velocity Date Tool by Velocity Date Comparison Tool which offers even more APIs.

Known issues

Backward Compatibility and Migration Notes

General Notes

If you're running in a multiwiki setup you'll also need to define the property xwiki.store.migration.databases=all to your xwiki.cfg file or explicitly name all databases to be migrated as in xwiki.store.migration.databases=db1,db2,....

You may also want to import the default wiki XAR in order to benefit from the improvements listed above.

Always make sure you compare your xwiki.cfg file with the newest version since some configuration parameters were added. Note you should add xwiki.store.migration=1 so that XWiki will attempt to automatically migrate your current database to the new schema. Make sure you backup your Database before doing anything.

Notes specific to XWiki Enterprise 2.6 RC1

  • The Main.RecentChages page was removed and replaced by Main.RecentActivity
  • The configuration option controlling the experimental CSRF protection mechanism introduced in 2.5 was changed from core.csrf.enabled to csrf.enabled.  If you are using CSRF protection, make sure to re-enable it by setting csrf.enabled = true in xwiki.properties.
  • The configuration option to define macro categories was changed from rendering.macroCategories to rendering.transformation.macro.categories. If you're using this option make sure you modify its name in xwiki.properties.

API Breakages

The following APIs were modified since XWiki Enterprise 2.5:

ERROR: 7006: org.xwiki.annotation.maintainer.AbstractAnnotationMaintainer: Return type of method 'protected void recomputeProperties(org.xwiki.annotation.Annotation, java.util.Collection, java.lang.String, org.xwiki.annotation.content.AlteredContent, java.lang.String)' has been changed to boolean
ERROR: 7012: org.xwiki.bridge.SkinAccessBridge: Method 'public java.lang.String getIconURL(java.lang.String)' has been added to an interface
ERROR: 7012: org.xwiki.rendering.block.Block: Method 'public org.xwiki.rendering.block.Block getNextSibling()' has been added to an interface
ERROR: 7012: org.xwiki.rendering.block.Block: Method 'public org.xwiki.rendering.block.Block getPreviousSibling()' has been added to an interface
ERROR: 7012: org.xwiki.rendering.block.Block: Method 'public void removeBlock(org.xwiki.rendering.block.Block)' has been added to an interface
ERROR: 7012: org.xwiki.rendering.block.Block: Method 'public void setNextSiblingBlock(org.xwiki.rendering.block.Block)' has been added to an interface
ERROR: 7012: org.xwiki.rendering.block.Block: Method 'public void setPreviousSiblingBlock(org.xwiki.rendering.block.Block)' has been added to an interface
ERROR: 6001: org.xwiki.rendering.block.NewLineBlock: Removed field NEW_LINE_BLOCK
ERROR: 6001: org.xwiki.rendering.block.SpaceBlock: Removed field SPACE_BLOCK
ERROR: 7002: org.xwiki.rendering.configuration.RenderingConfiguration: Method 'public java.util.Properties getMacroCategories()' has been removed
ERROR: 7012: org.xwiki.rendering.configuration.RenderingConfiguration: Method 'public java.util.List getTransformations()' has been added to an interface
ERROR: 6001: org.xwiki.rendering.listener.reference.ResourceType: Removed field IMAGE
ERROR: 8001: org.xwiki.rendering.macro.AbstractMacro: Class org.xwiki.rendering.macro.AbstractMacro removed
ERROR: 8001: org.xwiki.rendering.macro.AbstractNoParameterMacro: Class org.xwiki.rendering.macro.AbstractNoParameterMacro removed
ERROR: 8001: org.xwiki.rendering.macro.Macro: Class org.xwiki.rendering.macro.Macro removed
ERROR: 8001: org.xwiki.rendering.macro.MacroCategoryManager: Class org.xwiki.rendering.macro.MacroCategoryManager removed
ERROR: 8001: org.xwiki.rendering.macro.MacroExecutionException: Class org.xwiki.rendering.macro.MacroExecutionException removed
ERROR: 8001: org.xwiki.rendering.macro.MacroId: Class org.xwiki.rendering.macro.MacroId removed
ERROR: 8001: org.xwiki.rendering.macro.MacroIdFactory: Class org.xwiki.rendering.macro.MacroIdFactory removed
ERROR: 8001: org.xwiki.rendering.macro.MacroLookupException: Class org.xwiki.rendering.macro.MacroLookupException removed
ERROR: 8001: org.xwiki.rendering.macro.MacroManager: Class org.xwiki.rendering.macro.MacroManager removed
ERROR: 8001: org.xwiki.rendering.macro.descriptor.AbstractMacroDescriptor: Class org.xwiki.rendering.macro.descriptor.AbstractMacroDescriptor removed
ERROR: 8001: org.xwiki.rendering.macro.descriptor.ContentDescriptor: Class org.xwiki.rendering.macro.descriptor.ContentDescriptor removed
ERROR: 8001: org.xwiki.rendering.macro.descriptor.DefaultContentDescriptor: Class org.xwiki.rendering.macro.descriptor.DefaultContentDescriptor removed
ERROR: 8001: org.xwiki.rendering.macro.descriptor.DefaultMacroDescriptor: Class org.xwiki.rendering.macro.descriptor.DefaultMacroDescriptor removed
ERROR: 8001: org.xwiki.rendering.macro.descriptor.DefaultParameterDescriptor: Class org.xwiki.rendering.macro.descriptor.DefaultParameterDescriptor removed
ERROR: 8001: org.xwiki.rendering.macro.descriptor.MacroDescriptor: Class org.xwiki.rendering.macro.descriptor.MacroDescriptor removed
ERROR: 8001: org.xwiki.rendering.macro.descriptor.ParameterDescriptor: Class org.xwiki.rendering.macro.descriptor.ParameterDescriptor removed
ERROR: 8001: org.xwiki.rendering.macro.parameter.MacroParameterException: Class org.xwiki.rendering.macro.parameter.MacroParameterException removed
ERROR: 8001: org.xwiki.rendering.macro.parameter.ParameterValueTooHighException: Class org.xwiki.rendering.macro.parameter.ParameterValueTooHighException removed
ERROR: 8001: org.xwiki.rendering.macro.parameter.ParameterValueTooLowException: Class org.xwiki.rendering.macro.parameter.ParameterValueTooLowException removed
ERROR: 8001: org.xwiki.rendering.transformation.MacroTransformationContext: Class org.xwiki.rendering.transformation.MacroTransformationContext removed
ERROR: 7002: org.xwiki.rendering.wiki.WikiModel: Method 'public java.lang.String getAttachmentURL(org.xwiki.rendering.listener.reference.ResourceReference)' has been removed
ERROR: 7012: org.xwiki.rendering.wiki.WikiModel: Method 'public java.lang.String getLinkURL(org.xwiki.rendering.listener.reference.ResourceReference)' has been added to an interface
ERROR: 7002: org.xwiki.rendering.macro.box.AbstractBoxMacro: Method 'public org.xwiki.component.manager.ComponentManager getComponentManager()' has been removed
ERROR: 7002: org.xwiki.rendering.macro.box.AbstractBoxMacro: Method 'protected org.xwiki.rendering.parser.Parser getSyntaxParser(org.xwiki.rendering.transformation.MacroTransformationContext)' has been removed
ERROR: 7006: org.xwiki.rendering.macro.box.BoxMacroParameters: Return type of method 'public java.lang.String getImage()' has been changed to org.xwiki.rendering.listener.reference.ResourceReference
ERROR: 7005: org.xwiki.rendering.macro.box.BoxMacroParameters: Parameter 1 of 'public void setImage(java.lang.String)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
ERROR: 7002: org.xwiki.rendering.scaffolding.MockWikiModel: Method 'public java.lang.String getAttachmentURL(org.xwiki.rendering.listener.reference.ResourceReference)' has been removed

About

About

Support

Platform

User Guide

Admin Guide

Developer Guide

Projects

XWiki

Extensions

Other

Contribute

Status

Practices

Under the Hood

Get Involved

Get Connected