https://github.com/elight/acts_as_commentable_with_threading
Similar to acts_as_commentable; however, utilizes awesome_nested_set to provide threaded comments
https://github.com/elight/acts_as_commentable_with_threading
Last synced: 7 months ago
JSON representation
Similar to acts_as_commentable; however, utilizes awesome_nested_set to provide threaded comments
- Host: GitHub
- URL: https://github.com/elight/acts_as_commentable_with_threading
- Owner: elight
- License: mit
- Created: 2008-11-16T14:37:39.000Z (almost 17 years ago)
- Default Branch: master
- Last Pushed: 2022-05-08T16:45:46.000Z (over 3 years ago)
- Last Synced: 2025-03-19T07:42:00.758Z (8 months ago)
- Language: Ruby
- Homepage:
- Size: 130 KB
- Stars: 671
- Watchers: 17
- Forks: 165
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: MIT-LICENSE
Awesome Lists containing this project
- awesome-ruby-toolbox - Acts as commentable with threading - Similar to acts_as_commentable; however, utilizes awesome_nested_set to provide threaded comments (Active Record Plugins / Rails Comments)
- awesome-ruby - Acts As Commentable with Threading - Similar to acts_as_commentable; however, utilizes awesome_nested_set to provide threaded comments. (ORM/ODM Extensions)
README
[](https://travis-ci.org/elight/acts_as_commentable_with_threading)
[](https://codeclimate.com/github/elight/acts_as_commentable_with_threading)
Acts As Commentable (now with comment threads(TM)!!! -- kidding on the (TM))
===================
Allows for threaded comments to be added to multiple and different models.
Drop-in compatible for acts_as_commentable (however requiring a database
schema change)
Requirements
------------
The 2.x version of this gem is for Rails 4 and later versions only. For the Rails 3.x compatible version of this gem, please use version 1.2.0.
This gem depends on CollectiveIdea's Awesome Nested Set gem. It is installed if
not already present when you install this gem.
You can find the gem on GitHub at [collectiveidea/awesome_nested_set]
[collectiveidea/awesome_nested_set]: https://github.com/collectiveidea/awesome_nested_set
Install
-------
In your Gemfile, add:
gem 'acts_as_commentable_with_threading'
and run `bundle install`.
Migrations
----------
* To install from scratch:
rails generate acts_as_commentable_with_threading_migration
This will generate the migration script necessary for the table
* To upgrade to acts_as_commentable_with_threading from the
old acts_as_commentable:
rails generate acts_as_commentable_upgrade_migration
This will generate the necessary migration to upgrade your comments
table to work with acts_as_commentable_with_threading
If the generators fail, you can just as easily create the migrations by hand.
See the templates in the generators under [`lib/generators`].
[`lib/generators`]: https://github.com/elight/acts_as_commentable_with_threading/tree/master/lib/generators
Usage
-----
class Article < ActiveRecord::Base
acts_as_commentable
end
* Add a comment to a model instance, for example an Article:
@article = Article.find(params[:id])
@user_who_commented = @current_user
@comment = Comment.build_from( @article, @user_who_commented.id, "Hey guys this is my comment!" )
* To make a newly created comment into a child/reply of another comment:
@comment.move_to_child_of(the_desired_parent_comment)
* To retrieve all comments for an article, including child comments:
@all_comments = @article.comment_threads
* To retrieve only the root comments without their child comments:
@root_comments = @article.root_comments
* To check if a comment has children:
@comment.has_children?
* To verify the number of children a comment has:
@comment.children.size
* To retrieve a comment's children:
@comment.children
* If you plan to use the `acts_as_votable` plugin with your comment system be
sure to uncomment the line [`acts_as_votable`][L9] in `lib/comment.rb`.
[L9]: https://github.com/elight/acts_as_commentable_with_threading/blob/master/lib/generators/acts_as_commentable_with_threading_migration/templates/comment.rb#L9
Credits
-------
* [xxx](https://github.com/xxx) - For contributing the updates for Rails 3!
* [Jack Dempsey](https://github.com/jackdempsey) - This plugin/gem is heavily
influenced/liberally borrowed/stolen from [acts_as_commentable].
And in turn...
* Xelipe - Because acts_as_commentable was heavily influenced by Acts As Taggable.
[acts_as_commentable]: https://github.com/jackdempsey/acts_as_commentable
More
----
* [http://tripledogdare.net](http://tripledogdare.net)
* [http://evan.tiggerpalace.com](http://evan.tiggerpalace.com)