|
|
Default
|
|
|
|
|
Web part control ID:
|
Serves as an identifier for the web part. This ID must be unique within the context of each page template. The value of this property may only contain alphanumeric characters and the underscore character ( _ ).
|
|
|
|
Web part title:
|
Title of the web part displayed on the Design tab of CMS Desk and in on-site editing mode. If empty, the value of the Web part control ID property is used for this purpose.
|
|
| | | |
|
|
Visibility
|
|
|
|
|
Visible:
|
Indicates if the web part should be displayed.
|
|
|
|
Hide on subpages:
|
Indicates if the web part should be hidden on sub-pages. If checked, the web part will not be displayed on documents that inherit the web part from a parent document.
|
|
|
|
Show for document types:
|
Contains a list of document types on which the web part should be displayed. If the currently selected document uses the page template containing this web part, but its type is not specified by this property, the web part will be hidden. The document types in the list must be specified by their code names and separated by semicolons (;). If empty, the web part will be displayed on all document types.
|
|
|
|
Display to roles:
|
Contains a list of roles to which the web part should be displayed. This may be used to implement documents with specific functionality for different types of users. The roles in the list must be specified by their code names and separated by semicolons (;). If empty, the web part will be displayed to all users.
|
|
| | | |
|
|
Categories filter
|
|
|
|
|
Display site categories:
|
Indicates if site specific categories should be displayed.
|
|
|
|
Display global categories:
|
Indicates if global categories should be displayed.
|
|
|
|
Display personal categories:
|
Indicates if categories of the current user should be displayed.
|
|
|
|
Starting category:
|
Code name of the category the tree structure should start from, if empty the whole structure of categories is loaded.
|
|
| | | |
|
|
Documents filter
|
|
|
|
|
Use document filter:
|
Indicates if document filter settings should be applied instead of the categories filter settings.
|
|
|
|
Combine with default culture:
|
Indicates if the default language version of a document should be used as a replacement if a given document is not translated to the currently selected language. If the 'Use site settings' option is selected, the value is taken from 'Site Manager -> Settings -> Content -> Combine with default culture'.
|
|
|
|
Culture code:
|
Indicates which culture version of the specified documents should be used.
|
|
|
|
Alias path:
|
The path to document which categories are to be displayed by the web part. If you leave the value empty, the web part displays all categories assigned to child documents of the current document.
|
|
|
|
Max relative level:
|
Specifies the maximum number of content tree sub-levels from which content should be loaded. This number is relative, i.e. counted from the start of the path specified for the content of the web part. Entering -1 causes all sub-levels to be included.
|
|
|
|
Select only published:
|
Indicates if only published documents should be loaded.
|
|
| | | |
|
|
Categories & Documents filter
|
|
|
|
|
WHERE condition:
|
Sets the value of the WHERE clause in the SELECT statement used to retrieve the content.
|
|
|
|
ORDER BY expression:
|
Sets the value of the ORDER BY clause in the SELECT statement used to retrieve the content.
|
|
|
|
Select top N:
|
Selects only top N items. If blank, all items are selected.
|
|
| | | |
|
|
Transformations
|
|
|
|
|
Transformation:
|
Sets the transformation used for the displayed content in list view mode. Transformations are specified in format <class name>.<transformation name>.
|
|
| | | |
|
|
Navigation
|
|
|
|
|
Documents page path:
|
URL of the document which will be used as a link URL for categories.
|
|
|
|
Documents page target:
|
Specifies the name of the target frame in which the navigation links will be opened. For example: _blank
|
|
|
|
Use code name in URL:
|
Indicates if category code name will be used in query parameter. Category ID is used when unchecked.
|
|
| | | |
|
|
Layout
|
|
|
|
|
Render as tree:
|
Indicates whether menu list will be rendered as tree using <ul> and <li> tags.
|
|
|
|
Display only category names:
|
Indicates if the category name will be displayed instead of whole category path.
|
|
|
|
Category separator:
|
Sets the HTML code of the separator placed between items in the navigation. All options are supported, from a single character (>) to a custom image (<img src="/images/myseparator.gif">).
|
|
|
|
Category separator RTL:
|
Works the same way as the Category separator property, but is used if the page is displayed in a right-to-left culture.
|
|
| | | |
|
|
Settings
|
|
|
|
|
Categories root:
|
Display name of the categories root node.
|
|
|
|
Personal categories root:
|
Display name of the personal categories root node.
|
|
|
|
Category content before:
|
Specifies the content before category name.
|
|
|
|
Category content after:
|
Specifies the content after category name.
|
|
|
|
Render link title:
|
If enabled, the list will render category names as Title attributes (tooltips) for all links. This can improve the accessibility of your website.
|
|
| | | |
|
|
No data behavior
|
|
|
|
|
Hide if no record found:
|
Indicates if the web part should be hidden when no items to be displayed are retrieved.
|
|
|
|
No record found text:
|
Text that should be displayed if no records are found. This text will not be visible if the Hide if no record found property of the web part is enabled.
|
|
| | | |
|
|
Web part container
|
|
|
|
|
Web part container:
|
Specifies the name of the container (box) to be displayed around the web part. Only containers defined in Site Manager -> Development -> Web part containers can be selected. The selected container can be edited directly by using the Edit button.
|
|
|
|
Container title:
|
Sets a title for the container. This title is displayed only if the {%ContainerTitle%} macro is used in the code of the container.
|
|
|
|
Container CSS class:
|
CSS class used for the container. Applied only if the {%ContainerCSSClass%} macro is used as the value of the Class attribute in the code of the container.
|
|
|
|
Container custom content:
|
Custom content to be used in the container. Applied only if the {%ContainerCustomContent%} macro is used in the code of the container.
|
|
|
|
Hide container on subpages:
|
Indicates if the web part container should be hidden on sub-pages.
|
|
| | | |
|
|
HTML Envelope
|
|
|
|
|
Content before:
|
HTML content placed before the web part. Can be used to display a header or add some encapsulating code, such as <div> or <table> elements to achieve the required layout.
|
|
|
|
Content after:
|
HTML content placed after the web part. Can be used to display a footer or close the tags contained in the ContentBefore value, such as </div> or </table> elements.
|
|
| | | |
|
|
AJAX
|
|
|
|
|
Use update panel:
|
Indicates if an AJAX UpdatePanel container should be used for this web part.
|
|
| | | |
|
|
Time zones
|
|
|
|
|
Time zone:
|
Specifies the type of time zone used for the content of the web part.
|
|
|
|
Custom time zone:
|
May be used to assign a custom time zone specifically for the content of this web part. If selected, the time zone will be used regardless of current user or website time zone settings.
|
|
| | | |
|
|
Performance
|
|
|
|
|
Disable view state:
|
Indicates if view state should be disabled for this web part.
|
|
|
|
Disable macros:
|
If checked, macros contained in the values of the web part's properties will no longer be resolved.
|
|
|
|
Partial cache minutes:
|
Sets the number of minutes for which the output HTML code of the web part should remain cached. This process is similar to full-page caching, but only for the code of the web part specifically. If left empty or set to 0, partial caching will be not be used for the web part.
|
|
|
|
Partial cache dependencies:
|
Contains a list of cache keys on which the partial cache of the web part depends. When the specified cache items change, the partial cache of the web part is deleted. Each line may contain a single item only. If the 'Use default cache dependencies' box is checked, the default dependencies will be used, which include all possible object changes that could affect the specific web part.
|
|
| | | |
|
|
Output filter
|
|
|
|
|
Filter output HTML of web part:
|
If checked, the output code of this web part is processed by the output filters
|
|
|
|
Resolve URLs:
|
If checked, the filter removes the "~" character in relative URLs and replace it with the root URL of the website.
|
|
|
|
Fix attributes:
|
If checked, the filter ensures that all HTML tag attributes are in valid XHTML format.
|
|
|
|
Fix Javascript:
|
If checked, the filter ensures that the type and language attributes are included in all <script> tags.
|
|
|
|
Fix lower case:
|
If checked, the filter ensures that all HTML tags and attributes are generated in lower case.
|
|
|
|
Fix self closing tags:
|
If checked, the filter ensures that HTML tags without end tags are properly closed.
|
|
|
|
Fix tags:
|
If checked, the filter replaces tags that are not XHTML valid with appropriate equivalents (<strong> instead of <b>, <em> instead of <i>).
|
|
|
|
Fix HTML5:
|
If checked, the filter replaces attributes that are obsolete in HTML5 with CSS classes named in format <attribute name>_<attribute value>. The affected attributes are: cellpadding, cellspacing, width, height, border, align, valign
|
|
|
|
Convert TABLE tags to DIV tags:
|
If enabled, the TABLE tags in the output are automatically converted to DIV tags with CSS class corresponding to the tag name (table, tr, td, etc.) Blocks of HTML code can be optionally marked with class="_divs" or class="_nodivs" to allow or disable conversion for that particular block of code.
|
|
| | | |
Help URL: http://devnet.kentico.com/docs/webparts/index.html?CategoryList_properties.htm
