Merge branch 'master' of github.com:jamiebclark/Taggable

Author: jamiebclark

README.md

@@ -0,0 +1,49 @@
+# Taggable
+Taggable is a Plugin for CakePHP 2.x to add tags to a model
+
+## Installation
+1. Add the GitHub repository to your CakePHP app's Plugin folder.
+2. Add the Plugin to your `bootstrap.php` file
+3. Using the cake console, create your Tag table by running: `cd APP_DIRECTORY; cake schema create --plugin=Taggable`
+
+## Usage
+### Taggable Behavior
+Use the Taggable Behavior for any model that you want to connect to the Taggable tags table:
+```
+class YourModel extends AppModel {
+  public $name = "YourModel";
+  public $actsAs = array('Taggable.Taggable');
+}
+```
+#### Filtering by Tags
+You can filter a model query by tags if the model is using the Taggable behavior by including a "tags" field in your query. 
+```
+$this->find('all', array(
+  'tags' => array('news', 'baseball'),
+));
+```
+### Tag Helper
+Use the Tag Helper to add and display tags in your model. Include the TagHelper in your Controller without any parameters:
+```
+...
+  public $helpers = array('Taggable.Tag');
+...
+```
+#### Adding Tags
+Include `$this->Tag->input("YourModel");` in your form. This will display a form to add new tags and remove existing tags.
+#### Displaying Tags
+```
+echo $this->Tag->tagList($result["YourModel"]);
+```
+Including a url in the options will make each tag a link:
+```
+echo $this->Tag->tagList($result["YourModel"], array(
+  'url' => array(
+    'controller' => 'your_models',
+    'action' => 'index',
+  )
+));
+```
+Each link will have `tag:TAG_NAME` appended to the url.
+
+Including the boolean value for `'x'` will add an "X" link to each tag, allowing you to remove them from the current url.