Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/refinery/refinerycms-blog
The very best blogging engine for Refinery CMS
https://github.com/refinery/refinerycms-blog
Last synced: 3 months ago
JSON representation
The very best blogging engine for Refinery CMS
- Host: GitHub
- URL: https://github.com/refinery/refinerycms-blog
- Owner: refinery
- Created: 2010-08-08T22:40:24.000Z (over 14 years ago)
- Default Branch: master
- Last Pushed: 2023-05-23T07:05:29.000Z (over 1 year ago)
- Last Synced: 2024-05-12T18:37:47.631Z (6 months ago)
- Language: Ruby
- Homepage: http://refinerycms.com
- Size: 1.43 MB
- Stars: 305
- Watchers: 22
- Forks: 252
- Open Issues: 39
-
Metadata Files:
- Readme: readme.md
- Changelog: changelog.md
Awesome Lists containing this project
- awesome-refinerycms - refinerycms-blog - Blog (more features than [refinerycms-news](https://github.com/refinery/refinerycms-news)) (Refinery team extensions / Frontoffice extensions)
README
# Refinery CMS Blog [![Build Status](https://travis-ci.org/refinery/refinerycms-blog.svg?branch=master)](https://travis-ci.org/refinery/refinerycms-blog)
Simple blog engine for [Refinery CMS](http://refinerycms.com). It supports posts, categories and comments.
This version of `refinerycms-blog` supports Refinery 4.x and Rails 5.1.x (Ruby 2.2+). To use Rails 4.x / Refinery 3.1.x / Ruby 2.1 or older use the [refinerycms-blog "Refinery CMS 3-0 stable branch"](http://github.com/refinery/refinerycms-blog/tree/3-0-stable).
Options:
* Comment moderation
* [ShareThis.com](http://sharethis.com) support on posts. To enable, set your key in Refinery's settings area.## Requirements
Refinery CMS version 4.0.0 or above (Ruby 2.2 or above).
## Install
Open up your ``Gemfile`` and at the bottom, add this line:
```ruby
gem 'refinerycms-blog', git: 'https://github.com/refinery/refinerycms-blog', branch: 'master'
```Note: if the [refinerycms-page-images](https://github.com/refinery/refinerycms-page-images) extension is also installed, make sure `gem refinerycms-blog` comes before `gem 'refinerycms-page-images'`.
Now, run ``bundle install``
Next, to install the blog plugin run:
rails generate refinery:blog
Run database migrations:
rake db:migrate
Finally seed your database and you're done.
rake db:seed
## Visual Editor
By default, this extension does not require any particular visual editor.
Previously, Refinery was coupled to WYMeditor but this has been extracted to an
extension, [refinerycms-wymeditor](https://github.com/parndt/refinerycms-wymeditor).If you want to use `refinerycms-wymeditor`, simply place it in your Gemfile:
```ruby
gem 'refinerycms-wymeditor', ['~> 1.0', '>= 1.0.6']
```## Developing & Contributing
The version of Refinery to develop this engine against is defined in the gemspec. To override the version of refinery to develop against, edit the project Gemfile to point to a local path containing a clone of refinerycms.
### Testing
Generate the dummy application to test against
$ bundle exec rake refinery:testing:dummy_app
Run the test suite with [Guard](https://github.com/guard/guard)
$ bundle exec guard start
Or just with rake spec
$ bundle exec rake spec
## Additional Features
* To limit rss feed length, use the 'max_results' parameterhttp://test.host/blog/feed.rss?max_results=10
## More Information
* Check out our [Website](http://refinerycms.com/)
* Documentation is available in the [guides](http://refinerycms.com/guides)
* Questions can be asked on our [Google Group](http://group.refinerycms.org)
* Questions can also be asked in our IRC room, [#refinerycms on freenode](irc://irc.freenode.net/refinerycms)