Directory Mirror Page

The Directory Mirror page type is designed to provide an alternate view to a directory within your conversation. Using a Directory Mirror, you can flow the same content through a different template and stylesheet selection. Perhaps the most common use of this type of functionality is to create a printer friendly version of content in your site.

As an example, say you have a folder named "stories" at the root level of your conversation. In it, you have a bound url at "stories/faq". If you create a Directory Mirror page named "printversion" at the root level of your site, you could set that mirror page's "Directory path" properties to "stories/". You could then request the page "printversion/faq", and it would be served using the templates, stylesheet and other file properties of the "printversion" page.

The Directory Mirror page supports rendering all file types, not just bound URLs, but it is intended primarily as an alternate view. Some Page Types, while they will work, will produces links back to the page at it's original location, etc., for editing -- so it's not recommended that you attempt to use a Directory Mirror view for primary access to pages. The directory mirror page defaults to mirroring the entire conversation, but special Conversant URLs, such as message pages, and new thread pages will not be mirrored.

Creating a Directory Mirror Page

To create a new Directory Mirror Page, go to the structure editor of your site: /yourSite/admin/conversations/yourSite/structure, and select the folder in which you want to create the page.

Use the "Add new file" form to create the page.

Editing Directory Mirror Page Properties

The Directory Mirror has the same basic properties of any page in Conversant, including template and stylesheet selections. The selections made for these properties will be used when serving all mirrored pages.

• Directory Path
  The only custom property of the mirror page, this determines the path within your conversation that will be mirrored. Defaults to empty string, which will mirror the entire conversation.

Special Directory Mirror Macros

Two special macros are available and functional only in Directory Mirror pages:

• <--#mirroredPagePath-->
  Returns the path property of the page currently being mirrored. By using this macro as the "path" attribute in other Page Macros you can access the page properties of the original page in your templates.
• <--#mirroredPageURL-->
  Returns the URL to the original location of the page being mirrored.