Magnolia 4.5 reached end of life on June 30, 2016. This branch is no longer supported, see End-of-life policy.

Page tree
Skip to end of metadata
Go to start of metadata

The Blog module allows you to add a blog to your website. The module is integrated with the Standard Templating Kit and includes all features typically found in blogs. A sample blog is available at demo-features/special-templates/blog. In a multisite environment you can add a blog to each site in the page tree.

STK Templates

Pages

The module adds two page templates in Templating Kit > Template Definitions /pages:

  • stkBlog: Blog home or main page that aggregates content from blog posts in a site tree.
  • stkBlogEntry: Blog post page.

Both templates disable the promos and breadcrumb areas, giving the pages a blog look.

The stkBlog template is a standard STK feature page template that autogenerates the stkBlog component in content area. This component renders a teaser list of blog posts, i.e. pages based on the stkBlogEntry template.

The stkBlogEntry template extends the stkArticle template. It is a standard article template with the sectionHeader area and vertical navigation disabled. The blog-entry subcategory property is used by the stkBlog component to aggregate pages based on this template.

Here's the template definition in STK > Template Definitions /pages/stkBlogEntry.

Components

The module adds two components to the STK:

  • stkBlog: Aggregates teasers to all blog posts in a site tree, with the latest first. Pagination is available and editors can define the number of entries per page. The component is autogenerated on the stkBlog template.
  • stkBlogEntryList: Extras component that aggregates latest blog posts. Editors can select a parent page and define the number of teasers. The component is made available on all templates in the template prototype in Templating Kit > Site Definitions/default/templates/prototype/areas/extras/areas/extras1&2/availableComponents.

The component definitions are configured in Templating Kit > Template Definitions /components/features/stkBlog and /extras/stkBlogEntryList and are very similar

Here's the configuration of the stkBlog component.

Template availability

The page templates are made available in Templating Kit > Site Definitions /default/templates/availability/templates/stkBlog and /stkBlogEntry. See Site definition for more.

Tagging content

You can tag blog content using categories stored in the Data module.

Adding categories to posts

Categorization is available in the Page Header component in the stkBlogEntry template. The intro area uses the stkBlogEntryHeader dialog configured in Templating Kit > Dialog Definitions /pages/blogEntyr/stkBlogEntryHeader. This dialog includes the generic tabCategoriztion tab by extension. See Dialogs and Tagging content with categories for more information.

 Add Category Cloud components to the blog templates to render tag clouds on your blog pages.

Managing categories

Data > Category includes sample blog tags. These are bootstrapped on installation and you can add your own. See Creating categories for more.

Commenting

The Comments component is available on the stkBlogEntry template. See Commenting module for more.

 

Add the Latest Comments component to extras area to render comments from related pages. See Adding components to templates for more.

Comments are stored and moderated in Forums. See Moderating for more.

  • No labels