Ektron CMS400.Net Reference

>>Managing Content > Blogs > Blog Server Controls > BlogEntries Server Control

BlogEntries Server Control

The BlogEntries server control displays several blog posts or a user’s Journal (personal blog) on a Web form. You can change this server control's appearance without changing the other individual blog controls. Below is an example of a BlogEntries server control.

To use this server control to dynamically display a blog’s entries, set the following properties:

DynamicParameter - set this property to the parameter name used to pass a blog ID to the QueryString. The default is blogid.

BlogPostParameter - set this property to the parameter name used to pass a blog post’s ID to the QueryString. The default is id.

To use this server control to dynamically display a user’s Journal, set the following properties:

DynamicUserParameter - Set this property to the parameter name used to pass a user’s ID to the QueryString.

BlogPostParameter - set this property to the parameter name used to pass a blog post’s ID to the QueryString. The default is id.

BlogEntries Server Control Properties

The following table explains the properties of the BlogEntries control.

Note: The following table only lists Ektron-specific properties. It does not describe native .NET properties such as font, height, width and border style. For documentation of these properties, see Visual Studio help.

Property

Value

Data Type

Authenticated

Indicates if you are logged in to the CMS Explorer and can use it to browse to Content, Collections, etc. See Also: Using CMS Explorer to Browse Your Ektron CMS400.NET Site

String

BlogID

The ID of the blog in Ektron CMS400.NET from which blog entries are displayed; for example, 41. This is the default ID that is used when a blog ID is not passed dynamically to the QueryString. To pass a blog ID dynamically, set the DynamicParameter property.

If you don’t know the ID of the blog, use the CMS Explorer to browse to it. See Also: Using CMS Explorer to Browse Your Ektron CMS400.NET Site

Long

BlogPostParameter

Set this property to the parameter name used to pass a blog post’s ID to the QueryString. The default is id. When a parameter is defined, this server control passes the blog post’s ID as a URL parameter. If you do not set this parameter to id, you will not be forwarded to the blog post’s page when you click on any links in the post.

The default setting is id.

Blank - the list of blog posts is static. The links in the blog posts are inactive.

id - the ID of the blog post is passed to the URL as a parameter.

None use default - the list of blog posts is static. The links in the blog posts are inactive.

String

BlogStartDateRange

Set the date range of the Blogs to show. For example, if you want to display blogs for only the past 3 months, set this value to Quarterly.

None - no start date range

Monthly - current month

Quarterly - past 3 months

BiYearly - past 6 months

Yearly - past 12 months

String

CacheInterval

Sets the amount of time the server control’s data is cached. The default is 0 (zero). This is the amount of time, in seconds, a control’s data is cached. For example, if you want to cache the data for five minutes, set this property to 300 (three hundred). See Also: Caching with Server Controls

Double

DateToStart

The date of the last blog entries you want to appear. For example, if you want to display blog entries for January 1, 2006 and before, you enter 1/1/2006. Clicking the dropdown box provides you with a calendar.

DateTime

DefaultUserID

The ID of the user who owns a Journal from which to display journal entries. To display journal entries not associated with a user, leave this property set to 0 (zero) and enter the blog's ID in the BlogID property.

Warning! If you define a DefaultUserID, it overrides the BlogID property.

Long

DisplayXslt

Specify an external XSLT file.

Warning! If you specify an external file, it is strongly recommended that you 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.

String

 

DoInitFill

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 codebehind and have it render with your changes shown.

Boolean

DynamicParameter

Gets or sets the QueryString parameter to read a Blog ID dynamically. Set to “None - Use Default” if you want to always display the default blog. The default is blogid.

Note: If an ID for this property is passed on the QueryString and a an ID for the DynamicUserParameter property is passed the control displays blog entries for a user.

String

DynamicUserParameter

Gets or sets the QueryString parameter to read a User ID dynamically. Set to “Use Default” if you wish to always display the default user's blog (static.)

Note: If an ID for this property is passed on the QueryString and a an ID for the DynamicUserParameter property is passed the control displays blog entries for a user.

String

Hide

Used to hide the control in design time and run time.

True = Hide the control

False = Show the control

Boolean

Language

Set a language for viewing the blog entries. This property shows results in design-time (in Visual Studio) and at run-time (in a browser).

Integer

MaxResults

Set the maximum number of posts to display.

0 (zero) - no limit

-1 - all posts for the current day

-2 - all posts for the current month

-3 - the # of Post Visible Workarea setting

The default is -3.

See Also: Blog Properties

Integer

ShowHeader

Shows the title and tagline when set to True.

The default is True.

True - show title and tagline.

False - do not show header and tagline.

Boolean

SuppressWrapperTags

Suppresses the output of the span/div tags around the control. The default is False.

True - Suppress wrap tags.

False - Allow wrap tags.

Boolean


Visit the Ektron Dev Center at http://dev.ektron.com 1-866 - 4 - EKTRON

Ektron CMS400.NET Reference Version 8.02 SP1 Rev 1

Ektron Documentation,© 2011 Ektron, Inc.