{deck:id=Linking Plugin|width=907px}
{card:label=Overview}
h4. Linking Plugin
This plugin contains macros for linking to templates, the dashboard and other Confluence features.
h5. This plugin includes the following macros:
* *add-page* \- This will create a link on your page which, when clicked, is equivalent to clicking 'Add Page' on the Page Operations bar.
* *add-page-form* \- Creates a simple form on a page for users to enter the name of the new page to add.
* *child-countert* \- Allows display of the 'current' and 'next' Child Counter value, as well as the ability to disable or reset the value if required.
* *incoming-linksl* \- Generates a list of links of pages which link into this page.
* *link-page* \- This will create a link to a page, or a link to create a page based on a template and/or parent page.
* *link-to* \- Creates a link to special Confluence locations. All locations are case-insensitive.
* *link-window* \- Links to a page or URL, popping it up into a new window.
* *orphaned-links* \- Creates a list of pages which do not have any other pages linking to them.
* *outgoing-links* \- Creates a list of pages, websites and email addresses the current page links to.
* *undefined-links* \- Creates a list of pages which are linked to but have not yet been created.
{card}
{card:label=Documentation}
{deck:id=docs}
{card:label=add-page}
This will create a link on your page which, when clicked, is equivalent to clicking 'Add Page' on the Page Operations bar.
h4. The Code
{code}
{add-page:template=[template name]|live=true|parent=[<at:var at:name="self," />parent,@home,Page Name]}[link text]{add-page}
{code}
h4. {toggle-cloak:id=1} Parameters
{cloak:id=1}
||Name || Required || Default || Description ||
|| source | (x) | | (Since 2.11.0) The name of the template or page that is the source of the new page body content. |
|| type | (x) | template | (Since 2.11.0) Either 'template' or 'page', depending on what type of source is being used. |
|| parent | (x) | @self | The page you would like to be the parent of the new page. If no parent page is desired, set parent to a blank value. ie. 'parent='. Otherwise, set to 'Page Name' or 'SPACEKEY:Page Name'. There are also three special values:
* *@self* - sets the parent to the new page the macro appears in.
* *@parent* - sets the parent of the new page to the parent of the current page.
* *@home* - sets the parent of the new page to the home page of the current space. |
|| labels | (x) | | The list of labels to attach to the new page. Only works for live template pages. |
|| title | (x) | | If you want popup text to appear when the mouse is hovered over the link, enter it here. |
|| allowRename | (x) | false | (Since 2.4) If set to true, the user will be allowed to rename the page when it is being created. |
|| prefix | (x) | | (Since 2.8.0) The %injectable% prefix to apply to the page name. The user will not be able to modify this section of the name while creating it. Eg: 'prefix=%page:title% - ' will add the current page title plus ' - ' to the start of the page name. |
|| postfix | (x) | | (Since 2.8.0) The %injectable% postfix to apply to the page name. The user will not be able to modify this section of the name while creating it. Eg: 'postfix= - %page:title%' will add the current page title plus ' - ' to the end of the page name. |
|| template | (x) | | (Deprecated in 2.11.0) The name of the Template to use when creating the page. |
|| clonePage | (x) | | (Since 2.10.0; Deprecated in 2.11.0) The name of the page that will be cloned to create the new page. Note that the 'live' and 'template' parameters are not allowed in conjunction with this parameter. |
{cloak}
{card}
{card:label=add-page-form}
Very similar to the add-page macro, this will then create a new page, which may be based on a template if so desired.
h4. Code
{code}
{add-page-form:template=A Template|live=true}Add new page{add-page-form}
{code}
h4. {toggle-cloak:id=2} Parameters
||Name || Required || Default || Description ||
|| source | (x) | | (Since 2.11.0) The name of the template or page that is the source of the new page body content. |
|| type | (x) | template | (Since 2.11.0) Either 'template' or 'page', depending on what type of source is being used. |
|| parent | (x) | @self | The page you would like to be the parent of the new page. If no parent page is desired, set parent to a blank value. ie. 'parent='. Otherwise, set to 'Page Name' or 'SPACEKEY:Page Name'. There are also three special values:
* *@self* - sets the parent to the new page the macro appears in.
* *@parent* - sets the parent of the new page to the parent of the current page.
* *@home* - sets the parent of the new page to the home page of the current space. |
|| labels | (x) | | The list of labels to attach to the new page. Only works for live template pages. |
|| allowRename | (x) | false | (Since 2.4) If set to true, the user will be allowed to rename the page when it is being created. |
|| nameWidth | (x) | | If set, this specifies the width of the name text field. Can be any valid CSS width value, such as '300px' or '60%'. |
|| class | (x) | | (Since 2.6.5) Sets a class for the displayed form items. |
| prefix | (x) | | (Since 2.8.0) The %injectable% prefix to apply to the page name. The user will not be able to modify this section of the name while creating it. Eg: 'prefix=%page:title% - ' will add the current page title plus ' - ' to the start of the page name. |
| postfix | (x) | | (Since 2.8.0) The %injectable% postfix to apply to the page name. The user will not be able to modify this section of the name while creating it. Eg: 'postfix= - %page:title%' will add the current page title plus ' - ' to the end of the page name. |
| template | (x) | | (Deprecated in 2.11.0) The name of the Template to use when creating the page. |
{cloak}
{card}
{card:label=child-counter}
{card}
{card:label=Links Macros}
{deck:id=links}
{card:label=incoming-links}
{card}
{card:label=orphaned-links}
{card}
{card:label=outgoing-links}
{card}
{card:label=undefined-links}
{card}
{deck}
{card}
{card:label=link-page}
{card}
{card:label=link-window}
{card}
{deck}
{card}
{card}
{deck}
{roundrect:bgcolor=#828282|width=909px|height=50px|corners=false,false,true,true}
{roundrect}
|