The ListSummary server control is used to display, on a Web page, a list of content blocks in a selected folder. Optionally, the display can include content in all subfolders of the selected folder.
When added to a template and visited, a List Summary looks like this.
It displays each content block’s title and summary information. You can modify the display to suit your needs by modifying its properties.
NOTE: To display a List Summary on a PageBuilder page, use the List Summary—Displays an Ektron List Summary, a list of certain types of content in a selected folder. See Also: ListSummary Server Control widget.
NOTE: In contrast to a List Summary, a ContentList server control displays selected content items from any Ektron folder. See Also: Using the ContentList Server Control
The following are Ektron-specific server control properties. You can find information about native .NET properties such as font, height, width and border style in Visual Studio® help.
Override the control’s default text for the Add Content menu item.
For example, you have a News Web site. You could change Add Content to Add News Item.
Indicates if you are logged into the CMS Explorer and can use it to browse to content, collections, and so on. See Also: Browsing Your Ektron Site Using CMS Explorer.
The number of seconds that the server control’s data is cached. The default is 0 (zero). For example, if you want to cache the data for 5 minutes, set to 300. See Also: Caching with Server Controls.
WARNING! If the EnablePaging
property is set to True, the CacheInterval
property is disabled.
Checks the QueryString for this value and replaces the list summary with a content block when specified. Leave blank to always display the list summary.
Determines the type of content that appears in the list summary. The default is Content. Choices are:
Determines how the information on the page appears
WARNING! If you specify an external file, do not store this file in the Workarea folder. If you store this file in the Workarea folder, the file will be lost when you upgrade.
WARNING! If you enter a valid EkML file at the MarkupLanguage property, the Displayxslt property value is ignored.
By default, Fill occurs during the Page_Init event. Set to false if you want to postpone the fill-action until later. In this case, Fill is automatically called during the Page Render event. You might do this if you need to set or change a property on the control in code-behind and have it render with your changes shown.
This property, in conjunction with the MaxNumber property, lets site visitors view an unlimited number of items while controlling the amount of screen space. The MaxNumber property limits the number of items displayed. If you set this property to True, and the number of items exceeds MaxNumber, navigation aids appear below the last item, allowing the visitor to go to the next screen.
See example below.
So, for example, if a List Summary has 9 items and the MaxResults
property is set to 3, the screen displays only the first 3 items. When the site visitor clicks [Next], he sees items 4, 5 and 6, and so on.
WARNING! If the EnablePaging
property is set to True, the CacheInterval
property is disabled.
The folder that contains the items which appear in the list summary. See Also: Browsing Your Ektron Site Using CMS Explorer. The Recursive
property determines whether content blocks in this folder’s child folders also appear.
Set to True if you want to retrieve and display content (that is, the HTML body) for all content in the list summary. For example, to display content inside a Web server control such as a GridView.
Set this property to True if you want the following information for each content in the list. Returns Content View Count, Content Rating, Content Rating Average. Create your own XSLT styles to display this data.
WARNING! This property only provides reliable data when the Business Analytics Feature is on. Business Analytics.
Hides or displays the output of the control in design time and run time.
Choose whether to display icons next to the list summary’s links.
WARNING! This property only works when ecmSummary or ecmTeaser are used in the DisplayXslt
property. When the [$ImageIcon]
variable is used in an EkML file and that file is assigned to the MarkupLanguage
property, this property acts as True. See Also: Controlling Output with Ektron Markup Language
Set a language for viewing content; shows results in design-time (in Visual Studio) and at run-time (in a browser).
Determines the type of window that appears when you click a link in the server control.
Identify the template markup file that controls the display of the server control. For example, mymarkup.ekml
. If the EkML file is located in the same folder as the Web form containing the server control, just enter its name. Otherwise, the path to the file can be relative or absolute. See also: Controlling Output with Ektron Markup Language
See Also: listsummary.ekml
If you enter a valid EkML file at the MarkupLanguage property, the Displayxslt property value is ignored. If the EkML file contains the [$ImageIcon]
variable, the IncludeIcons
property acts as True.
Enter the maximum number of items to appear in the initial display of this server control.
If you enter no value or 0 (zero), the maximum is 50. This is done for performance reasons.
To let site visitors view more than the maximum but limit the amount of space being occupied, enter the maximum number of results per page here. Then, set the EnablePaging
property to True.
If you do and more than the number of MaxResults
are available, navigation aids appear below the last item to help the site visitor view additional items. See example below.
How to order the hyperlinks on the list. The sort field is determined by the OrderKey
property.
If sorting by date, descending puts the most recent first.
NOTE: For releases 8.0.1 and later the OrderKey property has been deprecated. It has been replaced by this OrderBy property.
Sort the list by one of the values.
Random (Boolean)
Set to True if you want to randomly display one content block in the specified folder. The content changes each time a user views the page.
If you use a custom XSLT or EkML file, the type of content displayed can be manipulated. For example, if you use an EkML file that has the [$Html] variable in it, the actual content appears instead of a link. See Also: Controlling Output with Ektron Markup Language and [$Html]
Determines if the display includes content blocks in child folders of the selected folder.
Set the ID of the taxonomy that content will be associated with when a logged in site visitor uses the Silver Access Point’s Add HTML Content to add content to a list summary server control.
Suppresses the output of the span/div tags around the control.
Lets a developer specify a server control’s tag.
Retrieving the XML structure of XML content allows for greater control over developing XSLs. The following example shows how to retrieve the XML structure.
FolderID
property.TextMode
property to MultiLine.NOTE: You should set the width of the text box to at least 400px.
Textbox1.Text = ListSummary1.XmlDoc.InnerXml