Your SilverStripe site comes with a wide variety of different page types that you can use:

The list of page types

This page describes each page type, how to use it, and extra information you need to know to get the most out of it.

Page

This is the standard content page, used for all pages that have no other requirements. Note that it comes with extra features such as being able to add related pages and tags from a taxonomy.

Error Page

This is a special page that is only shown to users when they have encountered the specific error that the page is set up to respond do. Your site comes with the two standard errors pages already created for you - one for "Page not found" (404 error) and one for "Server error" (500 error).

When you create an ErrorPage you set the error code in the Error code dropdown. You can find a fuller explanation of HTTP error codes atWikipedia (external link) .

Events

You can create specialised pages to allow website visitors to view individual events (Event Pages) and event listings (Event Holders).

To create a page to display information for an event, add a new page of the type Event Page. In addition to the fields available on other pages, this page type allows you to specify the date and time of the event. These details will be displayed on the template along with any taxonomy terms you associate with the page. For more information see the taxonomy page (external link) .

Event as shown on the site

The events must be listed in a structured way to allow visitors to easily browse them. This is acheived with an Event Holder which contains the Event Pages. Any number of Event Holders can be created, each with its own set of events.

Event Holder structure

The events listing for the above events holder and pages is shown below and includes the following features:

  • Events are sorted by date, descending (most recent on the top).
  • Sidebar shows the taxonomy terms associated with underlying events.
  • Months (and years) for which events are scheduled can be navigated.

Event listing

News

You can create News Pages and News Holder pages in a similar way to the event pages described above. The differences are:

  • NewsPage has an Author field. This is displayed on the listing page and the news page.
  • NewsPage has a Featured Image field. This is displayed as a thumbnail on the listing page and on the top right of the news page.
  • NewsPage doesn't have Start TimeEnd Time or Location fields.

The front-end navigation is handled in exactly the same way.

This page displays all of its child pages as links in the footer. By default they are not shown in the main navigation. Note that this functionality only exists in the default theme, this may not work in a custom theme.

Locate the pages for which you require footer links beneath the Footer Holder. The holder may need to be created at the top level of your site tree if it does not already exist.

**Footer Holder** and footer links placement

Ensure that the *URL Segment* of the **Footer Holder** is concise as the text in this field will show within the footer page links.

If you have a page elsewhere on your site that you require footer links for but you do not wish to move this page to under the Footer Holder, you can create a Redirector Page which links to that page.

Adding **Redirector Page** to the footer

Home Page

This is usually the first page that people will see when they visit your site. It contains a carousel in which you can feature parts of your site, a list of quicklinks, two feature sections and a news summary panel.

The carousel is made up of one or more carousel items. These can be viewed and edited in the Carousel tab. Each carousel item contains the following:

  • Title: This is displayed at the top of the caption. If there is no caption, it is not shown.
  • Caption: This is shown overlapping the bottom of the image.
  • Image: The actual image that appears in the carousel.
  • Link: If this is set, clicking on the carousel when it is showing this item will take the user to the specified page. You can unset the link by clicking on the small 'x' besides the dropdown arrow.

Quicklinks are a set of pages that are linked to from the homepage. In the default theme they are shown in the bottom left of the main content area. To add quicklinks, got to the Quicklinks tab when editing the homepage. Click on the Add Quicklink button. You will see the following fields:

  • Name: The text that will appear in the list.
  • Internal Link: A page within your site that the link will point to.
  • External Link: An external URL that the link will point to.

As each quicklink can have only one link, if the external link is set it will be used regardless of whether or not the internal link is specified.

Feature sections

The features are two panels in the middle of the bottom of the main content area. You can edit them in the Features tab of the home page. Each has the following fields:

  • Title: The title that appears at the top of the feature.
  • Category: The icon that appears at the top of the feature. A developer can add more options if desired.
  • Content: The actual content that is displayed in the feature panel.
  • Page to link to: If this is set, a button is shown at the bottom of of the panel linking to this page.
  • Button text: The text to display on the button, if it is shown.

News summary

In the default theme the home page displays the two latest news items on the homepage.

IFrame Page

An iframe page type is bundled for easy embedding of external resources. It has the following settings:

  • URL: this is a resource URL to be included into the page. If you want the height autosetting to work, the supplied URL needs to be either relative, or at least match the name of your site's domain.
  • Auto height: the client browser will attempt to set the height of the iframe automatically to match the height of the target content. This does not mean that the iframe will resize dynamically to respond to content changes.
  • Auto width: the client browser will fill the available horizontal space. This is not tied in any way to the iframe content.
  • Fixed height: explicit size, used also as a fallback if autosetting fails.
  • Fixed width: explicit size.

In addition, three content areas are supplied:

  • Content above the iframe
  • Content below the iframe
  • Alternate content: used if the client browser does not support iframes, or refuses to handle them.
Caveats: When setting the sizes, check under different browsers if everything fits correctly. Also, the autosetting is one-off only. The scrollbars will appear if the content of the iframed page changes dynamically, for example when expanding menus or showing other animations. The recommended approach is to disable automatic height.

Redirector Page

When a user visits this page they are redirected to either a page on your site or an external site. It is often used in menus when you want one page to be in two relevant places in the menu structure, such as sitting underneath a FooterHolder.

When you create a new page of this type you will see the radio button that lets you choose between A page on your website and Another website, and the dropdown to select the page or the text field to type in the external URL.

Registry Page

This page is used to allow your site users to browse a large set of data in an easy manner. For more information refer to the registry module (external link) documentation.

Sitemap Page

In the default theme this page displays a list of all pages on your site. It requires no customisation.

Subsites Virtual Page

This is just like a VirtualPage (see below), but can also display content from a page on another subsite.

User Defined Form

This page type displays a custom form that websites visitors can fill out and submit. It can email the submissions to a nominated recipient and stores them all in a database.

You can view more detailed information in the forms documentation (external link) .

Virtual Page

This page type is similar to a RedirectorPage and is used to duplicate content from another page. Instead of linking to the other page like the RedirectorPage page, the VirtualPage displays the content from the linked page.

Last modified: