The Best Macros To Create A Custom Dashboard

Elena Oana Florea
2 min readAug 20, 2020
Photo by Stephen Dawson on Unsplash

Creating a Custom Dashboard on XWiki enables users to better visualize and analyze the wiki content in real-time. The best macros used inside gadgets allow easy display of Office documents (Office Document Viewer), efficient management of pages (Children, Pages) or data visualization (Gallery, Chars).

Office Document Viewer

The macro offers a view for Office attachments inside the gadget without downloading or importing them. It supports formats like doc, ppt, xls, odt, odp, ods, and the data is displayed using an Office Server.

For example, an Excel document can be stored as an attachment on a wiki page and displayed directly on the Dashboard.

Children

The Children macro displays a tree of children’s pages of the current page.

Chart

Chart displays a graphical chart generated from miscellaneous data sources. The chart data can be stored either inline inside the macro content or on a dedicated wiki page. The example below uses inline content inside the gadget macro.

Pages

The macro displays an index for easy filtering of the pages created in a specific space or the pages from the entire wiki. It includes many customization options like displaying action buttons (copy, rename, delete), specified columns or the possibility to only list pages found in the passed space.

Gallery Macro

The Gallery Macro helps group and display images using a slide-show view. How to add the macro on the wiki Dashboard:

  • Click on “Add Gadget”
  • Search for “gallery” and click on “Select”
  • Add the images for the slide-show inside the “Content” field and click “Submit”
Custom XWiki Dashboard using Gallery, Office Document Viewer, Children, Pages and the Chart gadgets.

--

--

Elena Oana Florea

Support Director at XWiki. Passionate about open source, collaborative cultures and great customer service. https://www.linkedin.com/in/oanat/