✨(feature) Add a macro "/children" to automatically insert child page links

What problem do you want to fix?

To simplify the creation of links to child pages, a configurable macro should be introduced to automatically insert and generate a list of child pages with customizable display options (bulleted lists, cards, etc.).

• Show Descendants: Choose whether to display all the parent page's descendants.
• Parent page: Specifies the page to display children for (current or different space).
• Number of Children: Restricts the number of child pages displayed at the top level (subject to administrator limits).
• Depth of Descendants: Enter a number to specify the depth of descendants to display (e.g., 2 displays 2 levels). Has no effect if Show Descendants is enabled.
• Heading Style: Chooses the style used to display descendants (h1, h2, h3...)
• Excerpt Display: Allows you to include a short excerpt under each page in the list
• Sort Children By: Determines how the pages are sorted in the list
• Reverse Sort: Use with the Sort Children By parameter to change the sort order

For reference, you can check the Confluence "Children display macro" documentation to explore these features: Children Display Macro Documentation

Possible solution?

Trigger

• User Input: The user types /children in the editor.
• Behavior: The command triggers an autocomplete dropdown or directly opens a configuration dialog box (modal) dedicated to the child page macro.

The opened dialog box will display form fields mapped directly to the macro parameters, allowing users to configure the output without manually writing code.

• Parent Page: A text input or page picker (Default: current).
• Show Descendants: A toggle switch or checkbox (Default: false).
• Depth of Descendants: A numeric input field, disabled if Show Descendants is active (Default: none).
• Number of Children: A numeric input field to restrict top-level items (Default: none).
• Excerpt Display: A dropdown selector with options: None, Simple, and Rich content (Default: none).
• Sort Children By: A dropdown selector with options: Default (Manual/Alphabetical), Creation Date, Title, and Modified Date.
• Reverse Sort: A toggle switch or checkbox (Default: false).
• Heading Style: A selection field for styling headers (Default: none).

or

• User Input: The user types /children({options}) in the editor to give some options

Do you have an alternative?

You type everything out by hand... and it takes forever !

Upload

No response

Contact Details

[email protected]

Code of Conduct

• I agree to follow this project's Code of Conduct