Preparing for Confluence 5.3
This documentation is intended for Confluence developers who want to ensure that their existing plugins and add-ons are compatible with Confluence 5.3, and to learn about the new features for developing add-ons in Confluence 5.3.
Continuing on from the Blueprints API we introduced in Confluence 5.1, we will be introducing the concept of Space Blueprints. It will enable you to hook into the new create space dialog and allow users to easily create spaces of a certain type like Team Spaces (which will be a bundled Space Blueprint in 5.3).
To help you get started we have created a tutorial on Space Blueprints .
As previously announced, with Confluence 5.2 we introduced schema and API changes necessary to support the ability to change usernames. Users now have a new, unique, permanent key as well as the already-existing, unique, changeable username.
See Renamable Users in Confluence 5.2 and Writing a Plugin Upgrade Task to Migrate User Data to New User Keys for more information about migrating your plugin's existing data to user keys instead of usernames.
Macro storage format changes
There have been some changes to the storage format for Macros. Macros that use a
confluence-content parameter type should now expect an <
ac:link > in its field instead of a wikimarkup link, and macros using
attachment parameter types will now contain the corresponding resource identifier element in its body. See Confluence Storage Format and Confluence Storage Format for Macros for examples of the changes.
The in-memory representation of macros has also changed in the following ways:
- There is a new
typedParametersproperty that contains Links and ResourceIdentifiers, in the same way that the storage format for structured-macros now does.
- There is a new
storageVersionproperty that indicates what format the definition was parsed from (
ac:macroelements correspond to version 1,
ac:structured-macroelements correspond to version 2).
typeParametersand the older pure-string parameters properties now contain the default parameter, under the empty key
(""). This brings the MacroDefinition into line with the MacroParameters metadata collected from xhtml-macro modules declared in
atlassian-plugin.xml. Note that this may leak through to older wikimarkup macros causing them to have
""keys in their parameter lists.
Milestone releases for developers
Please watch the Development Releases page for pre-release versions of Confluence 5.3 that you can use for testing purposes.
If you have any questions about preparing for Confluence 5.3, please register for an account on Atlassian Answers, our community Q&A resource, and ask a question. We'll be keeping an eye on things to help out as soon as possible.