{deck:id=Advanced Macros|width=907px}
{card:label=Overview}
h4. Advanced Macros
This plugin provides many macros which generates information on Wiki content.
h5. This plugin includes the following macros:
* *listlabels* -- Displays the pages for a label in a pretty matrix.
* *content-by-user* -- List all the content created by a particular user.
* *children* -- List all the children of a page (and possibly their children).
* *search* -- Perform a full-text search, and include the results in the page.
* *index* -- Create an index of all pages within the space.
* *rss* -- Retrieve a remote RSS feed and summarise it in the page.
* *blog-posts* -- View, summarise or list the most recent news items in the space.
* *excerpt* -- Mark a section of a page as an excerpt for page summaries.
* *excerpt-include* -- Include the excerpt from one page within another page.
* *include* -- Include the full content of one page within another page.
* *gallery* -- Create a thumbnail gallery from a page's attachments.
* *doc* -- Link to the documentation using the doc macro.
* *change-history* -- Show the history of version comments.
* *popular-labels* -- List the most popular labels.
* *contentbylabel* -- List the pages labelled by a specified set of labels.
* *favpages* -- List the pages in your favourites list.
* *related-labels* -- List the related labels for a given set of labels, or for the current page.
* *recently-used-labels* -- List the labels that have been used recently.
* *navmap* -- Displays the pages for a label in a pretty matrix.
{card}
{card:label=Documentation}
{deck:id=advancedm}
{card:label=Excerpt / Include
Macros}
{deck:id=excerptincludem}
{card:label=include}
The Include macro displays the contents of one Wiki page in another. If the page is from another space, you will need to include the space name.
h3. The Code :
{code}
{include:HELP:Wiki Markup Editor}
{code}
h3. What you will get :
The page 'Wiki Markup Editor' from the wiki space 'HELP' is not displayed on this page:
{include:HELP:Wiki Markup Editor}
h3. Parameters
{code}
{include:SPACE:Name_of_page}
{code}
{note:title=The 'space' parameter is case sensitive.}
{card}
{card:label=excerpt}
The Excerpt Macro is used to mark a part of a page's content for re-use. By itself, the excerpt macro does not change the display of a page. However, defining an excerpt enables other macros such as *excerpt-include* and *blog-posts* macros to display the specified content elsewhere.
{note:title=A page can only have *ONE* excerpt.}
h3. The Code :
{code}
{excerpt}
Content to be included on another page.
{excerpt}
{code}
h3. What you will get :
Content to be included on another page.
h3. Parameters
||*Name*||*Required?*||*Default*||*Description*||
|hidden|(x)|false|Controls whether the text between the excerpt tags will appear on that page when users read it.|
{card}
{card:label=excerpt-include}
This macro allows a portion of a page to 'excerpted' in another. To use this macro you must define the 'excerpted' content with the *excerpt* macro.
h3. The Code :
{code}
{excerpt-include:Advanced Macros Plugin}
{code}
h3. What you will get :
This is the plugin libraries navigation bar, which was created using the *excerpt* and *excerpt-include* macros. The panel displays the name of the page where the 'excerpted' content is being pulled from. It can be removed by adjusting the 'nopanel' parameter (see below):
{excerpt-include:Advanced Macros Plugin}
If any changes are made to the content within the body of the *excerpt* macro, it will automatically be changed on any pages it is being 'excerpted'. This makes the *excerpt* and *excerpt-include* macros ideal for creating navigation bars.
h3. Parameters
||*Name*||*Required?*||*Default*||*Description*||
|nopanel|(x)|false|Controls whether the square panel border around the excerpt should be removed. Also controls whether the name of the page where the 'excerpted' content is being pulled from is displayed.|
{card}
{deck}
{card}
{card:label=Label
Macros}
{deck:id=labelm}
{card:label=popular-labels}
Displays the most popular labels used throughout a Wiki space.
h3. The Code :
Bulleted list:
{code}
{popular-labels:style=list|spacekey=HELP|count=15}
{code}
Heatmap :
{code}
{popular-labels:style=heatmap|spacekey=HELP|count=15}
{code}
h3. What you will get :
Bulleted list:
{popular-labels:style=list|spacekey=HELP}
Heatmap :
{popular-labels:style=heatmap|spacekey=HELP}
h3. Parameters
||*Name*||*Required?*||*Default*||*Description*||
|count|(x)|100|Specifies the total number of labels to display in the heatmap.|
|spacekey|(x)|none|Restricts the list of popular labels to the specified space. |
|style|(x)|list|Displays the list of popular labels in standard bullet-point 'list' form or as a 'heatmap'. The heatmap style uses different font sizes depending on their rank of popularity, ordered by label names. The list style orders labels by popularity (highest first).|
{card}
{card:label=contentbylabel}
{card}
{card:label=related-labels}
{card}
{card:label=recently-used-labels}
{card}
{card:label=listlabels}
{card}
{deck}
{card}
{card:label=content-by-user}
{card}
{card:label=children}
{card}
{card:label=search}
{card}
{card:label=index}
{card}
{card:label=rss}
{card}
{card:label=blog-posts}
{card}
{card}
{deck}
{deck}
{roundrect:bgcolor=#828282|width=907px|height=50px|corners=false,false,true,true}
{roundrect}
|