mirror of
https://github.com/silverstripe/silverstripe-blog
synced 2024-10-22 11:05:58 +02:00
Updated README
This commit is contained in:
parent
39784adf9e
commit
07c4415ab2
56
README.md
Normal file → Executable file
56
README.md
Normal file → Executable file
@ -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.
|
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**
|
||||||
|
```
|
||||||
|
<?php
|
||||||
|
Config::inst()->update("BlogPost", "show_in_sitetree", true);
|
||||||
|
```
|
||||||
|
|
||||||
|
Doing this will remove the GridField & result in a normal behaving SiteTree.
|
||||||
|
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user