Getting started
Sections
Help

Layout config

From Snowfire Wiki

Jump to: navigation, search


Every layout can have an optional configuration file, which should have the same filename as the layout, but with the .xml extension. If the layout file is named layout-file.tpl, then the configuration file should be called layout-file.xml.

The configuration options are applied when a page is created, if nothing else is specified.

Contents

Full-featured example

<?xml version="1.0" encoding="utf-8"?>
<layout>
	<settings>
		<container>Default container</container>
		<tags>tag1 tag2 tag3</tags>
		<children>
			<layouts allowNewLayout="true">
				<layout>post.tpl</layout>
			</layouts>
			<contentType>post</contentType>
			<noAddToMenu>true</noAddToMenu>
		</children>
	</settings>
	<childrenRss>
		<item>
			<content type="html-id">blog-post</content>
		</item>
	</childrenRss>
</layout>

Settings

Miscellaneous settings.

Container

What container to use.

Tags

Default tags, separated by a space.

Children

Options for child pages.

Layouts

What layouts are permitted. Please use one layout filename per <layout>. Creation of new layouts can be allowed with attribute allowNewLayout.

Content type

What function has these pages? This can be an arbitrary string, e.g. Blog post, Product, Photo page etc.

Singular

The type in singular, e.g. Blog post. Please capitalize the first word.

Plural

The type in plural, e.g. Blog posts. Please capitalize the first word.

noAddToMenu

Set to true to disable the option to add a page to the menu. Useful for blog posts etc.

Children RSS

Use to create an RSS feed from child pages. To enable the RSS feed, you must also press Enable RSS in the page settings dialog.

Title
Description

Set name and meta data for the feed. These are optional and will be taken from the page title and description, if they are not set in the config.

Item

Content

Specify what in the layout should be the feed item's body.

Type: html-id

Use a HTML ID

Example

If this is set to blog-post, then it will look for something similar to <div id="blog-post">...</div> in the layout file.

Views
Personal tools