Blogs widget

You use the Blogs widget to display blogs on your website pages. You select what content to display and then specify how blogs are listed and displayed individually.

The Blogs widget can be used along with Blog post widget. You can configure the widgets to work together and once you click on а blog title to see all blog posts for the currently selected blogs (listed in the Blog posts widget). To achieve this, configure the Blogs widget Open single item in... and select a page with a Blog post widget. Then configure the Blog post widget to show posts From currently opened blog.

PREREQUISITES: You created at least one blog item. For more information, see Create blogs.

Choose what content to display

  1. In the upper-right corner of the Blogs widget, click Edit
  2. In the Content tab page, choose which blogs you want to display. Choose between the following options:
    • All published blogs
      All created blogs are displayed.
    • Selected blogs...
      A custom selection of blog items is displayed. To select one or more blog items you want to display, click the Select button.
    • Blogs with more than...posts
      Only blogs that have more than specified number of posts is displayed.
    • Only blogs that have posts not older than...months
      Only blogs that have posts recent than the specified period is displayed.
  3. When finished, click Done selecting.
  4. List settings

    List settings define how blogs are listed by the Blogs widget. Choose one of the following options:

    • Use paging
      Divides the blogs into pages. In the input field, specify how many blogs per page to display.

    • Use limit
      Displays only a limited number of blogs. In the input field, specify how many blogs to display.

    • No limit and paging
      Displays all blogs that meet the requirements and filters you set in the Content tab.

    • Sort blogs
      By default, last published blog items are listed on top. You can select a different sorting criterion:

      • Last published
      • Last modified
      • By Title (A-Z)
      • By Title (Z-A)
      • As set manually
        This option is available only when you selected specific blogs in the Content tab using Selected blogs…. If you select As set manually, blogs are displayed in the same order as in the Content tab.
      • As set in Advanced mode
        To sort the list of blog items by property that is not defined in the sort dropdown menu, you must add a new sorting expression in the designer’s Advanced mode. For example, to sort blogs using the Content property of blogs, navigate to Advanced » Model and, for SortExpression, add Content ASC. As a result, in the sort dropdown menu, the As set in Advanced mode option is selected by default.
    • List template
      Select the template you want to use to list blogs on the webpage.

    • CSS classes
      Expand More options section to specify CSS file names and apply additional CSS classes to the Blogs widget.

    Single item settings

    Single item settings define how individual blogs are displayed. Choose one of the following options:

    • Open single item in...
      Select one of the following options:

      • Auto-generated page
        When you click a blog, it is displayed in an automatically generated page with the same layout as the list page.

      • Selected existing page…
        From the list of existing pages, select the specific page in which blogs are displayed.

      • Default page for blog
        The default page set in the backend when creating or editing a blog item will be used.

    NOTE: To display a blog in a page, the page must have a Blogs widget added in advance.

    • Detail template
      Select the template you want to use to display blogs on the webpage.

    • CSS classes
      Expand More options section to specify CSS file names and apply additional CSS classes to the Blogs widget.

    Advanced settings

    In Advanced settings, you specify individual properties of the widget:

    • DetailPageMode
      Defines the location where you should be redirected when you click a blog title. Available options are:

      • PerItem
        This is the default option. If this option is selected, the individual settings of the blog item are used. You can set different page when you create or edit the blog post.
      • SamePage
        The same page is used to display details of the blog when you click the blog title.
      • SelectedExistingPage
        The details of the blog are opened in the page with ID DetailsPageId in case there is a Blogs widget dropped there.
    • DetailsPageId
      Gets the ID of the page you selected in the Selected existing page.. option in the Single item settings tab page.

    • DetailTemplateName
      Gets the template you selected in the Detail template dropdown menu in the Single item settings tab page.

    • ListTemplateName
      Gets the template you chose in the List template dropdown menu in the List settings tab page.

    Model settings

    Model settings display all properties directly bound to the Blogs widget model. Access these properties by clicking the Model button in Advanced settings.

    • ContentViewDisplayMode
      By default, a single content item is displayed in Detail view. This property enables you to configure whether single content items are displayed in Detail or in List view by entering Detail or List, respectively.

    • DetailCssClass
      Gets and sets an additional CSS class to the detail view of a blog item.

    • DisplayMode
      Gets the value you selected in the Simple List settings tab page:

      • Paging
        This is the default option.
      • Limit
      • All
    • FilteredSelectionMode
      Defines whether to filter blog items depending on the blog posts they contain. Choose one of the following options:

      • MinPostsCount
      • MaxPostsAge
    • ItemsPerPage
      Defines the number of blogs per page when paging is enabled. The default value is 20.

    • ListCssClass
      Gets and sets an additional CSS class to the list view.

    • MaxPostsAge
      Defines period when the post for a blog should be created in order this blog to be displayed option Only blogs that have posts not older than… months is selected.

    • MinPostsCount
      Defines minimum posts count that a blog should have in order to be displayed when option Blogs with more than … posts is selected.

    • ProviderName
      If you have more than one providers added, you can use a blogs providers different than the default one. To do this, specify the name of this provider.

      NOTE: If you leave this property value empty, the default blogs provider is used.

    • SelectionMode
      Gets the option that you chose in the Content tab page. The possible values you can chose from are:

      • AllItems
      • SelectedItems
      • FilteredItems
    • SerializedSelectedItemsIds
      In case you specifically select some blogs, the IDs of the selected blogs are serialized and populated in that field. For example: ["3f47d0b8-2d22-6e58-888c-ff0000bfc4e0"]

    • SortExpression
      Adds additional sorting expression for the blogs. The default value is PublicationDate DESC.

Additional resources

ARTICLES

Want to learn more?

Sign up for our free beginner training. Boost your credentials through advanced courses and certification.
Register for Sitefinity training and certification.

Tags

Was this article helpful?

Next article

Blog posts widget