Wiki source code of XWiki Enterprise 2.6

Version 7.1 by Vincent Massol on 2010/11/26

Show last authors
1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
5 XWiki Enterprise 2.6 is a release mostly focused on stabilization but in which we've implemented a redesigned Activity Stream, Share Page by mail feature and Icon/Emoticon support (See the initial [[Roadmap>>enterprise:Main.Roadmap]]).
6
7 = New and Noteworthy (since XWiki Enterprise 2.5) =
8
9 == 1 Activity Stream ==
10
11 * Overhaul of the Recent Changes section of the Dashboard:(((
12 * New UI
13 * Support for more events compared to the previous Recent Changes: annotations, comments, document deletion
14 * It's now called Recent Activity (was called Recent Changes)
15
16 [[image:ReleaseNotes.ReleaseNotesXWikiEnterprise26RC1@activityMacro||style="border: 1px solid black;"]]
17 )))
18
19 == 2 Share Page by Mail ==
20
21 [[image:[email protected]||style="border: 1px solid #000;"]]
22
23 [[image:[email protected]||style="border: 1px solid #000;"]]
24
25 [[image:[email protected]||style="border: 1px solid #000;"]]
26
27 == 3 Icon/Emoticon Support ==
28
29 * Added a syntax in the experimental XWiki Syntax 2.1 for inserting an icon from the [[XWiki Icon Set>>http://www.famfamfam.com/lab/icons/silk/previews/index_abc.png]].(((
30 Usage:
31 {{code language="none"}}image:icon:<icon name>{{/code}}
32 Example:
33 {{code language="none"}}image:icon:accept{{/code}}
34 )))
35 * Added the ability to map characters to an icon in any XWiki Syntax (edit ##xwiki.properties## to modify or add new mappings).(((
36 Default mappings:
37
38 |=Characters|=Result
39 |##{{{:)}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/emoticon_smile.gif]]
40 |##{{{:(}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/emoticon_unhappy.gif]]
41 |##{{{:P}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/emoticon_tongue.gif]]
42 |##{{{:D}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/emoticon_grin.gif]]
43 |##{{{;)}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/emoticon_wink.gif]]
44 |##{{{(y)}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/thumb_up.gif]]
45 |##{{{(n)}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/thumb_down.gif]]
46 |##{{{(i)}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/information.gif]]
47 |##{{{(/)}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/accept.gif]]
48 |##{{{(x)}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/cancel.gif]]
49 |##{{{(!)}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/error.gif]]
50 |##{{{(+)}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/add.gif]]
51 |##{{{(-)}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/delete.gif]]
52 |##{{{(?)}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/help.gif]]
53 |##{{{(on)}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/lightbulb.gif]]
54 |##{{{(off)}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/lightbulb_off.gif]]
55 |##{{{(*)}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/star.gif]]
56 )))
57 * Box Macro's image parameter now support referencing an icon.(((
58 Example:
59 {{code language="none"}}{{box image="icon:accept"}}
60 Some content
61 {{/box}}{{/code}}
62 )))
63
64 == 4 Auto linking of WikiWords ==
65
66 * Added ability to automatically create wiki links on WikiWords.
67
68 {{info}}
69 Not enabled by default, to enable edit ##xwiki.properties##.
70 {{/info}}
71
72 == 5 New Activity Macro ==
73
74 * New [[Activity macro>>code:Macros.ActivityMacro]].
75
76 == 6 Others ==
77
78 * Scheduler jobs can be located in any page in the wiki and not only in the Scheduler space.
79 * Converted [[several Administration application pages>>http://jira.xwiki.org/jira/secure/IssueNavigator.jspa?reset=true&jqlQuery=project+%3D+XAADMINISTRATION+AND+fixVersion+%3D+%221.42%22]] to XWiki Syntax 2.0
80 * Improved livetable performance by [[throttling the requests>>http://ajaxpatterns.org/Submission_Throttling]] sent (one every few milliseconds).
81 * All the translations have been updated
82 * Lots of bug fixes and small improvements (full list in [[JIRA>>http://jira.xwiki.org]])
83
84 == 7 For developers ==
85
86 * Added new event types: add/update/delete comment/annotation/attachment
87 * Added ability to define in ##xwiki.properties## which Rendering Transformations to execute when rendering a document.
88 * Replace Velocity Date Tool by Velocity Date Comparison Tool which offers even more APIs.
89
90 = Known issues =
91
92 * There's a important bug in the Icon Transformation which makes content not rendered properly if there are partial matches followed by an icon match. See [[XWIKI-5729>>http://jira.xwiki.org/jira/browse/XWIKI-5729]]. You can disable the Icon Transformation by editing the ##xwiki.properties## file if it's causing problems for you.
93 * The Send Page by mail feature currently doesn't work on IPv6 systems if your machine is on localhost. To work around this start your container with ##-Djava.net.preferIPv4Stack=true##.
94 * [[Bugs we know about>>http://jira.xwiki.org/jira/secure/IssueNavigator.jspa?reset=true&&type=1&pid=10010&resolution=-1&sorter/field=updated&sorter/order=DESC]]
95
96 = Backward Compatibility and Migration Notes =
97
98 == General Notes ==
99
100 {{warning}}
101 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,...//.
102 {{/warning}}
103
104 You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from the improvements listed above.
105
106 {{warning}}
107 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.
108 {{/warning}}
109
110 == Notes specific to XWiki Enterprise 2.6 ==
111
112 * **The XWiki.XWikiPreferences page must be converted to the xwiki/2.0 syntax**:
113 ** Go to http://yourdomain/xwiki/bin/edit/XWiki/XWikiPreferences?editor=wiki
114 ** Put the following in the content field {{{ {{include document="XWiki.AdminSheet"/}} }}}
115 ** Change the syntax to xwiki/2.0 and press cancel (the automatic conversion would convert fields that must not be converted in the XWikiPreferences object)
116 * The Main.RecentChages page was removed and replaced by Main.Activity
117 * 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##.
118 * 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##.
119
120 == API Breakages ==
121
122 The following APIs were modified since XWiki Enterprise 2.5:
123
124 {{code language="none"}}
125 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
126 ERROR: 7012: org.xwiki.bridge.SkinAccessBridge: Method 'public java.lang.String getIconURL(java.lang.String)' has been added to an interface
127 ERROR: 8001: org.xwiki.component.manager.AbstractComponentDescriptorEvent: Class org.xwiki.component.manager.AbstractComponentDescriptorEvent removed
128 ERROR: 8001: org.xwiki.component.manager.ComponentDescriptorAddedEvent: Class org.xwiki.component.manager.ComponentDescriptorAddedEvent removed
129 ERROR: 8001: org.xwiki.component.manager.ComponentDescriptorEvent: Class org.xwiki.component.manager.ComponentDescriptorEvent removed
130 ERROR: 8001: org.xwiki.component.manager.ComponentDescriptorRemovedEvent: Class org.xwiki.component.manager.ComponentDescriptorRemovedEvent removed
131 ERROR: 8001: org.xwiki.component.manager.ComponentEventManager: Class org.xwiki.component.manager.ComponentEventManager removed
132 ERROR: 8001: org.xwiki.observation.event.ScriptEvaluationFinishedEvent: Class org.xwiki.observation.event.ScriptEvaluationFinishedEvent removed
133 ERROR: 8001: org.xwiki.observation.event.ScriptEvaluationStartsEvent: Class org.xwiki.observation.event.ScriptEvaluationStartsEvent removed
134 ERROR: 7012: org.xwiki.rendering.block.Block: Method 'public org.xwiki.rendering.block.Block getNextSibling()' has been added to an interface
135 ERROR: 7012: org.xwiki.rendering.block.Block: Method 'public org.xwiki.rendering.block.Block getPreviousSibling()' has been added to an interface
136 ERROR: 7012: org.xwiki.rendering.block.Block: Method 'public void removeBlock(org.xwiki.rendering.block.Block)' has been added to an interface
137 ERROR: 7012: org.xwiki.rendering.block.Block: Method 'public void setNextSiblingBlock(org.xwiki.rendering.block.Block)' has been added to an interface
138 ERROR: 7012: org.xwiki.rendering.block.Block: Method 'public void setPreviousSiblingBlock(org.xwiki.rendering.block.Block)' has been added to an interface
139 ERROR: 6001: org.xwiki.rendering.block.NewLineBlock: Removed field NEW_LINE_BLOCK
140 ERROR: 6001: org.xwiki.rendering.block.SpaceBlock: Removed field SPACE_BLOCK
141 ERROR: 7002: org.xwiki.rendering.configuration.RenderingConfiguration: Method 'public java.util.Properties getMacroCategories()' has been removed
142 ERROR: 7012: org.xwiki.rendering.configuration.RenderingConfiguration: Method 'public java.util.List getTransformations()' has been added to an interface
143 ERROR: 6001: org.xwiki.rendering.listener.reference.ResourceType: Removed field IMAGE
144 ERROR: 7002: org.xwiki.rendering.wiki.WikiModel: Method 'public java.lang.String getAttachmentURL(org.xwiki.rendering.listener.reference.ResourceReference)' has been removed
145 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
146 ERROR: 7002: org.xwiki.rendering.scaffolding.MockWikiModel: Method 'public java.lang.String getAttachmentURL(org.xwiki.rendering.listener.reference.ResourceReference)' has been removed
147 {{/code}}

Get Connected