Pro Macros

Last modified by Administrator on 2023/09/10 00:01

Pro Macros

Supercharge XWiki’s functionality with Pro macros. Compatible with Atlassian Confluence macros imported during migrations. Can be purchased individually or part of the XWiki Pro package. Try them free.

CategoryMacro
Active Installs50
Rating
0 Votes
LicenseGNU Lesser General Public License 2.1
Minimal XWiki version supportedXWiki 13.10
SourcesIssues

Macros are how you take XWiki's functionality to the next level. They can be used to:

  • Display content in a more visually appealing manner or highlight important information
  • Embed documents, such as PDF or Office files or display diagrams
  • Show the relations between XWiki pages and improve navigation
  • Display media, such as videos and audio

All Pro macros are compatible with Atlassian Confluence macros imported during migrations (generic macros), with some of them specifically developed only to cover this need (macros used only in the context of Confluence migrations):

Generic Macros

  • Panel
  • Status
  • View Files
  • Note
  • Paste Code
  • Content Report Table
  • Column
  • Section
  • Layout
  • Multimedia
  • Anchor
  • Team
  • User List
  • User Profile
  • Expand
  • Recently Updated

Macros used only in the context of Confluence migrations

  • Gliffy
  • Balsamiq
  • Mockup
  • Confluence Gallery
  • Excerpt
  • Tip
  • Drawio
  • Attachments

Inserting a macro

To insert a macro you should edit the page:

  • Click on the "+" icon from the editor
  • Select the macro from the list
  • Fill in the needed parameters
  • Click "Submit"

InsertMacros.png

Editing a macro

Macros can be edited by double clicking on the macro in the visual editor. Alternatively, you can edit the syntax of the macro by going to the page's source. The supported parameters, as well as the syntax, are detailed in the Documentation tab for each macro.

Generic Macros

Panel

The Panel macro allows you to display XWiki content inside a visually appealing panel. You can customize its size, colours and border.
This macro supports all Atlassian Confluence parameters as of version 7.9.

Parameters

 Parameter  Name  Default value  Description
 title  Title  -  If specific a title section is added with the specific text
 bgColor  Background color  -  If specific sets the background color of the content of the panel
 width  Width  -  If specified sets the width of the panel (300px or 50%)
 height  Height  -  If specified sets the width of the panel (300px or 50%)
 classes  CSS classes   -  If specified adds css classes to the panel
 borderColor  Border color white If specified sets the panel border color
 borderStyle  Border style solid  If specified sets the css border style
 borderWidth Border width 1px If specified sets the border width in pixels
 borderRadius Border radius8px 8px 0px 0px If specified replaces the default border radius
 titleBGColor  Title background color  -  If specified sets the title section background color
 titleColor  Title text color  -  If specified sets the title text color

Examples

Simple panel

Content of the panel

Simple panel with border and size

Content of the panel

Panel with title and colors

Title of the panel

Content of the panel

Panel with title and colors and border

Title of the panel

Content of the panel

Panel with bootstrap classes

Title of the panel

Content of the panel

Title of the panel

Content of the panel

Title of the panel

Content of the panel

Status

The Status macro helps you highlight the status of an item using a colored box. You can customize both the text and the background color. The background can be either lightly colored, or dark, depending on your preference. The macro can be used inside other macros.

Parameters

 Parameter  Name  Default value  Description
 title  Title The color nameThe text of the status. If not specified, the color name will be displayed (e.g.:"Grey").
 colour  Color GreyThe color of the status (text color and background color). The following colors are available: "Blue", "Green", "Grey", "Purple", "Red" and "Yellow".
 subtle  Subtle FalseThe aspect of the status: either white text on dark color background or dark color text on light color background. It should be filled with "true" or "false".

Examples

{{status title="Task"/}}

Results in:

Check the parameters.Task

{{status title="Improvement" colour="Green"/}}

Results in:

Add a new status macro.Improvement

{{status title="Improvement" colour="Green" subtle="true"/}}

