# RokCandy Macro - New / Edit

-- Draft version

You must ensure the Macro you create is Published in order for it to be available for use in your content.

You MUST Select a category. If there are no categories listed in the dropdown, you must create one via the Category link.

The Ordering setting is purely for management purposes and doesn't affect the use of the macro in anyway. It just affects the order the macro is displayed in the manager and also in the editor button.

The Macro field is where you should put your macro that will be searched for and replaced in your content. We strongly advice using BBCODE style syntax with square brackets "[ ]", as these are clear to read and also are not stripped out by editors or by Joomla's filtering routines. You do not have to use BBCODE however, as there is nothing restricting you to do so. You could in theory just have a simple string replacement here.

The HTML portion is where the resulting HTML or output code should be entered. This is the code that will replace the macro when the macro is found in the content. Again this doesn't have to be HTML, it can actually be anything you want.

Variables should be represented in curly brackets "{ }". If you use a variable in the macro you should also use that same variable in the HTML porition.

## Examples

Some examples of valid macros are shown below:
`
[h1]{text}[/h1]=<h1>{text}</h1>
[h2]{text}[/h2]=<h2>{text}</h2>
[h3]{text}[/h3]=<h3>{text}</h3>
[h4]{text}[/h4]=<h4>{text}</h4>
[h5]{text}[/h5]=<h5>{text}</h5>
[h1heading]{text}[/h1heading]=<h1 class="contentheading">{text}</h1>
[contentheading]{text}[/contentheading]=<div class="contentheading">{text}</div>
[componentheading]{text}[/componentheading]=<div class="componentheading">{text}</div>
[span class={classname}]{text}[/span]=<span class="{classname}">{text}</span>
[pre]{text}[/pre]=<pre>{text}</pre>
[blockquote]{text}[/blockquote]=<blockquote>{text}</blockquote>
[blockquote class={classname}]{text}[/blockquote]=<blockquote class="{classname}">{text}</blockquote>
[list class={classname}]{alist}[/list]=<ul class="{classname}">{alist}</ul>
[li]{text}[/li]=<li>{text}</li>
[number value={number}]{text}[/number]=<p><span class="number">{number}</span>{text}</p>
`