**********************************************************
    
    predefinedPages.txt
    
    $Id$
    
    @author gERD Schaufelberger <gerd@exit0.net>
    @copyright 2004/2005 Wombat Web Bench
    @link http://wombat.exit0.net
    @package wombat
    @subpackage manual
    
**********************************************************

PREDEFINED PAGES
================

Creating simple standard pages with the Wombat Site Maker Administration tool
can be quite hazzardious for novice users. The form to fill is just too big and
there are too many options. Hence there is a shortcut to create common pages in
a very simple way. 

Common pages are site specific, predefined XML files similar to page
definitions. They are stored in "conf/pagesStandard/" A site's maintainer may
add as many predefined pages as she wants. 

A predefined page can be seen as template to create new pages from. Therefore
they contain pretty much everything the actual page does. It also contains some
placeholders that allows to fill the blanks. 

Such a predefined page may look like this:
-----------------8<-----------------8<-----------------8<-----------------
<configuration>
    <xinc href="/defines.xml" once="yes" />

    <page:page edit="true" delete="true">
        <page:title>Standard CMS Page</page:title>
        <page:brief>--- does not matter ---</page:brief>

        <page:content>
            <part name="title">
                <page:action>staticString</page:action>
                <page:href>{TITLE}</page:href>
            </part>
            <part name="head">
                <page:action>cmsHtml</page:action>
                <page:href>{NAME}_{PART}</page:href>
            </part>
            <part name="maincontent">
                <page:action>cmsHtml</page:action>
                <page:href>{NAME}_{PART}</page:href>
            </part>
        </page:content>
    </page:page>
</configuration>
-----------------8<-----------------8<-----------------8<-----------------

This template will appear as "Standard CMS Page". The placeholders are "name",
"title" and "part", respectively "{NAME}", "{TITLE}" and "{PART}". They will be
replaced by: the name of the actual page, its title and the actual content part.

Using predefined pages users only have to fill out a form of four fields to
create a new page.