Results in:

Add a new status macro.Improvement

View Files

The View Files macro allows you to embed an Office or a PDF document inside an XWiki page. You will need to attach the document to the page. The supported file types are doc, docx, xls, xlsx, ppt, pptx, and pdf.
Any macro added as such in Confluence should be, when migrating, converted into a view-file macro and have a preview.
To display specific file types you can also use the following macros:

  • View Doc
  • View Pdf
  • View Ppt
  • View Xls

Example

{{view-file att--filename="Test.pdf"/}}

Results in:

TestPDF.png

Note

Similar to the warning macro, the note macro is used to highlight important notes in a coloured panel.

Parameters

ParameterDescription
titleThe title of the note.

Example

{{note title="Note: "}}
This is my note with title.
{{/note}}

Results in:

Note: 

This is my note with title.

Paste Code

Similar to the Code macro, the aim of this macro is to allow users to paste code snippets inside XWiki pages.

Parameters

ParameterDescription
languageThe code language to be used for the representation.
titleThe title of the box containing the code.

Example

{{paste-code-macro language="java" title="Hello World Example"}}
class Simple{
    public static void main(String args[]){
        System.out.println("Hello World !");
    }
}
{{/paste-code-macro}}

Results in:

Hello World Example

class Simple{
   public static void main(String args[]){
        System.out.println("Hello Java");
   }
}

Content Report Table

This macro provides a content report in a table format based on tags (labels).

Parameters

ParameterDescriptionRequiredDefault
labelsThe labels (tags) to report on, separated by comma.Yes 
spacesThe space keys to report on, separated by a comma and a blank space (e.g: "Confluence, XWiki")No 
maxResultsMaximum Number of results (pages).No20

Examples

{{content-report-table labels="test"/}}

Results in:

ContentReport.png

Column

The column macro lets you organise content in columns. This macro is used in conjunction with the Section macro, and provides more flexibility to the page layout.

Parameters

ParameterNameDescription 
widthWidthThe width of the column. Can be specified either in pixels (for example, 400px) or as a percentage of the available page width (for example, 50%).

Examples

Simple column

{{column width="350px"}}
Add the Section macro to a page to organise your content in sections and columns.  This macro is used in conjunction with the Column macro.
{{/column}}

Results in:

Add the Section macro to a page to organise your content in sections and columns.  This macro is used in conjunction with the Column macro.

Columns usage in Section

{{section border="true"}}

{{column width="250px"}}
Add the Section macro to a page to organise your content in sections and columns.  This macro is used in conjunction with the Column macro.
{{/column}}

{{column width="300px"}}
Content in the column 2
{{/column}}

{{column width="300px"}}
Content in the column 3
{{/column}}

{{column width="250px"}}
Content in the column 4
{{/column}}

{{/section}}

Results in:

Add the Section macro to a page to organise your content in sections and columns.  This macro is used in conjunction with the Column macro.

Content in the column 2

Content in the column 3

Content in the column 4

Section

Add the Section macro to a page to organise your content in sections and columns. This macro is used in conjunction with the Column macro to personalise the XWiki page layout.

Parameters

ParameterNameDescriptionDefault value
borderShow BorderSelect this option to draw a border around the columns, when they exist.false

Examples

Simple section without border

{{section}}
Content of a simple section, without border.
{{/section}}

Results in:

Content of a simple section, without border.

Simple section with border, no column

No border is added, because the borders are applied on columns, when they exist.

{{section border="true"}}
Content of a simple section, with border.
{{/section}}

Results in:

Content of a simple section, with border.

Simple section with border and column

{{section border="true"}}
{{column}}
Content of a simple section, with border.
{{/column}}
{{/section}}

Results in:

Content of a simple section, with border.

Section with 4 columns

{{section border="true"}}

{{column width="250px"}}
Content in the column 1
{{/column}}

{{column width="300px"}}
Content in the column 2
{{/column}}

{{column width="300px"}}
Content in the column 3
{{/column}}

