Blog Module

Introduction

The blog module allows you to post blogs on your SilverStripe. It includes the ability to post blogs using a site front-end form. Blogs are summarised on the blog holder page type, with more detail viewable when a specific blog is clicked.

Maintainer Contact

• Saophalkun Ponlu (phalkunz at silverstripe dot com)
• Carlos Barberis (carlos at silverstripe dot com)

Feature Overview

• Front-end blog post form
• Posts allow bbcode
• RSS feed for blog and also feeds for comments on posts
• Easily customizable
• Tag cloud widget
• Archive widget
• Blog management widget
• RSS widget (will likely move in future)
• MetaWeblog API support. (posting new blog entries using Posterous, and other blogging services that use this API).

Configuration Options

Use WYSIWYG editing instead of bbcode

Out of the box the blog module uses bbcode, just like the forum module. If you want to go back to using the standard page editing toolbar you need to add the following code to your mysite/_config.php file

:::php
BlogEntry::allow_wysiwyg_editing();

Page types

We have chosen to go with the following page types to include with the blog module:

• BlogHolder: The BlogHolder shows BlogEntrys, and provides a way to search etc.It would also contain methods to post new blogs.

• BlogEntry: This is simply an entry/post for the blog.

Simple form for adding a post

There is a blog management widget, that includes a link "Post new blog entry", which takes the user to [site/CurrentBlogHolder]/post (this is a good url to bookmark if you will be using it to blog regularly). This shows a blog entry form, which requires a subject and some content at the least. Clicking "Post blog entry" takes the user back to the blog. A login form will show if the user is not logged in. The entered author name is stored in a cookie. Initially the shown name will be the user's name.

BBcode support

• BBCode can be entered into the form.

• A bbcode tags help box shows when the "BBCode help" link is clicked. Javascript is required for this to work.

See :PEAR:BBCodeParser for more details.

Modifying the blog entry form

You may want to add or remove certain fields from the blog entry form. This can be done in BlogHolder.php. You will need to modify the $fields FieldSet object in the BlogEntryForm function. tutorial 3 shows you how to do this.

You will likely need to play around with the form and associated css to get the form looking how you want it.

View Archived Blogs

Blog archives can be viewed by year/month by appending the year, followed by a forward slash, then the numerical month, to the end of the blogholder URL. Alternately, just the year can be appended to view entries for that year.

for example: mysite/blog/2007/6 would show blog entries for June 2007

or: mysite/blog/2007 would show blog entries for 2007

Setting up MetaWeblog and RSD (Really Simple Discovery)

MetaWeblogController::$MODERATE_PUBLISHING - indicates whether blog entries posted via the API will need manual approvial via the CMS. (default: false)

MetaWeblogController::$RESTRICT_POST_TO_OWNER - restrict postings to the user defined as 'owner' in the blog holder (default: false)

In order to activate RSD you have to put $RSDLink in Page.ss, or BlogHolder.ss (if it is located in templates, and not Layout). After doing this, just point the blog service to the BlogHolder's url during that service's configuration.

Another note: Please make sure that this module's main directory is named 'blog'. MetaWeblog won't work otherwise.

Comments and Spam Protection

See :pagecomment for creating Askimet-protected comments for every page.

Widgets

See widgets

Working with the theme

The blog comes set up to use the \themes\blackcandy_blog\ directory by default.

• See :themes