Include Page Macro

Are these includes cached as part of regular page caching?

In order to provide users of my wiki space with something to read and review offline on the train (!), I created a page which used the {include} macro to create a page made up of multiple other pages, effectively:

{include:chapter 1}
{include:chapter 2}
{include:chapter 3}
...

The export page to PDF option (icon at top right of screen works well for the text - but it omits any images on the included pages. Is this a bug? or a feature?

The individual pages (chapter 1, chapter 2, etc) export to PDF with images ok on their own.

I'd like to have another optional parameter "labels=true" whereby the labels of the included page will be associated with the including page. This would be very useful to manage labels used on included pages in the same way that the

In my case I have labels on various distribution notice pages. I would like the labels to be automatically attached to any page that uses the distribution notice so that I can easily check that all content has the correct distribution notice.

I've created an issue here: CONF-7309

In the meantime I can use the

sorry forgot to escape the macros

is there a way to include a page and all its child pages..rather than doing it one by one?

The include macro, metadata-from macro, and the zone-template-instance macro all very simmilar, but subtly different, task. This is not explained in either of their documentation. Perhaps there should be a 'comparison' page?

CONTENT is the content being included, as named in the 'include' macro
INCLUDER is the page that contains the 'include' macro

Behavior	Include	edit-include	Zone-template-instance	metdata-from	Checklist	Reporting plugin
Includes content from another page or space
Renders wiki (and links) in context of CONTENT page						?
Allows access to metadata from CONTENT page						?
Allows setting of metadata on CONTENT page						?
Renders wiki (and links) in context of INCLUDER page
Allows access to metadata from INCLUDER page
Allows setting of metadata on INCLUDER page
Allows preview mode
Allows inclusion of PART of CONTENT page
Can shows an 'edit' button on included content
Can shows an intelligent missing page message for missing pages					n/a	n/a
Can show multiple pages at once
Shows 'add new page with this name' link for missing pages

Syntax

• {include:spaceKey:pageName}
• {edit-include:spaceKey:pageName}
• {zone-template-instance:spaceKey:pageName}{zone-template-instance} * (can also include zone-data tags}
• {metadata-from:spaceKey:pageName|metadataTag}
• see documentation for the more complicated checklist, reporting and metadata-report plugins

Similar to Alan's error above regarding the PDF export:

The images are not exported on the include page during an HTML export.  The path is correct in the HTML page exported, but no attachments folder is created and the images are not downloaded.

Can I include the contents of a news item from another space? Can't see to get it to work.

It would be useful to include an optional parameter noerror.

With the current implementation, you get a red error message when the page to be included does not exist (or if the user does not have viewing rights). In some instances you would like this to fail more gracefully, by simply not showing any error message.

This could help in making a welcome page different for users with different permissions. Until now I couldn't find any way in doing this elegantly. The show-to and include-excerpt macros both seem to discard some of the layout or links, so they cannot be used in that context either.

It would be nice to be able to use

{include:page-with-links-that-should-not-appear-for-group-B|noerror=true}

to include links from a page to which group B does not have viewing permissions, without showing an error message to group B.

Is the source-code for the "include page"-macro available somewhere. I'd like to look into ajaxifying it as we're having major performance issues w. our Confluence after upgrading from 2.2.9 to 2.5.7 (apparently the new permissions checking system is more cumbersome than the old).

I currently have 6 separate templates that collect user input. All 6 of these templates are under a parent page. I want the information from the child pages (collected via templates) to be displayed on the parent page.

Using the include tag, this works, but I lose all formatting and it includes as blocks of text.

Any way around this?