Blog Series Extension

This plugin is an extension to the RainLab.Blog plugin. With this extension you can group posts into series

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 %}