Version 25.1 by Thomas Mortagne on 2011/06/22

Show last authors
1 {{velocity}}
2 $xwiki.ssx.use("ReleaseNotesXWikiEnterprise30M3")
3 {{/velocity}}
4
5 {{box cssClass="floatinginfobox" title="**Contents**"}}
6 {{toc/}}
7 {{/box}}
8
9 This is the final release of XWiki Enterprise 3.1 ([[Roadmap>>Main.Roadmap]]). Over the course of the 3.1 cycle there were a few new features added and a lot of improvements in stability, code quality, and build practice. These release notes are compounded from the release notes from each release in the 3.1 cycle.
10
11 = New & Noteworthy (Since XWiki Enterprise 3.0) =
12
13 == PDF Export Options ==
14
15 [[image:pdfExportOptions.png||class="screenshot"]]
16
17 If you export a wiki page to PDF using the //Export// menu you'll get a panel where you can configure some PDF export options. These options are defined in the PDF velocity templates and were previously available only as query string parameters to the PDF export URL.
18
19 == Office Document Export ==
20
21 [[image:exportAsODT.png||class="screenshot"]]
22
23 If you configure your wiki to work with an office server ([[LibreOffice>>http://www.libreoffice.org/]] or [[OpenOffice>>http://www.openoffice.org/]]) as described in the [[Office Importer Application>>http://extensions.xwiki.org/xwiki/bin/view/Extension/Office+Importer+Application]] you'll notice a new entry in the export menu (as long as you are connected to the office server). By default only the ODT ([[OpenDocument>>http://opendocument.xml.org/]] Text format) export is exposed but you can tweak the export URL to export to other office formats supported by your office server. For instance ##/xwiki/bin/export/Sandbox/WebHome?format=doc## exports Sandbox.WebHome page to Microsoft Word's proprietary DOC format.
24
25 == Auto Watch ==
26
27 Starting with 3.1 an automatic watch is enabled. That mean that each time a user do a major modification to a document or create one it's automatically added it the user watchlist. That way it's easy to follow future contribution to a document in which we are involved on.
28
29 See http://extensions.xwiki.org/xwiki/bin/view/Extension/Watchlist+Application#HAutoWatch for more.
30
31 == Fork us on GitHub! ==
32
33 XWiki Enterprise 3.1 was the first version to be released from our new repository on github. We decided that git was sufficiently advanced over svn, our old version control system, that it warranted the effort spent to convert. If you are a developer who uses git then you already know what this means to you, you can participate in the XWiki development process by **forking** (git speak for copying) the source repository rather than being forced to provide patches to the benevolent committers who will accept or reject your patches at their pleasure. If you want to make something great but there's a part of the XWiki core which is holding you up, you can go right ahead and fork it into your own repository where you can fix it and share the results. We are excited to learn what you will create!
34
35 As a consequence, the structure of the repositories, the version numbers of the applications, plugins and build tools, as well as the structure of the projects on the [[issue tracker>>http://jira.xwiki.org/]] have changed. We moved all the plugins and applications inside the platform core, releasing them all together. This is also reflected in the issue tracker, where all the individual projects for each extension disappeared, since applications are now jira components inside the XWiki Platform project. This means that the version number confusion will stop, since everything has the same release version.
36
37 == For developers ==
38
39 * [[XCOMMONS-4>>http://jira.xwiki.org/jira/browse/XCOMMONS-4]]: Implement support for JSR 330 Annotations
40 * [[XCOMMONS-10>>http://jira.xwiki.org/jira/browse/XCOMMONS-10]]: Add support for injecting Logger with @Inject. Now you can have the XWiki Commons logging implementation inserted into your module using dependency injection.
41 * [[XWIKI-6103>>http://jira.xwiki.org/jira/browse/XWIKI-6103]]: Introduce APIs using References for context user
42 * [[XWIKI-6213>>http://jira.xwiki.org/jira/browse/XWIKI-6213]]: Add custom properties to extensions
43 * [[XWIKI-6563>>http://jira.xwiki.org/jira/browse/XWIKI-6563]]: Provide statistic information about clustered nodes
44
45 == Code Maintenance ==
46
47 * [[XWIKI-6167>>http://jira.xwiki.org/jira/browse/XWIKI-6167]]: Refactor extension manager as a set of modules.
48 * [[XRENDERING-76>>http://jira.xwiki.org/jira/browse/XRENDERING-76]]: Move XHTML parser/renderer in their own project
49 * [[XWIKI-6186>>http://jira.xwiki.org/jira/browse/XWIKI-6186]]: Retire the deprecated TablePlugin
50 * [[XWIKI-6187>>http://jira.xwiki.org/jira/browse/XWIKI-6187]]: Retire the deprecated PatternPlugin
51 * [[XWIKI-6188>>http://jira.xwiki.org/jira/browse/XWIKI-6188]]: Retire the deprecated TestPlugin
52 * [[XWIKI-6177>>http://jira.xwiki.org/jira/browse/XWIKI-6177]]: Remove deprecated preferences
53
54 == Upgrades ==
55
56 * [[XWiki now requires Java 6!>>http://jira.xwiki.org/jira/browse/XWIKI-5607]]
57 * [[Upgrade JGroups to latest version 2.12.1>>http://jira.xwiki.org/jira/browse/XWIKI-4769]]
58 * [[Upgrade to Groovy 1.8>>http://jira.xwiki.org/jira/browse/XWIKI-6571]]
59 * [[Upgrade to commons-net-3.0>>http://jira.xwiki.org/jira/browse/XCOMMONS-12]]
60 * [[Move from Commons Logging/Log4J to SLF4J/Logback>>http://jira.xwiki.org/jira/browse/XCOMMONS-9]]
61 * [[Upgrade to hibernate-validator 4.1.0.Final>>http://jira.xwiki.org/jira/browse/XE-924]]
62 * [[Upgrade yuicompressor to version 2.4.2>>http://jira.xwiki.org/jira/browse/XWIKI-6148]]
63 * [[Upgrade Pygments to verson 1.4>>http://jira.xwiki.org/jira/browse/XWIKI-6162]]
64 * [[Upgrade to JRuby 1.6>>http://jira.xwiki.org/jira/browse/XWIKI-6166]]
65 * [[Upgrade to GWT 2.2, GWT Maven Plugin 2.2 and SmartGWT 2.4>>http://jira.xwiki.org/jira/browse/XWIKI-6565]]
66 * [[Upgrade to commons-codec 1.5>>http://jira.xwiki.org/jira/browse/XCOMMONS-6]]
67
68 == Miscellaneous ==
69
70 * New Success Macro. For example: {{box}}image:icon:tick Success macro, you can access this by writing ~{~{success}}text here~{~{/success}}{{/box}}
71 * [[XWIKI-6518>>http://jira.xwiki.org/jira/browse/XWIKI-6518]]: Added edit menu for inline editing mode.
72 * [[XWIKI-6174>>http://jira.xwiki.org/jira/browse/XWIKI-6174]]: Make the attachment mimetype labels translatable
73 * [[XWIKI-116>>http://jira.xwiki.org/jira/browse/XWIKI-116]]: Added the ability to dictate what mode documents should be edited in by default on a document by document basis.
74 * [[XWIKI-6599>>http://jira.xwiki.org/jira/browse/XWIKI-6599]]: Support for suggestion sources to provide custom icon/images for individual result entry
75 * Lots of bug fixes, [[see a full list of issues closed in the 3.1 development cycle>>http://jira.xwiki.org/jira/secure/IssueNavigator!executeAdvanced.jspa?jqlQuery=fixVersion+%3D+%273.1+M1%27+or+fixVersion+%3D+%273.1M2%27+or+fixVersion+%3D+%273.1+RC1%27+or+fixVersion+%3D+%273.1%27&runQuery=true&clear=true]].
76
77 == Translations ==
78
79 * The translations for ##ca##, ##cs##, ##se##, ##es##, ##fr##, ##gl##, ##it##, ##lv##, ##nl##, ##pt##, ##ro##, ##ru##, ##sk##, ##sv##, ##si##, ##uk##, ##zh##, ##zh_TW## were updated.
80
81 = Known issues =
82
83 * [[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]]
84
85 = Test Report =
86
87 You can check the [[manual test report>>TestReports.ManualTestReportXE31]] to learn about what was tested and the results on various browsers.
88
89 = Backward Compatibility and Migration Notes =
90
91 == Java 1.6 ==
92
93 XWiki Enterprise 3.1 Milestone 2 and all subsequent versions will be compiled with Java6, Java5 is no longer supported.
94
95 == Deprecated XClass database tables removed ==
96
97 In [[XWIKI-6624>>http://jira.xwiki.org/jira/browse/XWIKI-6624]] a set of database tables and their supporting infrastructure were removed. These tables held XWiki Class information but since XWiki 1.0, the table method of storage has been deprecated and non-default. If upgrading from a pre-1.0 version of XWiki, it is important to make sure you are using the XML XWiki class storage and not the database tables first.
98
99 == WYSIWYG Editor Configuration ==
100
101 In order to implement [[XWIKI-6618>>http://jira.xwiki.org/jira/browse/XWIKI-6618]] we changed the format of the menu bar configuration. If you exclude the ##XWiki.WysiwygEditorConfig## page when you upgrade your wiki pages (which you should do in order to preserve your WYSIWYG editor configuration) then you have to:
102
103 1. edit the ##XWiki.WysiwygEditorConfig## page with the object editor
104 1. remove deprecated properties (you have to do this because we changed the type of the //Menu Bar// property to accommodate the new format)
105 1. change the value of the //Menu Bar// property to use the following JSON format:(((
106 {{code}}
107 [{
108 "feature" : "link",
109 "subMenu" : ["linkEdit", "linkRemove", "linkWikiPage", "linkAttachment", "|", "linkWebPage", "linkEmail"]
110 },
111 {
112 "feature" : "image",
113 "subMenu" : ["imageInsertAttached", "imageInsertURL", "imageEdit", "imageRemove"]
114 },
115 {
116 "feature" : "table",
117 "subMenu" : ["inserttable", "insertcolbefore", "insertcolafter", "deletecol", "|", "insertrowbefore", "insertrowafter", "deleterow", "|", "deletetable"]
118 },
119 {
120 "feature" : "macro",
121 "subMenu" : ["macroInsert", "macroEdit", "|", "macroRefresh", "|", "macroCollapse", "macroExpand"]
122 },
123 {
124 "feature" : "import",
125 "subMenu" : ["importOffice"]
126 }]
127 {{/code}}
128 )))
129
130 If importing ##XWiki.WysiwygEditorConfig## or ##XWiki.WysiwygEditorConfigTemplate## fails then you have to follow this steps in order to update the WYSIWYG editor configuration:
131
132 1. Open ##XWiki.WysiwygEditorConfig## and ##XWiki.WysiwygEditorConfigTemplate## in the object editor, and remove the ##XWiki.WysiwygEditorConfigClass## objects from them
133 1. Open ##XWiki.WysiwygEditorConfigClass## page in the class editor, delete the ##menuBar## property, and add it again as a //String// property
134 1. Open ##XWiki.WysiwygEditorConfig## and ##XWiki.WysiwygEditorConfigTemplate## in the object editor, add and then remove again an object of type ##XWiki.WysiwygEditorConfigClass##
135 1. Import the ##XWiki.WysiwygEditorConfigClass##, ##XWiki.WysiwygEditorConfig## and ##XWiki.WysiwygEditorConfigTemplate## pages from the upgrade XAR
136
137 If you didn't try and failed to import these documents already, it's simpler to just delete ##XWiki.WysiwygEditorConfig## and ##XWiki.WysiwygEditorConfigTemplate## first, then continue with a normal import.
138
139 == Removed Plugins ==
140
141 These plugins are very old and were almost never used.
142 Unless your xwiki.cfg file contains one of:
143
144 * com.xpn.xwiki.plugin.TablePlugin
145 * com.xpn.xwiki.plugin.PatternPlugin
146 * com.xpn.xwiki.plugin.test.TestPlugin
147
148 You are verifiably unaffected by this change.
149 These plugins are still available in the [[retired source code repository>>https://svn.xwiki.org/svnroot/xwiki/contrib/retired/]].
150
151 == XWikiPreferences class preferences ==
152
153 If you have an existing wiki and you are upgrading to 3.1, you will **not** experience any changes. If you are installing a new wiki, the following preferences will not be available to the XWikiPreferences or WebPreferences objects. If you are a developer of an XWiki based application which depended on one of these settings, you will need to upgrade your application to make it compatible with new 3.1 XWiki installations.
154
155 * convertmail
156 * editbox_height
157 * editbox_width
158 * macros_groovy
159 * macros_languages
160 * macros_mapping
161 * macros_velocity
162 * macros_wiki
163 * macros_wiki2
164 * menu
165 * notification_pages
166 * pageWidth
167 * renderXWikiGroovyRenderer
168 * renderXWikiRadeoxRenderer
169 * renderXWikiVelocityRenderer
170 * webbgcolor
171
172 == General Notes ==
173
174 {{warning}}
175 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,...//.
176 {{/warning}}
177
178 You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from the improvements listed above.
179
180 {{warning}}
181 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.
182 {{/warning}}
183
184 == API Breakages ==
185
186 No APIs were modified since XWiki Enterprise 3.0.

Get Connected