No commit activity in last 3 years
No release in over 3 years
Adds tagging with context and aggregation of tags for MongoMapper. Adds weight and distribution convenience methods to models in which it is included. Uses MongoDB's increment/decrement ($inc/$dec) to keep real-time counts of individual tags in context with optional type. Based on 'Mongoid Taggable With Context' (https://github.com/aq1018/mongoid_taggable_with_context).
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.0.0
~> 1.6.2
~> 0.9.0
>= 0
>= 0
 Project Readme

Taggregator Gem Version

Adds tagging in context (and aggregation of those tags) to your MongoMapper models. Tag weight and distribution methods make it easy to find real-time taxonomical hotspots in datastore. Taggregator Uses MongoDB's increment/decrement ($inc/$dec) to keep real-time counts of individual tags in context with optional type. Based on Mongoid Taggable With Context.

Basic Usage

Taggregator is easy to use. Just include the MongoMapper plugin in your model the normal way and call taggable, like so:

class Article
  include MongoMapper::Document
  plugin  MongoMapper::Plugins::Taggregator

  key :title, String
  key :body, String
  taggable
  taggable :keywords
  taggable :ads, :separator => ','
end

a = Article.new

Tags are then set with a string by calling a.tags = 'space separated tags'. The tag separator character defaults to the space character, but as you see in the above example, it can be overridden with any character or string of your choice. If we follow the lead of the example, we would set a.ads by calling a.ads = 'comma,separated,tags'. The call to taggable injects an array representation of the model's taggable fields with context, accessible through a.tags_array, a.keywords_array, and a.ads_array. If you have an array of tags (strings) and wish to set the tags array manually, you can (i.e., a.ads_array = ['xmas', 'shopping', 'books']). When the string a.ads is set, a.ads_array is populated with the individual tags. Likewise, setting the tags array populates the string representation of the tag list for that context.

The call to taggable mixes in some cool stuff. You can get all articles tags with a call to Article.tags and all tags (in the 'keywords' context) with Article.keywords. If you would like to get a list of all keywords with the keyword's associated frequency/weight, try this:

Article.tags_with_weight_for :keywords
=> [["stocks", 4], ["finance", 4], ["banking", 3], ["bonds", 1]]

Contributing to taggregator

  • Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
  • Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
  • Fork the project
  • Start a feature/bugfix branch
  • Commit and push until you are happy with your contribution
  • Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
  • Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.

Copyright

Copyright © 2010-2018 Mark Coates. See LICENSE.txt for further details.