{{column width="250px"}}
Content in the column 4
{{/column}}

{{/section}}

Results in:

Content in the column 1

Content in the column 2

Content in the column 3

Content in the column 4

Layout

The layout macro allows you to organize the content of your page, usually with the help of Layout Section and Layout Cell macros.

Examples

Two equal columns

{{layout}}
{{layout-section ac:type="two_equal"}}
{{layout-cell}}
Lorem Ipsum is simply dummy text of the printing and typesetting industry.
{{/layout-cell}}

{{layout-cell}}
There are many variations of passages of Lorem Ipsum available.
{{/layout-cell}}
{{/layout-section}}
{{/layout}}

Results in:

Lorem Ipsum is simply dummy text of the printing and typesetting industry.

There are many variations of passages of Lorem Ipsum available.

Three equal columns

{{layout}}
{{layout-section ac:type="three_equal"}}
{{layout-cell}}
Nemo enim ipsam voluptatem quia voluptas sit aspernatur.
{{/layout-cell}}

{{layout-cell}}
Nor again is there anyone who loves or pursues or desires to obtain pain of itself.
{{/layout-cell}}

{{layout-cell}}
To take a trivial example, which of us ever undertakes laborious physical exercise.
{{/layout-cell}}
{{/layout-section}}
{{/layout}}

Results in:

Nemo enim ipsam voluptatem quia voluptas sit aspernatur.

Nor again is there anyone who loves or pursues or desires to obtain pain of itself.

To take a trivial example, which of us ever undertakes laborious physical exercise.

Two columns, one behaving as sidebar on the right

{{layout}}
{{layout-section ac:type="two_right_sidebar"}}
{{layout-cell}}
At vero eos et accusamus et iusto odio dignissimos ducimus qui blanditiis praesentium voluptatum deleniti atque corrupti quos.
{{/layout-cell}}

{{layout-cell}}
Nam libero tempore, cum soluta nobis est eligendi optio cumque nihil impedit quo minus id quod maxime placeat facere possimus.
{{/layout-cell}}
{{/layout-section}}
{{/layout}}

Results in:

At vero eos et accusamus et iusto odio dignissimos ducimus qui blanditiis praesentium voluptatum deleniti atque corrupti quos.

Nam libero tempore, cum soluta nobis est eligendi optio cumque nihil impedit quo minus id quod maxime placeat facere possimus.

Two columns, one behaving as sidebar on the left

{{layout}}
{{layout-section ac:type="two_left_sidebar"}}
{{layout-cell}}
At vero eos et accusamus et iusto odio dignissimos ducimus qui blanditiis praesentium voluptatum deleniti atque corrupti quos.
{{/layout-cell}}

{{layout-cell}}
Nam libero tempore, cum soluta nobis est eligendi optio cumque nihil impedit quo minus id quod maxime placeat facere possimus.
{{/layout-cell}}
{{/layout-section}}
{{/layout}}

Results in:

At vero eos et accusamus et iusto odio dignissimos ducimus qui blanditiis praesentium voluptatum deleniti atque corrupti quos.

Nam libero tempore, cum soluta nobis est eligendi optio cumque nihil impedit quo minus id quod maxime placeat facere possimus.

Three columns, sidebar-content-sidebar

{{layout}}
{{layout-section ac:type="three_with_sidebars"}}
{{layout-cell}}
On the other hand, we denounce with righteous indignation
{{/layout-cell}}

{{layout-cell}}
But in certain circumstances and owing to the claims of duty.
{{/layout-cell}}

{{layout-cell}}
On the other hand, we denounce with righteous indignation.
{{/layout-cell}}
{{/layout-section}}
{{/layout}}

Results in:

On the other hand, we denounce with righteous indignation

But in certain circumstances and owing to the claims of duty.

On the other hand, we denounce with righteous indignation.

Multimedia

The Multimedia macro is a bridge between Confluence and XWiki. It uses the JW Player open-source embeddable media player for web sites, supporting many commonly-used audio and video formats.

