README

= Tags extension

Created by: Keith Bingman - keithbingman.com
Revived by: Benny Degezelle - gorilla-webdesign.be
New features by: Jim Gay - saturnflyer.com

This extension enhances the page model with tagging capabilities, tagging as in "2.0" and tagclouds.

== Requirements

This extension depends on the has_many_polymorphs plugin (included in vendor/plugins)
If you're still on Radiant pre-0.6.7, then the shards_extension should be installed and loaded first.
You can change the load order of extensions in config/environment.rb (see http://wiki.radiantcms.org/Using_the_Shards_Extension).

== Installation

=== Using RubyGems

`gem install radiant-tags-extension`

add the following line to your environment.rb
config.gem 'radiant-tags-extension'

=== Classic style

1. Copy the extension to your vendor/extensions directory as you would any other extension or use `script/extension install tags`
2. Run 'rake radiant:extensions:tags:install'
3. Make a page to sit in /search/by-tag, and give it the "Tag Search" pagetype.
	If you want to change this location, it's in Radiant::Config['tags.results_page_url'].

Done!
Here's a sample results page to get you started;
	
	<r:search:empty>
	  <h2>I couldn't find anything tagged with "<r:search:query/>".</h2>
	</r:search:empty>

	<r:search:results>
	  <h2>Found the following pages that are tagged with "<em><r:search:query/></em>".</h2>

	  <ul>
	  <r:search:results:each>
	    <li><r:link/> - <r:author/> - <r:date/></li>
	  </r:search:results:each>
	  </ul>
	</r:search:results>