This repository was archived by the owner on May 16, 2019. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 1
Categories ("Tags v2.0") engine for Ruby On Rails
License
pager/acts_as_20ggable
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
= acts_as_20ggable
This plugin implements categories ('Tags v2.0') engine inspired by Dmitriy Smirnov's
post http://spectator.ru/technology/web-building/tags2null .
It is heavily based on acts_as_taggable_on_steroids by Jonathan Viney (thanks!):
http://svn.viney.net.nz/things/rails/plugins/acts_as_taggable_on_steroids/
Also, it is under development and not production-ready yet. Look at FIXMEs, TODOs and OPTIMIZEs in code. Interface is subject to change, too.
== Instructions & usage
Almost everything concerned with original acts_as_taggable_on_steriods applies equally
to this plugin, so read original README first:
http://svn.viney.net.nz/things/rails/plugins/acts_as_taggable_on_steroids/README
=== Attention
TagHierarchyBuilder.rebuild_hierarchy relies on DB transactions. So, on
non-transactional datastores everything can break suddenly.
=== Playground configuration
Generate and apply migration:
ruby script/generate acts_as_20ggable_migration
rake db:migrate
Let's suppose we have photos and we want those photos to have tags:
class Photo < ActiveRecord::Base
acts_as_taggable
end
Also let's suppose we already have some photos with some tags in DB.
=== Tags hierarchy editing
To dump tags hierarchy for editing, use
hierarchy = TagHierarchyBuilder.dump_tags # => ['# Categories',
'# Synonyms',
'# Unlinked tags',
'Nature',
'Horse',
'Cat',
'Kitty',
'Animals']
Let user edit it as plain text, then to update hierarchy use
# hierarchy => ['# Categories',
'Nature / Animals',
'Animals / Horse',
'Nature / Animals / Cat',
'# Synonyms',
'Cat = Kitty']
TagHierarchyBuilder.rebuild_hierarchy(hierarchy)
Comments ("# …") in hierarchy specification are purely optional and inserted only
for user convenience.
TagHierarchyBuilder can throw TagHierarchyBuilder::WrongSpecificationSyntax or Tag::HierarchyCycle. Errors descriptions still not implemented, sorry.
=== Finding tagged objects
find_tagged_with by default returns models with all subtags:
Photo.find_tagged_with('Animals') # => Everything tagged with Animals, Horse, Cat, Kitty
Photo.find_tagged_with('Animals', :exclude_subtags => true) # => Only tagged with Animals
== Other
Problems, comments, and suggestions all welcome. avanie@gmail.com
About
Categories ("Tags v2.0") engine for Ruby On Rails
Resources
License
Stars
Watchers
Forks
Releases
No releases published
Packages 0
No packages published