Wiki source code of Release Notes for XWiki 4.2
Version 18.1 by Marius Dumitru Florea on 2012/10/05
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 Platform, XWiki Enterprise and XWiki Enterprise Manager. They share the same release notes as they are released together and have the same version. | ||
| 6 | |||
| 7 | This is the third release of the 4.x cycle ([[Roadmap>>Main.Roadmap]]). | ||
| 8 | |||
| 9 | {{warning}} | ||
| 10 | If you're upgrading from an older version and you use the new Distribution Wizard to upgrade your wiki pages you'll notice that it'll ask you to merge all pages that have been modified between your version and XWiki 4.2. This is because currently the Distribution Wizard doesn't know which version you have and thus asks you to perform the merge manually. This operation may take a long time (up to 20 minutes or so). Thus at the moment if you're upgrading from a previous version we recommend that you Cancel the Distribution Wizard and instead [[Import the new XAR>>platform:AdminGuide.Upgrade]]. This problem is [[reported in this issue>>http://jira.xwiki.org/browse/XWIKI-8252]] and should be fixed in the next release. | ||
| 11 | {{/warning}} | ||
| 12 | |||
| 13 | = New and Noteworthy (since XWiki 4.1) = | ||
| 14 | |||
| 15 | == Extension Manager improvements == | ||
| 16 | |||
| 17 | Main improvements: | ||
| 18 | |||
| 19 | * Starting with this version you can downgrade an extension. In other words, you can install an older version of an extension even if a newer version is currently installed. This doesn't apply to core extensions, which cannot be uninstalled, upgraded or downgraded individually. In order to downgrade an extension that is already installed you need to search for an older version. Currently this is possible only using the advanced search.((( | ||
| 20 | {{image reference="EM-extensionDowngradePlan.png"/}} | ||
| 21 | ))) | ||
| 22 | * From the main wiki of a wiki farm you now have the option to trigger extension jobs (install, uninstall, upgrade, downgrade, etc.) that target all the wikis. For instance, as you can see below, you can install an extension on the entire wiki farm:((( | ||
| 23 | {{image reference="EM-extensionGlobalInstall.png"/}} | ||
| 24 | ))) | ||
| 25 | * The log messages have been improved to include links to the affected documents or extensions as indicated in the following image~:((( | ||
| 26 | {{image reference="EM-extensionLogMessage"/}} | ||
| 27 | ))) | ||
| 28 | * An administrator of a subwiki can now install XAR extension (as long as it does not require a JAR extension). | ||
| 29 | |||
| 30 | == Experimental install/upgrade wizard == | ||
| 31 | |||
| 32 | Accessing a wiki page in view mode after an upgrade or when the database is empty (new install) will trigger a wizard that will allow you to install or update the default set of wiki pages and to upgrade or downgrade the extensions you may have previously installed. | ||
| 33 | |||
| 34 | The wizard is not yet production ready. It has a couple of issues we hope to fix very soon: | ||
| 35 | |||
| 36 | * information about core extensions is collected lazily and thus if you check distribution details just after starting XWiki you get incomplete information | ||
| 37 | * installing or checking the details of the user interface extension takes a couple of minutes depending on your internet bandwidth and the load of the remote extension repository | ||
| 38 | * some merge conflicts are reported even when the database is empty | ||
| 39 | |||
| 40 | The wizard currently has three steps. The first step offers an overview of the installation process by explaining the goal of the wizard and listing its steps. | ||
| 41 | |||
| 42 | {{image reference="ReleaseNotesXWikiEnterprise42RC1@DistributionWizard-WelcomeStep.png"/}} | ||
| 43 | |||
| 44 | In the second step you can see which XWiki distribution you are running and what is its recommended default set of wiki pages (the default user interface). You should install, upgrade or downgrade the UI so that it matches the distribution version. | ||
| 45 | |||
| 46 | {{image reference="ReleaseNotesXWikiEnterprise42RC1@DistributionWizard-UIStep.png"/}} | ||
| 47 | |||
| 48 | The Continue button becomes available after the recommended version of the user interface is installed. | ||
| 49 | |||
| 50 | In the third step you can upgrade the installed extensions. We group them in two categories: | ||
| 51 | |||
| 52 | * extensions that don't work with your current distribution but which have new versions available that are compatible with your current distribution. These extension require an upgrade. | ||
| 53 | * extensions that should work fine with your current distribution but which have upgrades available. Upgrading these extensions is optional. | ||
| 54 | |||
| 55 | {{image reference="ReleaseNotesXWikiEnterprise42RC1@DistributionWizard-ExtensionsStep.png"/}} | ||
| 56 | |||
| 57 | You can refresh the list of extensions by recomputing the upgrade plan. The Skip and Cancel buttons have the same meaning as in the previous step. The Continue button is available only after the required upgrades are performed. | ||
| 58 | |||
| 59 | At the end you'll be redirected back to the wiki page you have accessed in the first place. | ||
| 60 | |||
| 61 | == Improvements to the Extension Repository Application == | ||
| 62 | |||
| 63 | We modified the extension sheet to display the release notes for all the available versions of an extension. Check for instance the release notes for the [[Extended TODO Application>>extensions:Extension.Extended Todo Application||anchor="HReleaseNotes"]]: | ||
| 64 | |||
| 65 | {{image reference="ER-releaseNotes.png"/}} | ||
| 66 | |||
| 67 | == JIRA Macro == | ||
| 68 | |||
| 69 | A [[new JIRA Macro>>extensions:Extension.JIRA Macro]] is now part of the Platform but is not bundled by default (you'll need to install it with the Extension Manager). We previously had a [[Contributed JIRA Macro>>extensions:Extension.Contrib JIRA Macro]] but we decided that the JIRA macro was a good candidate to have in the Platform and thus supported by the XWiki Development Team. Compared to the older Contributed JIRA Macro, the new Macro has the following advantages: | ||
| 70 | |||
| 71 | * No Programming Rights required | ||
| 72 | * Supports issue ordering | ||
| 73 | * Supports ability to register new Styles, new Data Sources and new Field Displayers | ||
| 74 | * Displays closed issues as Striked-out | ||
| 75 | * Written in Java with automated tests | ||
| 76 | |||
| 77 | {{image reference="extensions:Extension.JIRA Macro@jiraMacroDefault.png"/}} | ||
| 78 | |||
| 79 | == New field types for email and list of pages == | ||
| 80 | |||
| 81 | Two new types of class properties have been added: | ||
| 82 | |||
| 83 | * The //Email// type extends the normal //String// type, adding by default a validation regular expression that should accept only a valid email address | ||
| 84 | * The //Page// type extends the normal //DBList// type, and allows to select one or more documents from the current wiki | ||
| 85 | |||
| 86 | These two new properties are still in development, and further improvements will be implemented in the next milestone. | ||
| 87 | |||
| 88 | == Computed class fields == | ||
| 89 | |||
| 90 | Another new type of class fields adds support for //virtual values// computed live from other class values, data from the database, data obtained from an external service, or practically any other source of data. These fields are non-editable and aren't stored in the database, since they only provide some wiki content that will be rendered each time such a property is displayed. | ||
| 91 | |||
| 92 | Traditionally, this kind of computation would have been written directly in the sheet used to display instances of that class, but putting it in a class field allows easier reuse of the code, since the property will be //displayed// in livetables, when indexing the document in Lucene, when displaying documents in an index page, and so on. | ||
| 93 | |||
| 94 | == Improved upload UI == | ||
| 95 | |||
| 96 | The new HTML5 FileUploader has been integrated in a few places: | ||
| 97 | |||
| 98 | * The standard attachment upload form | ||
| 99 | * The Import section of the Administration | ||
| 100 | |||
| 101 | See [[below>>||anchor="HNewHTML5FileUploadwidget"]] for more details about this feature. | ||
| 102 | |||
| 103 | == New logging administration UI == | ||
| 104 | |||
| 105 | It's now possible to review and modify the log level for all registered loggers. | ||
| 106 | |||
| 107 | {{image reference="extensions:Extension.Logging Application@loggingadmin.png"/}} | ||
| 108 | |||
| 109 | == New Applications Panel == | ||
| 110 | |||
| 111 | There's now a new "Applications" panel by default in XWiki Enterprise. This panel displays the applications present in your wiki. | ||
| 112 | |||
| 113 | {{image reference="applicationsPanelStandard.png"/}} | ||
| 114 | |||
| 115 | Administrators will get a couple of additional links, allowing them to install applications through the [[Extension Manager>>extensions:Extension.Extension Manager Application]], or to create new applications thanks to the [[App Within Minutes feature>>extensions:Extension.App Within Minutes Application]]. | ||
| 116 | |||
| 117 | {{image reference="applicationsPanel.png"/}} | ||
| 118 | |||
| 119 | {{info}} | ||
| 120 | Note for application developers: your applications can provide their own entries in this menu by [[declaring a UI Extension>>extensions:Extension.UIExtension Module]]. | ||
| 121 | {{/info}} | ||
| 122 | |||
| 123 | == Chart Macro Improvements == | ||
| 124 | |||
| 125 | * The [[Chart macro>>extensions:Extension.Chart Macro]] will now automatically default to the ##inline## Data Source type when not specified and the Chart Macro has some content. | ||
| 126 | * [[Two new Chart types have been added: XY Line 3D and XY Step>>extensions:Extension.Chart Macro]]. Examples:((( | ||
| 127 | {{image reference="timeseries-line3D.png"/}} | ||
| 128 | |||
| 129 | {{image reference="timeseries-step.png"/}} | ||
| 130 | ))) | ||
| 131 | |||
| 132 | == New Content Macro == | ||
| 133 | |||
| 134 | The [[new Content macro>>extensions:Extension.Content Macro]] allows to enter content in any of the supported Syntaxes and thus allows to have content written in various syntaxes. For example, in a page in XWiki Syntax 2.0: | ||
| 135 | |||
| 136 | {{code}} | ||
| 137 | This is in **bold** | ||
| 138 | |||
| 139 | {{content syntax="confluence/1.0"}} | ||
| 140 | This is *bold* too! | ||
| 141 | {{/content}} | ||
| 142 | {{/code}} | ||
| 143 | |||
| 144 | == Documents Macro improvements == | ||
| 145 | |||
| 146 | The ##~{~{documents}}## macro [[now supports specifying the list of columns to display>>extensions:Extension.Documents Macro]]. For example: | ||
| 147 | |||
| 148 | {{code}} | ||
| 149 | {{documents count="5" actions="false" space="Main" parent="Main.WebHome" columns="doc.title"/}} | ||
| 150 | {{/code}} | ||
| 151 | |||
| 152 | would display: | ||
| 153 | |||
| 154 | {{image reference="documents-columns.png"/}} | ||
| 155 | |||
| 156 | == Search improvements == | ||
| 157 | |||
| 158 | The Lucene index also stores the MIME type of the indexed attachments, allowing to customize the search to only include or exclude attachments of a certain type. The new field is named [[##mimetype##>>doc:extensions:Extension.Search Application Query Syntax||anchor="Hmimetype"]] and it contains a valid MIME type string, as returned by the container in which XWiki is running. For example, add ##-mimetype:image/*## to a query to exclude all image attachments from the results, or add ##mimetype:application/pdf## to only search inside PDF attachments. | ||
| 159 | |||
| 160 | Remember that in case of an upgrade, you have to rebuild the entire index to have this new field for existing documents. | ||
| 161 | |||
| 162 | == Miscellaneous == | ||
| 163 | |||
| 164 | * the progress tab is selected by default when you view the extension details if there is a job running (e.g. install in progress) for that extension | ||
| 165 | * when there is a merge conflict, the 'Show changes' button updates the changes asynchronously without reloading the entire page | ||
| 166 | * attachments of pages installed with the extension manager now have the right author set: the current user instead of the author from the XAR as it used to be | ||
| 167 | * the file size of attachments installed with the extension manager is now properly set | ||
| 168 | * the installation process is now more robust with respect to the exceptions that can occur while installing a JAR extension with components | ||
| 169 | * Document attachments so far have been displayed in the order in which they are returned by the database, which most of the time happened to be the upload date. Starting with this version attachments are displayed ordered by their filename, which makes it easier to find an attachment, but support for selecting a different order (date, size, author...) will be added soon. | ||
| 170 | * Uploading attachments with '+' character in their file names using the WebDAV interface shouldn't pose any more problems. | ||
| 171 | * It's now possible to use Velocity scripts in the Copyright field in the Administration. | ||
| 172 | * The XWiki Installer now fully works on Windows 7. The XWiki Data is now put in the ##%APPDATA%\XWiki Enterprise <version>\data## directory, while the binaries are installed in ##Program Files##. | ||
| 173 | * It is no longer allowed to use scripts in comments. This reduces the security risk from users that only have comment rights. | ||
| 174 | * Macro parameters may now contain macro syntax. Example: {{{ {{box title="{{info}}Hello!{{/info}}" }}Lorem ipsum ...{{/box}} }}} | ||
| 175 | * Improve OOB support for JBoss AS7: | ||
| 176 | ** Removed Struts Taglibs completely since we don't use them and some were defined but not made available, causing errors in deployments on JBoss AS7 ({{jira style="enum" url="http://jira.xwiki.org"}}XWIKI-7986{{/jira}}) | ||
| 177 | ** Fixed Logging conflict between JBoss AS and XWiki ({{jira style="enum" url="http://jira.xwiki.org"}}XWIKI-7987{{/jira}}) | ||
| 178 | * The [[IRC Bot Application>>extensions:Extension.IRC Bot Application]] now recognizes XAR import events and when receiving one, it doesn't send subsequent IRC notifications for modified or created documents to avoid spamming the IRC channel. | ||
| 179 | * Display the request URL in the IRC channel when the Link Checker bot listener is active and a broken link is found, thus making it easier to reproduce and debug the broken link | ||
| 180 | |||
| 181 | = For Developers = | ||
| 182 | |||
| 183 | == New Git Module == | ||
| 184 | |||
| 185 | A new, optional (i.e. not installed by default), [[Git Module has been added>>extensions:Extension.Git Module]]. It allows to easily perform Git operations from within wiki pages. For example to count all commits for the past year and list all committers who's committed code during this period, you could write in a wiki page: | ||
| 186 | |||
| 187 | {{code language="java"}} | ||
| 188 | {{groovy}} | ||
| 189 | import org.apache.commons.io.* | ||
| 190 | import org.eclipse.jgit.api.* | ||
| 191 | import org.eclipse.jgit.lib.* | ||
| 192 | import org.eclipse.jgit.revwalk.* | ||
| 193 | import org.eclipse.jgit.storage.file.* | ||
| 194 | import org.gitective.core.* | ||
| 195 | import org.gitective.core.filter.commit.* | ||
| 196 | |||
| 197 | def service = services.get("git") | ||
| 198 | def commonsRepository = service.getRepository("git://github.com/xwiki/xwiki-commons.git", "xwiki-commons") | ||
| 199 | // Do a Git pull to get latest commits | ||
| 200 | new Git(commonsRepository).pull().call() | ||
| 201 | def finder = new CommitFinder(commonsRepository) | ||
| 202 | |||
| 203 | def dateFilter = new CommitterDateFilter(System.currentTimeMillis() - 365*24*60*60*1000L) | ||
| 204 | def countFilter = new CommitCountFilter() | ||
| 205 | def authorFilter = new AuthorSetFilter() | ||
| 206 | def filters = new AndCommitFilter() | ||
| 207 | filters.add(countFilter, authorFilter) | ||
| 208 | finder.setFilter(dateFilter) | ||
| 209 | finder.setMatcher(filters) | ||
| 210 | finder.find() | ||
| 211 | |||
| 212 | println "There have been ${countFilter.count} commits in the past year!" | ||
| 213 | println "" | ||
| 214 | |||
| 215 | println "The following committers have participated in those commits:" | ||
| 216 | authorFilter.getPersons().each() { | ||
| 217 | println "* ${it.name} (${it.emailAddress})" | ||
| 218 | } | ||
| 219 | {{/groovy}} | ||
| 220 | {{/code}} | ||
| 221 | |||
| 222 | == Default custom displayers == | ||
| 223 | |||
| 224 | While XWiki allowed to specify a custom display for a given field, it was impossible to change the way field types, such as //DateProperty// or //IntegerProperty//, are displayed in general. Now it is possible to define custom displayers at the farm or wiki level, which gives the administrators more power to change the look and feel of the wiki. For example, this allows to use HTML5 input types for dates and numbers, to use custom suggestions for //list of users// fields, or to always add a validation input for all the //password// field types. | ||
| 225 | |||
| 226 | To use this feature, first you need to compute a //type// name for your property type. This is obtained from the java class simple name, removing the ##Class## suffix, and lowercasing. For example, for numbers the java class used is ##com.xpn.xwiki.objects.classes.NumberClass##, with the simple name ##NumberClass##, which gives ##number## as the type name. For a database list, we get ##dblist## from ##DBListClass##. | ||
| 227 | |||
| 228 | Next, there are three places where a default custom displayer can be defined. | ||
| 229 | |||
| 230 | 1. If a document whose name is the //type// capitalized and suffixed with ##Displayer## exists in the ##XWiki## space in the current wiki, then its content is used as the default custom displayer for that type of property. For example, ##localwiki:XWiki.NumberDisplayer## and ##localwiki:XWiki.DblistDisplayer##. | ||
| 231 | 1. If a document whose name is the //type// capitalized and suffixed with ##Displayer## exists in the ##XWiki## space in the main wiki, then its content is used as the default custom displayer for that type of property. For example, ##xwiki:XWiki.NumberDisplayer## and ##xwiki:XWiki.DblistDisplayer##. | ||
| 232 | 1. If a velocity template whose name is the //type// suffixed with ##.vm## exists in the current skin, then it is evaluated as the default custom displayer for that type of property. A skin file can be defined in many places, such as an attachment of a skin document, a file in a named skin on the filesystem, or a file in the ##templates/## directory. | ||
| 233 | |||
| 234 | If a specific class property provides custom display code in the XClass, then that code takes priority over an eventual default custom displayer for that property. | ||
| 235 | |||
| 236 | As with property custom displayers, when evaluating the display code several objects are placed in the context: | ||
| 237 | |||
| 238 | * ##name## is the name of the property being displayed | ||
| 239 | * ##prefix## is the HTML name prefix to append to an eventual input field name, and contains the XClass name, an underscore, the object number, and another underscore, for example ##XWiki.XWikiUsers_0_## | ||
| 240 | * ##object## is the object owning the displayed property, an instance of the public ##com.xpn.xwiki.api.Object## class | ||
| 241 | * ##type## is the target display type, one of ##view##, ##edit##, ##hidden## or ##search## | ||
| 242 | |||
| 243 | == New API to manipulate log level == | ||
| 244 | |||
| 245 | Several method as been added to ##org.xwiki.logging.LoggerManager## to manipulate the log level of registered loggers. | ||
| 246 | |||
| 247 | {{code language="java"}} | ||
| 248 | /** | ||
| 249 | * Associate the passed logger to the passed log level. | ||
| 250 | * | ||
| 251 | * @param loggerName the logger | ||
| 252 | * @param level the level of the logger | ||
| 253 | */ | ||
| 254 | void setLoggerLevel(String loggerName, LogLevel level); | ||
| 255 | |||
| 256 | /** | ||
| 257 | * @param loggerName the logger | ||
| 258 | * @return the log level associated to the logger | ||
| 259 | */ | ||
| 260 | LogLevel getLoggerLevel(String loggerName); | ||
| 261 | |||
| 262 | /** | ||
| 263 | * @return all the registered loggers | ||
| 264 | */ | ||
| 265 | Collection<Logger> getLoggers(); | ||
| 266 | {{/code}} | ||
| 267 | |||
| 268 | |||
| 269 | == New HTML5 File Upload widget == | ||
| 270 | |||
| 271 | The [[File Upload widget>>doc:platform:DevGuide.HTML5Upload]] can enhance HTML input elements of type file to provide an interactive upload UI. It can submit files either automatically when the user selects local files, or after the user presses the container form's submit button. | ||
| 272 | |||
| 273 | To use this widget, it is enough to create a new instance of ##XWiki.FileUploader## passing the target ##input## element as the first parameter, and an optional configuration object as the second parameter. | ||
| 274 | |||
| 275 | {{code language="javascript"}} | ||
| 276 | new XWiki.FileUploader(targetInput, { | ||
| 277 | autoUpload: true, | ||
| 278 | progressAutohide: true | ||
| 279 | }); | ||
| 280 | {{/code}} | ||
| 281 | |||
| 282 | [[image:platform:DevGuide.HTML5Upload@html5uploads.png||class="screenshot"]] | ||
| 283 | |||
| 284 | == JSRX and SSRX == | ||
| 285 | |||
| 286 | It's now possible by default to add [[skin extensions>>extensions:Extension.Skin Extension Plugin]] located in JAR files. Example usage: | ||
| 287 | |||
| 288 | {{code}} | ||
| 289 | $xwiki.jsrx("/lib/codemirror.js") | ||
| 290 | $xwiki.ssrx("/lib/codemirror.css") | ||
| 291 | {{/code}} | ||
| 292 | |||
| 293 | == Attachment Picker improvements == | ||
| 294 | |||
| 295 | It is now possible to specify a different document for the source (and target in case of uploads) of attachments, using the new ##targetdocname## macro parameter. | ||
| 296 | |||
| 297 | == Extension Manager improvements == | ||
| 298 | |||
| 299 | * the custom Maven property <xwiki.extension.features> now accept any number of new lines and white spaces between elements((( | ||
| 300 | {{code language="xml"}} | ||
| 301 | <xwiki.extension.features> | ||
| 302 | org.xwiki.platform:xwiki-platform-oldcore, | ||
| 303 | com.xpn.xwiki.platform:xwiki-core | ||
| 304 | </xwiki.extension.features> | ||
| 305 | {{/code}} | ||
| 306 | ))) | ||
| 307 | * new custom properties added to overwrite standard Maven properties: | ||
| 308 | ** ##xwiki.extension.name## to overwrite ##<name>## | ||
| 309 | ** ##xwiki.extension.summary## to overwrite ##<description>## | ||
| 310 | ** ##xwiki.extension.website## to overwrite ##<url>## | ||
| 311 | |||
| 312 | == XAR format improvement == | ||
| 313 | |||
| 314 | It's now possible to indicate the extension identifier right in the XAR package descriptor (package.xml). Among other things this allow standard import UI to find what it currently importing and register it automatically as installed extension if it can be found in the registered repositories during import process. | ||
| 315 | |||
| 316 | The XAR Maven plugin automatically take care of adding this information to the generated package.xml for Maven project. If for some reason you need to indicate it by hand you can use the property <extensionId> under the the <infos> element in the package.xml file. | ||
| 317 | |||
| 318 | {{code language="xml"}} | ||
| 319 | <package> | ||
| 320 | <infos> | ||
| 321 | <name>XWiki Platform - Extension - UI</name> | ||
| 322 | <description>XWiki Extension Manager, an application for managing extensions in a wiki.</description> | ||
| 323 | <licence></licence> | ||
| 324 | <author>XWiki.Admin</author> | ||
| 325 | <extensionId>org.xwiki.platform:xwiki-platform-extension-ui</extensionId> | ||
| 326 | <version>4.2-SNAPSHOT</version> | ||
| 327 | <backupPack>true</backupPack> | ||
| 328 | </infos> | ||
| 329 | <files> | ||
| 330 | [...] | ||
| 331 | </files> | ||
| 332 | </package> | ||
| 333 | {{/code}} | ||
| 334 | |||
| 335 | == New UI Extension mechanism (experimental) == | ||
| 336 | |||
| 337 | We're in the process of allowing applications to insert custom content in pre-defined places in the user interface. A first Extension Point has been defined in the new "Applications" panel, you can read more about this in the [[UI Extension module documentation>>extensions:Extension.UIExtension Module]]. | ||
| 338 | |||
| 339 | == Deprecated and Retired projects == | ||
| 340 | |||
| 341 | <description of deprecated and retired projects> | ||
| 342 | |||
| 343 | == Upgrades == | ||
| 344 | |||
| 345 | The following dependencies have been upgraded: | ||
| 346 | |||
| 347 | * Infinispan 5.1.5 | ||
| 348 | * JDeb 0.11 | ||
| 349 | * JGroups 3.1.0 | ||
| 350 | * Tika 1.2 | ||
| 351 | * GWT 2.5 RC1 | ||
| 352 | * Selenium 2.25 | ||
| 353 | * Prototype.js 1.7.1 | ||
| 354 | * Jython 2.5.3 | ||
| 355 | * Pegdown 1.1.0 (used by the XWiki Markdown Parser) | ||
| 356 | * Xalan 2.7.1 | ||
| 357 | |||
| 358 | == Miscellaneous == | ||
| 359 | |||
| 360 | * The transformation context have a "restricted" flag to indicate that macros and other transformations should not perform modifications to the database, expensive computations or other potentially harmful operations. Developers of macros and other rendering extensions should pay attention to this flag. | ||
| 361 | * The messageSender macro now accepts 3 parameters that allow you to customize it by overriding the default displayed visibility levels for a message (that a user can choose from), the default selected visibility level and the default value (in case of user or group visibility). More details on {{jira style="enum" url="http://jira.xwiki.org"}}XWIKI-7974{{/jira}}. | ||
| 362 | * The [[new experimental Security API that was first released in XWiki 4.0>>xwiki:ReleaseNotes.ReleaseNotesXWikiEnterprise40||anchor="HNewRightsImplementation28Experimental29"]] is now bundled by default in XWiki Enterprise. | ||
| 363 | * It's now possible to access root ComponentManager using "root" role hint:((( | ||
| 364 | {{code language="java"}} | ||
| 365 | @Inject | ||
| 366 | @Named("root") | ||
| 367 | private ComponentManager rootComponentManager; | ||
| 368 | {{/code}} | ||
| 369 | ))) | ||
| 370 | * A Provider has been added to easily access the context ComponentManager (a proxy which choose the right ComponentManager depending on context information like the current user and the current wiki)((( | ||
| 371 | {{code language="java"}} | ||
| 372 | @Inject | ||
| 373 | @Named("context") | ||
| 374 | private Provider<ComponentManager> contextComponentManager; | ||
| 375 | {{/code}} | ||
| 376 | ))) | ||
| 377 | * The ##AbstractMockingComponentTestCase## testing framework class has been modified. Read the [[Testing page>>dev:Community.Testing]] for more details on how to use it. | ||
| 378 | |||
| 379 | = Translations = | ||
| 380 | |||
| 381 | The following translations have been updated: | ||
| 382 | |||
| 383 | {{language codes="da, fr, pt_BR, ru, zhm, hu, it, lv, sv"/}} | ||
| 384 | |||
| 385 | = Tested Browsers = | ||
| 386 | |||
| 387 | Here's the list of browsers tested with this version (i.e. browsers that we've tested as working - Check the list of [[supported browsers>>dev:Community.BrowserSupportStrategy]]): | ||
| 388 | |||
| 389 | {{velocity}} | ||
| 390 | ## name = iexplorer, firefox, chrome, safari, opera | ||
| 391 | {{/velocity}} | ||
| 392 | |||
| 393 | {{browser name="firefox" version="15.0.1"/}} | ||
| 394 | |||
| 395 | = Known issues = | ||
| 396 | |||
| 397 | * [[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]] | ||
| 398 | |||
| 399 | = Test Report = | ||
| 400 | |||
| 401 | You can check the [[manual test report>>TestReports.ManualTestReportXE42RC1]] to learn about what was tested and the results on various browsers. | ||
| 402 | |||
| 403 | = Backward Compatibility and Migration Notes = | ||
| 404 | |||
| 405 | == General Notes == | ||
| 406 | |||
| 407 | You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from all the improvements listed above. | ||
| 408 | |||
| 409 | {{warning}} | ||
| 410 | 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. | ||
| 411 | {{/warning}} | ||
| 412 | |||
| 413 | == API Breakages == | ||
| 414 | |||
| 415 | The following APIs were modified since XWiki 4.1: | ||
| 416 | |||
| 417 | * The logging module is new and is still considered a "young API". Added new methods to manipulate loggers levels.((( | ||
| 418 | {{code language="none"}} | ||
| 419 | org.xwiki.logging.LoggerManager: Method 'public org.xwiki.logging.LogLevel getLoggerLevel(java.lang.String)' has been added to an interface | ||
| 420 | org.xwiki.logging.LoggerManager: Method 'public java.util.Collection getLoggers()' has been added to an interface | ||
| 421 | org.xwiki.logging.LoggerManager: Method 'public void setLoggerLevel(java.lang.String, org.xwiki.logging.LogLevel)' has been added to an interface | ||
| 422 | {{/code}} | ||
| 423 | ))) | ||
| 424 | * Fix method name typo (adding new method). This interface is not really supposed to be implemented except by internal class.((( | ||
| 425 | {{code language="none"}} | ||
| 426 | org.xwiki.properties.PropertyDescriptor: Method 'public java.lang.reflect.Field getField()' has been added to an interface | ||
| 427 | {{/code}} | ||
| 428 | ))) | ||
| 429 | * New #isValid() method((( | ||
| 430 | {{code language="none"}} | ||
| 431 | org.xwiki.extension.InstalledExtension: Method 'public boolean isValid(java.lang.String)' has been added to an interface | ||
| 432 | {{/code}} | ||
| 433 | ))) | ||
| 434 | * The Extension module is relatively new and is still undergoing some API tuning. New method to access environment extension. Also added new methods to execute custom checking before installing/uninstalling an extension and new methods to access local:installed extensions.((( | ||
| 435 | {{code language="none"}} | ||
| 436 | org.xwiki.extension.handler.ExtensionHandler: Method 'public void checkInstall(org.xwiki.extension.Extension, java.lang.String, org.xwiki.job.Request)' has been added to an interface | ||
| 437 | org.xwiki.extension.handler.ExtensionHandler: Method 'public void checkUninstall(org.xwiki.extension.InstalledExtension, java.lang.String, org.xwiki.job.Request)' has been added to an interface | ||
| 438 | org.xwiki.extension.repository.CoreExtensionRepository: Method 'public org.xwiki.extension.CoreExtension getEnvironmentExtension()' has been added to an interface | ||
| 439 | org.xwiki.extension.repository.InstalledExtensionRepository: Method 'public org.xwiki.extension.InstalledExtension getInstalledExtension(org.xwiki.extension.ExtensionId)' has been added to an interface | ||
| 440 | org.xwiki.extension.repository.LocalExtensionRepository: Method 'public org.xwiki.extension.LocalExtension getLocalExtension(org.xwiki.extension.ExtensionId)' has been added to an interface | ||
| 441 | org.xwiki.job.Request: Method 'public boolean containsProperty(java.lang.String)' has been added to an interface | ||
| 442 | org.xwiki.job.Request: Method 'public java.lang.Object removeProperty(java.lang.String)' has been added to an interface | ||
| 443 | {{/code}} | ||
| 444 | ))) | ||
| 445 | * New methods in the oldcore/wikimacro bridge((( | ||
| 446 | {{code}} | ||
| 447 | org.xwiki.rendering.macro.wikibridge.WikiMacro: Method 'public org.xwiki.model.reference.DocumentReference getAuthorReference()' has been added to an interface | ||
| 448 | org.xwiki.rendering.macro.wikibridge.WikiMacroFactory: Method 'public boolean isAllowed(org.xwiki.model.reference.DocumentReference, org.xwiki.rendering.macro.wikibridge.WikiMacroVisibility)' has been added to an interface | ||
| 449 | {{/code}} | ||
| 450 | ))) | ||
| 451 | * TODO Andreas: Explain why we have to break backward compatibility for the Chart module((( | ||
| 452 | {{code}} | ||
| 453 | org.xwiki.rendering.macro.chart.ChartDataSource: Field PARAMS has been removed, but it was previously a constant | ||
| 454 | org.xwiki.rendering.macro.chart.ChartDataSource: Field SOURCE has been removed, but it was previously a constant | ||
| 455 | org.xwiki.rendering.macro.chart.ChartMacroParameters: Method 'public java.util.Map getParametersMap()' has been removed | ||
| 456 | org.xwiki.chart.model.ChartModel: Method 'public org.jfree.chart.axis.Axis getAxis(int)' has been added to an interface | ||
| 457 | org.xwiki.chart.model.ChartModel: Method 'public java.lang.Number getCellValue(int, int)' has been removed | ||
| 458 | org.xwiki.chart.model.ChartModel: Method 'public int getColumnCount()' has been removed | ||
| 459 | org.xwiki.chart.model.ChartModel: Method 'public java.lang.String getColumnHeader(int)' has been removed | ||
| 460 | org.xwiki.chart.model.ChartModel: Method 'public org.jfree.data.general.Dataset getDataset()' has been added to an interface | ||
| 461 | org.xwiki.chart.model.ChartModel: Method 'public int getRowCount()' has been removed | ||
| 462 | org.xwiki.chart.model.ChartModel: Method 'public java.lang.String getRowHeader(int)' has been removed | ||
| 463 | org.xwiki.chart.model.DefaultChartModel: Class org.xwiki.chart.model.DefaultChartModel removed | ||
| 464 | {{/code}} | ||
| 465 | ))) | ||
| 466 | * Removed protected method (registerWikiMacros) that was not supposed to be used from outside (was protected for unit tests hacks.)((( | ||
| 467 | {{code}} | ||
| 468 | com.xpn.xwiki.XWiki: Method 'protected void registerWikiMacros()' has been removed | ||
| 469 | {{/code}} | ||
| 470 | ))) | ||
| 471 | * These classes below have never been used. It was supposed to be the start of the removal of Struts but since it hasn't progressed so far we're removing stray code from master. Experiments should be done on feature branches((( | ||
| 472 | {{code}} | ||
| 473 | org.xwiki.container.servlet.XWikiServlet: Class org.xwiki.container.servlet.XWikiServlet removed | ||
| 474 | {{/code}} | ||
| 475 | ))) | ||
| 476 | * Added a new sendMessageFromTemplate method signature that uses a map of parameters instead of a VelocityContext((( | ||
| 477 | {{code}} | ||
| 478 | com.xpn.xwiki.plugin.mailsender.MailSender: Method 'public int sendMessageFromTemplate(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.util.Map)' has been added to an interface | ||
| 479 | {{/code}} | ||
| 480 | ))) |
