 |
Templates, Add/Edit
Templates allow you to customize the look and feel of your content on your site. WebGUI comes with many existing templates that you can use as is or copy and modify to suit your individual needs. Note that in many cases that you can change the look of default WebGUI templates through CSS. The advantage to this is that the default templates are automatically updated when you upgrade WebGUI, where custom templates will have to be manually updated.
There are two ways to edit templates, via the Display tab of the Asset Edit screen or via the Asset Manager. In either case, you will need to be an Admin or a Template Admin.
Display tab of the Asset Edit screen
- Turn on Admin mode.
- Click on the Edit icon for an Asset.
- Select the "Display" tab for the Asset.
- Next to the template that the Asset uses will be two icons. EditThis will allow you to edit the currently selected template.ManageThis will take you to the Folder in the Asset Manager that contains this template.
Asset Manager
- Turn on Admin mode.
- Click on the "Assets" icon in the Admin bar.
- In the crumb trail style navigation, click on "Root".
- Then click on Asset titled, "Import Node".
- Most default WebGUI templates are stored by type in folders inside the Template Folder.
Template Name
Give this template a descriptive name so that you'll know what it is when you're applying a template to content.
NOTE: You should never edit the default templates that come with WebGUI as they are subject to change with each new release. Instead, copy the template you wish to edit, and edit the copy.
NamespaceWhat type of template is this? Show in Forms?Should this template be shown in the list of templates from this namespace? TemplateCreate your template by using template commands and variables, macros, and HTML. Head BlockPut meta tags, script tags, link tables, style sheets, and anything else here that you want to appear in the head block of the HTML document. Template TypeIf your configuration file lists multiple template engines, then select which type of template this is so that WebGUI can send it to the correct one. Asset IDThis is the unique identifier WebGUI uses to keep track of this Asset instance. Normal users should never need to be concerned with the Asset ID, but some advanced users may need to know it for things like SQL Reports. The Asset ID is not editable.
TitleThe title of the asset. This should be descriptive, but not very long. If left blank, this will be set to "Untitled". Macros, HTML and javascript may not be placed in the title.
Note: You should always specify a title, even if the Asset template will not use it. In various places on the site, like the Page Tree, Clipboard and Trash, the Title is used to distinguish this Asset from others.
Menu TitleA shorter title that will appear in navigation. If left blank, this will default to the Title.
UI Level:1
URL
The URL for this asset. It must be unique. If this field is left blank, then a URL will be made from the parent's URL and the Menu Title.
UI Level:3
Summary
A short description of this Asset.
UI Level:3
Extra <head> elements (tags)
These tags will be added to the <head> section of each page on which the asset appears.
controlsThese are the icons and URLs that allow editing, cutting, copying, deleting and reordering the Asset.Keywords: Templates
