Blog Series Extension

This plugin is an extension to the RainLab.Blog plugin. With this extension you can group related posts into series. It provides a better way to group related posts than it is possible with categories

Components

BlogSeries

The blogSeries component outputs the series and lists all posts which belong to the series

Attributes

• Slug - Look up the series using the supplied slug value.
• No Posts Message - Message to show if no posts where found.
• Sort Order - the column name and direction used for the sort order of the posts. The default value is published_at desc.
• Category Page - The page where the blog posts are filtered by a category.
• Post Page - The page where single blog posts are displayed.

Example Usage

title = "Blog Series"
url = "/blog/series/:slug"

[blogSeries]
slug = "{{ :slug }}"
noPostsMessage = "No posts found"
sortOrder = "created_at asc"
categoryPage = "blog"
postPage = "blog/posts"
==
<div class="blog-series">
    {% component 'blogSeries' %}
</div>

BlogSeriesList

The blogSeriesList component displays a list of blog series on the page

Attributes

• Display empty series - Show series that do not have any posts.
• Sort Order - the column name and direction used for the sort order of the series. The default value is title asc
• Series Page - The page where the series is displayed (the page with the blogSeries component).

Example Usage

title = "Blog"
url = "/blog/:page?"

[blogSeriesList]
seriesPage = "blog/series"
sortOrder = "updated_at asc"
==
...
<div class="sidebar">
    {% component 'blogSeriesList' %}
</div>
...

PostNavigation

The postNavigation component displays a navigation for the current posts series. This component should be included on the same page as the blogPost component because it requires the post slug

Attributes

• Slug - Look up the post using the supplied slug value.
• Small Navigation - Display a small "Previous/Next Navigation" instead of a full post list.
• Series Page - The page where the single series are displayed.
• Post Page - The page where single blog posts are displayed.

Example Usage

title = "Blog posts"
url = "/blog/post/:slug"

[blogPost]
slug = "{{ :slug }}"
categoryPage = "blog/categories"

[postNavigation]
slug = "{{ :slug }}"
smallNav = "0"
postPage = "blog/posts"
seriesPage = "blog/series"
==
{% if post %}
    <h2>{{ post.title }}</h2>
    {% component 'blogPost' %}
    {% component 'postNavigation' %}
{% else %}
    <h2>Post not found</h2>
 {% endif %}