Hide last authors
Marius Dumitru Florea 10.1 1 {{velocity}}
2 $xwiki.ssx.use("ReleaseNotesXWikiEnterprise30M3")
3 {{/velocity}}
Caleb James DeLisle 1.1 5 {{box cssClass="floatinginfobox" title="**Contents**"}}
6 {{toc/}}
7 {{/box}}
9 First milestone of the XWiki Enterprise 3.1 version ([[Roadmap>>Main.Roadmap]]).
11 = New and Noteworthy (since XWiki Enterprise 3.0) =
Caleb James DeLisle 2.1 12 The 3.1 cycle was a cycle full of major foundational reinforcement, what it lacked in eye candy it made up for in building new and better core structure.
Caleb James DeLisle 1.1 13
Caleb James DeLisle 2.1 14 == Fork us on GitHub! ==
15 XWiki Enterprise 3.1M1 is 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!
Sergiu Dumitriu 7.1 17 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.
Marius Dumitru Florea 8.1 19 == PDF Export Options ==
Marius Dumitru Florea 10.1 21 [[image:pdfExportOptions.png||class="screenshot"]]
Marius Dumitru Florea 8.1 22
Marius Dumitru Florea 11.1 23 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.
Marius Dumitru Florea 8.1 25 == Office Document Export ==
Marius Dumitru Florea 10.1 27 [[image:exportAsODT.png||class="screenshot"]]
Marius Dumitru Florea 11.1 29 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.
Caleb James DeLisle 1.1 30
Marius Dumitru Florea 12.1 31 Unfortunately there is a known limitation that we hope to fix in the next milestone: images are not embedded in the exported office document. See [[XWIKI-6583>>http://jira.xwiki.org/jira/browse/XWIKI-6583]] if you want to follow the progress.
Caleb James DeLisle 2.1 33 == Miscellaneous ==
Vincent Massol 5.1 34 * New Success Macro. For example: {{box}}image:icon:tick Success macro, you can access this by writing ~{~{success}}text here~{~{/success}}{{/box}}
Caleb James DeLisle 2.1 35 * Added edit menu for inline editing mode.
36 * Make the attachment mimetype labels translatable
Caleb James DeLisle 4.2 37 * Lots of bug fixes, [[see a full list of issues closed in the 3.1M1 frame>>http://jira.xwiki.org/jira/secure/IssueNavigator!executeAdvanced.jspa?jqlQuery=fixVersion+%3D+%273.1+M1%27&runQuery=true&clear=true]]
Caleb James DeLisle 1.1 38
39 == For developers ==
40 * [[XCOMMONS-4>>http://jira.xwiki.org/jira/browse/XCOMMONS-4]]: Implement support for JSR 330 Annotations
41 * [[XWIKI-6103>>http://jira.xwiki.org/jira/browse/XWIKI-6103]]: Introduce APIs using References for context user
Caleb James DeLisle 2.1 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
Caleb James DeLisle 1.1 44
45 * Various upgrades: yuicompressor-2.4.2 Pygments-1.4 JRuby-1.6 GWT-2.2 GWT-Maven-Plugin-2.2 SmartGWT-2.4 commons-codec-1.5 Groovy-1.7.10
Caleb James DeLisle 2.1 47 == Code Maintenance ==
48 * [[XWIKI-6167>>http://jira.xwiki.org/jira/browse/XWIKI-6167]]: Refactor extension manager as a set of modules.
49 * [[XRENDERING-76>>http://jira.xwiki.org/jira/browse/XRENDERING-76]]: Move XHTML parser/renderer in their own project
50 * [[XWIKI-6186>>http://jira.xwiki.org/jira/browse/XWIKI-6186]]: Retire the deprecated TablePlugin
51 * [[XWIKI-6187>>http://jira.xwiki.org/jira/browse/XWIKI-6187]]: Retire the deprecated PatternPlugin
52 * [[XWIKI-6188>>http://jira.xwiki.org/jira/browse/XWIKI-6188]]: Retire the deprecated TestPlugin
53 * [[XWIKI-6177>>http://jira.xwiki.org/jira/browse/XWIKI-6177]]: Remove deprecated preferences
Caleb James DeLisle 1.1 55 == Translations ==
57 * The following translations have been updated: ##de## ##fr## ##sv##
59 = Known issues =
61 * [[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]]
63 = Test Report =
65 You can check the [[manual test report>>TestReports.ManualTestReportXE31M1]] to learn about what was tested and the results on various browsers.
67 = Backward Compatibility and Migration Notes =
Caleb James DeLisle 2.1 69 == Removed Plugins ==
Caleb James DeLisle 4.3 70 These plugins are very old and were almost never used.
Caleb James DeLisle 2.1 71 Unless your xwiki.cfg file contains one of:
Sergiu Dumitriu 6.2 72
Caleb James DeLisle 2.1 73 * com.xpn.xwiki.plugin.TablePlugin
74 * com.xpn.xwiki.plugin.PatternPlugin
75 * com.xpn.xwiki.plugin.test.TestPlugin
Sergiu Dumitriu 6.2 76
Caleb James DeLisle 2.1 77 You are verifiable unaffected by this change.
Sergiu Dumitriu 6.2 78 These plugins are still available in the [[retired source code repository>>https://svn.xwiki.org/svnroot/xwiki/contrib/retired/]].
Caleb James DeLisle 1.1 79
Caleb James DeLisle 2.1 80 == XWikiPreferences class preferences ==
Sergiu Dumitriu 6.2 81 If you have an existing wiki and you are upgrading to 3.1M1, 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.1M1 XWiki installations.
Caleb James DeLisle 2.1 82 * convertmail
83 * editbox_height
84 * editbox_width
85 * macros_groovy
86 * macros_languages
87 * macros_mapping
88 * macros_velocity
89 * macros_wiki
90 * macros_wiki2
91 * menu
92 * notification_pages
93 * pageWidth
94 * renderXWikiGroovyRenderer
95 * renderXWikiRadeoxRenderer
96 * renderXWikiVelocityRenderer
97 * webbgcolor
Caleb James DeLisle 1.1 99 == General Notes ==
101 {{warning}}
102 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,...//.
103 {{/warning}}
105 You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from the improvements listed above.
107 {{warning}}
108 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.
109 {{/warning}}
111 == API Breakages ==
Caleb James DeLisle 2.1 113 No APIs were modified since XWiki Enterprise 3.0.

Get Connected