The {clickable} macro allows you to quickly and easily link entire blocks of content...

There are times when Wiki Markup Editor doesn't quite provide enough flexibility in terms of linking content and that's where this macro comes to the rescue.

With this macro you can easily and cleanly link entire blocks of text, panels and just about anything else that appears on your Pages, [USERGUIDE:News], [USERGUIDE:Profile] and Site Welcome Message.

This macro is used as shown below:

{clickable:tooltip|link}body content{clickable}

Parameters

Parameter	Required	Notes
default		The default parameter should contain a tooltip and the page to link to (which can be an internal or external link as desired - see Links for more information)

This plug-in is available without cost for both commercial and non-commercial purposes. However, if you have found it to be useful, particularly within a commercial environment, please consider making a donation to the author. This will encourage continued development of this and other plug-ins, as well as speeding up the response for your latest maintenance request.

If you wish to donate, it can be done easily with a credit card or bank transfer using PayPal. No account sign-up is required for credit or debit card payments.

This software is released under a BSD License

© 2005 Adaptavist.com Limited

This macro has been tested by Adaptavist with Confluence 1.4.1, 1.4.3, 1.4.4, 2.0, 2.1 and 2.1.2.

It is usually pre-installed with Builder accounts. To install it on your own Confluence installation, please see Content Formatting Macros

Adaptavist maintain a JIRA Project for tracking bug reports and feature requests for this macro. The currently reported items are shown below:

• Links

Basic Use

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

See the {clickable:Hints and Tips|clickable macro#Hints and Tips}*bottom of the
page*{clickable} for hints and tips.

That results in the following:

See the bottom of the page for hints and tips.

As you can see, if we hadn't made the clickable text bold, you'd have no way of knowing it was there. When using this macro, always make sure you give some sort of visual indication as to where the links are.

Linking Panels

When linking panels you can either put the macro inside or outside the panel. If you put it inside the panel (as shown below) then 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...

{tip:title=Click Below}{clickable:I'm a link!|#Hints and Tips}{loremipsum:1}{clickable}{tip}

Here's the result:

Click Below Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam fermentum vestibulum est. Cras rhoncus. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Sed quis tortor. Donec non ipsum. Mauris condimentum, odio nec porta tristique, ante neque malesuada massa, in dignissim eros velit at tellus. Donec et risus in ligula eleifend consectetuer. Donec volutpat eleifend augue. Integer gravida sodales leo. Nunc vehicula neque ac erat. Vivamus non nisl. Fusce ac magna. Suspendisse euismod libero eget mauris.

If you wrap the entire panel in the macro then everything (including the space either side of the panel) will be clickable:

{clickable:I'm a link!|#Hints and Tips}{tip:title=Click Anywhere}{loremipsum:1}{tip}
{clickable}

Which results in:

Click Anywhere Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam fermentum vestibulum est. Cras rhoncus. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Sed quis tortor. Donec non ipsum. Mauris condimentum, odio nec porta tristique, ante neque malesuada massa, in dignissim eros velit at tellus. Donec et risus in ligula eleifend consectetuer. Donec volutpat eleifend augue. Integer gravida sodales leo. Nunc vehicula neque ac erat. Vivamus non nisl. Fusce ac magna. Suspendisse euismod libero eget mauris.

Links in Clickable Regions

One of the interesting "features" of this macro is that any links that are within the clickable region are also clickable. This means that you can have a clickable region that goes to one location and then links within it that go to another locaiton...

{clickable:User Guide|Home}Most of this text links to the home page
but you can *[click here|#Hints and Tips]* to see some hints and tips.{clickable}

Would result in the following:

Most of this text links to the home page but you can USERGUIDE:click here to see some hints and tips.