silverstripe / silverstripe-tagfield

src/ReadonlyTagField.php

Indentation +21 added lines, -21 removed lines

@@ -12,29 +12,29 @@
  */
 class ReadonlyTagField extends TagField
 {
-    /**
-     * {@inheritDoc}
-     */
-    protected $readonly = true;
+	/**
+	 * {@inheritDoc}
+	 */
+	protected $readonly = true;
 
-    /**
-     * Render the readonly field as HTML.
-     *
-     * @param array $properties
-     * @return HTMLText
-     */
-    public function Field($properties = array())
-    {
-        $options = array();
+	/**
+	 * Render the readonly field as HTML.
+	 *
+	 * @param array $properties
+	 * @return HTMLText
+	 */
+	public function Field($properties = array())
+	{
+		$options = array();
 
-        foreach ($this->getOptions()->filter('Selected', true) as $option) {
-            $options[] = $option->Title;
-        }
+		foreach ($this->getOptions()->filter('Selected', true) as $option) {
+			$options[] = $option->Title;
+		}
 
-        $field = ReadonlyField::create($this->name . '_Readonly', $this->title);
+		$field = ReadonlyField::create($this->name . '_Readonly', $this->title);
 
-        $field->setForm($this->form);
-        $field->setValue(implode(', ', $options));
-        return $field->Field();
-    }
+		$field->setForm($this->form);
+		$field->setValue(implode(', ', $options));
+		return $field->Field();
+	}
 }

Spacing +1 added lines, -1 removed lines

@@ -31,7 +31,7 @@
             $options[] = $option->Title;
         }
 
-        $field = ReadonlyField::create($this->name . '_Readonly', $this->title);
+        $field = ReadonlyField::create($this->name.'_Readonly', $this->title);
 
         $field->setForm($this->form);
         $field->setValue(implode(', ', $options));

tests/Stub/StringTagFieldTestController.php

Indentation +14 added lines, -14 removed lines

@@ -12,21 +12,21 @@
 
 class StringTagFieldTestController extends Controller implements TestOnly
 {
-    public function StringTagFieldTestForm()
-    {
-        $fields = new FieldList(
-            $tagField = new StringTagField('Tags')
-        );
+	public function StringTagFieldTestForm()
+	{
+		$fields = new FieldList(
+			$tagField = new StringTagField('Tags')
+		);
 
-        $actions = new FieldList(
-            new FormAction('StringTagFieldTestFormSubmit')
-        );
+		$actions = new FieldList(
+			new FormAction('StringTagFieldTestFormSubmit')
+		);
 
-        return new Form($this, 'StringTagFieldTestForm', $fields, $actions);
-    }
+		return new Form($this, 'StringTagFieldTestForm', $fields, $actions);
+	}
 
-    public function StringTagFieldTestFormSubmit(DataObject $dataObject, Form $form)
-    {
-        $form->saveInto($dataObject);
-    }
+	public function StringTagFieldTestFormSubmit(DataObject $dataObject, Form $form)
+	{
+		$form->saveInto($dataObject);
+	}
 }

tests/Stub/TagFieldTestBlogPost.php

Indentation +8 added lines, -8 removed lines

@@ -8,14 +8,14 @@
 
 class TagFieldTestBlogPost extends DataObject implements TestOnly
 {
-    private static $table_name = 'TagFieldTestBlogPost';
+	private static $table_name = 'TagFieldTestBlogPost';
 
-    private static $db = [
-        'Title'   => 'Text',
-        'Content' => 'Text'
-    ];
+	private static $db = [
+		'Title'   => 'Text',
+		'Content' => 'Text'
+	];
 
-    private static $many_many = [
-        'Tags' => TagFieldTestBlogTag::class
-    ];
+	private static $many_many = [
+		'Tags' => TagFieldTestBlogTag::class
+	];
 }

tests/Stub/TagFieldTestController.php

Indentation +14 added lines, -14 removed lines

@@ -13,21 +13,21 @@
 
 class TagFieldTestController extends Controller implements TestOnly
 {
-    public function TagFieldTestForm()
-    {
-        $fields = new FieldList(
-            $tagField = new TagField('Tags', '', new DataList('TagFieldTestBlogTag'))
-        );
+	public function TagFieldTestForm()
+	{
+		$fields = new FieldList(
+			$tagField = new TagField('Tags', '', new DataList('TagFieldTestBlogTag'))
+		);
 
-        $actions = new FieldList(
-            new FormAction('TagFieldTestFormSubmit')
-        );
+		$actions = new FieldList(
+			new FormAction('TagFieldTestFormSubmit')
+		);
 
-        return new Form($this, 'TagFieldTestForm', $fields, $actions);
-    }
+		return new Form($this, 'TagFieldTestForm', $fields, $actions);
+	}
 
-    public function TagFieldTestFormSubmit(DataObject $dataObject, Form $form)
-    {
-        $form->saveInto($dataObject);
-    }
+	public function TagFieldTestFormSubmit(DataObject $dataObject, Form $form)
+	{
+		$form->saveInto($dataObject);
+	}
 }

tests/Stub/TagFieldTestBlogTag.php

Indentation +8 added lines, -8 removed lines

@@ -8,15 +8,15 @@
 
 class TagFieldTestBlogTag extends DataObject implements TestOnly
 {
-    private static $table_name = 'TagFieldTestBlogTag';
+	private static $table_name = 'TagFieldTestBlogTag';
 
-    private static $default_sort = '"TagFieldTestBlogTag"."ID" ASC';
+	private static $default_sort = '"TagFieldTestBlogTag"."ID" ASC';
 
-    private static $db = [
-        'Title' => 'Varchar(200)'
-    ];
+	private static $db = [
+		'Title' => 'Varchar(200)'
+	];
 
-    private static $belongs_many_many = [
-        'BlogPosts' => TagFieldTestBlogPost::class
-    ];
+	private static $belongs_many_many = [
+		'BlogPosts' => TagFieldTestBlogPost::class
+	];
 }

tests/Stub/StringTagFieldTestBlogPost.php

Indentation +6 added lines, -6 removed lines

@@ -7,11 +7,11 @@
 
 class StringTagFieldTestBlogPost extends DataObject implements TestOnly
 {
-    private static $table_name = 'StringTagFieldTestBlogPost';
+	private static $table_name = 'StringTagFieldTestBlogPost';
 
-    private static $db = [
-        'Title' => 'Text',
-        'Content' => 'Text',
-        'Tags' => 'Text',
-    ];
+	private static $db = [
+		'Title' => 'Text',
+		'Content' => 'Text',
+		'Tags' => 'Text',
+	];
 }

src/StringTagField.php

Spacing +1 added lines, -1 removed lines

