You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 12 Next »

Linking Plugin

This plugin contains macros for linking to templates, the dashboard and other Confluence features.

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.

This will create a link on your page which, when clicked, is equivalent to clicking 'Add Page' on the Page Operations bar.

The Code

{add-page:template=[template name]|live=true|parent=[<at:var at:name="self," />parent,@home,Page Name]}[link text]{add-page}

Parameters"> Parameters

Very similar to the add-page macro, this will then create a new page, which may be based on a template if so desired.

Code

{add-page-form:template=A Template|live=true}Add new page{add-page-form}

Parameters"> Parameters

Name

Required

Default

Description

source

 

(Since 2.11.0) The name of the template or page that is the source of the new page body content.

type

template

(Since 2.11.0) Either 'template' or 'page', depending on what type of source is being used.

parent

@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

 

The list of labels to attach to the new page. Only works for live template pages.

allowRename

false

(Since 2.4) If set to true, the user will be allowed to rename the page when it is being created.

nameWidth

 

If set, this specifies the width of the name text field. Can be any valid CSS width value, such as '300px' or '60%'.

class

 

(Since 2.6.5) Sets a class for the displayed form items.

prefix

 

(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

 

(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

 

(Deprecated in 2.11.0) The name of the Template to use when creating the page.

deck: com.atlassian.confluence.macro.MacroExecutionException: java.lang.NullPointerException
Unknown macro: {roundrect}
  • No labels