Phonemos User Guide

Macro Overview

Confluence has a macro/plugin usage report (under /admin/pluginusage.action) that shows which macro is used on how many pages.

Classification

  • ✅ fully supported (might still look a bit different)

  • ⚠️ reduced support, similar functionality available, but different user experience and/or not automatically migrated

  • ✏️ support is planned, can be prioritized if needed

  • ℹ️ not supported, but alternative is available

  • 🚫 not supported at the moment and no plans. Mostly this is because we did not find a good use case for the feature yet, but are open to suggestions

Built-in

Name

What is It?

Phonemos Support State

confluence-information-plugin

  • info

  • note

  • warning

  • tip

Box with text

 

Not all content is supported inside, but for most practical uses it looks identical.

Table of Contents Plugin

  • toc

List of all headings inside a page

 

ℹ️

Not supported and will not be supported like that. Phonemos has a table of contents-feature in the sidebar. User can toggle visibility of it.

Layout Macros

  • column

  • section

Two or three column layouts

 

 

Fully supported

Basic Macros

  • Panel

Just a border around something.

 

Only with an icon (see info, note, warning, tip)

Not all content is supported, but for most practical uses it looks identical.

  • Anchor

A place inside a page where you can hyperlink to.

⚠️

Headers are automatically anchors. A custom anchor macro is not planned currently.

  • noformat

Box with preformatted content (fixed-width font)

 

Supported via the code macro when you don’t select a language.

  • loremipsum

Some Placeholder Text

 

🚫

Not supported, as it’s just some Placeholder text. The user can just copy it from a lorem generator webpage.

Confluence Advanced Macros

  • children

List of child pages

 

Fully supported

  • excerpt

Content will be used a the page summary

🚫

Not supported, does not make sense on it own. See excerpt-include.

  • contentbylabel

List of pages selected that have a given label

 

✏️

on the roadmap

  • recently-updated

List of recently updated pages

 

Fully supported

  • include

Includes the full content of another page.

🚫

Not supported and not yet planned as we did not yet find a use case for it.

  • excerpt-include

Includes the content of the excerpt macro of another page

🚫

Not supported and not yet planned as we did not yet find a use case for it.

  • favpages

List of the current users favorite pages

 

🚫

No functionality to favorite pages

  • gallery

All images attached to the pages displayed.

 

⚠️

The user can use the layout component to emulate the functionality. It was rarely used.

  • blog-posts

List of Blog Post-type pages for a space, optionally with excerpts.

 

⚠️

Blog posts are just normal pages in Phonemos. A similar view can be achieved using the children-macro or recently added macro.

  • popular-labels

List of the most popular labels in the instance

 

🚫

We have not come across a good use case for it.

  • navmap

“Board” of pages that have a certain label

 

🚫

We have not come across a good use case for it.

  • list-labels

Renders the list of all labels or labels for a specific space.

 

🚫

We have not come across a good use case for it. There is probably something coming with the new metadata feature to do this slightly differently.

  • related-labels

List of labels that other pages having the same labels as this page also have.

 

🚫

We have not come across a good use case for it.

Confluence File Macro

  • view-file

In-page rendering of a supported file (PDF)

 

✏️

Planned. A preview is already available, but not directly in the page (only after a click).

Page Tree Plugin

  • pagetree

Baumansicht von Unterseiten

 

Supported for current page, page trees with different roots are on the roadmap.

  • pagetreesearch

Suchfeld für Suche unterhalb der aktuellen Seite

 

✏️

A way to restrict the search to the current page tree is planned.

Code Macro Plugin

  • code

Source Code Fragment

 

Fully supported

Wiki Markup Plugin

  • unmigrated-inline-wiki-markup

  • unmigrated-wiki-markup

not available from the UI. Used for content from very old confluence version.

🚫

Convert in confluence to regular content.

Status Macro

  • status

Display of a user defined text with a background

 

Fully supported

Confluence Expand Macro

  • expand

Collapsible section

 

Fully supported

Office Connector plugin

  • viewpdf

  • viewxls

  • viewppt

  • viewdoc

In-page view of the content of the file (full view)

✏️

On the roadmap, still undecided if the whole document is rendered into the page or a pageable preview is not yet decided.

Jira Plugin

  • jira

Jira Issue title and status

 

✏️

On the roadmap

  • jira (alternate config)

Table view of Jira issues (JQL filter)

 

✏️

On the roadmap

Confluence Live Search Macros Plugin

  • livesearch

Search box inside a confluence page

 

✏️

See pagetreesearch

User Lister

  • userlister

List of Confluence Users that are members of a certain group

 

🚫

Not planned at the moment. Users can be mentioned individually

Confluence Attachments Plugin

  • attachments

List of all attachments on a page

 

ℹ️

Different solution with file stacks. Will not be automatically migrated (manual conversion is easy)

Profile Macro

  • profile

Displays picture, name and email of a user

 

🚫

Not yet planned, but information would be available if there’s a good use case.

Page Properties Macros-Plugin

  • details

Let’s the user define metadata about a page. It works by adding a table such as the following below it

 

✏️

Page metadata is on the roadmap but will be supported more natively than in Confluence.

Confluence Inline Tasks

  • tasks-report-macro

List of task in a certain context

 

Supported

Confluence Roadmap Planner

  • roadmap

Simple bar charts for roadmaps

 

ℹ️⚠️

Solved via diagrams.net embedding that allows drawing such diagrams. No migration.

Confluence Core Macros

  • Multimedia

Embedded video/audio

Supported, but some degradation in layout (width/height etc)

Confluence Create Content Plugin

  • create-from-template

Button that will create a subpage based on a defined template

 

✏️

On the roadmap. Templating exists, but not yet a button that can be added to a page.

Confluence Contributors Plugin

  • contributors

List of contributors to a spaces

 

🚫

Not planned, as we do not see a good use case for it yet.

Confluence Content Report Plugin

  • content-report-table

List of pages with a certain label

 

✏️

On the roadmap together with page metadata

Dashboard Macro

  • recently-updated-dashboard

View of all recently updated pages in certain places

 

ℹ️

Not exactly like that, but the recently-updated is basically the same.

Profile Picture

  • profile picture

Displays the profile picture of a user

 

🚫

Not planned at the moment, since we don’t see a good use case for it

 

 

User Macros

  • Obviously not directly supported, but for some user macros they can easily be transformed in the migration to the actual content. Check with the developers on each individual case