silverstripe-blog/docs/en/widgets.md

48 lines
1.4 KiB
Markdown
Raw Normal View History

2015-05-21 06:54:26 +02:00
# Widgets
The blog module comes bundled with some useful widgets. To take advantage of them, you'll need to install the [SilverStripe widgets module](https://github.com/silverstripe/silverstripe-widgets). Widgets are totally optional - so your blog will work just fine without having widgets installed.
2015-06-03 03:47:11 +02:00
You can enable the widgets by adding the following YML config:
```yml
Blog:
extensions:
- WidgetPageExtension
BlogPost:
extensions:
- WidgetPageExtension
```
2015-05-21 06:54:26 +02:00
Once you have widgets installed you'll see the "Widgets" tab in the content section of your blog.
![](_images/widgets.png)
To add a widget - simply click the *plus* icon and the widget will be appear in the "Widgets currently used" column.
After you've finished adding widgets, publish your blog, and your freshly minted widgets will appear in your blog's sidebar.
## Archive
The archive widget helps you keep historical content relevant, by generating a list of posts, ordered by month or year.
![](_images/widgets-archive.png)
## Blog Categories
The blog categories widget lets your readers easily find the content they're interested in.
![](_images/widgets-categories.png)
## Recent Posts
The recent posts widget is great for providing quick links to your latest content.
![](_images/widgets-recent-posts.png)
## Blog Tags
Similar to the blog categories widget, blog tags help your readers find relevant content, at more fine grained level.
![](_images/widgets-tags.png)