Content Formatting Macros for Confluence Server and DC

Clickable

The Clickable macro allows you to quickly and easily link entire blocks of content.

With this macro it is easy to link entire blocks of text, panels and just about anything else on Pages, News, Profiles and the Site Welcome Message.

Usage

  1. Go to the form you wish to edit.

  2. Click Edit

  3. Click Insert More Content, and select Other Macros.

  4. Select the Clickable macro from the provided list:

    clickable 02
  5. Complete the desired fields.

    Parameter

    Description

    Type

    Default

    Required

    Link

    The link can be a page title (including space key if desired) or a URL

    string

    none

    error

    Atlassian macro output type

    The macro will be displayed inline with surrounding content

    single select

    inline

    check
  6. The macro will then appear on the page, with space to add any content into the body of the macro.

    clickable 03

Examples

Basic Use

The following example shows how to link a section of text:

With "Add-ons home page" added to the body of the macro and the Link parameter completed with "https://www.adaptavist.com/doco/display/CON/Adaptavist+Plugins".

The result is the following:

clickable 04

See the Apps home page.

Linking Panels

When linking panels the macro can be added inside or outside the panel. If put inside the panel (as shown below), the "whitespace" around the panel contents and also either side of the panel will not be clickable - only the content within the panel will be clickable.

Here’s the result:

clickable 05

If the entire panel is wrapped in the macro, then everything (including the space either side of the panel) will be clickable.

clickable 06

Which results in:

clickable 07

One of the interesting features of this macro is that any links that are within the clickable region are also clickable. This means that a separate destination can be linked to text inside a clickable region.

Frequently Asked Questions:

Q: Can I apply CSS styles to the clickable region to make it more obvious?

A: No.

Q: What is that "loremipsum" thing?

A: See the loremipsum macro for details.