Parameters

ParameterDescriptionRequiredDefault
pageThe page to which the multimedia file is attachedNo 
nameFile name of the attached multimedia file.Yes 
widthThe player width, in pixels. If not defined, the player tries to determine automatically the width from the played media file.No 
heightThe player height, in pixels. If not defined, the player tries to determine automatically the height from the played media file.No 
autostartIf the parameter is set to true then the video or audio file will start playing as soon as the page is loaded.Nofalse

Examples

Video

{{multimedia name="file_example.mp4" width="500" height="200" /}}

Results in:

Loading the video player...

Audio

{{multimedia name="file_example.mp3" height="30"/}}

Results in:

Loading the video player...

Anchor

By including the Anchor macro in a page, you can link to a specific part of a page. Once you have added a link to the anchor, clicking on the link will bring you back to the location of the anchor.

Example

For anchor "test":

{{anchor name="test" /}}

Link syntax:

[[test link>>||anchor="test"]]

Team

Display avatars of the members of a team.

Parameters

 Parameter  Name  Description  Default
 tag  Tag  Tag that users need to have to be shown  
 size  Size  The size (height and width) of an avatar  60
 showUsernames  Show usernames  The name of users should be displayed under their avatars  false
 letterAvatarBgColor  Letter Avatars Background Color  The background color of the letter avatars  #0A6
 letterAvatarFontColor  Letter Avatars Font Color  The font color of the letter avatars  white
 disableLetterAvatars  Disable Letter Avatars  Don't use letter avatars and display a default avatar instead  false
 requireExternalAuth  Require External Auth The user should be searched in LDAP or OAuth  false
 limit  Limit  The maximum number of people to show (0 turns off the limit)  100
 scope  rendering.macro.team.parameter.scope.name  rendering.macro.team.parameter.scope.description  auto

Examples

All users

{{team/}}

All users, no LDAP or OpenIDC requirements, bigger

{{team requireExternalAuth=false size=100 /}}

All users, no LDAP or OpenIDC requirements, some colors

{{team requireExternalAuth=false letterAvatarBgColor="#05C" letterAvatarFontColor="#FFA"/}}

All users, with LDAP or OpenIDC requirements

{{team requireExternalAuth=true /}}

All users with names, disable tools

{{team showUsernames=true disableTools=true/}}

All users with names, disable letter avatars, only in the main wiki

{{team showUsernames=true disableLetterAvatars=true scope=global/}}

User List

The macro allows displaying a custom list of users in a table with a set of configurable properties.

Parameters

 Parameter  Name  Description  Default
 users  Users  List of users to be displayed  
 properties  Properties  List of user properties to be displayed  avatar,username

Example

{{userList users="XWiki.danton,XWiki.mflorea,XWiki.slauriere" properties="avatar,username"/}}

Results in:

<span class="wikilink"><a href="/xwiki/bin/view/XWiki/danton">false</a></span> Dorina Anton
<span class="wikilink"><a href="/xwiki/bin/view/XWiki/mflorea">false</a></span> Marius Dumitru Florea
<span class="wikilink"><a href="/xwiki/bin/view/XWiki/slauriere">false</a></span> Stéphane Laurière

User Profile

The macro allows to display a user with their attributes in a box.

Parameters

 Parameter  Name  Description  Default
 reference  Reference  Reference to a user page  
 properties  Properties  List of user properties to be displayed, separated by a comma  company,email,phone,address

Example

{{userProfile reference="XWiki.slauriere"/}}

Results in:

Expand

This macro allows you to insert an expandable section, with a title and content. Compatible with Confluence migrations.

Parameters

 Parameter  Name  Description  Default
 title  Title  Title of the section, displayed when the section is collapsed 
 content  Content  Content visible when the section is expanded  

Example

