ActsAsTaggableRedux

Allows for user owned tags to be added to multiple classes, and makes tags easier to work with.

NOTE: this gem has not been updated for rails 3 and I'm not really maintaining it any more. If you would like to update and/or maintain please contact geemus, thanks!

Prerequisites

Install Edge Rails before you get started so you get RESTful routing.

ActsAsTaggableRedux depends on database tables to store tagging information. Create the migration for these tables with this command:

rake acts_as_taggable:db:create

Then run the migration to create the tables with this command:

rake db:migrate

Also you will need to add this to your user model:

acts_as_tagger

Any models that will have tags applied to them should then have this added:

acts_as_taggable

OPTIONAL: The helper functions assume the pressence of a tags controller, that is what the tag clouds and tags will link to.

OPTIONAL: To pretty up tag clouds and lists you can generate an example stylesheet with this command:

rake acts_as_taggable:stylesheet:create

and then include this in your layouts that have tag clouds:

<%= stylesheet_link_tag 'acts_as_taggable_stylesheet' %>

Example

The following is an example of how you might integrate tags with an Item model.

config/routes.rb map.resource :items, :tags

app/views/items/new.erb

New Item

<% form_for(:item, @item) do |f| -%>

<%= error_message_for :item %>

<b>Tags:</b> <%= f.text_field :tag_list -%>

<%= submit_tag "Save" -%>

<% end -%>

if you want users to own taggings change the tags line to this Tags: <%= f.text_field :tag_list, :value => @item.tag_list(user) -%> and add this line beneath it <%= f.hidden_field :user_id, :value => user.id -%>

app/views/items/show.erb Item tagged with: <% item.tags.each do |tag| -%> <%= link_to_tag(tag) %> <% end -%>

app/views/items/edit.erb

New Item

<% form_for(:item, @item, :html => { :method => :post }) do |f| -%>

<%= error_messages_for :item %>

<b>Tags:</b> <%= f.text_field :tag_list -%>

<%= submit_tag "Save" -%>

<% end -%>

app/controllers/items_controller.rb class ItemController < ApplicationController def new @item = Item.new end

def create
  @item = Item.new(params[:item])
  
  respond_to do |format|
    if @item.save
      flash[:notice] = 'Item was successfully created.'
      format.html { redirect_to item_url(@item) }
      format.xml  { head :created, :location => item_url(@item) }
    else
      format.html { render :action => "new" }
      format.xml  { render :xml => @item.errors.to_xml }
    end
  end
end

def show
  @item = Item.find(params[:id], :include => :tags)
end

def edit
  @item = Item.find(params[:id])
end

def update
  @item = Item.find(params[:id])
  
  respond_to do |format|
    if @item.update_attributes(params[:item])
      flash[:notice] = 'Item was successfully updated.'
      format.html { redirect_to item_url(@item) }
      format.xml  { head :updated, :location => item_url(@item) }
    end
      format.html { render :action => "edit"}
      format.xml  { render :xml => @item.errors.to_xml}
  end
end

end

Tag clouds

Tag clouds are created by a helper function, and depend on the counter cache to get fast accurate counts. To ensure this keeps working properly, don't add new tags to a taggable in any way other than using the tag.tag(taggable) style. This will ensure that the caches don't lose track. Also, see the prerequisites for installing the stylesheet so that the tag cloud actually looks like a tag cloud. Otherwise, just pop into a view that you want the tag cloud to appear and type this:

<%= tag_cloud %>

Contributing

Welcoming all pull requests on github.com at http://github.com/monki/acts_as_taggable_redux/tree/master or git://github.com/monki/acts_as_taggable_redux.git

Copyright (c) 2010 geemus(Wesley Beary), released under the MIT license