|
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.
|
|
| | |
|
Content
|
|
|
|
Path:
|
Specifies the path of the documents that should be selected. If empty, the path will be set to all child documents under the page on which the web part is placed. Use '.' for current document selection.
|
|
|
Data source name:
|
In order to display documents provided by a data source web part, its Web part control ID must be entered into this property. The data source web part must be placed on the same page. Only the Documents data source may be connected to this web part.
|
|
| | |
|
Content filter
|
|
|
|
Document types:
|
Determines which document types should be loaded, specified by a list of code names separated by semicolons (;). The * wildcard can be used as a substitute for a random sequence of characters. For example Product.* would include document types such as Product.Camera, Product.CellPhone, Product.Computer etc. If left empty, the web part will retrieve all document types by default. Please note that in this case (empty value), only the common data columns from View_CMS_Tree_Joined will be available. The specific fields of individual document types will not be included, so please consider this when writing transformations, WHERE conditions etc.
|
|
|
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.
|
|
|
Maximum nesting 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.
|
|
|
ORDER BY expression:
|
Sets the value of the ORDER BY clause in the SELECT statement used to retrieve the content.
|
|
|
Select only published:
|
Indicates if only published documents should be loaded.
|
|
|
Select top N documents:
|
Specifies the maximum amount of documents to be loaded. If empty, all possible documents will be selected.
|
|
|
Site name:
|
Sets the website (specified by its code name) from which the content should be loaded. If left empty, the current site is used.
|
|
|
WHERE condition:
|
Sets the value of the WHERE clause in the SELECT statement used to retrieve the content.
|
|
|
Columns:
|
Lists the database columns which should be loaded along with the given objects, separated by commas (,). If empty, all columns will be loaded. Specifying a list without unnecessary columns may significantly improve performance.
|
|
|
Filter out duplicate documents:
|
Indicates if the retrieved data should be filtered to contain documents only once, even if they are linked multiple times.
|
|
|
Filter name:
|
Sets the name of the Filter web part that should be connected.
|
|
| | |
|
Hierarchical transformation
|
|
|
|
Hierarchical transformation:
|
Sets the transformation to be used for the displayed documents in list view mode. This property can be used to set both standard and hierarchical transformations. Transformations are specified in format <class name>.<transformation name>.
|
|
| | |
|
Selected item transfromations
|
|
|
|
Selected item transformation:
|
Sets the transformation to be used for the displayed content in detail view mode. Transformations are specified in format <class name>.<transformation name>.
|
|
|
Selected item header transformation:
|
Sets the transformation placed before an item when it is displayed in detail view mode. Transformations are specified in format <class name>.<transformation name>.
|
|
|
Selected item footer transformation:
|
Sets the transformation placed after an item when it is displayed in detail view mode. Transformations are specified in format <class name>.<transformation name>.
|
|
| | |
|
Extended settings
|
|
|
|
Item separator:
|
Contains the code of a separator to be placed between displayed items, e.g. <hr />.
|
|
|
Hide header & footer for single item:
|
If checked, the header and footer transformations will not be applied if only a single item is displayed on a given hierarchical level.
|
|
|
Hierarchical display mode:
|
Allows the hierarchical display mode to be selected. Inner: generates sub-levels inside the parent item (tree structure). Separate: generates sub-levels outside of the items on parent levels (flat structure).
|
|
| | |
|
Paging
|
|
|
|
Enable paging:
|
Indicates if the displayed data should be paged.
|
|
|
Paging mode:
|
Determines which method is used to pass information about the currently selected page - it can be passed either as a parameter in the URL (Query string) or through postback (Postback).
|
|
|
Pager position:
|
Determines if the pager is displayed above or below the content displayed by the web part.
|
|
|
Page size:
|
Determines the maximum number of records displayed per page.
|
|
|
Query string key:
|
Sets the name of the URL parameter used to pass information about the current page number (used if the Paging mode property is set to Query string).
|
|
|
Group size:
|
Sets the maximum amount of page number links that will be displayed together. Any additional links that do not fit can be accessed in the next or previous group.
|
|
|
Display first & last automatically:
|
If enabled, the "go to first page" and "go to last page" buttons of the pager will be displayed only when there is no other way to access the first or last page through the pager.
|
|
|
Display previous & next automatically:
|
If enabled, the "go to previous page" and "go to next page" buttons of the pager will be displayed only when there is no other way of accessing the previous or next page through the pager.
|
|
|
Hide pager for single page:
|
Indicates whether the pager should be hidden if the displayed items fit onto a single page.
|
|
|
Reset scroll position:
|
Indicates whether scroll position should be cleared after post back
|
|
| | |
|
Pager design
|
|
|
|
Pages:
|
Sets the transformation used for page links. Use <%# Eval("Page") %> to get the appropriate page number dynamically, <%# Eval("PageURL") %> to get the page URL or <%# Eval("PageLink") %> to get a link to the appropriate page.
|
|
|
CurrentPage:
|
Sets the transformation used for the currently selected page. Use <%# Eval("Page") %> to get the current page number, <%# Eval("PageURL") %> to get the page URL or <%# Eval("PageLink") %> to get a link to the current page.
|
|
|
Page separator:
|
Sets the transformation used as a separator between page links.
|
|
|
First page:
|
Sets the transformation used for the link to the first page. Use <%# Eval("FirstURL") %> to get the URL of the first page.
|
|
|
Last page:
|
Sets the transformation used for the link to the last page. Use <%# Eval("LastURL") %> to get the URL of the last page.
|
|
|
Previous page:
|
Sets the transformation used for the link to the previous page. Use <%# Eval("PreviousURL") %> to get the URL of the previous page.
|
|
|
Next page:
|
Sets the transformation used for the link to the next page. Use <%# Eval("NextURL") %> to get the URL of the next page.
|
|
|
Previous group:
|
Sets the transformation used for the link to the previous group of page links. Use <%# Eval("PreviousGroupURL") %> to get the URL of the previous group.
|
|
|
Next group:
|
Sets the transformation used for the link to the next group of page links. Use <%# Eval("NextGroupURL") %> to get the URL of the next group.
|
|
|
Direct page:
|
Sets the transformation that implements direct page changing. Use a text box or drop-down list control with an ID set to "directPageControl" to register the page change event.
|
|
|
Pager layout:
|
Sets the transformation that determines the overall design of the pager.
|
|
| | |
|
Relationships
|
|
|
|
Main document:
|
Sets the document for which related documents will be displayed. Either the current document is used, or another document can be specified by entering its NodeGUID. Please note that if relationships are used, only the documents defined by the relationship settings will be displayed.
|
|
|
Main document is on the left side:
|
If checked, documents on the right side of the relationship with the specified document will be displayed.
|
|
|
Relationship name:
|
Allows the selection of the document relationship that should be used.
|
|
| | |
|
System settings
|
|
|
|
Check permissions:
|
Indicates if the permissions of the current user should be checked for the content of the web part. If enabled, only documents for which the user has the "read" permission will be loaded.
|
|
|
Cache item name:
|
Sets the name of the cache key used for the content of the web part. If not specified, this name is generated automatically based on the site, document path, Web part control ID and current user. A cache key can be shared between multiple web parts with the same content on different pages in order to avoid keeping redundant data in the memory.
|
|
|
Cache minutes:
|
Sets the number of minutes for which the content of the web part should remain cached before its latest version is reloaded from the database. If left empty, the value entered into the Site Manager -> Settings -> System -> Performance -> Cache content (minutes) setting will be used instead. If set to 0, caching will be disabled for the web part.
|
|
|
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.
|
|
| | |
|
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.
|
|
| | |
|
Editing buttons
|
|
|
|
Show New button:
|
Indicates if the button for adding new documents should be displayed when viewing the page in edit mode. When the button is used, a document of the first type entered into the Document types property is created at the beginning of the path specified for the web part's content.
|
|
|
New button text:
|
Sets the description text for the New document button.
|
|
|
Show Edit and Delete buttons:
|
If enabled, the web part offers edit and delete buttons for each item when displaying the page in edit mode. You can set the exact position of the buttons by adding the ##editbuttons## macro into the code of the used item transformation (must be of the ASCX type).
|
|
| | |
|
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.
|
|
|
Web part 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?DocumentHierarchicalViewer_properties.htm