{{expand title="Expand this section to learn more"}}
In pharetra fermentum est, non dapibus orci congue eget. Curabitur scelerisque dui vitae sagittis aliquam. Etiam tincidunt mattis ultrices. Integer felis magna, sodales sit amet finibus id, efficitur nec nulla. Ut volutpat tellus id bibendum scelerisque. Fusce ut massa nulla. Donec ullamcorper elit vitae metus condimentum, sed varius eros luctus. Etiam elit mi, finibus sed nibh a, facilisis eleifend orci.
{{/expand}}

Results in:

1677173833281-292.png

Recently Updated

This macro allows you to display the most recently updated pages, blog posts, and attachments. You can filter by space, labels (tags), author (last editor) and you can further customise the display through the maximum number of results, theme, show user profile and hide title parameters. 

Parameters

 Parameter  Name  Description  Default
 author  Author Filter the results by author(s) of the last modifications. none
 spaces  Space 

Display pages, blog posts or attachments only from certain specified spaces. You can specify one or more space keys, separated by a comma or a space.

  • To exclude content in a specific space, put a minus sign - immediately in front of that space name. For example: If you specify a space name of -Sandbox you will get only content which is not in the Sandbox.
  • To indicate that the results must come from a specific space, put a plus sign + immediately in front of that space name. For example: If you specify a space name of +LegalDepartment you will get only content in LegalDepartment. 

Special values: "@self" - the current space, "@global" - all spaces in wiki, "@all" or "*" - all spaces in every wiki.

@self
labelsLabel

Filter the results by label. The macro will display only the pages etc which are tagged with the label(s) you specify here. You can specify one or more label values, separated by a comma or a space.

  • To exclude content which matches a given label, put a minus sign immediately in front of that label value. For example: If you specify a label value of -toexclude you will get only content which is not labeled with 'toexclude'.
  • To display only pages tagged with a certain label, put a plus sign immediately in front of that label value. For example: If you specify a label value of +toinclude, you will get only pages that are tagged with 'toinclude'. The labels parameter only applies to the page and blog content types.
none
widthWidth of TableSpecify the widths of the macro display, as a percentage of the window widht. 100%
typesContent TypesFilter by content type (page, blogpost, comment, attachment). You can specify one or more types, separated by a comma or a space. all types
maxMaximum Number of ResultsRestrict the number of displayed results. 15
themeTheme

Choose the appearance of this macro:

  • concise — the default list, showing the names of pages which were updated or commented on, the users who made the page modifications and time when the modifications occurred.
  • social — lists recent modifications in reverse chronological order, but groups them by user. A 'sub' list appears within each user's time segment, showing the names of pages which they updated or commented on and time when these modifications occurred.
  • sidebar — lists recent updates in reverse chronological order, showing the names of pages which were updated or commented on and time when the page modifications occurred. The author is not displayed 
concise
showProfilePicShow User Profile PicturesDisplay the profile pictures of the authors. false
hideHeadingHide Title

Determines whether the macro hides or displays the text 'Recently Updated' as a title above the list of content.

false

Example

{{recently-updated spaces="Sandbox" types="page, attachments" max="10" showProfilePic="true" hideHeading="true" theme="social"/}}

Results in:

1677176326677-954.png

Macros used only in the context of Confluence migration

Gliffy

The Gliffy macro is a Confluence specific macro. It is a bridge between the Gliffy macro used in Confluence and the Diagram macro used in the XWiki Diagram Application. The aim of this macro is to allow users to view and modify the diagrams migrated from Confluence. By default, the macro displays the preview of the Gliffy diagram. The user can create the editable version of the diagram, by using its representation into an XWiki diagram, having always the option to go back to the preview of the original diagram.

Parameters

ParameterDescription
nameThe diagram identifier. It should be the name of the attachment storing the Gliffy diagram data. It should not have a filename extension. The Gliffy diagram exports consist in attachments added to the parent page. For example, for a diagram called MyGliffyDiagram, there will be two attachments on the parent page : MyGliffyDiagram.png (the filename with a ".png" extension) representing the preview of the diagram and MyGliffyDiagram (with no filename extention) representing the diagram data.

