Last modified by Thomas Mortagne on 2023/10/13

Show last authors
1 {{box cssClass="floatinginfobox" title="**Contents**"}}{{toc/}}{{/box}}
2
3 The highlights of this release are: the ability to annotate text in a document, a Color Theme visual editor and the ability to require anonymous users to solve a CAPTCHA before adding a comment to a document.
4
5 = New and Noteworthy (since XWiki Enterprise 2.2.5) =
6
7 == Annotations ==
8
9 The scope of this feature is to allow users to annotate text in a XWiki document. With the new feature you can:
10
11 * Make annotations by selecting the text and pressing ##Ctrl + M (Meta + M)##
12 (((
13 image:[email protected]
14 )))
15 * Show annotations on your page
16 (((
17 image:[email protected]
18 )))
19 * See an annotation for a text item by hovering over the yellow icon next to it
20 (((
21 image:[email protected]
22 )))
23 * Edit and delete annotations straight from the page
24 (((
25 image:[email protected]
26 )))
27 * Manage annotations from the "Annotations" tab
28 (((
29 image:[email protected]
30 )))
31
32 You can find a more detailed description of the annotations feature on the [[documentation page>>Documentation.UserGuide.Features.Annotations]].
33
34 == Color Theme Editor ==
35
36 The new editor allows fast and easy modifications for the look and feel of the wiki. You'll find in this editor
37
38 * A new way of displaying themes on the "Color Themes" space home
39 (((
40 image:[email protected]
41 )))
42 * The ability to create a new theme from the "Color Theme" space home
43 (((
44 image:[email protected]
45 )))
46 * A palette for each area you are editing with a popup listing everything you can customize at this level
47 (((
48 image:[email protected]
49 )))
50 * A dialog where you can make the desired changes
51 (((
52 image:[email protected]
53 )))
54 * The possibility to undo the latest modifications or reset all changes
55
56 Read more about Color Themes on the dedicated [[application page>>extensions:Extension.Color Theme Application]].
57
58 == Anonymous commenting with Captcha ==
59
60 Now thanks to the [[captcha module>>extensions:Extension.Captcha Module]] you can require unregistered users to solve a captcha in order to post comments. To require guests to solve a captcha simply go to the "Rights" section of the [[Administration Application>>extensions:Extension.Administration Application]] for the wiki or just the space, and check the box saying "Require unregistered users to solve a captcha when posting a comment on a page". **Note** This box does not give guests permission to comment, it only adds a requirement for commenting if they already have permission.
61 [[This feature is documented here.>>Documentation.AdminGuide.Configuration]]
62 Sample:
63
64 [[image:[email protected]||width=550px; style="border:1px solid black;]]
65
66 == Easier development of configurable applications using [[XWiki.ConfigurableClass>>extensions:Extension.Administration Application#HMakingyourapplicationeasilyconfigurablewithConfigurableClass28SinceEnterprise2.3M129]] ==
67
68 If you are developing an application and you need to provide your users with a way to configure it from the [[Administration Application>>extensions:Extension.Administration Application]] you are in luck. All you need to do is create a custom class holding all of the configuration for your application, then add an object of your custom configuration class and an object of ##XWiki.Configurable## class. You will be able to configure your application from the administration interface.
69 The following is an image of the administration interface with additional applications to be configured (you can customize the icon used).
70
71 [[image:ReleaseNotes.ReleaseNotesXWikiEnterprise23M1@AdministrationPanelExtraIcons.png||width=550px; style="border:1px solid black;]]
72
73 Note the current user does not have permission to edit one of the configurable applications.
74
75 == Miscellaneous ==
76
77 * Email addresses can now be modified from the user profile
78 * Lots of bug fixes
79
80 == Dependencies upgrade ==
81
82 * Upgrade to Pygments 1.3.1
83 * Upgrade to Groovy 1.7.2
84
85 = Known issues =
86
87 * [[Bugs we know about>>https://jira.xwiki.org/secure/IssueNavigator.jspa?reset=true&&type=1&pid=10010&resolution=-1&sorter/field=updated&sorter/order=DESC]]
88
89 = Backward Compatibility and Migration Notes =
90
91 == Important non-compatible changes ==
92
93 {{warning}}TODO{{/warning}}
94
95 == General Notes ==
96
97 {{warning}}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 <tt>xwiki.store.migration.databases=db1,db2,...//.{{/warning}}
98
99 You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from the improvements listed above. In case you don't want to reimport all the pages at least the following pages should be imported (+ the pages listed below in the Migration notes):
100 * Main.WebSearch
101 * Main.LuceneSearch
102 * XWiki.LiveTableResults*
103 * Blog.* (except the Blog.WebPreferences if you've made some changes to it. You can also exclude Blog.BlogIntroduction)
104
105 {{warning}}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.{{/warning}}
106
107 == Migration Notes ==
108
109 * Standalone/inline Macro parsing has been fixed.(((
110 {{error}}
111 There has been a [[bug>>https://jira.xwiki.org/browse/XWIKI-5050]] that appeared when we released the new XWiki Syntax 2.0 several releases back and which we've finally fixed in this release. Basically if you had a macro followed by a new line and then another macro, both macros were considered as being standalone. This is now fixed and they are correctly considered by the parser as inline. More specifically if you were previously using a standalone macro (such as the TOC macro or the HTML macro) and your macro wasn't separated from a previous macro by at least 2 new lines, it'll now fail to render.
112
113 In addition, several pages that are part of the XWiki Enterprise default XAR were not written correctly and didn't have these 2 new lines as mentioned above. We've fixed these pages too but you'll need to make sure you import them in your existing wiki (if you're upgrading) since otherwise these pages will fail to display correctly. These pages are:
114 * Main.RecentChanges
115 * Main.AllDocs
116 * XWiki.Tableview
117 * XWiki.Treeview
118 * XWiki.AllAttachments
119 * XWiki.OrphanedPages
120 * XWiki.DeletedDocuments
121 * XWiki.DeletedAttachments
122 * XWiki.XWikiUserPreferencesSheet
123 * Sandbox.WebHome
124 {{/error}}
125 )))
126 * Header id generation changed a bit and more special characters are now allowed in id names: hyphens ("-"), underscores ("_"), colons (":"), and periods (".") are not filtered anymore. This means that some bookmarks will stop pointing to the right section.
127 * Non-parametrized searches containing backslashes (\) will no longer work on some databases (eg: HSQLDB). For security and to support special characters ' and \ it is recommended that you pass strings as parameters.

Get Connected