Ektron CMS400.Net Reference

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

Blog Server Control

The Blog server control lets you quickly add a blog to a Web form. This one control has all items commonly found on a blog page, such as blog posts, a comments link, a blog roll, blog subjects, recent blog posts, the RSS feed for a blog, an archive, and a blog calendar. To learn more about each item, see Blogs.

The Blog server control lets you easily maintain the overall look of the blog. Any change to display properties, such as the background color or font, affects the entire blog.

However, you cannot change the location of each server control item. The title always appears on top, with the tagline below it. The blog posts always appear to the left and the calendar, blog roll, blog subjects, recent blog posts, RSS feed, archive and blog roll to the right.

Note: You can use individual blog server controls to change the page layout. See Also: Introduction to Blog Server Controls

To customize a blog's styling, edit the Blog.css file located in webroot\siteroot\Workarea\csslib.

Blog Server Control Properties

The following table explains the properties of the Blog 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

ArchiveMode

Select whether the archive appears in month format or year format. The default is month.

String

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. For example: 41.

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

Long

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

The amount of time, in seconds, the server control’s data is cached. The default is 0 (zero).

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, 2007 and before, you enter 1/1/2007. Clicking the dropdown box provides you with a calendar.

DateTime

DefaultUserID

The ID of the user who owns the blog to be displayed. This property is used when the server control displays a user's blog.

To display a blog not associated with a user, leave this property set to 0 (zero) and enter the blog's ID in the BlogID property.

Long

 

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.

None - Use Default - use the default Blog ID list.

ID - reads a blog’s ID dynamically

ekfrm - reads a form block’s ID dynamically

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

String

EditorHeight

Sets the height of the blog editor in pixels.

Integer

EditorWidth

Sets the width of the blog editor in pixels.

Integer

Hide

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

True = Hide the control

False = Show the control

Boolean

JavascriptEditorHTMLMode

Note: As of version 7.6, the JavaScript editor has been removed from Ektron CMS400.NET. This property has been deprecated.

Set to True to allow users to edit their posts and replies in HTML. The default is False.

String

Language

Set a language for viewing blog posts. 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. If set to 0 (zero), there is no limit. If set to -1, all posts for the day are shown. If set to -2, all posts for the month are shown, If set to -3, the control uses the # of Post Visible setting in the Workarea. The default is -3.

See Also: # of Visible Posts

Integer

PostParameter

Works like the DynamicParameter for content blocks. When id is selected, this server control passes the blog post ID as a URL parameter.

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

RecentPosts

The number of post links contained in the Recent Posts list. The default is 5 (five).

Integer

RssTemplate Specify the .aspx page to use to render the RSS for blogs. The default value is WorkArea/blogs/blogrss.aspx. String

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

ShowRSS

Displays the icon for the RSS feed () when set to True. The default is True.

True - show RSS feed icon.

False - do not show RSS feed icon.

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

WrapTag

Allows a developer to specify a server control’s tag. The default is Span.

Span - The <span> tag is used to designate an in-line portion of an HTML document as a span element.

Div - The <div> tag is used when you want to apply attributes to a block of code.

Custom - Allows you to use a custom tag.

String


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.