Blog
The Blog server control lets you add a blogshort for Web Log to a Web form. This control has the items commonly found on a blog page, such as blog posts, comments link, a blog roll, blog subjects, recent blog posts, the blog's RSS feed, archivethe state of content upon reaching its end date. What happens next is determined by your choice at the content's Schedule tab > Action on End Date options field. Choices are * Archive and remove from site (expire) * Archive and remain on site * Add to CMS Refresh Report, and a blog calendar.
The Blog server control lets you easily maintain the overall look of the blog. Any change to display properties, such as 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.
Inserting the Blog server control onto a page
Prerequisite
You must have installed the server controls. See Installing server controls into Visual Studio Toolbox.
- In Visual Studio, choose View > Toolbox.
- Click the Ektron server control tab to display the server controls.
- Drag the Blog server control and drop it into the desired location on the page.
NOTE: You also can place the cursor on the page where you want the server control, then double click the server control that you want.
<CMS:Blog ID="Blog" runat="server" />
- Click on
Blog
in the code to display and modify the control’s properties using the Properties window of Visual Studio. The page is updated as you modify the property values.
Blog properties
The following are Ektron-specific server controla server control uses API language to interact with the CMS and Framework UI to display the output. A server control can be dragged and dropped onto a Web form and then modified. properties. For information about native .NET properties such as font, height, width and border style, use Visual Studio® help.
- ArchiveMode (String)
Select whether the archive appears in month format or year format. The default is month
- BlogID (Long)
The ID of the blog in Ektron. For example: 41. If you don’t know the blog ID, use the CMS Explorer to browse to it.See also: Browsing your Ektron site using CMS Explorer
- BlogStartDateRange (String)
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
- CacheInterval (Double)
The number of seconds that a server controla server control uses API language to interact with the CMS and Framework UI to display the output. A server control can be dragged and dropped onto a Web form and then modified.’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.
- DateToStart (DateTime)
The date of the most recent blog entries to appear. For example, to display blog entries for January 1, 2012 and before, enter 1/1/2012. Click the drop-down box to access a calendar.
- DefaultUserID (Long)
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. - DoInitFill (Boolean)
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.
- DynamicParameter (String)
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.
- ekfrm. Reads a form block’s ID dynamically.
- You may display blogs dynamically by entering any value other than id. id is the default parameter for PostParameter.
- DynamicUserParameter (String)
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).
- EditorHeight (Integer)
Sets the height of the blog editor in pixels.
- EditorWidth (Integer)
Sets the width of the blog editor in pixels.
- Hide (Boolean)
Hides or displays the output of the control in design time and run time.
- True. Hide the control output.
- False. Display the control output.
- Language (Integer)
Set a language for viewing content; shows results in design-time (in Visual Studio) and at run-time (in a browser).
- MaxResults (Integer)
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
-2. All posts for the month are shown
-3. Use the # of Post Visible setting in the Workarea.
The default is -3.
- PostParameter (String)
Works like the
DynamicParameter
for content blocks. Whenid
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.
- RecentPosts (Integer)
The number of post links contained in the Recent Posts list. The default is 5.
- SelTaxonomyID (Integer)
Set the ID of the taxonomya content-level categorization system that uses one-to-many relationships (such as Ronald Reagan is to Actor, Governor, and President) to create a scalable organization of content. A taxonomy lets your site visitors navigate content independent of the folder structure. with which content is associated if a logged-in site visitor uses the Silver Access Point’s Add HTML Content option to add content to a Collection server control.
- ShowHeader (Boolean)
- True (default). Show title and tagline.
- False. Do not show header and tagline.
- True (default). Show title and tagline.
- ShowRSS (Boolean)
- True (default). Show RSS feed icon ().
- False. Do not show RSS feed icon.
- True (default). Show RSS feed icon ().
- SuppressWrapperTags (Boolean)
Suppresses the output of the span/div tags around the control.
- True. Suppress wrap tags.
- False (default). Allow wrap tags.
- WrapTag (String)
Lets a developer specify a server control’s tag.
- Span (default). Designate an inline portion of an HTML document as a span element.
- Div. Apply attributes to a block of code.
- Custom. Lets you use a custom tag.