Managing the Template Library

You can add a new template file or edit its properties, and re-upload new files (with the same name) to replace existing ones.

To add a new Template file:

1. Navigate to the part of the directory where you want to add the new file. In the Template Library listing, click Add New..
2. The Add New Template popup appears.
   

To edit the properties for the template file:

1. In the Template Library, click Edit Properties.
2. The Add New / Edit Style popup appears.

 

3. Edit the properties as follows:

 

Title	Name of template in CMS
Description	Brief explanation of the contents or use of the template
Image	A thumbnail image or icon that will help users recognize and pick the template from the template listing when creating a page. Click Browse to upload. Thumbnails should be 75 pixels by 75 pixels and highlight the main areas of each template so they are easily identifiable within iAPPS.
Template	Template file name (.ascx ). Click Browse to upload or re-upload.
Code-Behind	Code-behind (.cs) file associated with the template. Click Browse to upload or re-upload.
Theme	Choose any relevant themes this would be limited to from the dropdown list.
Template Styles	Check the box next to any of the styles you wish applied to the template.
Template Scripts	Check the box next to any of the scripts you wish applied to the template.
Page Part	Click checkbox to indicate that the file is a page part: a template used in other templates.
Variant Sites	Click this checkbox if you want to limit use of the template to only a master site, rather than any variant sites.

 

4. Click Save.
5. The new or updated file appears in the library listing.

If your ASCX file calls a code-behind file, that file must be placed on the server, even if it contains no custom code. Otherwise the iAPPS page you create from the ASCX template will be blank. Always include a C# code-behind file for each page template and page part, and upload to the server with your template.

 

Page Parts are ACSX files that are meant to be used by some parent page; they should not be available for content authors to select as page templates. These are typically the common ACSX files that are used in multiple page templates, but they may also contain custom code that is embedded into an iAPPS page template.

Page element ASCX files, such as the header.ascx and footer.ascx files, should have the Page Part check box checked in their properties display.

Page templates that are meant to be used by authors to create pages should not have the Page Part check box checked.

 

To view which pages are using a template:

1. In the Template Library, highlight the name of a file and select View Pages Using Template from the More as appropriate.

2. A Pages Using [template file] dialog appears, displaying either:

• A list of the pages using the selected file OR
• A message indicating that no pages reference the selected file

3. Click Close to return to the Template Library.

 

Content Manager does not delete an archived page template, but makes it unavailable by moving it to an archived folder.

To archive/make active a template:

1. In the Template Library, highlight the name of a file and select Archive or Make Active as appropriate.
2. Content Manager changes the status it displays for the library listing.
3. You can filter to display only archived files or active files using the Status drop-down filter.

 

If a page template is active, it appears in the Page Template library list with a status of Active, and displays in the Template list for users creating new pages.

Inactive templates cannot be used to create new pages.

 

To download existing template files as a zip file:

1. In the Template Library, highlight the name of a file and select Download Files.
2. A Open/Save File dialog will display. Choose where to save the file.