Wiki source code of XWiki Enterprise 2.6
Last modified by Thomas Mortagne on 2023/10/13 16:37
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{box cssClass="floatinginfobox" title="**Contents**"}} | ||
| 2 | {{toc/}} | ||
| 3 | {{/box}} | ||
| 4 | |||
| 5 | XWiki Enterprise 2.6 is a release mostly focused on stabilization but in which we've implemented a redesigned Activity Stream, Share Page by mail feature and Icon/Emoticon support (See the initial [[Roadmap>>Main.Roadmap]]). | ||
| 6 | |||
| 7 | = New and Noteworthy (since XWiki Enterprise 2.5) = | ||
| 8 | |||
| 9 | == 1 Activity Stream == | ||
| 10 | |||
| 11 | * Overhaul of the Recent Changes section of the Dashboard:((( | ||
| 12 | * New UI | ||
| 13 | * Support for more events compared to the previous Recent Changes: annotations, comments, document deletion | ||
| 14 | * It's now called Recent Activity (was called Recent Changes) | ||
| 15 | |||
| 16 | [[image:ReleaseNotes.ReleaseNotesXWikiEnterprise26RC1@activityMacro||style="border: 1px solid black;"]] | ||
| 17 | ))) | ||
| 18 | |||
| 19 | == 2 Share Page by Mail == | ||
| 20 | |||
| 21 | [[image:[email protected]||style="border: 1px solid #000;"]] | ||
| 22 | |||
| 23 | [[image:[email protected]||style="border: 1px solid #000;"]] | ||
| 24 | |||
| 25 | [[image:[email protected]||style="border: 1px solid #000;"]] | ||
| 26 | |||
| 27 | == 3 Icon/Emoticon Support == | ||
| 28 | |||
| 29 | * Added a syntax in the experimental XWiki Syntax 2.1 for inserting an icon from the [[XWiki Icon Set>>http://www.famfamfam.com/lab/icons/silk/previews/index_abc.png]].((( | ||
| 30 | Usage: | ||
| 31 | {{code language="none"}}image:icon:<icon name>{{/code}} | ||
| 32 | Example: | ||
| 33 | {{code language="none"}}image:icon:accept{{/code}} | ||
| 34 | ))) | ||
| 35 | * Added the ability to map characters to an icon in any XWiki Syntax (edit ##xwiki.properties## to modify or add new mappings).((( | ||
| 36 | Default mappings: | ||
| 37 | |||
| 38 | |=Characters|=Result | ||
| 39 | |##{{{:)}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/emoticon_smile.gif]] | ||
| 40 | |##{{{:(}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/emoticon_unhappy.gif]] | ||
| 41 | |##{{{:P}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/emoticon_tongue.gif]] | ||
| 42 | |##{{{:D}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/emoticon_grin.gif]] | ||
| 43 | |##{{{;)}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/emoticon_wink.gif]] | ||
| 44 | |##{{{(y)}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/thumb_up.gif]] | ||
| 45 | |##{{{(n)}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/thumb_down.gif]] | ||
| 46 | |##{{{(i)}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/information.gif]] | ||
| 47 | |##{{{(/)}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/accept.gif]] | ||
| 48 | |##{{{(x)}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/cancel.gif]] | ||
| 49 | |##{{{(!)}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/error.gif]] | ||
| 50 | |##{{{(+)}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/add.gif]] | ||
| 51 | |##{{{(-)}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/delete.gif]] | ||
| 52 | |##{{{(?)}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/help.gif]] | ||
| 53 | |##{{{(on)}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/lightbulb.gif]] | ||
| 54 | |##{{{(off)}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/lightbulb_off.gif]] | ||
| 55 | |##{{{(*)}}}##|[[image:http://www.xwiki.org/xwiki/bin/skin/resources/icons/silk/star.gif]] | ||
| 56 | ))) | ||
| 57 | * Box Macro's image parameter now support referencing an icon.((( | ||
| 58 | Example: | ||
| 59 | |||
| 60 | {{code language="none"}}{{box image="icon:accept"}} | ||
| 61 | Some content | ||
| 62 | {{/box}}{{/code}} | ||
| 63 | ))) | ||
| 64 | |||
| 65 | == 4 Auto linking of WikiWords == | ||
| 66 | |||
| 67 | * Added ability to automatically create wiki links on WikiWords. | ||
| 68 | |||
| 69 | {{info}} | ||
| 70 | Not enabled by default, to enable edit ##xwiki.properties##. | ||
| 71 | {{/info}} | ||
| 72 | |||
| 73 | == 5 New Activity Macro == | ||
| 74 | |||
| 75 | * New [[Activity macro>>extensions:Extension.Activity Macro]]. | ||
| 76 | |||
| 77 | == 6 Others == | ||
| 78 | |||
| 79 | * Scheduler jobs can be located in any page in the wiki and not only in the Scheduler space. | ||
| 80 | * Converted [[several Administration application pages>>https://jira.xwiki.org/secure/IssueNavigator.jspa?reset=true&jqlQuery=project+%3D+XAADMINISTRATION+AND+fixVersion+%3D+%221.42%22]] to XWiki Syntax 2.0 | ||
| 81 | * Improved livetable performance by [[throttling the requests>>http://ajaxpatterns.org/Submission_Throttling]] sent (one every few milliseconds). | ||
| 82 | * All the translations have been updated | ||
| 83 | * Lots of bug fixes and small improvements (full list in [[JIRA>>https://jira.xwiki.org]]) | ||
| 84 | |||
| 85 | == 7 For developers == | ||
| 86 | |||
| 87 | * Added new event types: add/update/delete comment/annotation/attachment | ||
| 88 | * Added ability to define in ##xwiki.properties## which Rendering Transformations to execute when rendering a document. | ||
| 89 | * Replace Velocity Date Tool by Velocity Date Comparison Tool which offers even more APIs. | ||
| 90 | |||
| 91 | = Known issues = | ||
| 92 | |||
| 93 | * There's a important bug in the Icon Transformation which makes content not rendered properly if there are partial matches followed by an icon match. See [[XWIKI-5729>>https://jira.xwiki.org/browse/XWIKI-5729]]. You can disable the Icon Transformation by editing the ##xwiki.properties## file if it's causing problems for you. | ||
| 94 | * The Send Page by mail feature currently doesn't work on IPv6 systems if your machine is on localhost. To work around this start your container with ##-Djava.net.preferIPv4Stack=true##. | ||
| 95 | * {{error}}There's a [[bug>>https://jira.xwiki.org/browse/XWIKI-5724]] in the import that will make the Main.Spaces, Main.Activity and XWiki.TagCloud pages not work anymore after they are imported. You need to resave them with a user having Admin rights.{{/error}} | ||
| 96 | * [[Other bugs we know about>>https://jira.xwiki.org/secure/IssueNavigator.jspa?reset=true&&type=1&pid=10010&resolution=-1&sorter/field=updated&sorter/order=DESC]] | ||
| 97 | |||
| 98 | = Backward Compatibility and Migration Notes = | ||
| 99 | |||
| 100 | == General Notes == | ||
| 101 | |||
| 102 | {{warning}} | ||
| 103 | 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,...//. | ||
| 104 | {{/warning}} | ||
| 105 | |||
| 106 | You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from the improvements listed above. | ||
| 107 | |||
| 108 | {{warning}} | ||
| 109 | 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. | ||
| 110 | {{/warning}} | ||
| 111 | |||
| 112 | == Notes specific to XWiki Enterprise 2.6 == | ||
| 113 | |||
| 114 | * **The XWiki.XWikiPreferences page must be converted to the xwiki/2.0 syntax**: | ||
| 115 | ** Go to http://yourdomain/xwiki/bin/edit/XWiki/XWikiPreferences?editor=wiki | ||
| 116 | ** Put the following in the content field {{{ {{include document="XWiki.AdminSheet"/}} }}} | ||
| 117 | ** Change the syntax to xwiki/2.0 and press cancel (the automatic conversion would convert fields that must not be converted in the XWikiPreferences object) | ||
| 118 | * The Main.RecentChages page was removed and replaced by Main.Activity | ||
| 119 | * The configuration option controlling the experimental CSRF protection mechanism introduced in 2.5 was changed from ##core.csrf.enabled## to ##csrf.enabled##. If you are using CSRF protection, make sure to re-enable it by setting ##csrf.enabled = true## in ##xwiki.properties##. | ||
| 120 | * The configuration option to define macro categories was changed from ##rendering.macroCategories## to ##rendering.transformation.macro.categories##. If you're using this option make sure you modify its name in ##xwiki.properties##. | ||
| 121 | |||
| 122 | == API Breakages == | ||
| 123 | |||
| 124 | The following APIs were modified since XWiki Enterprise 2.5: | ||
| 125 | |||
| 126 | {{code language="none"}} | ||
| 127 | ERROR: 7006: org.xwiki.annotation.maintainer.AbstractAnnotationMaintainer: Return type of method 'protected void recomputeProperties(org.xwiki.annotation.Annotation, java.util.Collection, java.lang.String, org.xwiki.annotation.content.AlteredContent, java.lang.String)' has been changed to boolean | ||
| 128 | ERROR: 7012: org.xwiki.bridge.SkinAccessBridge: Method 'public java.lang.String getIconURL(java.lang.String)' has been added to an interface | ||
| 129 | ERROR: 8001: org.xwiki.component.manager.AbstractComponentDescriptorEvent: Class org.xwiki.component.manager.AbstractComponentDescriptorEvent removed | ||
| 130 | ERROR: 8001: org.xwiki.component.manager.ComponentDescriptorAddedEvent: Class org.xwiki.component.manager.ComponentDescriptorAddedEvent removed | ||
| 131 | ERROR: 8001: org.xwiki.component.manager.ComponentDescriptorEvent: Class org.xwiki.component.manager.ComponentDescriptorEvent removed | ||
| 132 | ERROR: 8001: org.xwiki.component.manager.ComponentDescriptorRemovedEvent: Class org.xwiki.component.manager.ComponentDescriptorRemovedEvent removed | ||
| 133 | ERROR: 8001: org.xwiki.component.manager.ComponentEventManager: Class org.xwiki.component.manager.ComponentEventManager removed | ||
| 134 | ERROR: 8001: org.xwiki.observation.event.ScriptEvaluationFinishedEvent: Class org.xwiki.observation.event.ScriptEvaluationFinishedEvent removed | ||
| 135 | ERROR: 8001: org.xwiki.observation.event.ScriptEvaluationStartsEvent: Class org.xwiki.observation.event.ScriptEvaluationStartsEvent removed | ||
| 136 | ERROR: 7012: org.xwiki.rendering.block.Block: Method 'public org.xwiki.rendering.block.Block getNextSibling()' has been added to an interface | ||
| 137 | ERROR: 7012: org.xwiki.rendering.block.Block: Method 'public org.xwiki.rendering.block.Block getPreviousSibling()' has been added to an interface | ||
| 138 | ERROR: 7012: org.xwiki.rendering.block.Block: Method 'public void removeBlock(org.xwiki.rendering.block.Block)' has been added to an interface | ||
| 139 | ERROR: 7012: org.xwiki.rendering.block.Block: Method 'public void setNextSiblingBlock(org.xwiki.rendering.block.Block)' has been added to an interface | ||
| 140 | ERROR: 7012: org.xwiki.rendering.block.Block: Method 'public void setPreviousSiblingBlock(org.xwiki.rendering.block.Block)' has been added to an interface | ||
| 141 | ERROR: 6001: org.xwiki.rendering.block.NewLineBlock: Removed field NEW_LINE_BLOCK | ||
| 142 | ERROR: 6001: org.xwiki.rendering.block.SpaceBlock: Removed field SPACE_BLOCK | ||
| 143 | ERROR: 7002: org.xwiki.rendering.configuration.RenderingConfiguration: Method 'public java.util.Properties getMacroCategories()' has been removed | ||
| 144 | ERROR: 7012: org.xwiki.rendering.configuration.RenderingConfiguration: Method 'public java.util.List getTransformations()' has been added to an interface | ||
| 145 | ERROR: 6001: org.xwiki.rendering.listener.reference.ResourceType: Removed field IMAGE | ||
| 146 | ERROR: 7002: org.xwiki.rendering.wiki.WikiModel: Method 'public java.lang.String getAttachmentURL(org.xwiki.rendering.listener.reference.ResourceReference)' has been removed | ||
| 147 | ERROR: 7012: org.xwiki.rendering.wiki.WikiModel: Method 'public java.lang.String getLinkURL(org.xwiki.rendering.listener.reference.ResourceReference)' has been added to an interface | ||
| 148 | ERROR: 7002: org.xwiki.rendering.scaffolding.MockWikiModel: Method 'public java.lang.String getAttachmentURL(org.xwiki.rendering.listener.reference.ResourceReference)' has been removed | ||
| 149 | {{/code}} |
