70 lines
1.4 KiB
Markdown
70 lines
1.4 KiB
Markdown
# TagField Module
|
|
|
|
[](https://travis-ci.org/silverstripe-labs/silverstripe-tagfield)
|
|
[](https://scrutinizer-ci.com/g/silverstripe-labs/silverstripe-tagfield)
|
|
|
|
## 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
|
|
|
|
```php
|
|
class BlogPost extends DataObject {
|
|
private static $many_many = array(
|
|
'BlogTags' => 'BlogTag'
|
|
);
|
|
}
|
|
```
|
|
|
|
```php
|
|
class BlogTag extends DataObject {
|
|
private static $db = array(
|
|
'Title' => 'Varchar(200)',
|
|
);
|
|
|
|
private static $belongs_many_many = array(
|
|
'BlogPosts' => 'BlogPost'
|
|
);
|
|
}
|
|
```
|
|
|
|
```php
|
|
$field = TagField::create(
|
|
'BlogTags',
|
|
'Blog Tags',
|
|
BlogTag::get(),
|
|
$this->BlogTags()
|
|
)
|
|
->setShouldLazyLoad(true) // tags should be lazy loaded
|
|
->setCanCreate(true); // new tag DataObjects can be created
|
|
```
|
|
|
|
### String Tags
|
|
|
|
```php
|
|
class BlogPost extends DataObject {
|
|
private static $db = array(
|
|
'Tags' => 'Text'
|
|
);
|
|
}
|
|
```
|
|
|
|
```php
|
|
$field = StringTagField::create(
|
|
'Tags',
|
|
'Tags',
|
|
array('one', 'two'),
|
|
explode(',', $this->Tags)
|
|
);
|
|
|
|
$field->setShouldLazyLoad(true); // tags should be lazy loaded
|
|
```
|