Wiki source code of Release Notes for XWiki 5.2
Version 12.1 by Marius Dumitru Florea on 2013/10/02
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{box cssClass="floatinginfobox" title="**Contents**"}} | ||
| 2 | {{toc/}} | ||
| 3 | {{/box}} | ||
| 4 | |||
| 5 | This is the release notes for [[XWiki Commons>>http://commons.xwiki.org]], [[XWiki Rendering>>http://rendering.xwiki.org]], [[XWiki Platform>>http://platform.xwiki.org]] and [[XWiki Enterprise>>http://enterprise.xwiki.org]]. They share the same release notes as they are released together and have the same version. | ||
| 6 | |||
| 7 | {{warning}} | ||
| 8 | **The support of XWiki Enterprise Manager is stopped**. XWiki Enterprise now comes with the ability to create (sub)wikis by default, see below. | ||
| 9 | {{/warning}} | ||
| 10 | |||
| 11 | <insert description of release here> | ||
| 12 | |||
| 13 | = New and Noteworthy (since XWiki 5.1) = | ||
| 14 | |||
| 15 | [[Full list of issues fixed and Dashboard for 5.2>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=11602]]. | ||
| 16 | |||
| 17 | == Multi-wiki Support == | ||
| 18 | |||
| 19 | XWiki Enterprise comes now with the ability for users to create their own wikis (a.k.a subwikis) without the need to install additional extensions. This supersedes the notion of "workspace" and consists in the integration of the [[Workspace Application>>extensions:Extension.Workspace Application]] in the default XWiki distribution. | ||
| 20 | |||
| 21 | {{image reference="ReleaseNotesXWiki52M2@add-wiki.png"/}} | ||
| 22 | |||
| 23 | This new menu entry appears only if a wiki template is created first, see below. | ||
| 24 | |||
| 25 | === Wiki Creation Right === | ||
| 26 | |||
| 27 | The wiki creation is now possible for users who have the "createwiki" right. This right is only available for the main wiki users, exactly like the Programming Right. | ||
| 28 | |||
| 29 | === Wikis Administration Section === | ||
| 30 | |||
| 31 | A new section is available in the administration of the main wiki. In this section, you can enable the wiki creation feature by creating a wiki template. It also manages who has the right to create new wikis. | ||
| 32 | |||
| 33 | {{image reference="ReleaseNotesXWiki52M2@admin-wikis.png"/}} | ||
| 34 | |||
| 35 | === Wiki Creation Wizard === | ||
| 36 | |||
| 37 | A new wizard for the creation of a new wiki is now available from the "Add" menu. | ||
| 38 | |||
| 39 | {{image reference="ReleaseNotesXWiki52M2@createwiki1.png"/}} | ||
| 40 | |||
| 41 | {{image reference="ReleaseNotesXWiki52M2@createwiki2.png"/}} | ||
| 42 | |||
| 43 | === Home Menu === | ||
| 44 | |||
| 45 | A new top level menu is available when there is more than one wiki. | ||
| 46 | |||
| 47 | {{image reference="ReleaseNotesXWiki52RC1@mainwiki-homemenu.png"/}} | ||
| 48 | |||
| 49 | {{image reference="ReleaseNotesXWiki52RC1@workspace-homemenu.png"/}} | ||
| 50 | |||
| 51 | The "main wiki" (the first you have when you start a new instance) is now called "**Home**". | ||
| 52 | |||
| 53 | == Solr-based Search Suggest == | ||
| 54 | |||
| 55 | Starting with this version the [[search suggest>>doc:extensions:Extension.Search Application||anchor="HSearchSuggest"]] feature takes into account the configured search engine. To achieve this we added a new property to ##SearchSuggestSourceClass## that specifies the search engine used by the source. We also created a search suggest service based on Solr and we added search suggest sources that mimic the behaviour of the existing Lucene-based sources. As a result, the search suggest feature is now using Solr by default (as Solr is the default search engine starting with 5.1). | ||
| 56 | |||
| 57 | We also improved the search suggest administration section | ||
| 58 | |||
| 59 | {{image reference="ReleaseNotesXWiki52M2@searchSuggestAdminSection.png"/}} | ||
| 60 | |||
| 61 | and we simplified the source creation form. | ||
| 62 | |||
| 63 | {{image reference="ReleaseNotesXWiki52M2@searchSuggestSourceForm.png"/}} | ||
| 64 | |||
| 65 | The live search now displays a message when there are no results. | ||
| 66 | |||
| 67 | {{image reference="ReleaseNotesXWiki52RC1@liveSearch-noResults.png"/}} | ||
| 68 | |||
| 69 | == Distribution Wizard Step to Upgrade All Wikis == | ||
| 70 | |||
| 71 | We added a new step to the [[Distribution Wizard>>doc:platform:Features.DistributionWizard]] to update the default set of wiki pages on each of the existing wikis. This step is triggered only if you choose to upgrade the entire farm in the "Upgrade Mode" step. | ||
| 72 | |||
| 73 | {{image reference="ReleaseNotesXWiki52RC1@dw-wikisStep.png" width="600px"/}} | ||
| 74 | |||
| 75 | == Active Installs Tracking == | ||
| 76 | |||
| 77 | It' very important for the open source committers to understand how well or how badly they're faring when developing the XWiki open source project. So far we didn't know if the number of people using XWiki was increasing, decreasing or staying stable. This module allows us to know who's using XWiki. | ||
| 78 | |||
| 79 | It does the following: | ||
| 80 | |||
| 81 | * A client side JAR is bundled with XWiki and it sends a ping with data once per day | ||
| 82 | * A server side Application is installed on xwiki.org, allowing us to query the data sent and to display a counter of Active Installs of XWiki (i.e. installs for which we've received a ping in the last N days, for example at least one ping in the past month). | ||
| 83 | |||
| 84 | The data sent is anonymous and consists of the following: | ||
| 85 | |||
| 86 | * A unique id (UUID) representing the XWiki instance. Note that not even the IP is kept and there's no way to find who's having a give UUID (it's generated using Java's UUID implementation) | ||
| 87 | * The date of the ping | ||
| 88 | * The XWiki distribution id (e.g. ##org.xwiki.enterprise:xwiki-enterprise-web##) | ||
| 89 | * The version of your XWiki distribution (e.g. ##5.2##) | ||
| 90 | * The technical ids and versions of extensions you have installed. | ||
| 91 | |||
| 92 | This will allow us to present the following data: | ||
| 93 | |||
| 94 | * Number of total installs of XWiki | ||
| 95 | * Number of Active Installs | ||
| 96 | * Most used extensions across versions of XWiki | ||
| 97 | * How frequently the XWiki user base upgrades to newer versions of XWiki | ||
| 98 | |||
| 99 | {{image reference="ReleaseNotesXWiki52M2@stats.png"/}} | ||
| 100 | |||
| 101 | {{info}} | ||
| 102 | In the near future we'll offer a UI feature to opt-out (in the Administration pages) but at the moment if you wish to opt-out (please don't, we need your help, knowing who's using us and that it's growing is what keeps us motivated to continue developing XWiki!), then simply remove the ##WEB-INF/lib/xwiki-platform-activeinstalls*## JAR and restart. | ||
| 103 | {{/info}} | ||
| 104 | |||
| 105 | Reference documentation: | ||
| 106 | |||
| 107 | * [[Client side module>>extensions:Extension.Active Installs Client API]]. | ||
| 108 | * [[Server side module>>extensions:Extension.Active Installs Server Application]]. | ||
| 109 | |||
| 110 | == Toggle Email Address Obfuscation == | ||
| 111 | |||
| 112 | The email configuration section in the [[Administration>>doc:extensions:Extension.Administration Application]] now has an option to enable/disable the obfuscation of the email addresses that are stored in object properties of [[type Email>>ReleaseNotes.ReleaseNotesXWiki42||anchor="HNewfieldtypesforemailandlistofpages"]]. The obfuscation is done by displaying only the first letter of the email account, e.g. //a...@domain.org//, the rest of the letters being replaced by an ellipsis. Email obfuscation is off by default. | ||
| 113 | |||
| 114 | {{image reference="ReleaseNotesXWiki52M1@generalEmailSettings.png"/}} | ||
| 115 | |||
| 116 | == Markdown Syntax 1.1 == | ||
| 117 | |||
| 118 | We've added [[version 1.1 of the Rendering Syntax for Markdown>>rendering:Main.Markdown11]], adding support for: | ||
| 119 | |||
| 120 | * Macros | ||
| 121 | * Superscript and subscript | ||
| 122 | * (X)HTML improvements | ||
| 123 | |||
| 124 | == Export Large Wikis as XARs == | ||
| 125 | |||
| 126 | It's possible to enable the use of new [[WikiStream>>doc:extensions:Extension.Wiki Stream Module]] framework in standard export action (use in the standard export UI for example). Among other things it allows exporting a wiki of pretty much any size. | ||
| 127 | |||
| 128 | [[WikiStream>>doc:extensions:Extension.Wiki Stream Module]] is too young to be enabled by default and will require heavy testing. In the meantime you can try it by uncommenting {{code}}# xwiki.action.export.xar.usewikistream=1{{/code}} at the end of xwiki.cfg file. | ||
| 129 | |||
| 130 | == Miscellaneous == | ||
| 131 | |||
| 132 | * {{id name="userVerticalMenu"/}}The user profile menu is now consistent with the administration menu.((( | ||
| 133 | {{image reference="ReleaseNotesXWiki52M1@userProfile.png"/}} | ||
| 134 | ))) | ||
| 135 | * The ##line## [[chart>>doc:extensions:Extension.Chart Macro]] type has two parameters, ##hideShapes## and ##hideLines##, to hide the shapes used to display the data points or to hide the interpolation lines that connect the data points.((( | ||
| 136 | {{image reference="ReleaseNotesXWiki52M2@lineWithoutShapes.png"/}} | ||
| 137 | ))) | ||
| 138 | * When creating or editing a [[template provider>>doc:extensions:Extension.Administration Application||anchor="HCreatethetemplateprovider"]] the template name field is now mandatory.((( | ||
| 139 | {{image reference="ReleaseNotesXWiki52M2@templateNameMandatory.png"/}} | ||
| 140 | ))) | ||
| 141 | * The checkboxes for the global rights settings are now displayed on the left of their labels.((( | ||
| 142 | {{image reference="ReleaseNotesXWiki52RC1@RightsAdministration-CheckboxOnTheLeft.png"/}} | ||
| 143 | ))) | ||
| 144 | * The blog application is now packaged by default in the Home wiki only (not in new wikis). | ||
| 145 | * The "Create a new wiki" link has been removed from the wiki index. Now, you can only use the //Add > Wiki// menu. | ||
| 146 | * The Distribution Wizard does not appear anymore just after creating a new wiki based on the default template. | ||
| 147 | |||
| 148 | See the [[full list of JIRA issues>>http://jira.xwiki.org/sr/jira.issueviews:searchrequest-printable/temp/SearchRequest.html?jqlQuery=project+in+%28XCOMMONS%2C+XRENDERING%2C+XWIKI%2C+XE%29+and+status+%3D+Closed+and+resolution+%3D+Fixed+and+fixVersion+in+%28%225.2-milestone-1%22%2C+%225.2-milestone-2%22%2C+%225.2-rc-1%22%2C+%225.2%22%29&tempMax=1000]] fixed in this release. | ||
| 149 | |||
| 150 | = For Developers = | ||
| 151 | |||
| 152 | == <developer feature N> == | ||
| 153 | |||
| 154 | <description of developer feature N> | ||
| 155 | |||
| 156 | == Deprecated and Retired projects == | ||
| 157 | |||
| 158 | * Google plugin (##com.xpn.xwiki.plugin.google.GooglePlugin##) has been retired, you can find it on https://github.com/xwiki-contrib/retired/tree/master/xwiki-platform-google-plugin | ||
| 159 | |||
| 160 | == Upgrades == | ||
| 161 | |||
| 162 | The following dependencies have been upgraded: | ||
| 163 | |||
| 164 | * Aether 0.9.0.M2 (moved from org.sonatype.aether to org.eclipse.aether) | ||
| 165 | * CSSParser 0.9.9 | ||
| 166 | * [[Groovy 2.1.7>>http://jira.xwiki.org/browse/XCOMMONS-445]] | ||
| 167 | * [[HSQLDB 2.3.0>>http://jira.xwiki.org/browse/XE-1323]] | ||
| 168 | * Infinispan 5.3 | ||
| 169 | * JGroups 3.3.4 | ||
| 170 | * Maven 3.1.0 | ||
| 171 | * Tika 1.4 | ||
| 172 | * Xerces2-Java 2.11.0 | ||
| 173 | |||
| 174 | == Miscellaneous == | ||
| 175 | |||
| 176 | * Added support for custom facets in Solr search API | ||
| 177 | * New [[Instance Module>>extensions:Extension.Instance Module]] used to compute a unique id for each XWiki instance (used by the [[Active Installs Client API>>extensions:Extension.Active Installs Client API]] | ||
| 178 | * The way to declare the type supported by a ##org.xwiki.properties.converter.Converter## component changed from role hint to generic type. See [[Properties Module documentation>>extensions:Extension.Properties Module||anchor="HConvertercomponent28Recommended29"]] for more details. The old way is still supported for retro-compatibility. | ||
| 179 | * Added DocumentReference and EntityReference property converters which makes possible to: | ||
| 180 | ** use them in rendering macros parameters beans (see [[How to write a macro>>rendering:Main.ExtendingMacro||anchor="HMacroCode"]]) | ||
| 181 | ** in Velocity pass a String directly to a method requiring a DocumentReference or EntityReference | ||
| 182 | * Added new API to the JODA Time plugin to get an ISO8601 formatter. | ||
| 183 | |||
| 184 | = Translations = | ||
| 185 | |||
| 186 | The following translations have been updated: | ||
| 187 | |||
| 188 | {{language codes="ca, cs, da, de, es, fr, gl, it, ko, lv, nl, pl, pt, pt_BR, ro, ru, sk, sv, uk, vi, zh, zh_TW"/}} | ||
| 189 | |||
| 190 | = Tested Browsers & Databases = | ||
| 191 | |||
| 192 | {{include reference="TestReports.ManualTestReportTemplateSummary"/}} | ||
| 193 | |||
| 194 | = Known issues = | ||
| 195 | |||
| 196 | * [[Bugs we know about>>http://jira.xwiki.org/secure/IssueNavigator.jspa?reset=true&jqlQuery=category+%3D+%22Top+Level+Projects%22+AND+issuetype+%3D+Bug+AND+resolution+%3D+Unresolved+ORDER+BY+updated+DESC]] | ||
| 197 | |||
| 198 | = Backward Compatibility and Migration Notes = | ||
| 199 | |||
| 200 | == General Notes == | ||
| 201 | |||
| 202 | You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from all the improvements listed above. | ||
| 203 | |||
| 204 | {{warning}} | ||
| 205 | Always make sure you compare your ##xwiki.cfg## and ##xwiki.properties## files with the newest version since some configuration parameters were added. Note that 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. | ||
| 206 | {{/warning}} | ||
| 207 | |||
| 208 | == Solr Index Format Change == | ||
| 209 | |||
| 210 | If you're upgrading from XWiki 4.5.x to this version you'll need to perform a full re-indexation when using the Solr Search. This because in XWiki 4.5.x the Solr search was experimental and we've completely changed the indexing format in XWiki 5.1. | ||
| 211 | |||
| 212 | == Email Address Obfuscation == | ||
| 213 | |||
| 214 | In [[4.2>>ReleaseNotes.ReleaseNotesXWiki42||anchor="HNewfieldtypesforemailandlistofpages"]] we introduced a new object property type called Email that can be used to store email addresses. In [[5.1>>ReleaseNotes.ReleaseNotesXWiki51||anchor="HUseremail"]] we decided to use this new property type in the user profile to store the user email address. With this change we also introuced a defaut custom displayer for the Email property type that obfuscates the email address in view mode. As a consequence the user profile email address became obfuscated by default. Starting with 5.2 we allow you to toggle the email address obfuscation from the administration. What is important to know is that the email address obfuscation is off by default. So if you upgrade from 5.1 and you want to preserve the obfuscation then you need to enable it from the administration. | ||
| 215 | |||
| 216 | == Instance Identifier == | ||
| 217 | |||
| 218 | XWiki now creates a unique identifier in the database (this is used by the new Active Installs module and will be used in the future by the Extension Manager to identify your instance for example). You need to verify that your ##hibernate.cfg.xml## file has the following mapping definition next to the existing mapping definitions: | ||
| 219 | |||
| 220 | ((( | ||
| 221 | {{code}} | ||
| 222 | ... | ||
| 223 | <mapping resource="instance.hbm.xml"/> | ||
| 224 | ... | ||
| 225 | {{/code}} | ||
| 226 | ))) | ||
| 227 | |||
| 228 | == API Breakages == | ||
| 229 | |||
| 230 | The following APIs were modified since XWiki 5.1: | ||
| 231 | |||
| 232 | * Moved to ##xwiki-commons-legacy-properties## | ||
| 233 | |||
| 234 | {{code language="none"}} | ||
| 235 | org.xwiki.properties.converter.AbstractCollectionConverter: Class org.xwiki.properties.converter.AbstractCollectionConverter removed | ||
| 236 | {{/code}} | ||
| 237 | |||
| 238 | * This method should never have existed | ||
| 239 | |||
| 240 | {{code language="none"}} | ||
| 241 | org.xwiki.rendering.listener.reference.ResourceType: Method 'public void setScheme(java.lang.String)' has been removed | ||
| 242 | {{/code}} | ||
| 243 | |||
| 244 | * Moved from ##xwiki-rendering-api## to ##xwiki-rendering-xml## | ||
| 245 | |||
| 246 | {{code language="none"}} | ||
| 247 | org.xwiki.rendering.renderer.printer.XHTMLWikiPrinter: Class org.xwiki.rendering.renderer.printer.XHTMLWikiPrinter removed | ||
| 248 | org.xwiki.rendering.renderer.printer.XMLWikiPrinter: Class org.xwiki.rendering.renderer.printer.XMLWikiPrinter removed | ||
| 249 | {{/code}} | ||
| 250 | |||
| 251 | * This field is not meant to be be modified, the final was just forgotten. | ||
| 252 | |||
| 253 | {{code language="none"}} | ||
| 254 | com.xpn.xwiki.XWikiContext: Field TYPE_PROVIDER is now final | ||
| 255 | {{/code}} | ||
| 256 | |||
| 257 | * Not an API. This should be internal. | ||
| 258 | |||
| 259 | {{code language="none"}} | ||
| 260 | com.xpn.xwiki.store.XWikiHibernateBaseStore: Method 'protected java.lang.String[] addHibernateSequenceIfRequired(java.lang.String[], java.lang.String, org.hibernate.Session)' has been removed | ||
| 261 | {{/code}} | ||
| 262 | |||
| 263 | * Has been moved to ##xwiki-platform-feed-api## since it was the only module using it. We also dropped jTidy in favor of HTMLCleaner. | ||
| 264 | |||
| 265 | {{code language="none"}} | ||
| 266 | com.xpn.xwiki.util.TidyMessageLogger: Class com.xpn.xwiki.util.TidyMessageLogger removed | ||
| 267 | {{/code}} | ||
| 268 | |||
| 269 | * Google API plugin has been retired | ||
| 270 | |||
| 271 | {{code language="none"}} | ||
| 272 | com.xpn.xwiki.plugin.google.GooglePlugin: Class com.xpn.xwiki.plugin.google.GooglePlugin removed | ||
| 273 | com.xpn.xwiki.plugin.google.GooglePluginApi: Class com.xpn.xwiki.plugin.google.GooglePluginApi removed | ||
| 274 | {{/code}} | ||
| 275 | |||
| 276 | * Return the number of imported documents | ||
| 277 | |||
| 278 | {{code language="none"}} | ||
| 279 | com.xpn.xwiki.tool.backup.Importer: Return type of method 'public void importXAR(java.io.File, java.lang.String, com.xpn.xwiki.XWikiContext)' has been changed to int | ||
| 280 | {{/code}} | ||
| 281 | |||
| 282 | * The JPQLParser generates source code (that should be internal but it is not) and the grammar has changed a bit. | ||
| 283 | |||
| 284 | {{code language="none"}} | ||
| 285 | org.xwiki.query.jpql.analysis.Analysis: Method 'public void caseAFuncnumComparableItem(org.xwiki.query.jpql.node.AFuncnumComparableItem)' has been added to an interface | ||
| 286 | org.xwiki.query.jpql.analysis.Analysis: Method 'public void caseAFuncstrComparableItem(org.xwiki.query.jpql.node.AFuncstrComparableItem)' has been added to an interface | ||
| 287 | org.xwiki.query.jpql.analysis.Analysis: Method 'public void caseAFunctimeComparableItem(org.xwiki.query.jpql.node.AFunctimeComparableItem)' has been added to an interface | ||
| 288 | org.xwiki.query.jpql.analysis.Analysis: Method 'public void caseAPathComparableItem(org.xwiki.query.jpql.node.APathComparableItem)' has been added to an interface | ||
| 289 | org.xwiki.query.jpql.node.AGroupbyItem: Parameter 1 of 'public AGroupbyItem(org.xwiki.query.jpql.node.PPath)' has changed its type to org.xwiki.query.jpql.node.PComparableItem | ||
| 290 | org.xwiki.query.jpql.node.AGroupbyItem: Method 'public org.xwiki.query.jpql.node.PPath getPath()' has been removed | ||
| 291 | org.xwiki.query.jpql.node.AGroupbyItem: Method 'public void setPath(org.xwiki.query.jpql.node.PPath)' has been removed | ||
| 292 | org.xwiki.query.jpql.node.AOrderbyItem: Parameter 1 of 'public AOrderbyItem(org.xwiki.query.jpql.node.PPath, org.xwiki.query.jpql.node.TOrderbySpec)' has changed its type to org.xwiki.query.jpql.node.PComparableItem | ||
| 293 | org.xwiki.query.jpql.node.AOrderbyItem: Method 'public org.xwiki.query.jpql.node.PPath getPath()' has been removed | ||
| 294 | org.xwiki.query.jpql.node.AOrderbyItem: Method 'public void setPath(org.xwiki.query.jpql.node.PPath)' has been removed | ||
| 295 | {{/code}} |
