Add follow feature to Mongoid and Mongo_Mapper
Switch branches/tags
Nothing to show
Pull request Compare This branch is 18 commits behind lastomato:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.idea
app/models
lib
spec
.gitignore
.rakeTasks
Gemfile
LICENSE.txt
README.rdoc
Rakefile
mongo_followable.gemspec

README.rdoc

mongo_followable

Now works for both Mongoid and Mongo_Mapper!

see www.thesika.info/articles/mongo_followable_update for details

Installation

In console:

gem install mongo_followable

or in Gemfile:

gem 'mongo_followable', "~> 0.2.3"

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 and unfollow:

@group = Group.new
@group.save

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

current_user.follow(*array_of_objects_to_follow) # follow an array of objects
current_user.unfollow(*array_of_objects_to_follow) # unfollow

or,

@group.unfollowed(current_user)
@group.unfollowed_all

It's also possible to pass a block:

current_user.follow(u1, u2, u3, u4...) { |user| user.name == 'Jeremy Lin' }
current_user.unfollow(u1, u2, u3, u4...) { |user| user.followee_of? @kobe_bryant }

@group.unfollowed(u1, u2, u3...) { |user| user.ever_follow.include? @some_user }

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")

For inherited model:

@group.followers_by_type("user_post") # both are fine
@user.followees_by_type("GroupPost")

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: ustc.flyingfox@gmail.com

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

Copyright

Copyright © Jie Fan. See LICENSE.txt for further details.