Changes for page Release Notes for XWiki 6.4

Last modified by Thomas Mortagne on 2023/10/13

From 7.1 to 8.1 From 10.2 to 10.3

From version 8.1

edited by Manuel Smeria
on 2015/01/20

Change comment: There is no comment for this version

To version 10.2

edited by Vincent Massol
on 2015/01/21

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (2 modified, 0 added, 0 removed)

Details

Page properties

Author

@@ -1,1 +1,1 @@
--XWiki.ManuelSmeria
++XWiki.VincentMassol

Content

@@ -10,8 +10,96 @@
  [[Full list of issues fixed and Dashboard for <version>>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=<fill id here>]].
--== Mail Sender API Improvements ==
++== Menu Application ==
++Taking advantage of the ability to have LESS inside our [[StyleSheetExtensions>>extensions:Extension.Skin Extension Plugin||anchor="HUseLESS"]], we improved the [[Menu Application>>extensions:Extension.Menu Application]], on Flamingo based skins, making it responsive and also adapting its styling according to the active [[Flamingo Theme>>extensions:Extension.Flamingo Theme Application]].
++Colibri based skins preserve the initial styling.
++
++{{gallery}}
++image:ReleaseNotesXWiki64M2@menu_flamingo_charcoal.png
++image:ReleaseNotesXWiki64M2@menu_flamingo_united.png
++image:ReleaseNotesXWiki64M2@menu_flamingo_darkly.png
++image:ReleaseNotesXWiki64M2@menu_flamingo_simplex.png
++image:ReleaseNotesXWiki64M2@menu_flamingo_charcoal_responsive.png
++{{/gallery}}
++
++== Flamingo Skin ==
++
++We partially restored the behaviour of the top level menu from version 6.2, with some improvements:
++
++* For tablet and desktop:
++** the menu label is a link used for navigation
++** the toggle (arrow / caret) is used for opening the drop down menu, but should be better separated from the label
++* On phones the behaviour remains the same: taping on the label opens the menu(((
++{{gallery}}
++image:[email protected]
++image:[email protected]
++image:[email protected]
++image:[email protected]
++{{/gallery}}
++)))
++* The history table, under each page, is now responsive to the screen size:(((
++{{image reference="[email protected]" /}}
++)))
++* Some improvements have been made on the responsive tables (including the livetables) and we have fixed the broken livetables for mobiles on some places:(((
++{{image reference="[email protected]" width="30%"/}} {{image reference="[email protected]" width="30%"/}} {{image reference="[email protected]" width="30%"/}}
++)))
++
++== Rating Features ==
++
++=== Ratings module ===
++
++Contrib ratings project has been moved to platform. Java APIs have been broken by the package renaming but script APIs have been kept retro-compatible and the UI is mostly the same.
++
++See [[Ratings Application>>extensions:Extension.Ratings Application]].
++
++=== Ratings support for extensions ===
++
++It's now possible to rate extensions in [[Extension Repository>>extensions:Extension.Repository Application]] and any repository handler can expose extension rating that are displayed (read only for now) in [[Extension Manager>>extensions:Extension.Extension Manager Application]].
++
++{{image reference="[email protected]"/}} {{image reference="[email protected]"/}}
++
++== Wiki Configuration ==
++
++A new "Configuration > Wiki" section is added in Administration where you can configure the current wiki, whether it is the main wiki or a subwiki.
++
++{{image reference="ReleaseNotesXWiki64M3@wikiDescriptorEditingAdministration-cropped.png"/}}
++
++For more information, see the [[documentation>>extensions:Extension.Wiki Application||anchor="HConfigureWiki"]].
++
++== New Parameters for Document Tree Macro ==
++
++We added 3 new parameters to the [[Document Tree Macro>>extensions:Extension.Document Tree Macro]]:
++
++* **filterByClass**: show only the documents that have an object of the specified type. The value of this parameter is the full name of an XWiki document that holds a class definition. For example, 'Blog.CategoryClass' can be used to show only the documents that represent blog categories.
++* **openTo**: the id of the node to open the tree to. All the ancestors of the specified node, up to the root of the tree, will be opened also.
++* **showOnlyViewable**: show only the wiki, space and document nodes for which the current user has view right. If this is set to false then the wiki, space and document nodes that are not viewable by the current user are listed in the tree using their names. The user won't be able to see their content by following their links though (the user will just be aware of their existence).
++
++== Mail Feature ==
++
++* The mail feature has a new Category in the Admin UI (see the [[Mail Application>>extensions:Extension.Mail Application]] for details).(((
++{{image reference="[email protected]"/}}
++)))
++* There's now the possibility to configure default BCC addresses which will be added by default to all emails sent using the [[Mail Sender API>>extensions:Extension.Mail Sender API]].(((
++{{image reference="[email protected]"/}}
++)))
++* The [[Mail Sender API>>extensions:Extension.Mail Sender API]] now checks for permission before sending emails, when using it from scripts (i.e. when using the Mail Sender Script Service). There are currently 2 possible strategies that you configure in your ##xwiki.properties## file(((
++{{code language="none"}}
++#-# [Since 6.4M2]
++#-# Defines which authorization checks are done when sending mails using the Mail Sender Script Service.
++#-# Example of valid values:
++#-# - "programmingrights": the current document must have Programming Rights
++#-# - "alwaysallow": no check is performed. This is useful when running XWiki in a secure environment where we
++#-#   want to allow all users to be able to send emails through the Script Service.
++#-# The default is:
++# mail.sender.scriptServiceCheckerHint = programmingrights
++{{/code}}
++)))
++* The [[Mail Sender API>>extensions:Extension.Mail Sender API]] has been modified to support sending a large number of mails at once. In addition the [[Mail Admin UI>>extensions:Extension.Mail Application]] has been improved to display the statuses of mails (when they're sent by XWiki features specifying that the mail statuses should be persisted).(((
++{{image reference="[email protected]"/}}
++
++{{image reference="[email protected]"/}}
++)))
  * You can now specify the delay to wait between each mail being sent, in milliseconds. This is done to support mail throttling and not be considered a spammer by mail servers. For example if you wish to wait 10 seconds (if not specified the default is 8 seconds, which is 450 mails per hour), set the following in your ##xwiki.properties##:(((
  {{code language="none"}}
  mail.sender.sendWaitTime = 10000
