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 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 |
