Documentation

Installation

As any app for Confluence Cloud, you can install the app via the Confluence admin menu.

  1. Log into your Confluence instance as an admin.

  2. Click on “Apps > Manage apps” in the header menu.

  3. Click on “Find new apps” on the right navigation.

  4. Search for “Dialogs CSS for Confluence” and select it.

  5. Click on “Try it free” to install the app.

Usage

Dialogs for Confluence provides macros that add a button to a Confluence page to opens a Confluence dialog that shows either Confluence or remote content. To make use of the macros click the “Insert” / “+” Button in the edit mode and select one of the macros described below.

Macro “Dialog“

The macro “Dialog” opens a dialog when a button is clicked and accepts the Confluence content that is shown in the dialog as macro body. The macro supports the following options:

  • Text: Define the text on the button that opens the dialog.

  • Dialog width: Defines the width of the dialog.

  • Dialog height: Defines the height of the dialog.

  • Dialog title: Defines the title of the dialog.

  • Dialog size: If set to “fullscreen” a fullscreen dialog is opened and the options “Dialog width“ and “Dialog height“ are ignored.

Macro “Dialog (popup)“

The macro “Dialog (popup)” opens a dialog automatically on page load and accepts the Confluence content that is shown in the dialog as macro body. The Macro supports the following options:

  • Dialog width: Defines the width of the dialog.

  • Dialog height: Defines the height of the dialog.

  • Dialog title: Defines the title of the dialog.

  • Dialog size: If set to “fullscreen” a fullscreen dialog is opened and the options “Dialog width“ and “Dialog height“ are ignored.

Macro “Dialog (remote)”

Please note that some website does not allow iFrame loading. Those websites are not supported.

The macro “Dialog (remote)” opens a dialog when a button is clicked and shows a remote URL (as iFrame) in the dialog. The Macro supports the following options:

  • URL: URL to load the remote content from.

  • Text: Define the text on the button that opens the dialog.

  • Dialog width: Defines the width of the dialog.

  • Dialog height: Defines the height of the dialog.

  • Dialog title: Defines the title of the dialog.

  • Dialog size: If set to “fullscreen” a fullscreen dialog is opened and the options “Dialog width“ and “Dialog height“ are ignored.