@@ -161,7 +161,7 @@
         $schema = array_merge(
             parent::getSchemaDataDefaults(),
             [
-                'name' => $this->getName() . '[]',
+                'name' => $this->getName().'[]',
                 'lazyLoad' => $this->getShouldLazyLoad(),
                 'creatable' => $this->getCanCreate(),
                 'multi' => $this->getIsMultiple(),

Indentation +330 added lines, -330 removed lines

@@ -26,334 +26,334 @@
  */
 class StringTagField extends DropdownField
 {
-    /**
-     * @var array
-     */
-    private static $allowed_actions = [
-        'suggest',
-    ];
-
-    /**
-     * @var bool
-     */
-    protected $shouldLazyLoad = false;
-
-    /**
-     * @var int
-     */
-    protected $lazyLoadItemLimit = 10;
-
-    /**
-     * @var bool
-     */
-    protected $canCreate = true;
-
-    /**
-     * @var null|DataObject
-     */
-    protected $record;
-
-    /**
-     * @var bool
-     */
-    protected $isMultiple = true;
-
-    /**
-     * @return bool
-     */
-    public function getShouldLazyLoad()
-    {
-        return $this->shouldLazyLoad;
-    }
-
-    /**
-     * @param bool $shouldLazyLoad
-     * @return $this
-     */
-    public function setShouldLazyLoad($shouldLazyLoad)
-    {
-        $this->shouldLazyLoad = $shouldLazyLoad;
-
-        return $this;
-    }
-
-    /**
-     * @return int
-     */
-    public function getLazyLoadItemLimit()
-    {
-        return $this->lazyLoadItemLimit;
-    }
-
-    /**
-     * @param int $lazyLoadItemLimit
-     * @return $this
-     */
-    public function setLazyLoadItemLimit($lazyLoadItemLimit)
-    {
-        $this->lazyLoadItemLimit = $lazyLoadItemLimit;
-
-        return $this;
-    }
-
-    /**
-     * @return bool
-     */
-    public function getIsMultiple()
-    {
-        return $this->isMultiple;
-    }
-
-    /**
-     * @param bool $isMultiple
-     * @return $this
-     */
-    public function setIsMultiple($isMultiple)
-    {
-        $this->isMultiple = $isMultiple;
-
-        return $this;
-    }
-
-    /**
-     * @return null|DataObject
-     */
-    public function getRecord()
-    {
-        if ($this->record) {
-            return $this->record;
-        }
-
-        if ($form = $this->getForm()) {
-            return $form->getRecord();
-        }
-
-        return null;
-    }
-
-    /**
-     * @param DataObject $record
-     * @return $this
-     */
-    public function setRecord(DataObject $record)
-    {
-        $this->record = $record;
-
-        return $this;
-    }
-
-    public function Field($properties = [])
-    {
-        $this->addExtraClass('ss-tag-field');
-
-        return $this
-            ->customise($properties)
-            ->renderWith(TagField::class);
-    }
-
-    /**
-     * Provide TagField data to the JSON schema for the frontend component
-     *
-     * @return array
-     */
-    public function getSchemaDataDefaults()
-    {
-        $schema = array_merge(
-            parent::getSchemaDataDefaults(),
-            [
-                'name' => $this->getName() . '[]',
-                'lazyLoad' => $this->getShouldLazyLoad(),
-                'creatable' => $this->getCanCreate(),
-                'multi' => $this->getIsMultiple(),
-                'value' => $this->formatOptions($this->Value()),
-                'disabled' => $this->isDisabled() || $this->isReadonly(),
-            ]
-        );
-
-        if (!$this->getShouldLazyLoad()) {
-            $schema['options'] = $this->getOptions()->toNestedArray();
-        } else {
-            $schema['optionUrl'] = $this->getSuggestURL();
-        }
-
-        return $schema;
-    }
-
-    protected function formatOptions($fieldValue)
-    {
-        if (empty($fieldValue)) {
-            return [];
-        }
-
-        $formattedValue = [];
-        foreach ($fieldValue as $value) {
-            $formattedValue[] = [
-                'Title' => $value,
-                'Value' => $value,
-            ];
-        }
-        return $formattedValue;
-    }
-
-    /**
-     * When not used in a React form factory context, this adds the schema data to SilverStripe template
-     * rendered attributes lists
-     *
-     * @return array
-     */
-    public function getAttributes()
-    {
-        $attributes = parent::getAttributes();
-        $attributes['data-schema'] = json_encode($this->getSchemaData());
-        return $attributes;
-    }
-
-    /**
-     * @return string
-     */
-    protected function getSuggestURL()
-    {
-        return Controller::join_links($this->Link(), 'suggest');
-    }
-
-    /**
-     * @return ArrayList
-     */
-    protected function getOptions()
-    {
-        $options = ArrayList::create();
-
-        $source = $this->getSource();
-
-        if ($source instanceof Iterator) {
-            $source = iterator_to_array($source);
-        }
-
-        foreach ($source as $value) {
-            $options->push(
-                ArrayData::create([
-                    'Title' => $value,
-                    'Value' => $value,
-                ])
-            );
-        }
-
-        return $options;
-    }
-
-    public function setValue($value, $source = null)
-    {
-        if (is_string($value)) {
-            $value = explode(',', $value);
-        }
-
-        if ($source instanceof DataObject) {
-            $name = $this->getName();
-            $value = explode(',', $source->$name);
-        }
-
-        if ($source instanceof SS_List) {
-            $value = $source->column('ID');
-        }
-
-        if ($value === null) {
-            $value = [];
-        }
-
-        return parent::setValue(array_filter($value));
-    }
-
-    public function saveInto(DataObjectInterface $record)
-    {
-        parent::saveInto($record);
-
-        $name = $this->getName();
-
-        $record->$name = $this->dataValue();
-        $record->write();
-    }
-
-    /**
-     * Ensure that arrays are imploded before being saved
-     *
-     * @return mixed|string
-     */
-    public function dataValue()
-    {
-        return implode(',', $this->value);
-    }
-
-    /**
-     * Returns a JSON string of tags, for lazy loading.
-     *
-     * @param  HTTPRequest $request
-     * @return HTTPResponse
-     */
-    public function suggest(HTTPRequest $request)
-    {
-        $responseBody = json_encode(
-            ['items' => $this->getTags($request->getVar('term'))]
-        );
-
-        $response = HTTPResponse::create();
-        $response->addHeader('Content-Type', 'application/json');
-        $response->setBody($responseBody);
-
-        return $response;
-    }
-
-    /**
-     * Returns array of arrays representing tags that partially match the given search term
-     *
-     * @param string $term
-     * @return array
-     */
-    protected function getTags($term)
-    {
-        $items = [];
-        foreach ($this->getOptions() as $i => $tag) {
-            /** @var ArrayData $tag */
-            $tagValue = $tag->Value;
-            // Map into a distinct list (prevent duplicates)
-            if (stripos($tagValue, $term) !== false && !array_key_exists($tagValue, $items)) {
-                $items[$tagValue] = [
-                    'id' => $tag->Title,
-                    'text' => $tag->Value,
-                ];
-            }
-        }
-        // @todo do we actually need lazy loading limits for StringTagField?
-        return array_slice(array_values($items), 0, $this->getLazyLoadItemLimit());
-    }
-
-    /**
-     * DropdownField assumes value will be a scalar so we must
-     * override validate. This only applies to Silverstripe 3.2+
-     *
-     * @param Validator $validator
-     * @return bool
-     */
-    public function validate($validator)
-    {
-        return true;
-    }
-
-    /**
-     * @return bool
-     */
-    public function getCanCreate()
-    {
-        return $this->canCreate;
-    }
-
-    /**
-     * @param bool $canCreate
-     * @return $this
-     */
-    public function setCanCreate($canCreate)
-    {
-        $this->canCreate = $canCreate;
-
-        return $this;
-    }
+	/**
+	 * @var array
+	 */
+	private static $allowed_actions = [
+		'suggest',
+	];
+
+	/**
+	 * @var bool
+	 */
+	protected $shouldLazyLoad = false;
+
+	/**
+	 * @var int
+	 */
+	protected $lazyLoadItemLimit = 10;
+
+	/**
+	 * @var bool
+	 */
+	protected $canCreate = true;
+
+	/**
+	 * @var null|DataObject
+	 */
+	protected $record;
+
+	/**
+	 * @var bool
+	 */
+	protected $isMultiple = true;
+
+	/**
+	 * @return bool
+	 */
+	public function getShouldLazyLoad()
+	{
+		return $this->shouldLazyLoad;
+	}
+
+	/**
+	 * @param bool $shouldLazyLoad
+	 * @return $this
+	 */
+	public function setShouldLazyLoad($shouldLazyLoad)
+	{
+		$this->shouldLazyLoad = $shouldLazyLoad;
+
+		return $this;
+	}
+
+	/**
+	 * @return int
+	 */
+	public function getLazyLoadItemLimit()
+	{
+		return $this->lazyLoadItemLimit;
+	}
+
+	/**
+	 * @param int $lazyLoadItemLimit
+	 * @return $this
+	 */
+	public function setLazyLoadItemLimit($lazyLoadItemLimit)
+	{
+		$this->lazyLoadItemLimit = $lazyLoadItemLimit;
+
+		return $this;
+	}
+
+	/**
+	 * @return bool
+	 */
+	public function getIsMultiple()
+	{
+		return $this->isMultiple;
+	}
+
+	/**
+	 * @param bool $isMultiple
+	 * @return $this
+	 */
+	public function setIsMultiple($isMultiple)
+	{
+		$this->isMultiple = $isMultiple;
+
+		return $this;
+	}
+
+	/**
+	 * @return null|DataObject
+	 */
+	public function getRecord()
+	{
+		if ($this->record) {
+			return $this->record;
+		}
+
+		if ($form = $this->getForm()) {
+			return $form->getRecord();
+		}
+
+		return null;
+	}
+
+	/**
+	 * @param DataObject $record
+	 * @return $this
+	 */
+	public function setRecord(DataObject $record)
+	{
+		$this->record = $record;
+
+		return $this;
+	}
+
+	public function Field($properties = [])
+	{
+		$this->addExtraClass('ss-tag-field');
+
+		return $this
+			->customise($properties)
+			->renderWith(TagField::class);
+	}
+
+	/**
+	 * Provide TagField data to the JSON schema for the frontend component
+	 *
+	 * @return array
+	 */
+	public function getSchemaDataDefaults()
+	{
+		$schema = array_merge(
+			parent::getSchemaDataDefaults(),
+			[
+				'name' => $this->getName() . '[]',
+				'lazyLoad' => $this->getShouldLazyLoad(),
+				'creatable' => $this->getCanCreate(),
+				'multi' => $this->getIsMultiple(),
+				'value' => $this->formatOptions($this->Value()),
+				'disabled' => $this->isDisabled() || $this->isReadonly(),
+			]
+		);
+
+		if (!$this->getShouldLazyLoad()) {
+			$schema['options'] = $this->getOptions()->toNestedArray();
+		} else {
+			$schema['optionUrl'] = $this->getSuggestURL();
+		}
+
+		return $schema;
+	}
+
+	protected function formatOptions($fieldValue)
+	{
+		if (empty($fieldValue)) {
+			return [];
+		}
+
+		$formattedValue = [];
+		foreach ($fieldValue as $value) {
+			$formattedValue[] = [
+				'Title' => $value,
+				'Value' => $value,
+			];
+		}
+		return $formattedValue;
+	}
+
+	/**
+	 * When not used in a React form factory context, this adds the schema data to SilverStripe template
+	 * rendered attributes lists
+	 *
+	 * @return array
+	 */
+	public function getAttributes()
+	{
+		$attributes = parent::getAttributes();
+		$attributes['data-schema'] = json_encode($this->getSchemaData());
+		return $attributes;
+	}
+
+	/**
+	 * @return string
+	 */
+	protected function getSuggestURL()
+	{
+		return Controller::join_links($this->Link(), 'suggest');
+	}
+
+	/**
+	 * @return ArrayList
+	 */
+	protected function getOptions()
+	{
+		$options = ArrayList::create();
+
+		$source = $this->getSource();
+
+		if ($source instanceof Iterator) {
+			$source = iterator_to_array($source);
+		}
+
+		foreach ($source as $value) {
+			$options->push(
+				ArrayData::create([
+					'Title' => $value,
+					'Value' => $value,
+				])
+			);
+		}
+
+		return $options;
+	}
+
+	public function setValue($value, $source = null)
+	{
+		if (is_string($value)) {
+			$value = explode(',', $value);
+		}
+
+		if ($source instanceof DataObject) {
+			$name = $this->getName();
+			$value = explode(',', $source->$name);
+		}
+
+		if ($source instanceof SS_List) {
+			$value = $source->column('ID');
+		}
+
+		if ($value === null) {
+			$value = [];
+		}
+
+		return parent::setValue(array_filter($value));
+	}
+
+	public function saveInto(DataObjectInterface $record)
+	{
+		parent::saveInto($record);
+
+		$name = $this->getName();
+
+		$record->$name = $this->dataValue();
+		$record->write();
+	}
+
+	/**
+	 * Ensure that arrays are imploded before being saved
+	 *
+	 * @return mixed|string
+	 */
+	public function dataValue()
+	{
+		return implode(',', $this->value);
+	}
+
+	/**
+	 * Returns a JSON string of tags, for lazy loading.
+	 *
+	 * @param  HTTPRequest $request
+	 * @return HTTPResponse
+	 */
+	public function suggest(HTTPRequest $request)
+	{
+		$responseBody = json_encode(
+			['items' => $this->getTags($request->getVar('term'))]
+		);
+
+		$response = HTTPResponse::create();
+		$response->addHeader('Content-Type', 'application/json');
+		$response->setBody($responseBody);
+
+		return $response;
+	}
+
+	/**
+	 * Returns array of arrays representing tags that partially match the given search term
+	 *
+	 * @param string $term
+	 * @return array
+	 */
+	protected function getTags($term)
+	{
+		$items = [];
+		foreach ($this->getOptions() as $i => $tag) {
+			/** @var ArrayData $tag */
+			$tagValue = $tag->Value;
+			// Map into a distinct list (prevent duplicates)
+			if (stripos($tagValue, $term) !== false && !array_key_exists($tagValue, $items)) {
+				$items[$tagValue] = [
+					'id' => $tag->Title,
+					'text' => $tag->Value,
+				];
+			}
+		}
+		// @todo do we actually need lazy loading limits for StringTagField?
+		return array_slice(array_values($items), 0, $this->getLazyLoadItemLimit());
+	}
+
+	/**
+	 * DropdownField assumes value will be a scalar so we must
+	 * override validate. This only applies to Silverstripe 3.2+
+	 *
+	 * @param Validator $validator
+	 * @return bool
+	 */
+	public function validate($validator)
+	{
+		return true;
+	}
+
+	/**
+	 * @return bool
+	 */
+	public function getCanCreate()
+	{
+		return $this->canCreate;
+	}
+
+	/**
+	 * @param bool $canCreate
+	 * @return $this
+	 */
+	public function setCanCreate($canCreate)
+	{
+		$this->canCreate = $canCreate;
+
+		return $this;
+	}
 }

tests/StringTagFieldTest.php

Indentation +140 added lines, -140 removed lines

@@ -15,144 +15,144 @@
  */
 class StringTagFieldTest extends SapphireTest
 {
-    /**
-     * @var string
-     */
-    protected static $fixture_file = 'StringTagFieldTest.yml';
-
-    /**
-     * @var array
-     */
-    protected static $extra_dataobjects = [
-        StringTagFieldTestBlogPost::class,
-    ];
-
-    public function testItSavesTagsOnNewRecords()
-    {
-        $record = $this->getNewStringTagFieldTestBlogPost('BlogPost1');
-
-        $field = new StringTagField('Tags');
-        $field->setValue(['Tag1', 'Tag2']);
-        $field->saveInto($record);
-
-        $record->write();
-
-        $this->assertEquals('Tag1,Tag2', $record->Tags);
-    }
-
-    /**
-     * @param string $name
-     *
-     * @return StringTagFieldTestBlogPost
-     */
-    protected function getNewStringTagFieldTestBlogPost($name)
-    {
-        return $this->objFromFixture(
-            StringTagFieldTestBlogPost::class,
-            $name
-        );
-    }
-
-    public function testItSavesTagsOnExistingRecords()
-    {
-        $record = $this->getNewStringTagFieldTestBlogPost('BlogPost1');
-        $record->write();
-
-        $field = new StringTagField('Tags');
-        $field->setValue(['Tag1', 'Tag2']);
-        $field->saveInto($record);
-
-        $this->assertEquals('Tag1,Tag2', $record->Tags);
-    }
-
-    public function testItSuggestsTags()
-    {
-        $field = new StringTagField('SomeField', 'Some field', ['Tag1', 'Tag2'], []);
-
-        /**
-         * Partial tag title match.
-         */
-        $request = $this->getNewRequest(['term' => 'Tag']);
-
-        $this->assertEquals(
-            '{"items":[{"id":"Tag1","text":"Tag1"},{"id":"Tag2","text":"Tag2"}]}',
-            $field->suggest($request)->getBody()
-        );
-
-        /**
-         * Exact tag title match.
-         */
-        $request = $this->getNewRequest(['term' => 'Tag1']);
-
-        $this->assertEquals($field->suggest($request)->getBody(), '{"items":[{"id":"Tag1","text":"Tag1"}]}');
-
-        /**
-         * Case-insensitive tag title match.
-         */
-        $request = $this->getNewRequest(['term' => 'TAG1']);
-
-        $this->assertEquals(
-            '{"items":[{"id":"Tag1","text":"Tag1"}]}',
-            $field->suggest($request)->getBody()
-        );
-
-        /**
-         * No tag title match.
-         */
-        $request = $this->getNewRequest(['term' => 'unknown']);
-
-        $this->assertEquals(
-            '{"items":[]}',
-            $field->suggest($request)->getBody()
-        );
-    }
-
-    public function testGetSchemaDataDefaults()
-    {
-        $form = new Form(null, 'Form', new FieldList(), new FieldList());
-        $field = new StringTagField('TestField', 'Test Field', ['one', 'two']);
-        $field->setForm($form);
-
-        $field
-            ->setShouldLazyLoad(false)
-            ->setCanCreate(false);
-
-        $schema = $field->getSchemaDataDefaults();
-        $this->assertSame('TestField[]', $schema['name']);
-        $this->assertFalse($schema['lazyLoad']);
-        $this->assertFalse($schema['creatable']);
-        $this->assertEquals([
-            ['Title' => 'one', 'Value' => 'one'],
-            ['Title' => 'two', 'Value' => 'two'],
-        ], $schema['options']);
-
-        $field
-            ->setShouldLazyLoad(true)
-            ->setCanCreate(true);
-
-        $schema = $field->getSchemaDataDefaults();
-        $this->assertTrue($schema['lazyLoad']);
-        $this->assertTrue($schema['creatable']);
-        $this->assertContains('suggest', $schema['optionUrl']);
-    }
-
-    public function testSchemaIsAddedToAttributes()
-    {
-        $field = new StringTagField('TestField');
-        $attributes = $field->getAttributes();
-        $this->assertNotEmpty($attributes['data-schema']);
-    }
-
-    /**
-     * @param array $parameters
-     * @return HTTPRequest
-     */
-    protected function getNewRequest(array $parameters)
-    {
-        return new HTTPRequest(
-            'get',
-            'StringTagFieldTestController/StringTagFieldTestForm/fields/Tags/suggest',
-            $parameters
-        );
-    }
+	/**
+	 * @var string
+	 */
+	protected static $fixture_file = 'StringTagFieldTest.yml';
+
+	/**
+	 * @var array
+	 */
+	protected static $extra_dataobjects = [
+		StringTagFieldTestBlogPost::class,
+	];
+
+	public function testItSavesTagsOnNewRecords()
+	{
+		$record = $this->getNewStringTagFieldTestBlogPost('BlogPost1');
+
+		$field = new StringTagField('Tags');
+		$field->setValue(['Tag1', 'Tag2']);
+		$field->saveInto($record);
+
+		$record->write();
+
+		$this->assertEquals('Tag1,Tag2', $record->Tags);
+	}
+
+	/**
+	 * @param string $name
+	 *
+	 * @return StringTagFieldTestBlogPost
+	 */
+	protected function getNewStringTagFieldTestBlogPost($name)
+	{
+		return $this->objFromFixture(
+			StringTagFieldTestBlogPost::class,
+			$name
+		);
+	}
+
+	public function testItSavesTagsOnExistingRecords()
+	{
+		$record = $this->getNewStringTagFieldTestBlogPost('BlogPost1');
+		$record->write();
+
+		$field = new StringTagField('Tags');
+		$field->setValue(['Tag1', 'Tag2']);
+		$field->saveInto($record);
+
+		$this->assertEquals('Tag1,Tag2', $record->Tags);
+	}
+
+	public function testItSuggestsTags()
+	{
+		$field = new StringTagField('SomeField', 'Some field', ['Tag1', 'Tag2'], []);
+
+		/**
+		 * Partial tag title match.
+		 */
+		$request = $this->getNewRequest(['term' => 'Tag']);
+
+		$this->assertEquals(
+			'{"items":[{"id":"Tag1","text":"Tag1"},{"id":"Tag2","text":"Tag2"}]}',
+			$field->suggest($request)->getBody()
+		);
+
+		/**
+		 * Exact tag title match.
+		 */
+		$request = $this->getNewRequest(['term' => 'Tag1']);
+
+		$this->assertEquals($field->suggest($request)->getBody(), '{"items":[{"id":"Tag1","text":"Tag1"}]}');
+
+		/**
+		 * Case-insensitive tag title match.
+		 */
+		$request = $this->getNewRequest(['term' => 'TAG1']);
+
+		$this->assertEquals(
+			'{"items":[{"id":"Tag1","text":"Tag1"}]}',
+			$field->suggest($request)->getBody()
+		);
+
+		/**
+		 * No tag title match.
+		 */
+		$request = $this->getNewRequest(['term' => 'unknown']);
+
+		$this->assertEquals(
+			'{"items":[]}',
+			$field->suggest($request)->getBody()
+		);
+	}
+
+	public function testGetSchemaDataDefaults()
+	{
+		$form = new Form(null, 'Form', new FieldList(), new FieldList());
+		$field = new StringTagField('TestField', 'Test Field', ['one', 'two']);
+		$field->setForm($form);
+
+		$field
+			->setShouldLazyLoad(false)
+			->setCanCreate(false);
+
+		$schema = $field->getSchemaDataDefaults();
+		$this->assertSame('TestField[]', $schema['name']);
+		$this->assertFalse($schema['lazyLoad']);
+		$this->assertFalse($schema['creatable']);
+		$this->assertEquals([
+			['Title' => 'one', 'Value' => 'one'],
+			['Title' => 'two', 'Value' => 'two'],
+		], $schema['options']);
+
+		$field
+			->setShouldLazyLoad(true)
+			->setCanCreate(true);
+
+		$schema = $field->getSchemaDataDefaults();
+		$this->assertTrue($schema['lazyLoad']);
+		$this->assertTrue($schema['creatable']);
+		$this->assertContains('suggest', $schema['optionUrl']);
+	}
+
+	public function testSchemaIsAddedToAttributes()
+	{
+		$field = new StringTagField('TestField');
+		$attributes = $field->getAttributes();
+		$this->assertNotEmpty($attributes['data-schema']);
+	}
+
+	/**
+	 * @param array $parameters
+	 * @return HTTPRequest
+	 */
+	protected function getNewRequest(array $parameters)
+	{
+		return new HTTPRequest(
+			'get',
+			'StringTagFieldTestController/StringTagFieldTestForm/fields/Tags/suggest',
+			$parameters
+		);
+	}
 }

src/TagField.php

Spacing +4 added lines, -4 removed lines

@@ -220,7 +220,7 @@ 
         $schema = array_merge(
             parent::getSchemaDataDefaults(),
             [
-                'name' => $this->getName() . '[]',
+                'name' => $this->getName().'[]',
                 'lazyLoad' => $this->getShouldLazyLoad(),
                 'creatable' => $this->getCanCreate(),
                 'multi' => $this->getIsMultiple(),
@@ -277,7 +277,7 @@ 
         }
 
         // Prep a function to parse a dataobject into an option
-        $addOption = function (DataObject $item) use ($options, $values) {
+        $addOption = function(DataObject $item) use ($options, $values) {
             $titleField = $this->getTitleField();
             $option = $item->$titleField;
             $options->push(ArrayData::create([
@@ -325,7 +325,7 @@ 
         return array_merge(
             parent::getAttributes(),
             [
-                'name' => $this->getName() . '[]',
+                'name' => $this->getName().'[]',
                 'style' => 'width: 100%',
                 'data-schema' => json_encode($this->getSchemaData()),
             ]
@@ -437,7 +437,7 @@ 
         $titleField = $this->getTitleField();
 
         $query = $source
-            ->filter($titleField . ':PartialMatch:nocase', $term)
+            ->filter($titleField.':PartialMatch:nocase', $term)
             ->sort($titleField)
             ->limit($this->getLazyLoadItemLimit());
 

Indentation +525 added lines, -525 removed lines

@@ -26,529 +26,529 @@
  */
 class TagField extends MultiSelectField
 {
-    /**
-     * @var array
-     */
-    private static $allowed_actions = [
-        'suggest',
-    ];
-
-    /**
-     * @var bool
-     */
-    protected $shouldLazyLoad = false;
-
-    /**
-     * @var int
-     */
-    protected $lazyLoadItemLimit = 10;
-
-    /**
-     * @var bool
-     */
-    protected $canCreate = true;
-
-    /**
-     * @var string
-     */
-    protected $titleField = 'Title';
-
-    /**
-     * @var DataList
-     */
-    protected $sourceList;
-
-    /**
-     * @var bool
-     */
-    protected $isMultiple = true;
-
-    /** @skipUpgrade */
-    protected $schemaComponent = 'TagField';
-
-    /**
-     * @param string $name
-     * @param string $title
-     * @param null|DataList|array $source
-     * @param null|DataList $value
-     * @param string $titleField
-     */
-    public function __construct($name, $title = '', $source = [], $value = null, $titleField = 'Title')
-    {
-        $this->setTitleField($titleField);
-        parent::__construct($name, $title, $source, $value);
-
-        $this->addExtraClass('ss-tag-field');
-    }
-
-    /**
-     * @return bool
-     */
-    public function getShouldLazyLoad()
-    {
-        return $this->shouldLazyLoad;
-    }
-
-    /**
-     * @param bool $shouldLazyLoad
-     *
-     * @return static
-     */
-    public function setShouldLazyLoad($shouldLazyLoad)
-    {
-        $this->shouldLazyLoad = $shouldLazyLoad;
-
-        return $this;
-    }
-
-    /**
-     * @return int
-     */
-    public function getLazyLoadItemLimit()
-    {
-        return $this->lazyLoadItemLimit;
-    }
-
-    /**
-     * @param int $lazyLoadItemLimit
-     *
-     * @return static
-     */
-    public function setLazyLoadItemLimit($lazyLoadItemLimit)
-    {
-        $this->lazyLoadItemLimit = $lazyLoadItemLimit;
-
-        return $this;
-    }
-
-    /**
-     * @return bool
-     */
-    public function getIsMultiple()
-    {
-        return $this->isMultiple;
-    }
-
-    /**
-     * @param bool $isMultiple
-     *
-     * @return static
-     */
-    public function setIsMultiple($isMultiple)
-    {
-        $this->isMultiple = $isMultiple;
-
-        return $this;
-    }
-
-    /**
-     * @return bool
-     */
-    public function getCanCreate()
-    {
-        return $this->canCreate;
-    }
-
-    /**
-     * @param bool $canCreate
-     *
-     * @return static
-     */
-    public function setCanCreate($canCreate)
-    {
-        $this->canCreate = $canCreate;
-
-        return $this;
-    }
-
-    /**
-     * @return string
-     */
-    public function getTitleField()
-    {
-        return $this->titleField;
-    }
-
-    /**
-     * @param string $titleField
-     *
-     * @return $this
-     */
-    public function setTitleField($titleField)
-    {
-        $this->titleField = $titleField;
-
-        return $this;
-    }
-
-    /**
-     * Get the DataList source. The 4.x upgrade for SelectField::setSource starts to convert this to an array.
-     * If empty use getSource() for array version
-     *
-     * @return DataList
-     */
-    public function getSourceList()
-    {
-        return $this->sourceList;
-    }
-
-    /**
-     * Set the model class name for tags
-     *
-     * @param DataList $sourceList
-     * @return self
-     */
-    public function setSourceList($sourceList)
-    {
-        $this->sourceList = $sourceList;
-        return $this;
-    }
-
-    /**
-     * {@inheritdoc}
-     */
-    public function Field($properties = [])
-    {
-        $this->addExtraClass('entwine');
-
-        return $this->customise($properties)->renderWith(self::class);
-    }
-
-    /**
-     * Provide TagField data to the JSON schema for the frontend component
-     *
-     * @return array
-     */
-    public function getSchemaDataDefaults()
-    {
-        $options = $this->getOptions(true);
-        $schema = array_merge(
-            parent::getSchemaDataDefaults(),
-            [
-                'name' => $this->getName() . '[]',
-                'lazyLoad' => $this->getShouldLazyLoad(),
-                'creatable' => $this->getCanCreate(),
-                'multi' => $this->getIsMultiple(),
-                'value' => $options->count() ? $options->toNestedArray() : null,
-                'disabled' => $this->isDisabled() || $this->isReadonly(),
-            ]
-        );
-
-        if (!$this->getShouldLazyLoad()) {
-            $schema['options'] = array_values($this->getOptions()->toNestedArray());
-        } else {
-            $schema['optionUrl'] = $this->getSuggestURL();
-        }
-
-        return $schema;
-    }
-
-    /**
-     * @return string
-     */
-    protected function getSuggestURL()
-    {
-        return Controller::join_links($this->Link(), 'suggest');
-    }
-
-    /**
-     * @return ArrayList
-     */
-    protected function getOptions($onlySelected = false)
-    {
-        $options = ArrayList::create();
-        $source = $this->getSourceList();
-
-        // No source means we have no options
-        if (!$source) {
-            return ArrayList::create();
-        }
-
-        $dataClass = $source->dataClass();
-
-        $values = $this->Value();
-
-        // If we have no values and we only want selected options we can bail here
-        if (empty($values) && $onlySelected) {
-            return ArrayList::create();
-        }
-
-        // Convert an array of values into a datalist of options
-        if (is_array($values) && !empty($values)) {
-            $values = DataList::create($dataClass)
-                ->filter($this->getTitleField(), $values);
-        } else {
-            $values = ArrayList::create();
-        }
-
-        // Prep a function to parse a dataobject into an option
-        $addOption = function (DataObject $item) use ($options, $values) {
-            $titleField = $this->getTitleField();
-            $option = $item->$titleField;
-            $options->push(ArrayData::create([
-                'Title' => $option,
-                'Value' => $option,
-                'Selected' => (bool) $values->find('ID', $item->ID)
-            ]));
-        };
-
-        // Only parse the values if we only want the selected items in the values list (this is for lazy-loading)
-        if ($onlySelected) {
-            $values->each($addOption);
-            return $options;
-        }
-
-        $source->each($addOption);
-        return $options;
-    }
-
-    /**
-     * {@inheritdoc}
-     */
-    public function setValue($value, $source = null)
-    {
-        if ($source instanceof DataObject) {
-            $name = $this->getName();
-
-            if ($source->hasMethod($name)) {
-                $value = $source->$name()->column($this->getTitleField());
-            }
-        }
-
-        if (!is_array($value)) {
-            return parent::setValue($value);
-        }
-
-        return parent::setValue(array_filter($value));
-    }
-
-    /**
-     * Gets the source array if required
-     *
-     * Note: this is expensive for a SS_List
-     *
-     * @return array
-     */
-    public function getSource()
-    {
-        if (is_null($this->source)) {
-            $this->source = $this->getListMap($this->getSourceList());
-        }
-        return $this->source;
-    }
-
-    /**
-     * Intercept DataList source
-     *
-     * @param mixed $source
-     * @return $this
-     */
-    public function setSource($source)
-    {
-        // When setting a datalist force internal list to null
-        if ($source instanceof DataList) {
-            $this->source = null;
-            $this->setSourceList($source);
-        } else {
-            parent::setSource($source);
-        }
-        return $this;
-    }
-
-    /**
-     * @param DataObject|DataObjectInterface $record DataObject to save data into
-     * @throws Exception
-     */
-    public function getAttributes()
-    {
-        return array_merge(
-            parent::getAttributes(),
-            [
-                'name' => $this->getName() . '[]',
-                'style' => 'width: 100%',
-                'data-schema' => json_encode($this->getSchemaData()),
-            ]
-        );
-    }
-
-    /**
-     * {@inheritdoc}
-     */
-    public function saveInto(DataObjectInterface $record)
-    {
-        $name = $this->getName();
-        $titleField = $this->getTitleField();
-        $values = $this->Value();
-
-        /** @var Relation $relation */
-        $relation = $record->$name();
-        $ids = [];
-
-        if (!$values) {
-            $values = [];
-        }
-
-        if (empty($record) || empty($titleField)) {
-            return;
-        }
-
-        if (!$record->hasMethod($name)) {
-            throw new Exception(
-                sprintf("%s does not have a %s method", get_class($record), $name)
-            );
-        }
-
-        foreach ($values as $key => $value) {
-            // Get or create record
-            $record = $this->getOrCreateTag($value);
-            if ($record) {
-                $ids[] = $record->ID;
-                $values[$key] = $record->Title;
-            }
-        }
-
-        $relation->setByIDList(array_filter($ids));
-    }
-
-    /**
-     * Get or create tag with the given value
-     *
-     * @param  string $term
-     * @return DataObject|bool
-     */
-    protected function getOrCreateTag($term)
-    {
-        // Check if existing record can be found
-        $source = $this->getSourceList();
-        if (!$source) {
-            return false;
-        }
-
-        $titleField = $this->getTitleField();
-        $record = $source
-            ->filter($titleField, $term)
-            ->first();
-        if ($record) {
-            return $record;
-        }
-
-        // Create new instance if not yet saved
-        if ($this->getCanCreate()) {
-            $dataClass = $source->dataClass();
-            $record = Injector::inst()->create($dataClass);
-
-            if (is_array($term)) {
-                $term = $term['Value'];
-            }
-
-            $record->{$titleField} = $term;
-            $record->write();
-            if ($source instanceof SS_List) {
-                $source->add($record);
-            }
-            return $record;
-        }
-
-        return false;
-    }
-
-    /**
-     * Returns a JSON string of tags, for lazy loading.
-     *
-     * @param  HTTPRequest $request
-     * @return HTTPResponse
-     */
-    public function suggest(HTTPRequest $request)
-    {
-        $tags = $this->getTags($request->getVar('term'));
-
-        $response = HTTPResponse::create();
-        $response->addHeader('Content-Type', 'application/json');
-        $response->setBody(json_encode(['items' => $tags]));
-
-        return $response;
-    }
-
-    /**
-     * Returns array of arrays representing tags.
-     *
-     * @param  string $term
-     * @return array
-     */
-    protected function getTags($term)
-    {
-        $source = $this->getSourceList();
-        if (!$source) {
-            return [];
-        }
-
-        $titleField = $this->getTitleField();
-
-        $query = $source
-            ->filter($titleField . ':PartialMatch:nocase', $term)
-            ->sort($titleField)
-            ->limit($this->getLazyLoadItemLimit());
-
-        // Map into a distinct list
-        $items = [];
-        $titleField = $this->getTitleField();
-        foreach ($query->map('ID', $titleField) as $id => $title) {
-            $items[$title] = [
-                'Title' => $title,
-                'Value' => $title,
-            ];
-        }
-
-        return array_values($items);
-    }
-
-    /**
-     * DropdownField assumes value will be a scalar so we must
-     * override validate. This only applies to Silverstripe 3.2+
-     *
-     * @param Validator $validator
-     * @return bool
-     */
-    public function validate($validator)
-    {
-        return true;
-    }
-
-    /**
-     * Converts the field to a readonly variant.
-     *
-     * @return ReadonlyTagField
-     */
-    public function performReadonlyTransformation()
-    {
-        /** @var ReadonlyTagField $copy */
-        $copy = $this->castedCopy(ReadonlyTagField::class);
-        $copy->setSourceList($this->getSourceList());
-        return $copy;
-    }
-
-    /**
-     * Prevent the default, which would return "tag"
-     *
-     * @return string
-     */
-    public function Type()
-    {
-        return '';
-    }
-
-    public function getSchemaStateDefaults()
-    {
-        $data = parent::getSchemaStateDefaults();
-
-        // Add options to 'data'
-        $data['lazyLoad'] = $this->getShouldLazyLoad();
-        $data['multi'] = $this->getIsMultiple();
-        $data['optionUrl'] = $this->getSuggestURL();
-        $data['creatable'] = $this->getCanCreate();
-        $options = $this->getOptions(true);
-        $data['value'] = $options->count() ? $options->toNestedArray() : null;
-
-        return $data;
-    }
+	/**
+	 * @var array
+	 */
+	private static $allowed_actions = [
+		'suggest',
+	];
+
+	/**
+	 * @var bool
+	 */
+	protected $shouldLazyLoad = false;
+
+	/**
+	 * @var int
+	 */
+	protected $lazyLoadItemLimit = 10;
+
+	/**
+	 * @var bool
+	 */
+	protected $canCreate = true;
+
+	/**
+	 * @var string
+	 */
+	protected $titleField = 'Title';
+
+	/**
+	 * @var DataList
+	 */
+	protected $sourceList;
+
+	/**
+	 * @var bool
+	 */
+	protected $isMultiple = true;
+
+	/** @skipUpgrade */
+	protected $schemaComponent = 'TagField';
+
+	/**
+	 * @param string $name
+	 * @param string $title
+	 * @param null|DataList|array $source
+	 * @param null|DataList $value
+	 * @param string $titleField
+	 */
+	public function __construct($name, $title = '', $source = [], $value = null, $titleField = 'Title')
+	{
+		$this->setTitleField($titleField);
+		parent::__construct($name, $title, $source, $value);
+
+		$this->addExtraClass('ss-tag-field');
+	}
+
+	/**
+	 * @return bool
+	 */
+	public function getShouldLazyLoad()
+	{
+		return $this->shouldLazyLoad;
+	}
+
+	/**
+	 * @param bool $shouldLazyLoad
+	 *
+	 * @return static
+	 */
+	public function setShouldLazyLoad($shouldLazyLoad)
+	{
+		$this->shouldLazyLoad = $shouldLazyLoad;
+
+		return $this;
+	}
+
+	/**
+	 * @return int
+	 */
+	public function getLazyLoadItemLimit()
+	{
+		return $this->lazyLoadItemLimit;
+	}
+
+	/**
+	 * @param int $lazyLoadItemLimit
+	 *
+	 * @return static
+	 */
+	public function setLazyLoadItemLimit($lazyLoadItemLimit)
+	{
+		$this->lazyLoadItemLimit = $lazyLoadItemLimit;
+
+		return $this;
+	}
+
+	/**
+	 * @return bool
+	 */
+	public function getIsMultiple()
+	{
+		return $this->isMultiple;
+	}
+
+	/**
+	 * @param bool $isMultiple
+	 *
+	 * @return static
+	 */
+	public function setIsMultiple($isMultiple)
+	{
+		$this->isMultiple = $isMultiple;
+
+		return $this;
+	}
+
+	/**
+	 * @return bool
+	 */
+	public function getCanCreate()
+	{
+		return $this->canCreate;
+	}
+
+	/**
+	 * @param bool $canCreate
+	 *
+	 * @return static
+	 */
+	public function setCanCreate($canCreate)
+	{
+		$this->canCreate = $canCreate;
+
+		return $this;
+	}
+
+	/**
+	 * @return string
+	 */
+	public function getTitleField()
+	{
+		return $this->titleField;
+	}
+
+	/**
+	 * @param string $titleField
+	 *
+	 * @return $this
+	 */
+	public function setTitleField($titleField)
+	{
+		$this->titleField = $titleField;
+
+		return $this;
+	}
+
+	/**
+	 * Get the DataList source. The 4.x upgrade for SelectField::setSource starts to convert this to an array.
+	 * If empty use getSource() for array version
+	 *
+	 * @return DataList
+	 */
+	public function getSourceList()
+	{
+		return $this->sourceList;
+	}
+
+	/**
+	 * Set the model class name for tags
+	 *
+	 * @param DataList $sourceList
+	 * @return self
+	 */
+	public function setSourceList($sourceList)
+	{
+		$this->sourceList = $sourceList;
+		return $this;
+	}
+
+	/**
+	 * {@inheritdoc}
+	 */
+	public function Field($properties = [])
+	{
+		$this->addExtraClass('entwine');
+
+		return $this->customise($properties)->renderWith(self::class);
+	}
+
+	/**
+	 * Provide TagField data to the JSON schema for the frontend component
+	 *
+	 * @return array
+	 */
+	public function getSchemaDataDefaults()
+	{
+		$options = $this->getOptions(true);
+		$schema = array_merge(
+			parent::getSchemaDataDefaults(),
+			[
+				'name' => $this->getName() . '[]',
+				'lazyLoad' => $this->getShouldLazyLoad(),
+				'creatable' => $this->getCanCreate(),
+				'multi' => $this->getIsMultiple(),
+				'value' => $options->count() ? $options->toNestedArray() : null,
+				'disabled' => $this->isDisabled() || $this->isReadonly(),
+			]
+		);
+
+		if (!$this->getShouldLazyLoad()) {
+			$schema['options'] = array_values($this->getOptions()->toNestedArray());
+		} else {
+			$schema['optionUrl'] = $this->getSuggestURL();
+		}
+
+		return $schema;
+	}
+
+	/**
+	 * @return string
+	 */
+	protected function getSuggestURL()
+	{
+		return Controller::join_links($this->Link(), 'suggest');
+	}
+
+	/**
+	 * @return ArrayList
+	 */
+	protected function getOptions($onlySelected = false)
+	{
+		$options = ArrayList::create();
+		$source = $this->getSourceList();
+
+		// No source means we have no options
+		if (!$source) {
+			return ArrayList::create();
+		}
+
+		$dataClass = $source->dataClass();
+
+		$values = $this->Value();
+
+		// If we have no values and we only want selected options we can bail here
+		if (empty($values) && $onlySelected) {
+			return ArrayList::create();
+		}
+
+		// Convert an array of values into a datalist of options
+		if (is_array($values) && !empty($values)) {
+			$values = DataList::create($dataClass)
+				->filter($this->getTitleField(), $values);
+		} else {
+			$values = ArrayList::create();
+		}
+
+		// Prep a function to parse a dataobject into an option
+		$addOption = function (DataObject $item) use ($options, $values) {
+			$titleField = $this->getTitleField();
+			$option = $item->$titleField;
+			$options->push(ArrayData::create([
+				'Title' => $option,
+				'Value' => $option,
+				'Selected' => (bool) $values->find('ID', $item->ID)
+			]));
+		};
+
+		// Only parse the values if we only want the selected items in the values list (this is for lazy-loading)
+		if ($onlySelected) {
+			$values->each($addOption);
+			return $options;
+		}
+
+		$source->each($addOption);
+		return $options;
+	}
+
+	/**
+	 * {@inheritdoc}
+	 */
+	public function setValue($value, $source = null)
+	{
+		if ($source instanceof DataObject) {
+			$name = $this->getName();
+
+			if ($source->hasMethod($name)) {
+				$value = $source->$name()->column($this->getTitleField());
+			}
+		}
+
+		if (!is_array($value)) {
+			return parent::setValue($value);
+		}
+
+		return parent::setValue(array_filter($value));
+	}
+
+	/**
+	 * Gets the source array if required
+	 *
+	 * Note: this is expensive for a SS_List
+	 *
+	 * @return array
+	 */
+	public function getSource()
+	{
+		if (is_null($this->source)) {
+			$this->source = $this->getListMap($this->getSourceList());
+		}
+		return $this->source;
+	}
+
+	/**
+	 * Intercept DataList source
+	 *
+	 * @param mixed $source
+	 * @return $this
+	 */
+	public function setSource($source)
+	{
+		// When setting a datalist force internal list to null
+		if ($source instanceof DataList) {
+			$this->source = null;
+			$this->setSourceList($source);
+		} else {
+			parent::setSource($source);
+		}
+		return $this;
+	}
+
+	/**
+	 * @param DataObject|DataObjectInterface $record DataObject to save data into
+	 * @throws Exception
+	 */
+	public function getAttributes()
+	{
+		return array_merge(
+			parent::getAttributes(),
+			[
+				'name' => $this->getName() . '[]',
+				'style' => 'width: 100%',
+				'data-schema' => json_encode($this->getSchemaData()),
+			]
+		);
+	}
+
+	/**
+	 * {@inheritdoc}
+	 */
+	public function saveInto(DataObjectInterface $record)
+	{
+		$name = $this->getName();
+		$titleField = $this->getTitleField();
+		$values = $this->Value();
+
+		/** @var Relation $relation */
+		$relation = $record->$name();
+		$ids = [];
+
+		if (!$values) {
+			$values = [];
+		}
+
+		if (empty($record) || empty($titleField)) {
+			return;
+		}
+
+		if (!$record->hasMethod($name)) {
+			throw new Exception(
+				sprintf("%s does not have a %s method", get_class($record), $name)
+			);
+		}
+
+		foreach ($values as $key => $value) {
+			// Get or create record
+			$record = $this->getOrCreateTag($value);
+			if ($record) {
+				$ids[] = $record->ID;
+				$values[$key] = $record->Title;
+			}
+		}
+
+		$relation->setByIDList(array_filter($ids));
+	}
+
+	/**
+	 * Get or create tag with the given value
+	 *
+	 * @param  string $term
+	 * @return DataObject|bool
+	 */
+	protected function getOrCreateTag($term)
+	{
+		// Check if existing record can be found
+		$source = $this->getSourceList();
+		if (!$source) {
+			return false;
+		}
+
+		$titleField = $this->getTitleField();
+		$record = $source
+			->filter($titleField, $term)
+			->first();
+		if ($record) {
+			return $record;
+		}
+
+		// Create new instance if not yet saved
+		if ($this->getCanCreate()) {
+			$dataClass = $source->dataClass();
+			$record = Injector::inst()->create($dataClass);
+
+			if (is_array($term)) {
+				$term = $term['Value'];
+			}
+
+			$record->{$titleField} = $term;
+			$record->write();
+			if ($source instanceof SS_List) {
+				$source->add($record);
+			}
+			return $record;
+		}
+
+		return false;
+	}
+
+	/**
+	 * Returns a JSON string of tags, for lazy loading.
+	 *
+	 * @param  HTTPRequest $request
+	 * @return HTTPResponse
+	 */
+	public function suggest(HTTPRequest $request)
+	{
+		$tags = $this->getTags($request->getVar('term'));
+
+		$response = HTTPResponse::create();
+		$response->addHeader('Content-Type', 'application/json');
+		$response->setBody(json_encode(['items' => $tags]));
+
+		return $response;
+	}
+
+	/**
+	 * Returns array of arrays representing tags.
+	 *
+	 * @param  string $term
+	 * @return array
+	 */
+	protected function getTags($term)
+	{
+		$source = $this->getSourceList();
+		if (!$source) {
+			return [];
+		}
+
+		$titleField = $this->getTitleField();
+
+		$query = $source
+			->filter($titleField . ':PartialMatch:nocase', $term)
+			->sort($titleField)
+			->limit($this->getLazyLoadItemLimit());
+
+		// Map into a distinct list
+		$items = [];
+		$titleField = $this->getTitleField();
+		foreach ($query->map('ID', $titleField) as $id => $title) {
+			$items[$title] = [
+				'Title' => $title,
+				'Value' => $title,
+			];
+		}
+
+		return array_values($items);
+	}
+
+	/**
+	 * DropdownField assumes value will be a scalar so we must
+	 * override validate. This only applies to Silverstripe 3.2+
+	 *
+	 * @param Validator $validator
+	 * @return bool
+	 */
+	public function validate($validator)
+	{
+		return true;
+	}
+
+	/**
+	 * Converts the field to a readonly variant.
+	 *
+	 * @return ReadonlyTagField
+	 */
+	public function performReadonlyTransformation()
+	{
+		/** @var ReadonlyTagField $copy */
+		$copy = $this->castedCopy(ReadonlyTagField::class);
+		$copy->setSourceList($this->getSourceList());
+		return $copy;
+	}
+
+	/**
+	 * Prevent the default, which would return "tag"
+	 *
+	 * @return string
+	 */
+	public function Type()
+	{
+		return '';
+	}
+
+	public function getSchemaStateDefaults()
+	{
+		$data = parent::getSchemaStateDefaults();
+
+		// Add options to 'data'
+		$data['lazyLoad'] = $this->getShouldLazyLoad();
+		$data['multi'] = $this->getIsMultiple();
+		$data['optionUrl'] = $this->getSuggestURL();
+		$data['creatable'] = $this->getCanCreate();
+		$options = $this->getOptions(true);
+		$data['value'] = $options->count() ? $options->toNestedArray() : null;
+
+		return $data;
+	}
 }