Wiki source code of Release Notes for XWiki Enterprise 3.2 Milestone 3
Last modified by Sergiu Dumitriu on 2011/10/06
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{velocity output="false"}} | ||
| 2 | $xwiki.ssx.use("ReleaseNotesXWikiEnterprise30M3") | ||
| 3 | {{/velocity}} | ||
| 4 | |||
| 5 | {{box cssClass="floatinginfobox" title="**Contents**"}} | ||
| 6 | {{toc/}} | ||
| 7 | {{/box}} | ||
| 8 | |||
| 9 | Last milestone of the XWiki Enterprise 3.2 version ([[Roadmap>>Main.Roadmap]]). | ||
| 10 | |||
| 11 | = New and Noteworthy (since XWiki Enterprise 3.2 Milestone 2) = | ||
| 12 | |||
| 13 | == Improved search results scoring == | ||
| 14 | |||
| 15 | An old complaint has been the fact that the search results returned by the Lucene plugin were rarely useful, with the desired document far from the top of the returned list. This has now been improved, and results are scored differently depending on the field where the search query matches them. A hit on the document title will ensure that the document will be among the first results, while a hit on the owner document's name of an attached image will place the image towards the end. | ||
| 16 | |||
| 17 | [[image:search.png||style="border: 1px solid black"]] | ||
| 18 | |||
| 19 | == New implementation of the sheet system == | ||
| 20 | |||
| 21 | In preparation for the //Application Within Minutes// major feature, this release introduces a new way of associating objects with the sheets used for displaying them. Whereas until now the content of the document had to explicitly contain an ##~{~{include}}## statement in order to display an attached object, an object can pull its sheet automatically. This frees up the document content for a more useful purpose. | ||
| 22 | |||
| 23 | You can read more about this feature on the [[Sheet Module>>extensions:Extension.Sheet Module]] documentation page. | ||
| 24 | |||
| 25 | == Easier activation and configuration of Google Analytics == | ||
| 26 | |||
| 27 | In older versions XWiki did provide a velocity template that could be edited to enable Google Analytics. Still, this required either access to the server or overriding a template in the skin document, which was not that easy to discover. Starting with this version, there's a custom section in the wiki Administration which makes it extremely easy to enable Google Analytics tracking. | ||
| 28 | |||
| 29 | [[image:analytics.png||style="border: 1px solid black"]] | ||
| 30 | |||
| 31 | = For developers = | ||
| 32 | |||
| 33 | == Retired projects == | ||
| 34 | |||
| 35 | Several very old and unmaintained projects have been retired: | ||
| 36 | |||
| 37 | * [[exoplatform plugin>>https://github.com/xwiki-contrib/plugin-exoplatform]] | ||
| 38 | * [[adwords plugin>>https://github.com/xwiki-contrib/plugin-adwords]] | ||
| 39 | * [[alexa plugin>>https://github.com/xwiki-contrib/plugin-alexa]] | ||
| 40 | * [[workstream application>>https://github.com/xwiki-contrib/application-workstream]] | ||
| 41 | * [[Albatross skin>>https://github.com/xwiki-contrib/skin-albatross]] | ||
| 42 | * [[calendar plugin and application>>https://github.com/xwiki-contrib/plugin-calendar]] | ||
| 43 | * [[photo album application>>https://github.com/xwiki-contrib/application-photoalbum]] | ||
| 44 | * [[S5 presentation application>>https://github.com/xwiki-contrib/application-s5]] | ||
| 45 | |||
| 46 | == Translations == | ||
| 47 | |||
| 48 | The following translations have been updated: ##de## ##fr## ##lv## ##nl## ##sv## | ||
| 49 | |||
| 50 | == Upgrades == | ||
| 51 | |||
| 52 | * commons-configuration 1.7 | ||
| 53 | * commons-lang 3.0.1 | ||
| 54 | * Groovy 1.8.2 | ||
| 55 | * Logback 0.9.30 | ||
| 56 | * Lucene 3.4 | ||
| 57 | * Hibernate 3.6.7 Final | ||
| 58 | * HTML Cleaner 2.2 | ||
| 59 | * Jetty 7.4.5 | ||
| 60 | * reflections 0.9.5 | ||
| 61 | * Selenium 2.7.0 | ||
| 62 | * slf4j 1.6.2 | ||
| 63 | |||
| 64 | = Backward Compatibility and Migration Notes = | ||
| 65 | |||
| 66 | == General Notes == | ||
| 67 | |||
| 68 | {{warning}} | ||
| 69 | 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,...//. | ||
| 70 | {{/warning}} | ||
| 71 | |||
| 72 | You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from the improvements listed above. | ||
| 73 | |||
| 74 | {{warning}} | ||
| 75 | 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. | ||
| 76 | {{/warning}} | ||
| 77 | |||
| 78 | == Issues specific to XWiki Enterprise 3.2 Milestone 3 == | ||
| 79 | |||
| 80 | * The behavior of the HTML Macro has changed slightly (caused internally by an upgrade to HTML Cleaner 2.2): CDATA elements not located inside SCRIPT or STYLE elements are now removed when cleaned (i.e. when the ##clean## parameter is ##true##). If you don't want any cleaning done, use ##clean="false"##. | ||
| 81 | * Since the Lucene engine has been upgraded to a new major version, you should completely rebuild the index. This can be done from the main wiki administration, in the //Search// section. | ||
| 82 | * See the [[retired section>>#HRetired]] above for the list of removed modules. The most important one is the **removal of the Albatross skin** from the distribution. Be careful to review your ##xwiki.cfg## file and update the ##xwiki.defaultskin## and ##xwiki.defaultbaseskin## properties and make sure their values is now ##colibri## (unless you wish to continue using Albatross, in which case you'll need to install the Albatross skin in your installation). | ||
| 83 | * The **ehcache** library is no longer packaged by default. If you've configured a second level hibernate cache using this library, make sure you manually download it in the libs or replace your configuration with another cache engine. | ||
| 84 | * See the backward compatibility and migration notes for the new implementation of the [[sheet system>>extensions:Extension.Sheet Module]]. | ||
| 85 | * The permanent data storage directory is now by default ##data##, in the root of the standalone distribution. This is where you'll find, for example, the Lucene index, the custom extensions installed by the extension manager, or the attachments when the filesystem attachment storage is configured. If you're upgrading from an older version, make sure you first move the existing data from the ##jetty/work/## directory. You can configure the location of the permanent data storage in ##xwiki.properties## via the ##container.persistentDirectory## setting, and, for older code using the ##XWiki.getWorkDirectory## method, in ##xwiki.cfg## via the ##xwiki.work.dir## setting. | ||
| 86 | |||
| 87 | == API Breakages == | ||
| 88 | |||
| 89 | The following APIs were modified since XWiki Enterprise 3.1: | ||
| 90 | |||
| 91 | {{code language="none"}} | ||
| 92 | org.xwiki.component.util.ReflectionUtils: Added final modifier to class | ||
| 93 | org.xwiki.component.util.ReflectionUtils: Accessibility of method 'public ReflectionUtils()' has been decreased from public to private | ||
| 94 | com.xpn.xwiki.plugin.activitystream.api.ActivityEvent: Method 'public java.util.Map getParameters()' has been added to an interface | ||
| 95 | com.xpn.xwiki.plugin.activitystream.api.ActivityEvent: Method 'public void setParameters(java.util.Map)' has been added to an interface | ||
| 96 | org.xwiki.bridge.AttachmentNameFactory: Class org.xwiki.bridge.AttachmentNameFactory removed | ||
| 97 | org.xwiki.bridge.AttachmentNameSerializer: Class org.xwiki.bridge.AttachmentNameSerializer removed | ||
| 98 | org.xwiki.bridge.DocumentAccessBridge: Method 'public int getObjectNumber(org.xwiki.model.reference.DocumentReference, org.xwiki.model.reference.DocumentReference, java.lang.String, java.lang.String)' has been added to an interface | ||
| 99 | org.xwiki.bridge.DocumentAccessBridge: Method 'public java.lang.Object getProperty(org.xwiki.model.reference.ObjectReference, java.lang.String)' has been added to an interface | ||
| 100 | org.xwiki.bridge.DocumentAccessBridge: Method 'public java.lang.Object getProperty(org.xwiki.model.reference.ObjectPropertyReference)' has been added to an interface | ||
| 101 | org.xwiki.bridge.DocumentAccessBridge: Method 'public java.lang.Object getProperty(org.xwiki.model.reference.DocumentReference, org.xwiki.model.reference.DocumentReference, int, java.lang.String)' has been added to an interface | ||
| 102 | org.xwiki.bridge.DocumentNameFactory: Class org.xwiki.bridge.DocumentNameFactory removed | ||
| 103 | org.xwiki.bridge.DocumentNameSerializer: Class org.xwiki.bridge.DocumentNameSerializer removed | ||
| 104 | org.xwiki.container.ApplicationContext: Method 'public java.io.File getPermanentDirectory()' has been added to an interface | ||
| 105 | org.xwiki.container.Request: Method 'public java.util.List getProperties(java.lang.String)' has been added to an interface | ||
| 106 | org.xwiki.container.portlet.PortletApplicationContext: In method 'public PortletApplicationContext(javax.portlet.PortletContext)' the number of arguments has changed | ||
| 107 | org.xwiki.container.servlet.ServletApplicationContext: In method 'public ServletApplicationContext(javax.servlet.ServletContext)' the number of arguments has changed | ||
| 108 | org.xwiki.eventstream.Event: Method 'public java.util.Map getParameters()' has been added to an interface | ||
| 109 | org.xwiki.eventstream.Event: Method 'public void setParameters(java.util.Map)' has been added to an interface | ||
| 110 | org.xwiki.gwt.dom.client.Style$IEFloatProperty: Class org.xwiki.gwt.dom.client.Style$IEFloatProperty removed | ||
| 111 | com.xpn.xwiki.api.Api: Method 'public boolean checkProgrammingRights()' has been removed | ||
| 112 | com.xpn.xwiki.api.Context: Method 'public boolean isVirtual()' has been removed | ||
| 113 | com.xpn.xwiki.api.Document: Method 'public com.xpn.xwiki.stats.impl.DocumentStats getCurrentMonthWebStats(java.lang.String)' has been removed | ||
| 114 | com.xpn.xwiki.api.StatsService: Method 'public com.xpn.xwiki.XWikiContext ajc$superDispatch$com_xpn_xwiki_api_StatsService$getXWikiContext()' has been removed | ||
| 115 | com.xpn.xwiki.api.StatsService: Method 'public com.xpn.xwiki.stats.impl.DocumentStats getCurrentMonthXWikiStats(java.lang.String)' has been removed | ||
| 116 | com.xpn.xwiki.api.StatsServiceCompatibilityAspect: Class com.xpn.xwiki.api.StatsServiceCompatibilityAspect removed | ||
| 117 | com.xpn.xwiki.api.XWiki: Removed field ajc$interField$com_xpn_xwiki_api_XWikiCompatibilityAspect$util | ||
| 118 | com.xpn.xwiki.api.XWiki: Method 'public int add(int, int)' has been removed | ||
| 119 | com.xpn.xwiki.api.XWiki: Method 'public long add(long, long)' has been removed | ||
| 120 | com.xpn.xwiki.api.XWiki: Method 'public java.lang.String add(java.lang.String, java.lang.String)' has been removed | ||
| 121 | com.xpn.xwiki.api.XWiki: Method 'public com.xpn.xwiki.XWiki ajc$privFieldGet$com_xpn_xwiki_api_XWikiCompatibilityAspect$com_xpn_xwiki_api_XWiki$xwiki(com.xpn.xwiki.api.XWiki)' has been removed | ||
| 122 | com.xpn.xwiki.api.XWiki: Method 'public void ajc$privFieldSet$com_xpn_xwiki_api_XWikiCompatibilityAspect$com_xpn_xwiki_api_XWiki$xwiki(com.xpn.xwiki.api.XWiki, com.xpn.xwiki.XWiki)' has been removed | ||
| 123 | com.xpn.xwiki.api.XWiki: Method 'public com.xpn.xwiki.XWikiContext ajc$superDispatch$com_xpn_xwiki_api_XWiki$getXWikiContext()' has been removed | ||
| 124 | com.xpn.xwiki.api.XWiki: Method 'public java.lang.String clearAccents(java.lang.String)' has been removed | ||
| 125 | com.xpn.xwiki.api.XWiki: Method 'public java.lang.String clearName(java.lang.String)' has been removed | ||
| 126 | com.xpn.xwiki.api.XWiki: Method 'public int copyWikiWeb(java.lang.String, java.lang.String, java.lang.String, java.lang.String, boolean)' has been removed | ||
| 127 | com.xpn.xwiki.api.XWiki: Method 'public java.lang.String escapeText(java.lang.String)' has been removed | ||
| 128 | com.xpn.xwiki.api.XWiki: Method 'public java.lang.String escapeURL(java.lang.String)' has been removed | ||
| 129 | com.xpn.xwiki.api.XWiki: Method 'public java.lang.String generateRandomString(int)' has been removed | ||
| 130 | com.xpn.xwiki.api.XWiki: Method 'public java.util.List getArrayList()' has been removed | ||
| 131 | com.xpn.xwiki.api.XWiki: Method 'public java.util.Date getCurrentDate()' has been removed | ||
| 132 | com.xpn.xwiki.api.XWiki: Method 'public java.util.Date getDate()' has been removed | ||
| 133 | com.xpn.xwiki.api.XWiki: Method 'public java.util.Date getDate(long)' has been removed | ||
| 134 | com.xpn.xwiki.api.XWiki: Method 'public java.lang.String getDocLanguagePreference()' has been removed | ||
| 135 | com.xpn.xwiki.api.XWiki: Method 'public java.lang.String getFormEncoded(java.lang.String)' has been removed | ||
| 136 | com.xpn.xwiki.api.XWiki: Method 'public java.lang.String getHTMLArea(java.lang.String)' has been removed | ||
| 137 | com.xpn.xwiki.api.XWiki: Method 'public java.util.Map getHashMap()' has been removed | ||
| 138 | com.xpn.xwiki.api.XWiki: Method 'public java.lang.String getMessage(java.lang.String)' has been removed | ||
| 139 | com.xpn.xwiki.api.XWiki: Method 'public java.lang.String getNl()' has been removed | ||
| 140 | com.xpn.xwiki.api.XWiki: Method 'public com.xpn.xwiki.api.Object getNull()' has been removed | ||
| 141 | com.xpn.xwiki.api.XWiki: Method 'public java.util.Collection getRecentActions(java.lang.String, int)' has been removed | ||
| 142 | com.xpn.xwiki.api.XWiki: Method 'public int getTimeDelta(long)' has been removed | ||
| 143 | com.xpn.xwiki.api.XWiki: Method 'public java.util.Map getTreeMap()' has been removed | ||
| 144 | com.xpn.xwiki.api.XWiki: Method 'public java.lang.String getURLEncoded(java.lang.String)' has been removed | ||
| 145 | com.xpn.xwiki.api.XWiki: Method 'public java.lang.String getWebCopyright()' has been removed | ||
| 146 | com.xpn.xwiki.api.XWiki: Method 'public java.lang.String getWebPreference(java.lang.String)' has been removed | ||
| 147 | com.xpn.xwiki.api.XWiki: Method 'public java.lang.String getWebPreference(java.lang.String, java.lang.String)' has been removed | ||
| 148 | com.xpn.xwiki.api.XWiki: Method 'public int getWebPreferenceAsInt(java.lang.String)' has been removed | ||
| 149 | com.xpn.xwiki.api.XWiki: Method 'public int getWebPreferenceAsInt(java.lang.String, int)' has been removed | ||
| 150 | com.xpn.xwiki.api.XWiki: Method 'public long getWebPreferenceAsLong(java.lang.String)' has been removed | ||
| 151 | com.xpn.xwiki.api.XWiki: Method 'public long getWebPreferenceAsLong(java.lang.String, long)' has been removed | ||
| 152 | com.xpn.xwiki.api.XWiki: Method 'public java.lang.String getWebPreferenceFor(java.lang.String, java.lang.String)' has been removed | ||
| 153 | com.xpn.xwiki.api.XWiki: Method 'public java.lang.String getWebPreferenceFor(java.lang.String, java.lang.String, java.lang.String)' has been removed | ||
| 154 | com.xpn.xwiki.api.XWiki: Method 'public java.lang.String getXMLEncoded(java.lang.String)' has been removed | ||
| 155 | com.xpn.xwiki.api.XWiki: Method 'public boolean isVirtual()' has been removed | ||
| 156 | com.xpn.xwiki.api.XWiki: Method 'public void outputImage(java.awt.image.BufferedImage)' has been removed | ||
| 157 | com.xpn.xwiki.api.XWiki: Method 'public double parseDouble(java.lang.String)' has been removed | ||
| 158 | com.xpn.xwiki.api.XWiki: Method 'public float parseFloat(java.lang.String)' has been removed | ||
| 159 | com.xpn.xwiki.api.XWiki: Method 'public int parseInt(java.lang.String)' has been removed | ||
| 160 | com.xpn.xwiki.api.XWiki: Method 'public java.lang.Integer parseInteger(java.lang.String)' has been removed | ||
| 161 | com.xpn.xwiki.api.XWiki: Method 'public long parseLong(java.lang.String)' has been removed | ||
| 162 | com.xpn.xwiki.api.XWiki: Method 'public java.lang.String parseMessage()' has been removed | ||
| 163 | com.xpn.xwiki.api.XWiki: Method 'public java.lang.String parseMessage(java.lang.String)' has been removed | ||
| 164 | com.xpn.xwiki.api.XWiki: Method 'public java.lang.String printStrackTrace(java.lang.Throwable)' has been removed | ||
| 165 | com.xpn.xwiki.api.XWiki: Method 'public void sendMessage(java.lang.String, java.lang.String, java.lang.String)' has been removed | ||
| 166 | com.xpn.xwiki.api.XWiki: Method 'public void sendMessage(java.lang.String, java.lang.String[], java.lang.String)' has been removed | ||
| 167 | com.xpn.xwiki.api.XWiki: Method 'public java.util.List sort(java.util.List)' has been removed | ||
| 168 | com.xpn.xwiki.api.XWiki: Method 'public java.lang.String[] split(java.lang.String, java.lang.String)' has been removed | ||
| 169 | com.xpn.xwiki.api.XWiki: Method 'public java.lang.String sqlfilter(java.lang.String)' has been removed | ||
| 170 | com.xpn.xwiki.api.XWiki: Method 'public java.lang.Number toNumber(com.xpn.xwiki.api.Object)' has been removed | ||
| 171 | com.xpn.xwiki.api.XWikiCompatibilityAspect: Class com.xpn.xwiki.api.XWikiCompatibilityAspect removed | ||
| 172 | com.xpn.xwiki.cache.api.XWikiCache: Class com.xpn.xwiki.cache.api.XWikiCache removed | ||
| 173 | com.xpn.xwiki.cache.api.XWikiCacheNeedsRefreshException: Class com.xpn.xwiki.cache.api.XWikiCacheNeedsRefreshException removed | ||
| 174 | com.xpn.xwiki.cache.api.XWikiCacheService: Class com.xpn.xwiki.cache.api.XWikiCacheService removed | ||
| 175 | com.xpn.xwiki.user.api.XWikiRightService: Method 'public boolean hasWikiAdminRights(com.xpn.xwiki.XWikiContext)' has been added to an interface | ||
| 176 | compatibility.com.xpn.xwiki.api.ApiCompatibilityAspect: Class compatibility.com.xpn.xwiki.api.ApiCompatibilityAspect removed | ||
| 177 | compatibility.com.xpn.xwiki.api.ContextCompatibilityAspect: Class compatibility.com.xpn.xwiki.api.ContextCompatibilityAspect removed | ||
| 178 | compatibility.com.xpn.xwiki.api.DocumentCompatibilityAspect: Class compatibility.com.xpn.xwiki.api.DocumentCompatibilityAspect removed | ||
| 179 | com.xpn.xwiki.plugin.lucene.IndexRebuilder: Method 'protected int addTranslationsOfDocument(com.xpn.xwiki.doc.XWikiDocument, com.xpn.xwiki.XWikiContext)' has been removed | ||
| 180 | com.xpn.xwiki.plugin.lucene.SearchResults: In method 'public SearchResults(org.apache.lucene.search.Hits, com.xpn.xwiki.api.XWiki, com.xpn.xwiki.XWikiContext)' the number of arguments has changed | ||
| 181 | com.xpn.xwiki.plugin.lucene.SearchResults: Accessibility of method 'public SearchResults(org.apache.lucene.search.Hits, com.xpn.xwiki.api.XWiki, com.xpn.xwiki.XWikiContext)' has been decreased from public to package | ||
| 182 | com.xpn.xwiki.plugin.wikimanager.WikiManager: Removed field LOG | ||
| 183 | com.xpn.xwiki.plugin.wikimanager.WikiManager: Method 'public void importPackage(java.lang.String, java.lang.String, com.xpn.xwiki.XWikiContext)' has been removed | ||
| 184 | org.xwiki.gwt.wysiwyg.client.plugin.submit.IESubmitPlugin: Class org.xwiki.gwt.wysiwyg.client.plugin.submit.IESubmitPlugin removed | ||
| 185 | {{/code}} |
