Documentation

Light-weight, fast, simple and powerful!
 
Translations of this page?:

Wolf CMS user guide

Welcome to the Wolf CMS user guide. This book will guide non-administrative users of the Wolf content management system on topics like how to create pages, edit them and other such everyday tasks.

This book is a collection of wiki pages from the wolfcms.org documentation wiki that are gathered together to form a book-like total.

By accessing this book and selecting the “Export to ODT” button, you can generate an Open Office document for your viewing/printing pleasure. You can of course also use Open Office to turn the ODT document into a PDF file.

Creating a page

This section will explain step by step how you can create a page in Wolf CMS. It is important to understand that pages have “parents” and “children”.

When a page “B” is placed underneath another page “A” in terms of hierarchy, “B” is the child of “A”. In other words, “A” is the parent of “B”.

Steps

  • Make sure you are logged into the administration section of your site;
  • On the right side of your new page's parent, click on the small green “plus” icon;1)

"Add Child" icons identified

  • Fill in the various bits of information about your new page. (The title is mandatory information);
  • Select a “status” for the new page; (see "Status" below)
  • Save the new page by clicking the “Save” button below the editing area.

All “main pages” in Wolf CMS are actually child pages of the “Home” page.

Status

All pages have one of four “status” types:

  • Draft - The page is saved to the database, but cannot be accessed from the front end;
  • Preview - The page is visible to the content editor, but not available on the front end;
  • Published - The page is visible on the front end;
  • Hidden - The page is saved to the database and viewable on the front end. It is not included in the navigation, but can be linked to directly or accessed directly.

The default page status can be set to either “Draft” or “Published” from the Administration > Settings page in the administrative section of your site.

For more information on these “status” types, see the full Page Status documentation.

Create and Set/Switch a Layout

The default installation of WolfCMS comes with two “Layouts” already for use. New layouts are easily made, and switching between layouts just takes a couple of clicks.

Creating a new Layout

You can make your own just following these few steps:

  1. In the Layouts tab, click the “New Layout” button.
  2. Write unique name for the layout
  3. Fill the Content-Type for it (example: text/html )
  4. Fill “Body” area with your code (ususally with the full (X)HTML page structure)
  5. Click on the “Save” button
  6. All done!

See also the tutorial on developing a custom theme for Wolf CMS.

Setting your new Layout

To change the layout for the whole site, you only need to change the Layout of the Homepage. (Other pages can have different layouts set on a page-by-page basis by following this same procedure.)

1. Go to Pages → Homepage (root file ”/”).

2. Open it, then either

3.a [For 0.6 or earlier] Select your layout from the Layout dropdown menu (below Body/Sidebar texarea (default is “Normal”)), or

3.b [For 0.7+] (1) Click on the “Settings” tab, then (2) select the desired layout from the Layout dropdown menu

4. Save and Close

You're done! Click on “View Site” in the upper right corner to preview your masterpiece.

Wolf's Default Layouts

Wolf comes with two layouts ready to use after initial installation. They demonstrate different ways of working with Wolf:

  • the Simple layout shows you how you can write/manage your code (use snippets, creating menus etc.)
  • the Wolf layout includes all necessary code in a single page (no snippets), and also has a “conditional menu” for child pages of the main navigation items.

Snippets

A “snippet” is bit of layout that might be used across many pages. For example, Wolf CMS comes with “header” and “footer” snippets.

Creating a Snippet

  1. Login to your Wolf CMS administration back-end.
  2. In the Snippets tab, click the “New Snippet” button.
  3. Write a name for this snippet (must be unique).
  4. Write the content “Body” of this snippet.
  5. You can decide to use (or not) a filter for this snippet by selecting it from the drop-down filter menu.
  6. Click on the “Save” button.

Using the Snippet

Including snippets in your page or layout is quite simple. You need to know the exact name of the snippet2), and then include this code where you want this snippet to appear:

<?php $this->includeSnippet('the_name_of_the_snippet') ?>

For further details on the includeSnippet function, consult the function reference page.

Use Page Drag/Drop/Copy

Wolf allows you to re-order or copy pages using a simple drag/drop system. The default “Page” tab looks like this:

Sorting

To change the sort order of the pages, click the “reorder” link, then click-and-drag the grey “drag-to-sort” label that appears:

Click again on the “reorder” link to finish the operation.

Note that if you are trying to relocate a page to a lower level in the “tree”, there must already be a page present at that lower level. For example:

Home
  |
  |- Lorem
  |    |
  |    |- Dolor
  |    |
  |    |- Sit
  |
  |- Ipsum

If you want to drag the “Dolor” page so that it is a child-page to “Ipsum”, you must first create a dummy page at that level,

  |- Ipsum
       |
       |- Dummy

then drag the “Dolor” page into place:

Home
  |
  |- Lorem
  |    |
  |    |- Sit
  |
  |- Ipsum
       |
       |- Dummy
       |
       |- Dolor

Then the “Dummy” page can be deleted:

Home
  |
  |- Lorem
  |    |
  |    |- Sit
  |
  |- Ipsum
       |
       |- Dolor

Copying

To copy a page, click the “copy” icon on the right:

The new copy will be created below the “original”. If the original page was called “Page title”, the new page will be called “Page title (copy)”. The copy operation will also bring any “child” pages with it (that is, an entire “branch” will be copied).

Final word

This book is an experimental product and consists of dynamically generated content consisting of other wolfcms.org wiki pages. We hope you like it!

If you enjoy and use Wolf CMS, consider donating to the project.

1) It has the tooltip “Add child” when you hover the mouse pointer over it.
2) The same as it appears under the Snippets tab
 
books/users.txt · Last modified: 2011-09-12 00:46 (external edit)
 
Except where otherwise noted, content on this wiki is licensed under the following license:GNU Free Documentation License 1.2
Copyright 2010 wolfcms.org / design by yello studio / Wolf CMS Inside