Pages

Introduction

Pages are Tailor Blueprint entries designed to display the content throughout the theme. The idea behind the pages is that anyone can create anything based anything. There are three types of pages defined in the page.yaml blueprint, listed below:

Simple Pages

Simple pages are just that. They support the following content:

• An adaptive content field

• An Image field used to display behind the title

• SEO & OG Tag information provided by the seo_fields.yaml file

• Header, Body, and Footer code areas provided by the code_fields.yaml file

These pages are designed to dump data quickly, such as Terms & Conditions or Privacy Policy Information

Dynamic (Builder) Pages

These pages are more powerful. You can build pages exactly how you want. They support a lot of features but most of them are covered in the Block Types area of the documentation. To summarize, These pages have the following content and abilities:

• A "builder block" style area supported by October CMS's repeater field widget with the following blocks:

  • Hero (Section with Background Image, content, and buttons from the buttons.yaml file)

  • Section Block With configurable columns matching the top level of selectable blocks

  • Posts which are filterable

  • Events which are filterable

  • Products which are filterable

  • Forms which displays a chosen form

• SEO & OG Tag information provided by the seo_fields.yaml file

• Header, Body, and Footer code areas provided by the code_fields.yaml file.

Search Pages

Search Pages return search content from a Search Section block or from the Global Search. They support the following content:

• An Image field used to display behind the title

• SEO & OG Tag information provided by the seo_fields.yaml file

• Header, Body, and Footer code areas provided by the code_fields.yaml file

These page types can keep data structure as well, so they can have any child (or be a child)

Template Files

The files below are used to display content throughout the site. Below is an explanation of what each file does and how things are rendered.

Pages

page.htm

This file is used to display page content form the page.yaml blueprint. It includes sections for the Simple and Dynamic Pages.

it uses the builder/items.htm partial for rendering the Section Blocks builder content.

index.htm

This file is used to display the homepage from the settings. It's almost a carbon copy of the site except there's some logic to get the current homepage from the settings.yaml blueprint.

Partials

builder/items.htm

This file renders the top level Section blocks in the Dynamic Page builder. It contains partial links to the following blocks:

• Hero Section

• Section

• Posts Section

• Events Section

• Form Section

search/*

These files include the search results from a query. They return all front facing post types. They are used by the Search Section block.

Blueprints

builder/sections/*

These files are used to render the top level Section blocks in the Dynamic Page Builder

builder/columns/*

These files are used in the Section Block to render partial content. They are very similar to the Section blocks but include a few more partials to render column block content:

• Buttons Column

• Content Column

• Images Column

builder/globals/*

These files are used throughout the Section and Column blocks to render the following content:

• Buttons

  • Used in Buttons Column Block

  • Used in Hero Section Block

• Shop Alerts

  • Used in all Products Blocks (Section and Column). Used to display Shop alert content when the shop content isn't set.