Pages are the fundamental building blocks of your website. Below you can find out how to setup a page from scratch.
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
Dash or underscore?
By default, Wagon converts underscores to dashes in the filename of a page. In SEO, dashes are better than underscores.
If you do want to use an underscore, just override the
slugattribute in the page YAML file.
wagon generate page <<your page slug>>
You will be asked 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.
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:
|title||The page title is used in the backoffice and in your template. You can use |
|published||If set to false, the page won't be publicly visible once hosted in an engine. It will be visible within the Wagon webserver.|
|listed||The listed option is used to decide if the page should be listed in the menu.|
|position||Set the position among sibling pages. This is used for ordering in menus. Accepts integers (1, 2, 3, ...)|
|seo_title||Set the title for SEO, you can use it through the |
|meta_description||Same as |
|meta_keywords||Same as |
|redirect_url||Set a redirection to the given url (301).|
|allow_layout||If set to false, the page's layout won't be changeable in the back-office.|
Multiple child pages + a content_type_template
Note when you have a content-type-template in a parent folder with multiple other child pages like this:
+ index + projects + content_type_template + page_1 + page_2 + ...
You have to add positions which are lower to all the child pages (page_1, page_2, ...). It is recommended to give the content-type-template a position of 99. Other pages can get a lower number (1 -> 98).
Updated 8 months ago