MINOR Migrated content from doc.ss.org

README.md

@@ -1,18 +1,81 @@
 # Blog Module
 
-## Maintainer Contact
+## Introduction
 
-- Saophalkun Ponlu
-- Carlos Barberis 
+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.
 
-## Requirements
+## Maintainer Contact ##
 
-SilverStripe minimum version 2.4.0
+ * Saophalkun Ponlu (phalkunz at silverstripe dot com)
+ * Carlos Barberis (carlos at silverstripe dot com)
 
-## Installation
+## Feature Overview
 
-See docs/Install.md
+*  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)
 
-## Usage
+## Configuration Options
 
-See doc/Install.md
+### 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](/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](tutorial/3-forms#creating_the_form) 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
+
+## Comments and Spam Protection
+
+See [:pagecomment](/pagecomment) for creating Askimet-protected comments for every page.
+
+## Widgets
+
+See [widgets](/widgets)
+
+
+## Working with the theme
+
+The blog comes set up to use the `\themes\blackcandy_blog\` directory by default. 
+
+   * See [:themes](/themes)