Creating page types

This page describes how you can create page types. You can create new page types in the Page types application.

There are three ‘types’ of page types that you can create in Kentico:

  • Standard page types - use these to create template-based pages that form the structure of the site. Standard page types hold data in fields that you can fully customize.
  • Content only page types - suitable for pages on MVC sites whose only task is to hold content, such as individual news articles. Content only pages aren’t based on page templates and don’t contain presentation properties and tabs. This allows content editors to use the pages without unnecessary distractions.
  • Container page types - suitable for storing queries and transformations. Container page types don’t contain any custom fields as they are created without a coupled data table.

Creating standard page types

  1. Open the Page types application.
  2. Click New page type. A New page type wizard opens.

Step 1

  1. Fill in the values:
    • Page type display name: the system displays this name to users in the administration interface

    • Namespace: namespace distinguishes your page types from the default system types that use the cms namespace.

    • Name: page type identifier appended to its namespace

      Filling the page type display name

      Important

      When creating page types, always use a unique prefix (namespace) and name.

      Never use the cms, com, om or content prefixes. The best option is to use your company name or an abbreviation as the prefix, for example: ACME_MyPageType.

  2. Click Next.

Step 2

  1. Enter a Table name for the database table that stores the page type data.

  2. Enter a Primary key name for the table.

  3. (Optional) Select if you want the page to Inherit fields from page type.

  4. (Optional) Enable Content only page type.

      • Suitable for pages on MVC sites whose only task is to hold content, such as individual news articles. The pages don’t contain presentation properties and tabs. This allows content editors to use the pages without unnecessary distractions.
        Note that you cannot convert ‘Content only’ page type to a standard page type later.Specifying the page table name

The page is only a container without custom fields

Use the second option ‘The page is only a container without custom fields’ if you want to create a page type that doesn’t contain any custom fields (Container page type). That is, a page page without a coupled data table. Container page types are suitable for storing queries and transformations that are shared by multiple page types.

  1. Click Next.

The wizard creates the database table.

Step 3

Now, you need to define fields of the page type (columns of the table). To define a page type field:

  1. Click New field.

  2. For each field, enter the values, click Save and repeat the procedure until you have defined all the listed fields.

    • Field name: ComputerName
    • Data type: Text
    • Size: 200
    • Required: yes (checked)
    • Field caption: Computer name
    • Form control: Text box

     

    • Field name: ComputerProcessorType

    • Data type: Text

    • Size: 200

    • Field caption: Processor type

    • Form control: Drop-down list

    • Editing control settings -> Data source: select List of options and enter the following items into the text area, one per line:

      
      
      
        Athlon;Athlon
        Pentium XEON;Pentium XEON
        Pentium Core 2 Duo;Pentium Core 2 Duo
      
        
    • Field name: ComputerRamSize

    • Data type: Integer number

    • Field caption: RAM (MB)

    • Form control: Text box

     

    • Field name: ComputerHDDSize
    • Data type: Integer number
    • Field caption: HDD (GB)
    • Form control: Text box

     

    • Field name: ComputerImage

    • Data type: File

    • Field caption: Image

    • Form control: Direct uploader

      Creating fields for the page type

  3. Click Next.

You can also define system fields that will be displayed when editing pages of this type on the Form tab. You can do this using the Field type drop-down list when creating a new field. Select Page field and you can then choose from the following two groups of system fields:

  • Page fields - offers system fields of pages.
  • Node fields - offers system fields of content tree nodes.

Page or node system fields will then be offered in the Field name drop-down list. If you leave the Display field in the editing form check-box turned on, the field will be visible on the page’s Form tab.

Step 4

  1. Choose the field that will be used as the name for pages of this type. Pages of this type will use the value of the field in site navigation and in the Page application’s content tree. Only Required ‘text’ fields are available in the drop-down list.

    Specifying page name source

  2. Click Next.

Step 5

Select the page types that will be supported as parents for pages of this type in the Page application’s content tree.

  1. Click Add page types and select a specific page type.

  2. Click OK.

    Adding parent page types

  3. Click Next.

Step 6

Assign the page type to all websites on which you want to use it.

  1. Click Add sites.

  2. Check the appropriate websites in the selection dialog.

  3. Click OK.

    Adding sites where the page type can be used

  4. Click Next.

Step 7

The wizard has finished the configuration of the new page type.

Click Finish. You have created a new page type. 

Now, you may want to:

How content in page types is stored

The new page type has its own database table for its specific fields. Each page is stored in three tables: CMS_Tree (tree structure), CMS_Document (page properties, metadata and content defined on the Page tab) and the custom table - for example, custom_Computer.

The system automatically ensures all operations are performed correctly on these tables. The advantage of this storage is that it is very fast and you can easily write standard SQL SELECT queries to retrieve data from the Microsoft SQL Server database.