Besides the name parameter, the {{gliffy}} macro used in Confluence has other parameters that don't have to be cleaned, because these parameters are being ignored by this bridge macro.

Example

  {{gliffy name="MyGliffyDiagram" /}}

Results in:

MyGliffyDiagram.png

Balsamiq

This macro is a bridge for the Confluence Balsamiq Wireframe macro. It displays the image preview of the mockup, as it was migrated from Confluence.

The wireframe preview is an attachment added to the parent page. For example, for a wireframe identified with MyWireframeID, there will be an attachment on the parent page of this form: <balsamiq_MyWireframeID[_branchID].png. This means that there will be a prefix called balsamiq followed by an underscore (_), then the resource identifier (MyWireframeID in this case), then an arbitrary suffix (if it is set, by default it will be called Master). So, here are some filenames matching our example :

  • balsamiq_MyWireframeID_Master.png
  • balsamiq_MyWireframeID.png

Even if the macro is called in Confluence "Balsamiq wireframes", the id of the macro is "mockup". This is why, when importing these types of macros into XWiki, they are converted into "mockup" macros. 

Parameters

ParameterDescriptionAccepted valuesDefault valueMandatory
initialResourceIDThe ressource ID that is part of the mockup filename attached to the current page (in the example above, it would be MyWireframeID).  Yes
initialBranchIDThe branch on which the file was stored. If it exists, by default, Confluence sets it to Master.   
AlignmentThe alignment of the wireframe preview.Left, Center and RightLeft  

Example

  {{wireframe initialResourceID="2278E287-509B-183B-1098-2EC38DDDB7D8" initialBranchID="Master" Alignment="Center"/}}

Results in:

Balsamiq.png

Mockup

This macro id a bridge for the Confluence Balsamiq Mockup macro. It displays the image preview of the mockup, as it was migrated from Confluence.
The mockup preview is an attachment added to the parent page. For example, for a mockup identified with MyMockupID, there will be an attachment on the parent page of this form: <balsamiq/mockup>_MyMockupID[_branchID].png. This means that there should be a prefix called either mockup or balsamiq, followed by an underscore (_), then the resource identifier (MyMockupID in this case), then an arbitrary suffix (if it is set, by default it will be called Master). So, here are some filenames matching our example:

  • balsamiq_MyMockupID_Master.png
  • balsamiq_MyMockupID.png
  • mockup_MyMockupID.png

Parameters

ParameterDescription
NameThe resource ID that is part of the mockup filename attached to the current page (in the example above, it would be MyMockupID).
initialResourceIDIn case the Name parameter is not set, this is parameter will be taken into account for identifying the attachment representing the mockup preview.
initialBranchIDThe branch on which the file was stored. If it exists, by default, Confluence sets it to Master.

Example

  {{mockup initialResourceID="2278E287-509B-183B-1098-2EC38DDDB7D8" initialBranchID="Master"/}}

This means that the accepted preview filenames attached to the current page are: 

  1. balsamiq_2278E287-509B-183B-1098-2EC38DDDB7D8_Master.png
  2. mockup_2278E287-509B-183B-1098-2EC38DDDB7D8_Master.png

Filename number 1. has priority, so in case both files are attached to the current page, the first one is displayed.

It results in:

Balsamiq.png

Confluence Gallery

The Confluence Gallery macro is a bridge between Confluence and XWiki. This bridge uses the XWiki implementation of the Gallery macro under the hood and therefore assumes that the Confluence gallery macro is prefixed during import. There are a few things to note:

Only a subset of the parameters supported by the Confluence macro are supported by this bridge macro: title, exclude, include and page. The remaining parameters are ignored:

  • columns does not make sense for the XWiki macro as the images are displayed differently
  • excludeLabel and includeLabel are not supported since XWiki does not support attachment tags
  • sort and reverse have not been implemented in this bridge macro

Parameters

ParameterDescriptionRequiredDefault
titleTitle of the gallery.No 
excludeExcluded images (comma separated).No 
includeIncluded images (comma separated).No 
pagePages containing the images to display. Current page if empty.No 

