loading table of contents...

8.1.12. Create from Template

As described in Section 8.1.11, “Content Creation” when you create a Page content item in the Create content menu or from a link list, you will get a new and empty content item. If you want, on the other hand, create a Page with predefined content, or even a complete navigation hierarchy, you can use the Create contentCreate from Template menu item. This will open a dialog where you can choose your Page from predefined templates.

Create from template dialog

Figure 8.20. Create from template dialog


As with the standard Create Page dialog you can choose a name, the destination folder for the page and the navigation parent. The Create from Template dialog adds a template chooser from which you can select the template and a new combo box (Editorial Content Folder) where you can select a destination folder for the editorial content. The folder defined in the Page Folder combo box must not exist.

The suggested target paths for editorial content and content used to model the navigation are taken from a content-based setting from the bundle Content Creation (see Section 8.1.10, “Settings for Studio” for an explanation of the content-based settings mechanism). You can modify the settings paths.editorial and paths.navigation to match your specific content tree.

Location of new template folders

By default, templates will be looked up in the following folders:

  • Global: /Settings/Options/Settings/Templates/CMChannel/

  • Site specific: Options/Settings/Templates/CMChannel/

  • User's home folder: {USER_HOME}/Templates/CMChannel/

The lookup path is configurable in the Studio properties file CreateFromTemplateStudioPluginSettings.properties by changing the property pagegrid_template_paths. Additional entries can be added in a comma separated format.

[Caution]Caution

Keep care when you configure a template path outside the site hierarchy or when you use the global templates location. It is possible that the preconfigured layout of a global template may not be available for the active site. Therefore, the page grid extending mechanism won't work anymore, since the page grid editor can't find the layout definitions of other pages.

How to add a new template folder

Template folders must have a specific format to be detected as template folders. Each template is defined in a separate folder inside the Templates/CMChannel folder. The folder must contain a CMSymbol document named "Descriptor" that might contain an additional icon and description for the template. The icon is used as a preview in the template chooser and the description will be shown as the template name in the template chooser.

Each template folder must contain exactly one page document at root level, otherwise the folder will be ignored. If the template consists of several pages, the sub pages should be placed within a subfolder of the template. Editorial content (Article, Images ...) that is contained in these folders and is linked by Page templates will be copied to the destination, defined in the Create from Template dialog.

If the name and the description should be internationalized, create an additional Descriptor document next to the original descriptor and append the locale to the document name, "Descriptor_de" for the German version, for instance.