Kentico CMS 7.0 Developer's Guide

Creating a linked document

Creating a linked document

Previous topic Next topic Mail us feedback on this topic!  

Creating a linked document

Previous topic Next topic JavaScript is required for the print function Mail us feedback on this topic!  

A linked document is a "stub" or "shortcut" of some existing document. It allows you to place a single document to multiple places in the content tree instead of creating its copies. Such a document is then displayed in the given part of the website, but when you edit it, you actually update the original document.

 

This feature is useful if you need to include a document (product) in multiple site sections (product categories), but keep only one instance of the document.

 

In order to create a linked document, select the document under which you want the linked one to be placed, click New and choose Link an existing document in the bottom of the screen:

 

devguide_clip0313

 

Then, choose the document that should be linked. You have two additional options to configure:

 

Link also all child documents - this option is displayed only when the selected document has some child documents stored under itself; if enabled, all child documents will be linked along with the selected document

Copy document permissions - if enabled, document-level permissions will be preserved on the linked document; if disabled, the document will inherit permissions from its parent in the target location

 

Click Link to create the new linked document.

 

devguide_clip1158

 

Unless the Site Manager -> Settings -> Content -> Content management -> Display linked icon option is disabled, the linked document will appear with the LinkedDoc_Flag icon in the content tree:

 

devguide_clip1159

 

You can see a list of all linked documents for the currently selected document in the Properties -> Linked docs dialog.