Example

All images in the current page:

{{confluence_gallery/}}

Results in:

Gallery.png

Excerpt

The Excerpt macro is a bridge macro between Confluence and XWiki. It allows the user to mark part of the page's content for use by other macros. Note the Excerpt include macro is not yet available.

The macro can also be used to hide part of the content of a page.

Parameters

ParameterDescriptionDefault
atlassian-macro-output-typeThe ouput type. It can be either BLOCK or INLINE.INLINE
hiddenIf true, the content of the macro will be hidden.false

Example

Example of excerpt with HTML:
{{excerpt}}
|=Title1|=Title2|=Title3
|Text1|Text2|Text3
{{/excerpt}}

Results in:

Title1Title2Title3
Text1Text2Text3

Example of hidden excerpt:
{{excerpt hidden="true"}}
My hidden content.
{{/excerpt}}

Result in:
My hidden content.

Tip

This is a bridge macro between Confluence Tip macro and XWikis Success macro.

Parameters

ParameterDescription
titleThe title of the tip.

Example of usage

{{tip title="Tip: "}}
This is my tip with a title.
{{/tip}}

Result :

Tip: 

This is my tip with a title.

Drawio

The Drawio macro is a bridge between Drawio macro used in Confluence and the Diagram macro used in XWiki. The aim of this macro is to allow users to view and also to modify the Drawio/Diagrams.net diagrams migrated from Confluence. By default, the macro displays the preview of the Drawio diagram. The user can create the editable version of the diagram, by using its representation into an XWiki diagram, always having the option to go back to the preview of the original diagram.

Parameters

ParameterDescription
diagramNameThe diagram identifier. It should be the name of the attachment storing the Drawio diagram data. It should have a `.drawio` filename extension. The Drawio diagram exports consist in attachments added to the parent page. For example, for a diagram called MyDrawioDiagram.drawio, there will be two attachments on the parent page: MyDrawioDiagram.drawio.png (the filename with a ".png" extension) representing the preview of the diagram and MyDrawioDiagram.drawio representing the diagram data in Diagrams.net's native format.

Besides the diagramName parameter, the {{drawio}} macro used in Confluence has other parameters that don't have to be cleaned, because these parameters are being ignored by this bridge macro.

Example of usage

The syntax of the macro using the diagram called "MyDrawioDiagram.drawio" is the following:

{{drawio diagramName="MyDrawioDiagram.drawio" /}}

The result is the following:

In order to use this macro, the Diagram application needs to be installed. To install, click here.

Installation Steps

This paid extensions requires XWiki 13.10 or above. In order to install the extension, follow the next steps inside your XWiki instance (on cloud or on premise).

Navigate to the Extension Manager

In the Applications Panel click on "More Applications..." and then "Install new applications...". Alternatively navigate directly to the Administration and select the "Extensions" section.

step1.png

Install the Extension

Search for the extension you wish to install and use the Install button to install it.

step2.png

Get a License

Navigate to the "Licenses" section of the Administration, fill your details, look for the extension you just installed in the live table and click the buttons to get a trial license or to buy a license.

step3.png

Install the License

If you have selected a trial license then you're good and there's nothing else to do. Your trial license is automatically installed.

However if you've selected to buy a license you'll be redirected to a page to perform the payment. At the end you need to come back to the "Licenses" administration section and click on the "Check for Updates" button. This will download and apply the license you bought.

Use the Extension

Start using the Extension! Refer to the extension's documentation to know how to use it.

Installing Paid Apps on Subwikis

If you want to install an application on the whole farm (main wiki + subwikis), you can do so directly from the main wiki’s Extension Manager, as seen below:

step4.png

Extensions can also be installed only on a particular subwiki by global admins. Subwiki admins will not be able to install these extensions due to their limited rights.

Options

The price is per year and varies depending on the support level and the number of users.

