Pages
The pages module is a simple but powerful way to manage static content on your site. Page layouts can be managed and widgets embedded without ever editing the template files.
How Pages Work in PyroCMS
Every page on a website has a purpose. For instance, a page's purpose could be to display a member of a company's staff. It could be to display a product. It could be a combination of things. Every page has some common elements as well. For instance, a page will always have metadata, privacy settings, etc.
PyroCMS's pages module let's you take all of this into account when managing pages on your site. Each page has common fields (like metadata), but you can also create data structures that allow you to enter only the data you need for that page. We call these page types. For instance, for your staff member page you can create a Staff Member page type and add a Bio and Headshot Image field. You could create a Product page type with all sorts of fields like product description, price, etc.
Page types even house how those fields are displayed in the page type layout field, so you can define your fields and also define how they should be displayed on a page.
The Page Tree
The page tree is a visual, heirarchical overview of all the pages on your site. Module URIs don't show up here (see PyroCMS URLs for an overview of how URLs work in PyroCMS), just pages.
You can have any combination of page types in your page tree as well - they'll all show up in your page tree.
Re-Ordering Pages
Page re-ordering is achieved via simple drag and drop. You can drag/drop individual pages or entire sections (by dragging the parent page). There will be a shadow to show you where your page drag will end up.
Modifying Pages
To modify a page, click it in the page tree. A data summary panel will show, with options for modifying the page.
The following options are available:
| Option | Notes |
|---|---|
| Add Child | Adds a child page to the current page. |
| Duplicate | Duplicates a page and all child pages. |
| Edit | Edit a page. |
| Delete | Delete a page and its child pages. |
Default Pages
You'll notice that on a default install of PyroCMS there are some pages already there in the tree:
| Page | Notes |
|---|---|
| Home | Every site needs a home page! The home page is like any other page, it just has Is default (home) page? selected under the Options tab. |
| Page Missing | A 404 page that will be called when a page cannot be found. |
| Contact | This is an example page, using the contact module. |
Adding a New Page
To add a new page, click Add Page. If you only have one page type, your new page will automatically use that page type. However, if you have several page types, you'll be able to select each page type from a pop up menu.
Once you select your page type, you'll see the page form. The page form is divided into tabs:
Page Details
This is the basic info about your page - title, content, etc.
| Field | Notes |
|---|---|
| Title | The full title of your page. You can override the title of this field when editing your page type, by changing the value of the Title Label field. |
| Slug | The slug that your page will be called by in the URI. Along with the slug, a preview of the full URI of your page is provided. |
| Status | "Live" or "Draft". Draft pages can be seen by Administrators, but will not be available to other groups. |
Page Content
If the page type for this page has fields added to it, those fields will show up here. You can override the name of this tab when editing your page type, using the Content Tab Label field. This is so you can name it something more descriptive like "Product Info".
Meta data
The meta section allows you to control the meta data of your page. This is the data that is traditionally used by search engines (sans keywords) to populate the text preview of your page that shows up in search results.
| Field | Notes |
|---|---|
| Meta title | The full title of your page. |
| Meta Keywords | Keywords the pretain to your page. |
| Meta description | A short (no more than 160 character) description of your page. |
CSS
The CSS tab allows you to add extra CSS that will be added to your page (inline). PyroCMS will wrap the appropriate <style> tags around the CSS.
Script
You may place javascript here that you would like appended to the <head> of the page. PyroCMS will wrap the appropriate <script> tags around the javascript.
Options
| Field | Notes |
|---|---|
| Access | Allows you to restrict access to this page to certain user groups. Groups without access will see a 404 page. |
| Comments Enabled? | Turns comments on and off for this page. |
| RSS Enabled | If the RSS feed is enabled an RSS feed will be created that a visitor can subscribe to. They will receive each child page in their rss reader. |
| Is default (home) page? | If this is checked, this page will be the page that loads up on your root URI. |
| Require an exact uri match | The "Require an exact uri match" field is a clever little tool that allows you to pass parameters in the url. By default PyroCMS looks for a page with the slug of "acme-widgets" that is the child of "products" when you visit products/acme-widgets. By un-checking this box in the Products page you are telling PyroCMS that it is now okay if there isn't a page named Acme Widgets. It will now load Products and 'acme-widgets' will just be a parameter. This makes it easy to pass parameters to embedded tags. An example using the Streams add-on to display the 'acme-widgets' stream on the Products page. |