ActsAsReadable allows you to create a generic relationship of items which can be marked as ‘read’ by users. This is useful for forums or any other kind of situation where you might need to know whether or not a user has seen a particular model.
TODO…
class Post < ActiveRecord::Base acts_as_readable end
bob = User.find_by_name(“bob”)
bob.readings # => []
Post.unread_by(bob) # => [<Post 1>,<Post 2>,<Post 3>…] Post.read_by(bob) # => []
Post.find(1).read_by?(bob) # => false Post.find(1).read_by!(bob) # => <Reading 1> Post.find(1).read_by?(bob) # => true Post.find(1).readers # => [<User bob>]
Post.unread_by(bob) # => [<Post 2>,<Post 3>…] Post.read_by(bob) # => [<Post 1>]
bob.readings # => [<Reading 1>]
Version 2.4.0 now supports reading and querying against STI subclasses, even when the read and queried subclass don’t match. This requires you to migrate the readings.readable_type column data to the base class name of the stored class name, as in versions prior to 2.4.0 the column stored the class name of whatever instance was being read, event STI subclasses.
There are multiple gemfiles available for testing against different Rails versions. Set BUNDLE_GEMFILE to target them, e.g.
bundle install BUNDLE_GEMFILE=gemfiles/rails7.gemfile bundle exec rspec
Copyright © 2024 Culture Code Software Consulting. Released under the MIT license