mongo_followable¶ ↑

Now works for both Mongoid and Mongo_Mapper!

Installation¶ ↑

In console:

gem install mongo_followable

or in Gemfile:

gem 'mongo_followable', "~> 0.2.0"

Usage¶ ↑

To make model followable you need to include Mongo::Followable into your document;Meanwhile, you also need to include Mongo::Follower in your follower model:

class User
  include Mongoid::Document  #for Mongo_Mapper users, this line of code should be 'include MongoMapper::Document
  include Mongo::Followable
  include Mongo::Follower
end

class Group
  include Mongoid::Document  #for Mongo_Mapper users, this line of code should be 'include MongoMapper::Document
  include Mongo::Followable
end

Now you can set authorization:

current_user.set_authorization('user', 'game') # now current_user cannot follow User and Game model
current_user.unset_authorization('User', 'Game')

And then you can follow a model:

@group = Group.new
@group.save

current_user.follow(@group)
current_user.unfollow(@group)

You can also judge whether a model is a follower of another model or a model is a followee of another model:

	
current_user.follower_of?(@group)
current_user.followee_of?(@group)

Moreover, it’s easy to get a model’s follower/followee count:

current_user.followers_count
current_user.followees_count

Of course, you can get a list of followers/followees:

	
User.followers_of(@group)
User.followees_of(@group)

@group.all_followers
@user.all_followees

Getting a model’s followers/followees by type is also possible:

@group.followers_by_type("user")
@user.followees_by_type("group")

And their count:

@group.followers_by_type("user")
@group.followers_count_by_type("user")
@user.followees_by_type("group")
@user.followees_count_by_type("group")

You can also get a model’s follow/followed history:

@user.ever_follow
@group.ever_followed

Another feature is to get a list of models which has the most followers/followees:

User.with_max_followees
User.with_min_followees
User.with_max_followees_by_type('group')
User.with_min_followees_by_type('group')
Group.with_max_followers
Group.with_min_followers
Group.with_max_followers_by_type('user')
Group.with_min_followers_by_type('user')

Now you can tell if two models have some common followers/followees by following methods:

@user.common_followees?(@another_user)
@user.common_followers?(@group)

And see what the common followers/followees are:

@user.common_followees_with(@another_user)
@user.common_followers_with(@group)

Any bug or issue, please send me an email: [email protected]

TODO¶ ↑

inter-models followable #FINISHED#
divide into two parts: followable(being followed) and follower(following others) #FINISHED#
following history/followed history #FINISHED#
most/least followed/following #FINISHED
add authorization to followable models #FINISHED#
common followers/followees #FINISHED#
add support for mongo_mapper in next version #FINISHED#

!!If you have any advice, plese do not hesitate to tell me!!

Thanks¶ ↑

Thanks the author(s) of acts_as_followable, you can find this gem here

Thanks the author(s) of voteable_mongo, you can find this gem here

l4u / mongo_followable Goto Github PK