Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Live template
templateTypetemplate
templateOption{"label":"Macro Reference Live Template v2","value":"471763892","templateType":"template"}
templateTypeOption{"label":"Confluence template/blueprint","value":"template"}
templateId471763892
excerptDescription This macro creates a link to a page or a link to create a page based on a template and/or parent page. If the page doesn't exist or is untitled, it generates an Add Page link, which can take the user directly to a template and/or set the page parent when clicked. If you click the link and the page already exists, the macro will redirect to the existing page. We only support editing existing macros. We do not support adding new macros, and in the labels of the macro, we will add "Legacy" in the title Parameters Name Required Default Value Description Create link Text (/) Text display for the link. Source Type (x) Template/blueprint (Cloud) The type of page source that is being used.   Source (x) The name of the template or page that is the source of the new page body content.  Live Template (x) false If set to true , the template will be "live". It uses a Scaffolding Forms & Templates 's Live Template  macro to import and execute the current value of the template every time the page is viewed. Requires Scaffolding Forms & Templates to be installed.  Parent (x) Current page The target parent for the new page. Defaults to the current page. NOTE The special values @self, @parent, and @home are no longer supported in Cloud. Existing macros with these special values will continue to work, unless the Parent field is updated to another page. Page Title (x) The title of the new page. Name (x) The name of the new page. Prefix (x) The prefix to apply before the page name. May contain these functions: $spaceKey  to use the targeted page's Confluence space key as prefix. $spaceName  to use the targeted page's Confluence space name as prefix. $date(<date-format>) to output the current time and date e.g. $date(YYYY-MM-dd HH:mm a) . Supported date-formats are as follows: Format Output Description YY 18 Two-digit year YYYY 2018 Four-digit year M 1-12 The month, beginning at 1 MM 01-12 The month, 2-digits MMM Jan-Dec The abbreviated month name MMMM January-December The full month name D 1-31 The day of the month DD 01-31 The day of the month, 2-digits d 0-6 The day of the week, with Sunday as 0 dd Su-Sa The min name of the day of the week ddd Sun-Sat The short name of the day of the week dddd Sunday-Saturday The name of the day of the week H 0-23 The hour HH 00-23 The hour, 2-digits h 1-12 The hour, 12-hour clock hh 01-12 The hour, 12-hour clock, 2-digits m 0-59 The minute mm 00-59 The minute, 2-digits s 0-59 The second ss 00-59 The second, 2-digits SSS 000-999 The millisecond, 3-digits Z +5:00 The offset from UTC ZZ +0500 The offset from UTC, 2-digits A AM PM a am pm The <format> parameter specifies the structure of the identifier (e.g., "00", "000"). It controls the number of digits in the numeric part of the identifier. startAt can be set to any number and after adding the parameter, the page incrementation will increase by one up. For example,  if <startAt> is set to 100 and the format is "00", the generated IDs could be "100", "101", and so on. $id(<format>,<startAt>) works globally across all spaces. It means that if there is a form with prefix/postfix and pages (in all user spaces) prefixed with numbers, the number will be incremented relative to the highest number of pages in all user spaces. For separate incrementation of different pages / spaces, the best solution will be to add prefix-label in prefix/postfix, for example, my space 1 - $id(000, 1) $pageTitle - to replace the current page title. Postfix (x) The postfix to apply before the page name. May contain these functions: $spaceKey to use the targeted page's Confluence space key as prefix. $spaceName to use the targeted page's Confluence space name as prefix. $date(<date-format>)  to output the current time and date e.g.  $date(YYYY-MM-dd HH:mm a) . Supported date-formats are as follows: Format Output Description YY 18 Two-digit year YYYY 2018 Four-digit year M 1-12 The month, beginning at 1 MM 01-12 The month, 2-digits MMM Jan-Dec The abbreviated month name MMMM January-December The full month name D 1-31 The day of the month DD 01-31 The day of the month, 2-digits d 0-6 The day of the week, with Sunday as 0 dd Su-Sa The min name of the day of the week ddd Sun-Sat The short name of the day of the week dddd Sunday-Saturday The name of the day of the week H 0-23 The hour HH 00-23 The hour, 2-digits h 1-12 The hour, 12-hour clock hh 01-12 The hour, 12-hour clock, 2-digits m 0-59 The minute mm 00-59 The minute, 2-digits s 0-59 The second ss 00-59 The second, 2-digits SSS 000-999 The millisecond, 3-digits Z +5:00 The offset from UTC ZZ +0500 The offset from UTC, 2-digits A AM PM a am pm The <format> parameter specifies the structure of the identifier (e.g., "00", "000"). It controls the number of digits in the numeric part of the identifier. startAt can be set to any number and after adding the parameter, the page incrementation will increase by one up. For example,  if <startAt> is set to 100 and the format is "00", the generated IDs could be "100", "101", and so on. $id(<format>,<startAt>) works globally across all spaces. It means that if there is a form with prefix/postfix and pages (in all user spaces) prefixed with numbers, the number will be incremented relative to the highest number of pages in all user spaces. For separate incrementation of different pages / spaces, the best solution will be to add prefix-label in prefix/postfix, for example, my space 1 - $id(000, 1) $pageTitle - to replace the current page title. Labels (x) The list of labels to attach to the new page. Editor View Macro Edit View Notes
fieldGroupKeys{"c4ublnabvz":["net.customware.confluence.plugin.scaffolding__c4ublnabvz__data_0_8b4g897f6s3bas0fgxad","net.customware.confluence.plugin.scaffolding__c4ublnabvz__data_1_8b4g897f6s3bas0fgxad"]}

Tutorial Examples

Filter by label (Content by label)
showLabelsfalse
showSpacefalse
cqllabel = "add-page"
labelsadd-page