{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
{cloak:id=2}
||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}
When 'child counting' is enabled for a page, the plugin will keep track of how many children have been added to this page over time. This is different to the 'current page count', since it will not decrease when pages are deleted. This makes it useful for creating new pages with unique ID values which will never be duplicated.
h4. Code
{code}
{macro:current/next/disable/enable/reset X|source=[page name]}
{code}
h4. {toggle-cloak:id=3} Parameters
{cloak:id=3}
||Name || Required || Default || Description ||
|| [default] / action | (/) | current | May be one of the following:
* *current* - Outputs the current 'child count' value.
* *next* - Outputs the next 'child count' value (current + 1). Requesting this will also 'enable' child counting automatically.
* *enable* - Enables child counting. Will not reset the counter if it's already enabled.
* *disable* - Disables child counting and resets the counter.
* *reset* - Resets the current 'counter' value to 0.
* *reset to X* - Resets the current 'counter' value to the specified number. Must be positive.
|| source | (x) | @self | Specifies the page the macro should operate on. If specified to another page, this will perform the specified action on that page, if the current user has sufficient permissions. |
{note:title=Note}
It doesn't generally make much sense to use the 'operational' actions permanently on a page. For example, specifying 'reset to 100' on a page will constantly reset the counter to 100, not just the first time you save it. It may be simplest to add them in edit mode and Preview, then remove them again.
{note}
{cloak}
{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}
|