ReleaseNotesXWikiEnterprise18 (XWiki.org)

1

#startfloatingbox()

2

*Contents*

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

#endfloatingbox()

#macro(displayImg $img)

#end

1 Release Notes for XWiki Enterprise 1.8

11

12

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.

13

#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")

14

15

1.1 Changes since XWiki Enterprise 1.7

16

17

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

18

19

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

20

* First usable version of the new GWT WYSIWYG editor

21

* Upgrade to groovy 1.6.

22

* new "useravatar" macro for 2.0 syntax

23

* new "rss" macro for 2.0 syntax

24

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

25

* 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.")

26

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

27

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

28

29

1.1.1 2. Usability Improvements

30

31

* *New Wiki Dashboard* on the home page:

32

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

33

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

34

*** Links to the administration of each space.

35

*** Allows to create new spaces.

36

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

37

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

38

39

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

40

** Tag rename.

41

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

42

43

* *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}

44

- | XE 1.8M1 | XE 1.8M2

45

Requests number | 37 | 25

46

Total size | 332Ko | 200Ko

47

Download @ T1 (seconds) | 9.16 | 6.06

48

{table}

49

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

50

51

1.1.1 3. Authentication

52

53

* 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>.

54

55

1.1.1 4. Translations

56

57

* New or improved translations:

** french

** german

** spanish

1.1.1 5. Important bugs fixed

63

64

* Scaled images in exported PDF and RTF have wrong dimensions

65

* When a wiki is removed, it's not removed form the cache

66

* Including a document with first or second heading level breaks the including document section edit link

67

* PDF export does not take into account the encoding specified in xwiki.cfg

1.1.1 6. Others

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

72

* *New REST API*

73

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

74

75

## + 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]

80

81

1.1 Common Migration notes

82

83

#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>.")

84

85

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

86

87

#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.")

88

89

1.1.1 Applications migration

90

91

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:

92

* scriptaculous files

93

* accordions files

94

* chart wizard files

95

* usersandgroups.js and usersandgroups.css

96

* livetable.js and livetable.css

97

* lightbox.js

98

* tablefilterNsort.js and table.css

99

* fullscreenEdit.js and fullscreenEdit.css

100

101

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:

102

103

{code}

104

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

105

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

106

{code}