danrye / silverstripe-tagfield

SilverStripe module for editing tags (both in the CMS and other forms)

TagField Module

Requirements

• SilverStripe 3.1 or newer
• Database: MySQL 5+, SQLite3, Postgres 8.3, SQL Server 2008

Download/Information

• http://silverstripe.org/tag-field-module

Usage

Relational Tags w/ Extension

class Tag extends DataObject {
    static $db = array(
        'Title' => 'Varchar(200)',
    );

    static $belongs_many_many = array(
    	'BlogPosts' => 'BlogPost'
    );
}

BlogPost:
  extensions:
    - TaggableExtension

Relational Tags

class BlogPost extends DataObject {
	static $many_many = array(
		'BlogTags' => 'BlogTag'
	);
}

class BlogTag extends DataObject {
	static $db = array(
		'Title' => 'Varchar(200)',
	);

	static $belongs_many_many = array(
		'BlogPosts' => 'BlogPost'
	);
}

$field = new TagField(
	'BlogTags', 'Blog Tags', BlogTags::get(), $post->BlogTags()
);

$field->setShouldLazyLoad(true); // tags should be lazy loaded
$field->setCanCreate(true);      // new tag DataObjects can be created

String Tags

class BlogPost extends DataObject {
	static $db = array(
		'Tags' => 'Text'
	);
}

$field = new StringTagField(
	'BlogTags', 'Blog Tags', array('one', 'two'), explode(',', $post->Tags)
);

$field->setShouldLazyLoad(true); // tags should be lazy loaded