Supplied Templates
AssetNow NX uses templates to deliver content. Templates can format content for visual rendering suitable for web browsers, generate specialized formats for such as syndicated content feeds, or transform content into other formats as required by special devices and systems.
The templates supplied with AssetNow NX are grouped into 6 types:
- Category templates display AssetNow NX category content and are setup for web browsers. A category is typically an intermediate page which lists and links to content pages contained in the category. A template is applied to a category by selecting it from a drop list in the Category publishing tool.
- Content templates display AssetNow NX pages and are setup for web browsers. A template is applied to a content page by selecting it from a drop list in the Content publishing tool.
- Custom templates can be designed to deliver any required output such displaying a page in a pop-up window.
- List templates are used to format AssetNow mailing list (newsletter) messages and typically comprise a pair of templates, XHTML and plain text, to format message content for e-mail clients.
- System templates display and output AssetNow NX forms and RSS feeds. These include search, site map, and tool RSS feeds.
- Transformation templates output Category, Content, and Comment feeds in popular formats including RSS and ATOM. Developers can also add XSL/T based transformation templates or parsing to output virtually any required format.
Templates are located in folders in the /sys/cftags/assetnow/design/templates
directory.
When customizing templates we recommend renaming the template with a prefix specific to the site, project, or template display format. For example mysite_category.cfm, this will allow you to easily manage different templates and make it easier for publishers when they select a template to apply. For example you can name templates based on formatting such as col_3_category.cfm
for a 3 column display.
Using the _xhtml
suffix is only required if you wish to serve XHTML strict content to specific browser as described in the Template and Widget FAQ.
At a minimum when implementing a new site design you should review/update the Category, Content, and System templates (login, search, and site map).
The following tables lists the templates supplied with AssetNow NX. Developers can modify these templates as required and add as many, or few, templates as necessary to implement their site designs.
Additional templates may be present in these directories, the tables list the core templates used by the supplied AssetNow site.
Category Templates
Typically a category page is an intermediate page listing and linking to subcategories and content contained in the category.
| Template | Description |
|---|---|
category_xhtml.cfm | Displayed when a category is selected. Widgets are supplied to generate these links automatically as new categories and content are added. If a category contains a single content page the default behavior is to display the complete page so that visitors do not have to click an additional link to reach one page. |
home_xhtml.cfm | Home is a the top level category of a site and typically uses a separate template to allow formatting of the home page to suit the site design. |
blog_xhtml.cfm | Lists all new content pages published in the category and subcategories of the category using this template. |
system_xhtml.cfm | A plain template that can be used to format a hidden/private category containing site information, publishing guidelines and policies etc. The category can be set as the default category to be displayed when the Tools Start screen is displayed. The default setting displayed the site home page, this can be changed by setting the start url in the TOOLS_START_URL system parameter. Effectively this allows you to publish and maintain information for publishers/tool users with AssetNow NX. |
Content Templates
Content templates output pages published with AssetNow NX
| Template | Description |
|---|---|
page_xhtml.cfm | Outputs selected AssetNow NX content page. |
dom_slides.cfm | Example showing how a template can display a page in a special format. In this example a page is displayed as a slide show presentation using the DOMSlides solution from Christian Heilmann. |
system_xhtml.cfm | A plain template to be used in conjunction with the category system_xhtm.cfm
template described above. |
Custom Templates
| Template | Description |
|---|---|
custom.cfm | Example that launches a pop-up window containing a form. |
List Templates
| Template | Description |
|---|---|
default.cfm | X/HTML format template used when sending email messages (newsletters) to mailing list subscribers. |
default_text.cfm | Plain text format template used when send email messages (newsletters) to mailing list subscribers. |
System Templates
| Template | Description |
|---|---|
login.cfm | Sign-in form displayed when clicking the sign in link or accessing the sign in url. |
nopermissions.cfm | Displayed when a user requests a page to which they do not have permissions. |
pagenotfound.cfm | Displayed is the requested page does not exist. |
profile.cfm | User profile form, allows users/members to update their user information. |
register.cfm | Member registration form. If enabled for a group visitors can complete the form to register. |
search.cfm | Site search form and results |
sitemap.cfm | Displays automatically generated site map. |
subscribe.cfm | List (Newsletter) subscription form. Allows visitors to subscribe, unsubscribe and change their subscriptions. |
toolfeed.cfm | Generates authenticated (private) feeds for content approval and notes which can be subscribed to by Tool users. You should not need to modify this template. |
Transformation Templates
Transformation templates are grouped in folders as listed below:
| Template | Description |
|---|---|
/category | Contains templates for RSS, ATOM, RDF and and example (EXP) output format. The example applies an XSLT to reformat a page simialr to a screen reader display. See the EXP transformation applied to this page - to return use your web browser "back" button. EXP is simply an extension we have defined, you can defiend your own transformations and extensions. Extensions are defined and enabled by adding them in the ALLOW_DISPLAY_TYPES system parameter. |
/content | Contains templates for RSS, ATOM, RDF and and example (EXP) output format. |
/comments | Contains an RSS feed template that generates a comment feed if comments are enabled in a category. |
/xsl | Examples of XSLT transformations. |
Links Referenced
- RSS
- http://en.wikipedia.org/wiki/RSS_(file_format)
- ATOM
- http://atomenabled.org/
- XSL/T based transformation
- http://www.w3.org/TR/xslt
- Template and Widget FAQ
- http://www.assetnow.com/index.cfm/1,84,283,0,html/Template-and-Widget-FAQ
- system parameter
- http://www.assetnow.com/index.cfm/1,84,278,0,html/AssetNow-NX-System-Setting-Parameters
- DOMSlides solution from Christian Heilmann
- http://icant.co.uk/domslides/
- RDF
- http://en.wikipedia.org/wiki/Resource_Description_Framework
- See the EXP transformation applied to this page
- http://www.assetnow.com/index.cfm/1,84,286,-1,exp
- system parameter
- http://www.assetnow.com/index.cfm/1,84,278,0,html/AssetNow-NX-System-Setting-Parameters
Location
http://www.assetnow.com/index.cfm/1,84,286,-1,html
Copyright © Orbital Limited 2008
