From 07c4415ab26a497467640c2b700815b31eea9ad5 Mon Sep 17 00:00:00 2001 From: micmania1 Date: Sun, 11 Aug 2013 00:26:17 +0100 Subject: [PATCH] Updated README --- README.md | 56 ++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 55 insertions(+), 1 deletion(-) mode change 100644 => 100755 README.md diff --git a/README.md b/README.md old mode 100644 new mode 100755 index b46ed27..9bfe532 --- a/README.md +++ b/README.md @@ -1,4 +1,58 @@ -silverstripe-blog +Silverstripe Blog ================= A fresh take on blogging in Silverstripe set out to tackle the issue of a cluttered Site Tree. + +## Requirements +``` +silverstripe/framework: 3.1.* +silverstripe/cms: 3.1.* +``` + +## Suggested Modules +``` +silverstripe/widgets: * +silverstripe/comments: * +``` + + +## Installation + +``` +composer require micmania1/silverstripe-blog:1.0.* +``` + + +## Features +* Blog Posts extend SiteTree so no Page functionality is lost by using DataObject's. +* Blog Posts can be listed in the SiteTree **OR** in a GridField within the blog, removing clutter for large blogs. +* Filter blog posts by category +* Filter blog posts by tag +* Full blog Archive by Year, month or day +* 4 widgets included (category listing, tag listing, archive & recent posts). +* Publish Date - Set a blog post to publish in the future. +* Custom GridField components for quickly adding new objects. +* RSS Feed of the blog + + + +## Usage +Because the blog is part of the SiteTree the usage is the same as any other page. + +By default, blog posts are filtered out of the SiteTree to avoid clutter and instead put in a GridField inside of the blog. If you wish to display the blog posts within the site tree you can do so using Silverstripe config. + +**YAML** +``` +BlogPost: + show_in_sitetree: true +``` + +**PHP** +``` +update("BlogPost", "show_in_sitetree", true); +``` + +Doing this will remove the GridField & result in a normal behaving SiteTree. + +