Kentico CMS 7.0 Context Help

Layout

Layout

Previous topic Next topic Mail us feedback on this topic!  

Layout

Previous topic Next topic JavaScript is required for the print function Mail us feedback on this topic!  

Here you can specify the page layout of the template.

 

The following actions are available in the header of this tab:

 

Save Save - click this button to confirm any changes made to the template's layout settings or content.

CheckOut Check out - locks the layout, so that other users cannot modify it at the same time. After you finish your edits, you can allow other users to modify the layout again using the CheckIn Check in button or you can cancel the checkout by clicking UndoCheckoutNew Undo checkout.

NavigateToDocument Preview - allows you to edit the layout side-by-side with a preview of how the template appears on the live site. Please see the Design preview help topic for additional details about the preview mode.

 

You can either select an existing Shared layout or use a Custom layout that will only be available for this specific template.

 

 

InfoBox_Note

 

Shared page layouts

 

If you choose a shared layout for the template, you can modify its code by editing it in Site Manager -> Development -> Page layouts.

 

Changes made there affect all templates that use the given layout. You can check which templates share the layout on its Page templates tab.

 

Editing custom page layouts

 

When using a custom layout, you can modify the page template's structure by editing the layout. The Layout type selector allows you to choose between two types of layout code:

 

Layout type

Description

ASCX

This type of layout code supports both HTML and ASCX markup, i.e. the same syntax that you would use to edit a standard web form or user control, including inline code.

 

Important: For security reasons, ASCX layouts may only be edited by users who have the Edit ASCX code permission for the Design module.

 

You can Insert the following types of layout elements (as control tags):

 

Web part zone

<cms:CMSWebPartZone ZoneID="zoneA" runat="server" />

 

Defines an area where developers can place web parts in Design mode. The zones then display the web part content on the live site.

 

Conditional layout

<cms:CMSConditionalLayout runat="server" ID="ConditionLayout" >

...

</cms:CMSConditionalLayout>

 

The page layout renders the content between the CMSConditionalLayout tags only if the conditions specified by the properties are fulfilled. See also: Conditional layouts

 

Device layout

<cms:CMSDeviceLayout runat="server" ID="DeviceLayout" VisibleForDeviceProfiles="" >

...

</cms:CMSDeviceLayout>

 

The content between the CMSDeviceLayout tags is only visible for visitors who match the specified device profiles.

HTML

The system processes the layout code as basic HTML. This means that ASCX markup, such as controls or inline code, is not functional when the layout is rendered.

 

You can Insert web part zones into HTML layouts as macro expressions:

 

{^WebPartZone|(id)zoneA^}

 

 

Adding CSS styles to the custom layout

 

Custom layouts of page templates allow you to directly define any CSS classes used within the layout code.

 

Requirement: The Allow CSS from components setting must be enabled in Site Manager -> Settings -> System -> Performance.

 

1. Click Add CSS styles below the page layout's code. The CSS styles editor appears.

 

2. Enter the definitions of the required CSS classes.

 

3. Click Save Save.

 

All pages that use the given template automatically load the specified styles.

 

Additional resources

 

Developer's Guide -> Development -> Web development overview -> Portal engine development model -> Page layouts

Developer's Guide -> Development -> Mobile development

Developer's Guide -> Development -> Team development -> Object locking

Developer's Guide -> Development -> CSS stylesheets and design -> CSS for page components