If a Kentico CMS document is related to some other documents, these can be displayed using one of the following controls:

 

 

All of them have the following three properties that can be set in order to display related documents (besides other properties, such as Path, ClassNames, etc.):
 

 

More information about related documents can be found at Developer's Guide -> Content management -> Document properties -> Related docs.

 

Example

 

The following example shows how to create an ASPX page template that displays news items related to the current page by using the CMSRepeater control:

 

1. Now open the Kentico CMS web project in Visual Studio and create a new Web form called RelationshipExample.aspx in the CMSTemplates/CorporateSiteAspx folder.

 

2. Switch to the Source view of the newly created web form and add the following line under the <%@ Page %> directive:

 

 

3. Switch to the code behind. You need to add a reference to the CMS.UIControls namespace:

 
[C#]
 

 

4. Modify the class from which the page is inherited. Change the following code:

 
[C#]
 

 

to this:

 
[C#]
 

 

Now the page can be correctly used as a page template in Kentico CMS.

 

Please keep in mind that the name of the class must be identical to the value of the Inherits attribute of the <%@ Page %> directive on the ASPX page. This is case sensitive.

 

5. Switch to its Design tab, drag and drop a CMSRepeater control from the toolbox onto the form and set its following properties:

 

 

This tells the control to read news documents, specifies the path to the News section of the sample Corporate Site, assigns the transformation that should be used to display the news documents and tells the control to display only documents that are in the isrelatedto relationship with the currently selected document.

 

The overall code of the CMSRepeater control will look like this:
 

 

6. Save the changes to the web form.

 

7. Now open the sample Corporate Site ASPX, go to Site Manager -> Development -> Page templates, select the Corporate Site ASPX category and create a new template. Enter the following properties:
 

 

Click OK. Press the Select button next to the File name field and choose the RelationshipExample.aspx web form from the CMSTemplates/CorporateSiteASPX folder.

 

Click Save.

 

8. Switch to the Sites tab, press Add sites and select Corporate Site ASPX.

 

9. Switch to CMS Desk, select Services from the content tree and create a new Page (menu item) called under it, enter New Service 1 into the Page name field and select the Corporate Site ASPX -> Related news page template. Click Save. Now switch to Properties -> Related docs tab of the new page and add a related document by using Add related document, choose is related to as the Relationship name and select the News -> Your first news document as the Right-side document.

 

 

10. Repeat step 9, but call the new page New Service 2 and select the News -> Your second news document as the Right-side document of the relationship.

 

11. Now select the /Services/New Service 1 page from the content tree and switch to Live site mode. You will see that the CMSRepeater on the page template is displaying a preview of the news item related to this page:

 

 

If you select /Services/New Service 2 page, you will see the Your second news item displayed in the same fashion.

 

Using web parts to display related documents

 

When using the portal engine, related documents can also be displayed by the following web parts from the Listings and viewers category:

 

 

This can be done by setting the properties in their Relationships property section as seen in the following image:

 

 

Example

 

The following example shows how to display news items related to a product by using the Repeater web part:

 

1. Open the sample Corporate Site, go to CMS Desk -> Content, select Products -> Laptops -> Acer Aspire 3105WLMi and switch to the Properties -> Related docs. Now add a related document by using Add related document, choose is related to as the Relationship name and select the News -> Your first news document as the Right-side document.

 

2. Repeat step 1 for Products -> Laptops -> Asus F3U AP059C, but select the News -> Your second news document as the Right-side document.

 

3. Select Products from the content tree, switch to the Design tab and add () a Listings and viewers -> Repeater web part to the zoneRight web part zone.

 

4. The Web part properties (Repeater) dialog will appear. Set the following properties:

 

 

5. Now select /Products/Laptops/Acer Aspire 3105WLMi from the content tree and switch to Live site mode. You will see the news item that was added as a related document in step 1 displayed below the product using the CMS.News.Preview transformation:

 

 

If you select /Products/Laptops/Asus F3U AP059C, you will see the Your second news item displayed in the same fashion.

 

Page url: http://devnet.kentico.com/docs/5_5r2/controls/index.html?cms_listings_and_viewers_displaying_related_documents.htm