ReleaseNotesXWikiEnterprise18 (XWiki.org)

1

#startfloatingbox()

2

*Contents*

#toc ("2" "3" "")

#endfloatingbox()

1 Release Notes for XWiki Enterprise 1.8

7

8

The focus on 1.8 branch was on making the new rendering architecture and the new GWT based WYSIWYG able to fully replace the "old" rendering and TinyMCE based WYSIWYG.

9

#warning("This version introduce conditional loading of JavaScript and StyleSheet in order for pages to load faster, sending to the browser only the files it needs to display the requested pages. This might break existing applications developed on top of XWiki that relied on such JavaScript and CSS files being present all the time. See [Applications migration section>#HApplicationsmigration] for more details")

10

11

1.1 Changes since XWiki Enterprise 1.7

12

13

1.1.1 1. First usable version of new rendering and new WYSIWYG editor

14

15

* Add ability to configure xwiki to use the XWiki Syntax 2.0 as default when creating new pages

16

* First usable version of the new GWT WYSIWYG editor

17

* Upgrade to groovy 1.6.

18

* new "useravatar" macro for 2.0 syntax

19

* new "rss" macro for 2.0 syntax

20

* Added [wiki syntax for embedded documents>platform:Main.XWikiSyntax#HEmbeddeddocuments28XWikisyntax20only29]

21

* Syntax API to convert a document from one syntax to another + new converter from XWiki Syntax 1.0 to XWiki Syntax 2.0. #info("You can try it by changing the syntax identifier of a page.")

22

23

1.1.1 2. Usability Improvements

24

25

* *New Wiki Dashboard* on the home page:

26

** Spaces: all the spaces within your wiki (technical spaces are hidden):

27

*** Links to the list of pages within each spaces.

28

*** Links to the administration of each space.

29

*** Allows to create new spaces.

30

** Tags: all the tags in the wiki under the form of a tag cloud.

31

** Recent changes: all the recent modifications in the wiki, grouped by author and by date.\\\\#displayImg("dashboard.jpg")

32

33

* *New way of displaying tags*, with 2 new features:

34

** Tag rename.

35

** Tag delete.\\\\#displayImg("tags.jpg")

36

37

* *Page loading time reduced by 30%*. Statistics on Sandbox.WebHome, ~~without client-side file caching~~ (most of the downloaded files are cached on the client after the first request):\\{table}

38

- | XE 1.8M1 | XE 1.8M2

39

Requests number | 37 | 25

40

Total size | 332Ko | 200Ko

41

Download @ T1 (seconds) | 9.16 | 6.06

42

{table}

43

* *Improved information section in document footer*, including document children:\\\\#displayImg("footer.jpg")

44

* *[New Office Importer>code:Applications.OfficeImporterApplication]*

45

* *New REST API*

46

* *[New Blog application>code:Applications.BlogApplication]*

47

48

1.1.1 3. Authentication

49

50

* Improved authentication performance for LDAP. By default the authentication system now calls the authenticator only once by session, this means it does not call the LDAP authenticator and does not generate queries on the LDAP server for each request anymore. This can be changed using the <tt>xwiki.authentication.always</tt> configuration property in <tt>xwiki.cfg</tt>.

51

52

1.1.1 4. Translations

53

54

* New or improved translations:

** french

** german

** spanish

1.1.1 5. Important bugs fixed

60

61

* Many bug fixes and improvements in the new GWT WYSIWYG editor

62

* Many bug fixes and improvements in the new XWiki 2.0 syntax rendering

63

* Many bug fixes and improvements in 1.0->2.0 syntaxes conversion

64

* Erroneous rendering of links to page anchors

65

* If a macro fail it breaks the whole rendering process

66

67

## + lots of other changes, see [Platform details>http://jira.xwiki.org/jira/secure/ReleaseNote.jspa?version=10696&styleName=Text&projectId=10010&Create=Create].

1.1 Known issues

* [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]

72

73

1.1 Common Migration notes

74

75

#warning("If you're running in a multiwiki setup you'll also need to define the property <tt>xwiki.store.migration.databases=all</tt> to your <tt>xwiki.cfg</tt> file or explicitely name all databases to be migrated as in <tt>xwiki.store.migration.databases=db1,db2,...</tt>.")

76

77

You may also want to [import the default wiki XAR>Main.Download] in order to benefit from improvements listed above.

78

79

#warning("Always make sure you compare your <tt>xwiki.cfg</tt> file with the newest version since some configuration parameters were added. Of note, you should add <tt>xwiki.store.migration=1</tt> so that XWiki will attempt to automatically migrate your current database to the new schema. Make sure you backup your Database before doing anything.")

80

81

1.1.1 Applications migration

82

83

XE 1.8M2 has introduced [conditional loading of JavaScript and StyleSheet files>http://jira.xwiki.org/jira/browse/XWIKI-3177] in order for pages to load faster, sending to the browser only the files it needs to display the requested pages. This might break existing applications developed on top of XWiki that relied on such JavaScript and CSS files being present all the time. Concerned files and libraries are the following:

84

* scriptaculous files

85

* accordions files

86

* chart wizard files

87

* usersandgroups.js and usersandgroups.css

88

* livetable.js and livetable.css

89

* lightbox.js

90

* tablefilterNsort.js and table.css

91

* fullscreenEdit.js and fullscreenEdit.css

92

93

If you have applications that relies on one or several of these libraries, you will need to explicitly make them request the desired files using the [Skin Extension plugin>code:Plugins.SkinExtensionsPlugin]. For example, if your application needs the live-table feature (the dynamic AJAX grid), add the following lines to the code page that requires it:

94

95

{code}

96

$xwiki.jsfx.use('js/xwiki/table/livetable.js') ## Inject livetable.js <script> tag in the header

97

$xwiki.ssfx.use('js/xwiki/table/livetable.css') ## Inject livetable.css <link> tag in the header

98

{code}