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, News, Profile and Site Welcome Message.
Parameters:
This macro is used as shown below:
{clickable:tooltip|link}body content{clickable}
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)
Examples
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}
Hints and Tips:
A clickable region is not immediately apparent to the end-user so it's a good idea to include a normal link somewhere within it. If you do this, both links should ideally go to the same place! On the main tab of our home page, you can see this in action...
This macro requires JavaScript to be enabled in order for it to work. You should always provide a normal link somewhere within the clickable region.
Frequently Asked Questions:
Q
Can I apply CSS styles to the clickable region to make it more obvious?
.png)
