radiant-tags-extension

radiant-tags-extension copied to clipboard

= 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>