Wiki source code of Release Notes for XWiki Enterprise 2.4
Version 17.1 by Silvia Macovei on 2010/07/21
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | = XWiki Enterprise 2.4 Release Notes = | ||
| 2 | |||
| 3 | {{box cssClass="floatinginfobox" title="**Contents**"}} | ||
| 4 | {{toc/}} | ||
| 5 | {{/box}} | ||
| 6 | |||
| 7 | = New and Noteworthy = | ||
| 8 | |||
| 9 | == Search == | ||
| 10 | |||
| 11 | === Changed default search engine === | ||
| 12 | |||
| 13 | Lucene Search is promoted as default search. | ||
| 14 | |||
| 15 | image:searchlucene.png | ||
| 16 | |||
| 17 | To read about the benefits of using Lucene search over Database search go to the [[search application page>>code:Applications.SearchApplication]]. | ||
| 18 | |||
| 19 | Starting with the 2.4 release you can select the wikis where to search in using the LuceneSearch page. | ||
| 20 | |||
| 21 | [[image:wikiselection.png||style="border:1px solid black;"]] | ||
| 22 | |||
| 23 | === New search configuration UI === | ||
| 24 | |||
| 25 | image:searchadministration.png | ||
| 26 | |||
| 27 | The Search Application now has a dedicated section in the wiki administration section from which you can: | ||
| 28 | |||
| 29 | * Choose the default engine (Lucene or Database). | ||
| 30 | * See the status for the Lucene Search: the number of indexed elements and the number of elements waiting in the queue. | ||
| 31 | * Control the Lucene index by indexing the whole farm, indexing the wiki or customizing the index to your specific preferences. | ||
| 32 | |||
| 33 | For more information check out the [[documentation page>>http://code.xwiki.org/xwiki/bin/view/Applications/SearchApplication]]. | ||
| 34 | |||
| 35 | == New Template-based page creation == | ||
| 36 | |||
| 37 | Starting with XWiki Enterprise 2.4 users and applications can provide documents that can be used as template when creating new pages. The new document (content, objects and other metadata) will be replicated from the template. | ||
| 38 | |||
| 39 | * After you have [[created the template and the template provider>>code:Applications.AdministrationApplication#HEasyTemplatesCreationandAdministration28StartingwithXWikiEnterprise2.4M229]] you can then start creating pages from this template: | ||
| 40 | |||
| 41 | image:1gcreatedocument.jpg | ||
| 42 | |||
| 43 | * "Wanted Links" also offers the choice to create the new document from the available templates ( "My Template" template in the image below): | ||
| 44 | |||
| 45 | image:1ipopup.jpg | ||
| 46 | |||
| 47 | Find more details about the template creation and administration on the [[documentation page>>code:Applications.AdministrationApplication#HEasyTemplatesCreationandAdministration28StartingwithXWikiEnterprise2.4M229]]. | ||
| 48 | |||
| 49 | == New Invitation Manager application == | ||
| 50 | |||
| 51 | The Invitation Manager application allows users to send emails, inviting friends and colleagues to join a wiki. You will be able to configure your wiki to send emails through an open mail relay on the server or through an email account of your choosing. | ||
| 52 | |||
| 53 | image:InvitationSending.png | ||
| 54 | |||
| 55 | Read more about this application and learn how to configure it by visiting the [[application page>>code:Applications.InvitationApplication]]. | ||
| 56 | |||
| 57 | == WYSIWYG improvements == | ||
| 58 | |||
| 59 | === Insert external image === | ||
| 60 | |||
| 61 | You can now insert an external image in the edited page while in WYSIWYG mode. The external image is specified by its location on the web, i.e. its URL. To do this go to Image > Insert Image... menu and select the "External" tab: | ||
| 62 | |||
| 63 | image:XWIKI-5202.png | ||
| 64 | |||
| 65 | === Insert macros === | ||
| 66 | |||
| 67 | You may insert macros with a single click from the tool bar: | ||
| 68 | |||
| 69 | [[image:insertMacroFromToolBar.png]] | ||
| 70 | |||
| 71 | === Paste with filtered styles === | ||
| 72 | |||
| 73 | A 'paste with filtered styles' button has also been added to the tool bar: | ||
| 74 | |||
| 75 | [[image:pasteIconOnToolBar.png]] | ||
| 76 | |||
| 77 | The Wysiwyg editor import from office feature now filters style by default. | ||
| 78 | |||
| 79 | == Objects and classes editor improvements == | ||
| 80 | |||
| 81 | The object and class editor are now fully panel-less, which among other things means that you have the full object/class editors UI even in an empty wiki without having to import the needed XE xar. | ||
| 82 | |||
| 83 | [[image:objecteditor.png||style="border:1px solid black;" width="500"]] | ||
| 84 | |||
| 85 | The class editor also adds better refactoring capabilities: | ||
| 86 | |||
| 87 | * Reorder class properties | ||
| 88 | * Delete a class property | ||
| 89 | |||
| 90 | [[image:classeditor.png||style="border:1px solid black;" width="500"]] | ||
| 91 | |||
| 92 | There are also many other small ergonomics improvements to discover ! | ||
| 93 | |||
| 94 | == JMX Administration Console == | ||
| 95 | |||
| 96 | * XWiki is now using [[JMX to provide runtime Monitoring information>>platform:AdminGuide.Monitoring]]. | ||
| 97 | * The first usage implemented is about monitoring the JBoss cachad and the Velocity Macro caches, as shown below: | ||
| 98 | |||
| 99 | image:platform:AdminGuide.Monitoring@jconsole1.png | ||
| 100 | |||
| 101 | == Watchlist improvements == | ||
| 102 | |||
| 103 | * Allow to remove elements in the watchlist from the user profile | ||
| 104 | * Add in virtual mode, add a wikis section in "elements in your watchlist" | ||
| 105 | |||
| 106 | [[image:watchlist.png||style="border:1px solid black;"]] | ||
| 107 | |||
| 108 | == Rendering cache == | ||
| 109 | |||
| 110 | You can now provide a list of pages for which to cache the result. See ##core.renderingcache.*## properties to control it. | ||
| 111 | |||
| 112 | It's also possible to force a page to refresh by using ##refresh=1## parameter in the URL. | ||
| 113 | |||
| 114 | == New Code macro configuration == | ||
| 115 | |||
| 116 | It's now possible to indicate which Pygments style to use with the default highlighter based on Pygments. | ||
| 117 | |||
| 118 | See http://code.xwiki.org/xwiki/bin/view/Macros/CodeMacro20 for more details. | ||
| 119 | |||
| 120 | == Security improvements == | ||
| 121 | |||
| 122 | * Added support for HttpOnly flag for session cookies (XSS protection measure) | ||
| 123 | * Fixed some XSS issues | ||
| 124 | * Improved file access sandboxing | ||
| 125 | |||
| 126 | == Performance improvements == | ||
| 127 | |||
| 128 | * Defered scripts | ||
| 129 | |||
| 130 | == Chart macro improvements == | ||
| 131 | |||
| 132 | * Chart macro now supports more than 26 columns. | ||
| 133 | |||
| 134 | == Script improvements == | ||
| 135 | |||
| 136 | * Make the Query Manager use the Script Service to expose services to scripts. See [[Query Guide>>platform:DevGuide.QueryGuide]] for more details. | ||
| 137 | * Make possible to directly return the Block based result of a script macro. It's supported for all JSR 223 macro which means all script macro script Velocity macro for now. See [[Script Macro>>code:Macros.ScriptMacro]] for more details. | ||
| 138 | * Prevent nested script macros by default: It's now impossible for the output of a script macro to become another script macro for security reasons. See [[Script Macro>>code:Macros.ScriptMacro]] for more details. | ||
| 139 | * Provide a way to escape regexp literal string from velocity | ||
| 140 | {{code language="none"}}$regextool.quote("some[literal]text"){{/code}} | ||
| 141 | |||
| 142 | == Javascript improvements == | ||
| 143 | |||
| 144 | * Start writing a Javascript mirror of the XWiki data model: Document.getURL | ||
| 145 | * New "suggestDocuments" behavior for input fields | ||
| 146 | |||
| 147 | == REST improvements == | ||
| 148 | |||
| 149 | * Isolate REST API JAXB model classes in a separate module | ||
| 150 | |||
| 151 | == Dependencies upgrade == | ||
| 152 | |||
| 153 | * Doxia 1.1.3 | ||
| 154 | * JODConverter 3.0 beta3 | ||
| 155 | * JBossCache 3.2.5.GA | ||
| 156 | * Groovy 1.7.3 | ||
| 157 | * Script.aculo.us 1.8.3 | ||
| 158 | * Jython 2.5.2b1 | ||
| 159 | * Hibernate Validator 4.0.2 | ||
| 160 | * JGroups 2.8 | ||
| 161 | * JFreeChart 1.0.13 | ||
| 162 | |||
| 163 | == Translations == | ||
| 164 | |||
| 165 | * WYSIWYG newly supported language: Russian | ||
| 166 | * All the translations have been updated | ||
| 167 | |||
| 168 | = Known issues = | ||
| 169 | |||
| 170 | * [[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]] | ||
| 171 | |||
| 172 | = Backward Compatibility and Migration Notes = | ||
| 173 | |||
| 174 | == Important non-compatible changes == | ||
| 175 | |||
| 176 | {{warning}} | ||
| 177 | TODO | ||
| 178 | {{/warning}} | ||
| 179 | |||
| 180 | == General Notes == | ||
| 181 | |||
| 182 | {{warning}} | ||
| 183 | 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. | ||
| 184 | {{/warning}} | ||
| 185 | |||
| 186 | == Migration Notes == | ||
| 187 | |||
| 188 | * Standalone/inline Macro parsing has been fixed.((( | ||
| 189 | {{error}} | ||
| 190 | There has been a [[bug>>http://jira.xwiki.org/jira/browse/XWIKI-5050]] that appeared when we released the new XWiki Syntax 2.0 several releases back and which we've finally fixed in this release. Basically if you had a macro followed by a new line and then another macro, both macros were considered as being standalone. This is now fixed and they are correctly considered by the parser as inline. More specifically if you were previously using a standalone macro (such as the TOC macro or the HTML macro) and your macro wasn't separated from a previous macro by at least 2 new lines, it'll now fail to render. | ||
| 191 | |||
| 192 | In addition, several pages that are part of the XWiki Enterprise default XAR were not written correctly and didn't have these 2 new lines as mentioned above. We've fixed these pages too but you'll need to make sure you import them in your existing wiki (if you're upgrading) since otherwise these pages will fail to display correctly. These pages are: | ||
| 193 | * XWiki.ClassSheet | ||
| 194 | * XWiki.WebSearch | ||
| 195 | * XWiki.LuceneSearch | ||
| 196 | {{/error}} | ||
| 197 | ))) |
