Kentico CMS 7.0 Context Help

New/Edit transformation

New/Edit transformation

Previous topic Next topic Mail us feedback on this topic!  

New/Edit transformation

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

Here you are either creating a new transformation under a hierarchical transformation or editing an existing one. You can set the following properties:

 

Transformation type

Here you can choose what purpose the transformation should serve within the hierarchical transformation. The following types are available:

 

Item transformation - applied to all displayed items that are not covered by a specialized transformation type (e.g. alternating items, first items etc.).

Alternating item transformation - applied to items that have an even position in the listing order. Every level in the hierarchy has its own separate alternation pattern.

First item transformation - applied to the first item on every level in the hierarchy. Only works for levels that contain more than one item.

Last item transformation - applied to the last item on every level. Only works for levels that contain more than one item.

Header transformation - rendered at the beginning of every level (before the first item on the level). These transformations provide a convenient way to visually separate or style individual levels.

Footer transformation - rendered at the end of every level in the hierarchy (after the last item on the level). Can be used to close encapsulating elements from the Header.

Single item transformation - applied in cases where there is only one item on a level in the hierarchy.

Separator transformation - rendered between items on the same level. It is not placed between items on different hierarchy levels (i.e. between a parent item and its child).

Current item transformation - applied to the currently selected item (i.e. the document that is being viewed). Please note that it is always necessary to specify a Document type (or types) for this kind of transformation.

 

If there are multiple transformations of different types included in the hierarchical transformation, more than one may be applicable to a single item. In these cases, the item will be displayed using the transformation type with the highest priority, according to the following order:

 

1.Current item (top priority)

2.First/Last/Single item

3.Alternating item

4.Item

Document types

Sets which document types should be affected by the transformation.

 

You can specify multiple document types by entering their code names separated by semicolons, e.g. CMS.News;CMS.Article. Leaving this field empty means that the transformation will be applied to all document types. Transformations that are dedicated to specific document types have a greater priority than those set to include all types.

 

This property has no effect for Header, Footer or Separator transformation types.

Level

This property specifies the level in the hierarchy from which the transformation should be applied. For example, if 2 is entered, the transformation will affect items on the third level (the number of the first level in the hierarchy is 0) and will also be inherited by all levels below it. Leaving an empty value or entering -1 specifies all levels.

 

Levels are always counted from the start of the particular data hierarchy that is being displayed. In the case of documents, this means that level 0 represents the first level under the selected path, not the root of the entire website.

 

Please note that you can override the level inheritance by adding another transformation for a lower level (it must use the same transformation type and affect the same document types).

Transformation name

Sets the standard transformation that should be used within the hierarchical transformation for the purpose defined by the remaining properties. The name is specified in format:
<document type code name>.<transformation name>

 

You can select an existing transformation by clicking the Select button or create a New one. The code of the currently selected transformation can also be modified by means of the Edit button.

 

Additional information about document types and transformations can be found in:

 

Developer's Guide -> Development -> Document types -> Transformations -> Hierarchical transformations

Developer's Guide -> Development -> Document types