Support / Users 10 25 50 100 250 500 1000 2500 5000 10000 20000
Silver
Pro Macros is part of the XWiki Pro package. Purchasing this package you will benefit from more extensions at a better price. Check the full offer in XWiki Pro!

Benefits

What do you get when you purchase an XWiki extension?

1 year license

By purchasing an XWiki extension license, you'll benefit from it during one year.

Free updates

You benefit from all the extension updates during one year. You are always up to date.

Support included

If you are facing an issue, you can reach the XWiki support. Our team is always available to help.

How to Buy

To buy, install this extension from inside your XWiki instance and follow the instructions.

Release notes

v1.9.3

Bugs fixed:

  • #118 "column" macro should work without content.
  • #140 The avatars show with different size
  • #160 UserList macro fires a NullPointerException due to conflict on WikiDescriptorManager field

v1.9.2

Bugs fixed:

  • #151 Recently Updated Macro displays an error on pages with different locales

v1.9.1

Bugs fixed:

  • #144 Link not converted well when used within note macro
  • #146 UserList and UserProfile macros work without license

v1.9

Bugs fixed:

  • #124 The example usage on the attachments macro page (Confluence.Macros.Attachments) is using the old name of the attachments macro
  • #126 Inline rendering converted into block
  • #129 Upgrade parent to 13.10-3

Tasks done:

  • #133 Upgrade parent to 13.10-3

Upgraded licensing version to 1.24.1.

v1.8.1

Bugs fixed:

  • #125 In UserList macro, the parameter for setting a fixed layout is not taken into account

v1.8

New features:

  • #88 Create the "userlister" macro
  • #90 User list macro: Allow to pick a group to display the users 

Bugs fixed:

  • #112 Adapt the attachments macro to the new livetable attachments view
  • #113 The content of the columns from stacked user lists is not aligned

v1.7.1

Improvements:

  • #119 Add text wrapping option for MS Stream macro

Bugs fixed:

  • #110 Add warning when adding macros without a license

v1.7

New Features:

  • #84 Create the "recently-updated" macro
  • #85 Create the "Expand" bridge macro

v1.6.1

Bugs fixed:

  • #99 Diagram is empty after conversion from drawio

v1.6

New Features:

  • #82 Create the "Attachments" macro
  • #73 Create a Confluence bridge macro for Microsoft Stream Macro

v1.5

Improvements on the Team macro:

  • Fix usernames not being shown
  • Support subwikis through the scope parameter
  • Fix links, which now point to the user profiles

v1.4

New Macro:

  • Team, to show the avatars of a team
  • User List, to display a custom list of users with their avatar and properties
  • User Profile, to display a user card

Support for new Confluence Macros:

  • Drawio
  • Tip

v1.3

New Features:
#64 Create a button macro
#69 Develop a Microsoft Stream macro

Update the PDF Viewer dependency version to 2.4
Update the Licensing dependency version to 1.22.1

v1.2.2

Update the PDF Viewer dependency version to 2.3.3
Update the Licensing dependency version to 1.22

v1.2.1

Update the licensor and PDF Viewer versions.

v1.2

Update parent version to 11.10.

Extension details

This information is only displayed to Administrators. Your users can't see this tab.

License

  • GNU Lesser General Public License 2.1

Sources

Issues

Type

  • xar

Developed by

Compatibility

  • Requires XWiki 13.10 or above.

Installable with the Extension Manager

Dependencies

  • com.xwiki.pro:xwiki-pro-macros-api 1.9.3
  • com.xwiki.licensing:application-licensing-licensor-api 1.24.1
  • org.xwiki.platform:xwiki-platform-office-ui 13.10
  • com.xwiki.pdfviewer:macro-pdfviewer-ui 2.5
  • org.xwiki.contrib:macro-jwplayer-ui 2.1.10
  • org.xwiki.platform:xwiki-platform-rendering-wikimacro-store 13.10
Tags: XWiki Pro
Created by Silvia Macovei on 2021/07/28 15:43
XWiki SAS Copyright © 2021