@@ -43,37 +43,231 @@
  {{image reference="mailwiki.png"/}}
  )))
++== Wikis ==
++
++* A "Wikis" category has been created in the administration, where the configuration have been moved and split in different sections:(((
++|=Left menu|=Right menu
++|{{image reference="[email protected]"/}}|{{image reference="[email protected]"/}}
++)))
++
++== Extension Manager incompatible exceptions ==
++
++When trying to install an incompatible extension (i.e. you are running XWiki 6.2.4 and want to install FAQ Application 6.3), you are now displayed a proper error instead of having to read through the install log to understand what went wrong, and you are instructed to use the ##Description > Stable Versions## section to manually (for now) find a compatible version of the extension that you want to install.
++
++{{image reference="[email protected]"/}}
++
++== Solr server setup package ==
++
++Everything needed to setup an XWiki index in a remote Solr server is now packaged in a standalone project (##xwiki-platform-search-solr-server-data##). A Debian package (##xwiki-solr-data##) has also been provided to make easier to keep it up to date.
++
  == Miscellaneous ==
--<insert misc user stuff and important bug fix descriptions here in a list, when they are too small to warrant a section by themselves - Change the version in the URL below!>
++* It's [[now possible to send Registration emails in HTML>>extensions:Extension.Administration Application||anchor="HRegistration"]] (by default they're sent in plain text). This is achieved by fully supporting any MIME content in the "Validation Email Content" and "Confirmation Email Content" sections of the Registration Administration UI. For example for the "Validation Email Content" field, you could use the following template to send HTML emails:(((
++{{code language="none"}}
++#set ($wikiname = $request.serverName)
++#set ($host = ${request.getRequestURL()})
++#set ($host = ${host.substring(0, ${host.indexOf('/', ${mathtool.add(${host.indexOf('//')}, 2)})})})
++Subject: Validate your account on ${wikiname}
++Content-type: text/html; charset=iso-8859-1
++<p>Hello <b>${xwiki.getUserName("XWiki.$xwikiname", false)}</b>,</p>
++<p>This email address was used to register a new account on ${wikiname}. If you did not make the request, please ignore this message.</p>
++<p>In order to activate your account, please follow this link:
++${host}${xwiki.getURL('XWiki.AccountValidation', 'view', "validkey=${validkey}&xwikiname=${xwikiname}")}</p>
++{{/code}}
++)))
++* The selected tree node is now highlighted even when links are enabled:(((
++{{image reference="[email protected]" /}}
++)))
++* A list of icons supported by XWiki have been created, with mapping for Silk and Font Awesome. Which means that we now propose a list of icons that are both present in Silk and Font Awesome.
++* The list of columns in the UserDirectory customization screen is now sorted alphabetically
++* The accuracy of the attachment content type detection has been improved. If the file name extension is unknown then we attempt to detect the content type from the first bytes of the file content. You can check this by attaching a text file without the 'txt' file name extension.
++* Displaying the 'Stable versions' label in an extension's description in Extension Manager before and after the list of versions is retrieved.
++* A click to the Document Index does not lead to an other space anymore.
++* [[extensions:Extension.Tag Cloud Macro]] has now a new parameter (spaces) to display a tag cloud from multiple spaces.
++
  See the [[full list of JIRA issues>>http://jira.xwiki.org/sr/jira.issueviews:searchrequest-printable/temp/SearchRequest.html?jqlQuery=project+in+%28XCOMMONS%2C+XRENDERING%2C+XWIKI%2C+XE%29+and+status+%3D+Closed+and+resolution+%3D+Fixed+and+fixVersion+%3D+%22<version>%22&tempMax=1000]] fixed in this release.
  = For Developers =
--== <developer feature N> ==
++== Icon Picker ==
--<description of developer feature N>
++An [[icon picker>>extensions:Extension.Icon Theme Application||anchor="#HIconPicker"]] has been created to help users selecting an image in the list of supported icons.
--== Deprecated and Retired projects ==
++{{image reference="ReleaseNotes[email protected]"/}}
--<description of deprecated and retired projects>
++This picker is already used in [[Application Within Minutes>>extensions:Extension.App Within Minutes Application]] for the application's icon selection.
++== Skin Extensions ==
++
++[[Now you can use LESS in your Skin Extensions!>>extensions:Extension.Skin Extension Plugin||anchor="HUseLESS"]]. You just need to set the new property "Content Type" to LESS inside your Skin Extension object:
++
++{{image reference="[email protected]"/}}.
++
++== Admin ConfigurableClass ==
++
++The [[##ConfigurableClass## mechanism>>extensions:Extension.Administration Application||anchor="HMakingyourapplicationconfigurablewithConfigurableClass"]] has been improved to be able to contribute new categories in the Admin UI. For example the "Email" Category in the following screenshot is contributed through a ##ConfigurableClass##:
++
++{{image reference="[email protected]"/}}
++
++It was configured using:
++
++{{image reference="[email protected]"/}}
++
++== Velocity changes ==
++
++=== Remove a Velocity Engine from the cache ===
++
++##org.xwiki.velocity.VelocityFactory## now provide an API to remove a cached Velocity Engine.
++
++=== Overriding Velocimacros in wiki-based skins ===
++
++It's now possible to override the ##macros.vm## template in a wiki based skin (object property and attachment). Any modification to this template is also taken into account (the Velocity engine is recreated when the template is modified).
++
++=== Cleanup unprotected namespaces ===
++
++VelocityEngine automatically get rid of the passed namespace at the end of execution unless it's protected.
++
++In practice in means that the following:
++
++{{code language="java"}}
++engine.evaluate(new VelocityContext(), new StringWriter(), "namespace", "#macro(mymacro)toto#end")
++
++Writer out = new StringWriter();
++engine.evaluate(new VelocityContext(), out, "namespace", "#mymacro()")
++
++System.out.println(out.toString())
++{{/code}}
++
++will now print
++
++{{code language="none"}}
++#mymacro()
++{{/code}}
++
++To get
++
++{{code language="none"}}
++toto
++{{/code}}
++
++you need the following
++
++{{code language="java"}}
++engine.startedUsingMacroNamespace("namespace")
++
++try {
++  engine.evaluate(new VelocityContext(), new StringWriter(), "namespace", "#macro(mymacro)toto#end")
++
++  Writer out = new StringWriter();
++  engine.evaluate(new VelocityContext(), out, "namespace", "#mymacro()")
++
++  System.out.println(out.toString())
++} finally {
++  engine.stoppedUsingMacroNamespace("namespace")
++}
++{{/code}}
++
++== Skins system improvements ==
++
++Support for a new ##skin.properties## configuration file has been introduced in filesystem skins.
++
++Right now it supports a ##parent## property to indicate another skin to inherit from. If set to an empty value ({{code language="properties"}}parent={{/code}}) the skin will directly inherit from the WAR; if not set at all it will behave as before which means inherit from whatever is configured in ##xwiki.cfg##'s ##xwiki.defaultbaseskin## property.
++
++== Component Metadata Access ==
++
++If your Component implementation needs to get access to its component metadata (i.e. its ##ComponentDescriptor##) then it can [[get it injected automatically>>extensions:Extension.Component Module||anchor="HComponentMetadata"]]. For example:
++
++{{code language="java"}}
++import org.xwiki.component.descriptor.ComponentDescriptor;
++...
++@Component
++@Singleton
++public class MyComponentImpl implements MyComponent
++{
++    @Inject
++    private ComponentDescriptor<MyComponent> descriptor;
++
++    public void doSomething()
++    {
++        String hint = this.descriptor.getRoleHint();
++        ...
++    }
++}
++{{/code}}
++
++== Panels executed with the rights of their author ==
++
++It's now possible to write script requiring programming right in panels as long as you have programming right, same as wiki macros.
++
++== UI extensions executed with the rights of their author ==
++
++What you can execute in UI extension used to depend on current document author right, it's now based on the own ui extension author.
++
++== Rendering ==
++
++* XWiki Rendering now provide an HTML5 Renderer.
++
++== Miscellaneous ==
++
++* Added new APIs to get all the icon themes present on the wiki, and all icons that these icon themes contain.(((
++{{code language="velocity"}}
++$services.icon.getIconSetNames()
++$services.icon.getIconNames()
++$services.icon.getIconNames("Font Awesome")
++{{/code}}
++)))
++* A new parameter has been added to the ##get## action and the ##plain## xpage: ##htmlHeaderAndFooter##, which add the HTML headers (##<html>##,##<head>##,##<body>##, etc...) and footers (##</body>##, ##</html>##, etc...). It could be useful to create light popups that display only the document content without any UI.
++* XWikiAttachment now provide ##setAuthorReference## and ##getAuthorReference## APIs
++* ##org.xwiki.logging.event.LogEvent## now have a getTimestamp() method returning the number of milliseconds elapsed from 1/1/1970 until logging event was created.
++* A SOLR-based implementation of the standard REST search resource has been added
++* The [[Solr Query>>extensions:Extension.Solr Search Query API]] parameter ##xwiki.supportedLocales## has a new default value: the list of supported locales configured for the current wiki (where you execute the search).
++* The ##{{{@Component}}}## annotation is no longer inheritable. Thus each component implementation class must now define it and not rely on it being present in some Abstract class.
++* The XWiki build now verifies that all components are correctly listed in ##META-INF/components.txt## files and that the threading model is explicitly defined (i.e. that either ##{{{@Singleton}}}## or ##{{{@InstantiationStrategy(ComponentInstantiationStrategy.PER_LOOKUP)}}}## is used). If not, the build fails. A new ##{{{@Component}}}## annotation parameter has been added for explicitly mentioning that a Component should not be statically registered (these components are usually used in tests). It's used as follows:(((
++{{code language="java"}}
++@Component(staticRegistration = false)
++{{/code}}
++)))
++* You can now control in which order the sections added via the [[ConfigurableClass>>extensions:Extension.Administration Application||anchor="HFieldsyoucandefine"]] are displayed in the administration.
++* New APIs to generate unescaped display user name:
++** ##com.xpn.xwiki.XWiki#getPlainUserName(DocumentReference userReference, XWikiContext context)##
++** ##com.xpn.xwiki.XWiki#getUserName(DocumentReference userReference, String format, boolean link, boolean escapeXML, XWikiContext context)##
++** ##com.xpn.xwiki.api.XWiki#getPlainUserName(DocumentReference userReference)##
++* New script oriented APIs to get document author/contentAuthor/creator as ##DocumentReference##
++
  == Upgrades ==
  The following dependencies have been upgraded:
--* <list libraries that have been upgraded>
++* [[httpclient 4.3.6>>http://jira.xwiki.org/browse/XCOMMONS-681]]
++* [[commons-codec 1.10>>http://jira.xwiki.org/browse/XCOMMONS-684]]
++* [[Groovy 2.3.8>>http://jira.xwiki.org/browse/XCOMMONS-704]]
++* [[JGroups 3.6.1>>http://jira.xwiki.org/browse/XWIKI-11523]]
++* [[Pygments 2.0.1>>http://jira.xwiki.org/browse/XWIKI-11522]]
++* [[Joda-Time 2.6>>http://jira.xwiki.org/browse/XWIKI-11516]]
++* [[Bootstrap 3.3.1>>http://jira.xwiki.org/browse/XWIKI-11381]]
++* [[Bootswatch 3.3.1+2>>http://jira.xwiki.org/browse/XWIKI-11569]]
++* [[slf4j 1.7.9>>http://jira.xwiki.org/browse/XCOMMONS-712]]
++* [[Lucene and SOLR 4.10.3>>http://jira.xwiki.org/browse/XWIKI-11603]]
  == Miscellaneous ==
--* it's now possible to provide metadatas to ##MacroContentParser#parse## API
++* It's now possible to provide metadatas to ##MacroContentParser#parse## API
++* It's now possible to know what namespace a ComponentManager instance is associated with by casting it to  ##org.xwiki.component.manager.NamespacedComponentManager##. See [[Component Module documentation>>http://extensions.xwiki.org/xwiki/bin/view/Extension/Component+Module||anchor="HNamespacedComponentManager"]].
++* Added getCurrentWikiDescriptor() method to the wiki API and script service to be consistent with the existing getCurrentWikiId() method
++* The ClassLoader automatically set as Thread ClassLoader is now dynamic meaning that any modification of the context wiki will automatically change the actual Thread ClassLoader. It used to be set to whatever was the wiki in the URL at ExecutionContext init.
++* [[A new CSS class>>platform:DevGuide.SpecialCSSClasses||anchor="HClassesfortheresponsiveness"]] have been added in Flamingo, to handle responsive tables.
++* The #sheetTitle Velocity macro supports a new use case: displaying the sheet title if the current document doesn't have an object of some type:(((
++{{code language="none"}}
++#sheetTitle('The sheet used to display objects of type Space.MyClass', 'Space.MyClass')
++{{/code}}
++)))
  = Translations =
  The following translations have been updated:
--{{language codes="none, none"/}}
++{{language codes="da, de, es, fr, ko, lv, pl, pt_BR, ro, ru, sv, tr"/}}
  = Tested Browsers & Databases =
@@ -95,9 +95,10 @@
  When upgrading make sure you compare your ##xwiki.cfg##, ##xwiki.properties## and ##web.xml## files with the newest version since some configuration parameters may have been modified or 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.
--== Issues specific to XWiki <version> ==
++== Issues specific to XWiki 6.4 ==
--<issues specific to the project>
++* VelocityEngine automatically get rid of the passed namespace at the end of execution unless it's protected. See [[Velocity section>>||anchor="HVelocitychanges"]].
++* If upgrading the content in the DistributionWizard, and the upgrade is from XWiki 6.2.x or 6.3, you might get a conflict for the document Blog.BlogSheet. Unless you have done modifications to that document, please keep the new version; otherwise please keep the merged, or if not available, keep your version. For details see issue [[XWIKI-11450>>http://jira.xwiki.org/browse/XWIKI-11450]].
  == API Breakages ==

Changes for page Release Notes for XWiki 6.4

Summary

Details

Quick Links

Let us know

About

About

Support

Platform

User Guide

Admin Guide

Developer Guide

Projects

XWiki

Extensions

Other

Contribute

Status

Practices

Under the Hood

Get Involved

Get Connected