Create a page

Choose your page slug

The page slug is its name in the url, in a Wagon site it's defined by the filename without extension. It should only contains alphabetic characters, numbers and "-" or "_". The full path of a page contains its parent (and ancestors).

+ index
    + company
        + presentation

In this example, the presentation page full path will be /company/presentation.

Use the command line generator

bundle exec wagon generate page <<your page slug>>

You will be ask 2 things:

  • whether you want HAML template: answer 'no' if you're not familiar with HAML.
  • whether you want a localized template: answer 'no' (multilingual is another topic...)

It will generate a file: app/views/page/<<your page slug>>.liquid.

Note: In the generate command, you can set the full path of your page:
bundle exec wagon generate page company/presentation
It will create app/views/pages/company.liquid and app/views/pages/company/presentation.liquid.

Page header

Before the page content, there is a header, enclosed by "---". It contains meta-information about the page using the yaml syntax.

---
title: Page title
published: true
listed: false
---

If your page extends another one, remember it should be the first instruction after the header.

Here are some possible options that can be used in the page header:

Property Description
title Pretty obvious... The page title is used in the backoffice and in your template if you use {{ page.title }}. See more about the page object
published If set to false, the page won't be publicly visible once hosted in an engine. It will be visible with the Wagon webserver.
listed The listed option is used to decide if the page should be listed in a menu.
position Set the position among sibling pages. This is used for ordering in menus.
seo_title Set the title for SEO, you can use it through the {% seo %} tag or {{ page.seo_title }}.
seo_description Same as seo_title for the meta description. You can use {{ page.seo_description }} in your page template.
seo_keywords Same as seo_description.
redirect_url Set a redirection to the given url (301).

© 2024 LocomotiveCMS Terms of use Privacy Policy
Back to top