Content Architecture
Page Models
Support multiple zones, default component models, and more.
What are Page Models and why are they important?
A Page Model in Agility represents the architecture and structure of your page. It’s important to have a good Page Model to make it as easy as possible for Editors to create new Pages on your site.
When an Editor creates a Page, they’ll be required to choose from a selection of pre-defined Page Models that you’ve created as a Developer.
Model Structure
Each Model is made up of different Zones where Editors can add content. Components can be added, removed and rearranged within these Zones to structure a page.
You might have one Model for your home page with a simple design and single Content Zone as well as a more complex two-column Page model option with a Header, Main Content Zone and a Sidebar Zone. How you choose to structure your pages is entirely up to you!
Creating a Page Model
To get started with your first model
1. Navigate to Page Models from the Models Section of your Agility Instance
2. Click + New Page Model
3. Give the Model a Name
4. Click Add Zone
5. Give the Zone a Name and click Update Zone
6. To create additional Zones, click the + Zone button and repeat as needed
7. Click Save when you're ready
You’ll now see your new Page Model in the Page Models list and Editors can start using it for new Pages
Rendering the Page Model
In order to handle the rendering for the new Page Model in your solution, you'll need to have code that will be responsible for rendering the model.
Further Reading
Page Templates in Agility represents a page's layout. This enables a variety of layouts where editors can add Page Modules to one or more Content Zones.
When editors create pages in Agility CMS, they must select which template they'd like to use from a list of pre-defined Templates which you, the developer, have created for them.
As a developer, you can decide how the template is rendered into HTML.
Each template has Content Zones which are areas where editors can enter pieces of content. These are called Page Modules, and they can be added, removed, and rearranged within these zones to structure a page.
For example, you may have a simple Page Template named Main Template that is used for your Home or About Page with a single Content Zone.
Main Template in Agility CMS Select an Image
You might also have a more complex Page Template called Two Column Template that has two Content Zones, a Main Content Zone, and a Sidebar Content Zone which can be used for a News or Blog Listing Page.
The bulk of the Content and Page Modules on the page can reside within the Main Content Zone, and the Sidebar Content Zone can contain a Page Module that displays The Latest, or Related Posts or News Articles.
How to Create Page Templates
1. Navigate to page templates by clicking on Models > Page Templates
Creating page templates in Agility CMS Select an Image
2. Click on Add.
Each page template has the following items:
- Name
- Content Zone(s)
3. Enter the Name of the Page Template.
Enter name of page template in Agility CMS Select an Image
4. Add Content Zones by clicking + button.
Add content zones for page templates in Agility CMS Select an Image
5. Fill in Display Name (this will automatically populate the Reference Name) and if desired add Default Modules that will be automatically added to the page template by clicking the + button.
Module zone details for page templates in Agility CMS Select an Image
A shared module zone is when you specify a content zone that it will be shared across all pages that use the same template. For example, if you had a sidebar content zone and you want the content to be the same across multiple pages.
Now you can see your newly created Page Template in the list.
Page template list in Agility CMS Select an Image
Next Steps
Editors can start to use your Page Template when they create new pages. Editors may also migrate an existing page to use the new Page Template and copy over any Page Modules they want to keep.
Rendering the Page TemplateIn order to handle the rendering for the new Page Template in your solution, you'll need to have code that will be responsible for rendering the template.
Setting Default Modules on a Page Template
If you have a case where editors consistently build pages with similar layouts, you can set up Default Modules that are associated with each Content Zone on the Page Template.
Content zone details in Agility CMS Select an Image
When editors create a page using that template, they'll immediately see the Page Modules that are associated with the template that they need to enter content for.
Page modules associates with templates in Agility CMS Select an Image