silverstripe / silverstripe-tagfield

src/TagField.php

Indentation +465 added lines, -465 removed lines

@@ -23,470 +23,470 @@
  */
 class TagField extends MultiSelectField
 {
-    /**
-     * @var array
-     */
-    private static $allowed_actions = array(
-        '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 $source
-     * @param null|DataList $value
-     * @param string $titleField
-     */
-    public function __construct($name, $title = '', $source = [], $value = null, $titleField = 'Title')
-    {
-        $this->setSourceList($source);
-        $this->setTitleField($titleField);
-        parent::__construct($name, $title, $source, $value);
-    }
-
-    /**
-     * @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
-     * @return DataList
-     */
-    public function getSourceList()
-    {
-        return $this->sourceList;
-    }
-
-    /**
-     * Set the model class name for tags
-     * @param  DataList $className
-     * @return self
-     */
-    public function setSourceList($sourceList)
-    {
-        $this->sourceList = $sourceList;
-        return $this;
-    }
-
-    /**
-     * {@inheritdoc}
-     */
-    public function Field($properties = array())
-    {
-        Requirements::css('silverstripe/tagfield:client/dist/styles/bundle.css');
-        Requirements::javascript('silverstripe/tagfield:client/dist/js/bundle.js');
-
-        $schema = [
-            'name' => $this->getName() . '[]',
-            'lazyLoad' => $this->getShouldLazyLoad(),
-            'creatable' => $this->getCanCreate(),
-            'multi' => $this->getIsMultiple(),
-            'value' => $this->Value(),
-            'disabled' => $this->isDisabled() || $this->isReadonly(),
-        ];
-        if (!$this->getShouldLazyLoad()) {
-            $schema['options'] = array_values($this->getOptions()->toNestedArray());
-        } else {
-            if ($this->Value()) {
-                $schema['value'] = $this->getOptions(true)->toNestedArray();
-            }
-            $schema['optionUrl'] = $this->getSuggestURL();
-        }
-        $this->setAttribute('data-schema', Convert::array2json($schema));
-
-        $this->addExtraClass('ss-tag-field');
-
-        return $this
-            ->customise($properties)
-            ->renderWith(self::class);
-    }
-
-    /**
-     * @return string
-     */
-    protected function getSuggestURL()
-    {
-        return Controller::join_links($this->Link(), 'suggest');
-    }
-
-    /**
-     * @return ArrayList
-     */
-    protected function getOptions()
-    {
-        $options = ArrayList::create();
-
-        $source = $this->getSourceList();
-
-        if (!$source) {
-            $source = ArrayList::create();
-        }
-
-        $dataClass = $source->dataClass();
-
-        $values = $this->Value();
-
-        if (!$values) {
-            return $options;
-        }
-
-        if (is_array($values)) {
-            $values = DataList::create($dataClass)
-                ->filter($this->getTitleField(), $values);
-        }
-
-        $ids = $values->column($this->getTitleField());
-
-        $titleField = $this->getTitleField();
-
-        foreach ($source as $object) {
-            $options->push(
-                ArrayData::create(array(
-                    'Title' => $object->$titleField,
-                    'Value' => $object->ID,
-                    'Selected' => in_array($object->$titleField, $ids),
-                ))
-            );
-        }
-
-        return $options;
-    }
-
-    /**
-     * {@inheritdoc}
-     */
-    public function setValue($value, $source = null)
-    {
-        if ($source instanceof DataObject) {
-            $name = $this->getName();
-
-            if ($source->hasMethod($name)) {
-                $values = [];
-                $titleField = $this->getTitleField();
-
-                foreach ($source->$name() as $tag) {
-                    $values[] = [
-                        'Title' => $tag->$titleField,
-                        'Value' => $tag->ID,
-                        'Selected' => true
-                    ];
-                }
-
-                return parent::setValue($values);
-            }
-        }
-
-        if (!is_array($value)) {
-            return parent::setValue($value);
-        }
-
-        return parent::setValue($value);
-    }
-
-    /**
-     * {@inheritdoc}
-     */
-    public function getAttributes()
-    {
-        return array_merge(
-            parent::getAttributes(),
-            [
-                'name' => $this->getName() . '[]',
-                'style'=> 'width: 100%'
-            ]
-        );
-    }
-
-    /**
-     * {@inheritdoc}
-     */
-    public function saveInto(DataObjectInterface $record)
-    {
-        $name = $this->getName();
-        $titleField = $this->getTitleField();
-        $source = $this->getSource();
-        $values = $this->Value();
-        $relation = $record->$name();
-        $ids = array();
-
-        if (!$values) {
-            $values = array();
-        }
-
-        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
-     */
-    protected function getOrCreateTag($term)
-    {
-        // Check if existing record can be found
-        /** @var DataList $source */
-        $source = $this->getSourceList();
-        $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();
-            return $record;
-        } else {
-            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 = new HTTPResponse();
-        $response->addHeader('Content-Type', 'application/json');
-        $response->setBody(json_encode(array('items' => $tags)));
-
-        return $response;
-    }
-
-    /**
-     * Returns array of arrays representing tags.
-     *
-     * @param  string $term
-     * @return array
-     */
-    protected function getTags($term)
-    {
-        /**
-         * @var array $source
-         */
-        $source = $this->getSourceList();
-
-        $titleField = $this->getTitleField();
-
-        $query = $source
-            ->filter($titleField . ':PartialMatch:nocase', $term)
-            ->sort($titleField)
-            ->limit($this->getLazyLoadItemLimit());
-
-        // Map into a distinct list
-        $items = array();
-        $titleField = $this->getTitleField();
-        foreach ($query->map('ID', $titleField) as $id => $title) {
-            $items[$title] = array(
-                'Title' => $title,
-                'Value' => $id
-            );
-        }
-
-        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 TagField_Readonly
-     */
-    public function performReadonlyTransformation()
-    {
-        $copy = $this->castedCopy(ReadonlyTagField::class);
-        $copy->setSourceList($this->getSourceList());
-        return $copy;
-    }
-
-    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();
-        $data['value'] = $this->Value();
-
-
-        return $data;
-    }
+	/**
+	 * @var array
+	 */
+	private static $allowed_actions = array(
+		'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 $source
+	 * @param null|DataList $value
+	 * @param string $titleField
+	 */
+	public function __construct($name, $title = '', $source = [], $value = null, $titleField = 'Title')
+	{
+		$this->setSourceList($source);
+		$this->setTitleField($titleField);
+		parent::__construct($name, $title, $source, $value);
+	}
+
+	/**
+	 * @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
+	 * @return DataList
+	 */
+	public function getSourceList()
+	{
+		return $this->sourceList;
+	}
+
+	/**
+	 * Set the model class name for tags
+	 * @param  DataList $className
+	 * @return self
+	 */
+	public function setSourceList($sourceList)
+	{
+		$this->sourceList = $sourceList;
+		return $this;
+	}
+
+	/**
+	 * {@inheritdoc}
+	 */
+	public function Field($properties = array())
+	{
+		Requirements::css('silverstripe/tagfield:client/dist/styles/bundle.css');
+		Requirements::javascript('silverstripe/tagfield:client/dist/js/bundle.js');
+
+		$schema = [
+			'name' => $this->getName() . '[]',
+			'lazyLoad' => $this->getShouldLazyLoad(),
+			'creatable' => $this->getCanCreate(),
+			'multi' => $this->getIsMultiple(),
+			'value' => $this->Value(),
+			'disabled' => $this->isDisabled() || $this->isReadonly(),
+		];
+		if (!$this->getShouldLazyLoad()) {
+			$schema['options'] = array_values($this->getOptions()->toNestedArray());
+		} else {
+			if ($this->Value()) {
+				$schema['value'] = $this->getOptions(true)->toNestedArray();
+			}
+			$schema['optionUrl'] = $this->getSuggestURL();
+		}
+		$this->setAttribute('data-schema', Convert::array2json($schema));
+
+		$this->addExtraClass('ss-tag-field');
+
+		return $this
+			->customise($properties)
+			->renderWith(self::class);
+	}
+
+	/**
+	 * @return string
+	 */
+	protected function getSuggestURL()
+	{
+		return Controller::join_links($this->Link(), 'suggest');
+	}
+
+	/**
+	 * @return ArrayList
+	 */
+	protected function getOptions()
+	{
+		$options = ArrayList::create();
+
+		$source = $this->getSourceList();
+
+		if (!$source) {
+			$source = ArrayList::create();
+		}
+
+		$dataClass = $source->dataClass();
+
+		$values = $this->Value();
+
+		if (!$values) {
+			return $options;
+		}
+
+		if (is_array($values)) {
+			$values = DataList::create($dataClass)
+				->filter($this->getTitleField(), $values);
+		}
+
+		$ids = $values->column($this->getTitleField());
+
+		$titleField = $this->getTitleField();
+
+		foreach ($source as $object) {
+			$options->push(
+				ArrayData::create(array(
+					'Title' => $object->$titleField,
+					'Value' => $object->ID,
+					'Selected' => in_array($object->$titleField, $ids),
+				))
+			);
+		}
+
+		return $options;
+	}
+
+	/**
+	 * {@inheritdoc}
+	 */
+	public function setValue($value, $source = null)
+	{
+		if ($source instanceof DataObject) {
+			$name = $this->getName();
+
+			if ($source->hasMethod($name)) {
+				$values = [];
+				$titleField = $this->getTitleField();
+
+				foreach ($source->$name() as $tag) {
+					$values[] = [
+						'Title' => $tag->$titleField,
+						'Value' => $tag->ID,
+						'Selected' => true
+					];
+				}
+
+				return parent::setValue($values);
+			}
+		}
+
+		if (!is_array($value)) {
+			return parent::setValue($value);
+		}
+
+		return parent::setValue($value);
+	}
+
+	/**
+	 * {@inheritdoc}
+	 */
+	public function getAttributes()
+	{
+		return array_merge(
+			parent::getAttributes(),
+			[
+				'name' => $this->getName() . '[]',
+				'style'=> 'width: 100%'
+			]
+		);
+	}
+
+	/**
+	 * {@inheritdoc}
+	 */
+	public function saveInto(DataObjectInterface $record)
+	{
+		$name = $this->getName();
+		$titleField = $this->getTitleField();
+		$source = $this->getSource();
+		$values = $this->Value();
+		$relation = $record->$name();
+		$ids = array();
+
+		if (!$values) {
+			$values = array();
+		}
+
+		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
+	 */
+	protected function getOrCreateTag($term)
+	{
+		// Check if existing record can be found
+		/** @var DataList $source */
+		$source = $this->getSourceList();
+		$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();
+			return $record;
+		} else {
+			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 = new HTTPResponse();
+		$response->addHeader('Content-Type', 'application/json');
+		$response->setBody(json_encode(array('items' => $tags)));
+
+		return $response;
+	}
+
+	/**
+	 * Returns array of arrays representing tags.
+	 *
+	 * @param  string $term
+	 * @return array
+	 */
+	protected function getTags($term)
+	{
+		/**
+		 * @var array $source
+		 */
+		$source = $this->getSourceList();
+
+		$titleField = $this->getTitleField();
+
+		$query = $source
+			->filter($titleField . ':PartialMatch:nocase', $term)
+			->sort($titleField)
+			->limit($this->getLazyLoadItemLimit());
+
+		// Map into a distinct list
+		$items = array();
+		$titleField = $this->getTitleField();
+		foreach ($query->map('ID', $titleField) as $id => $title) {
+			$items[$title] = array(
+				'Title' => $title,
+				'Value' => $id
+			);
+		}
+
+		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 TagField_Readonly
+	 */
+	public function performReadonlyTransformation()
+	{
+		$copy = $this->castedCopy(ReadonlyTagField::class);
+		$copy->setSourceList($this->getSourceList());
+		return $copy;
+	}
+
+	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();
+		$data['value'] = $this->Value();
+
+
+		return $data;
+	}
 }
 

Spacing +3 added lines, -3 removed lines

@@ -206,7 +206,7 @@ 
         Requirements::javascript('silverstripe/tagfield:client/dist/js/bundle.js');
 
         $schema = [
-            'name' => $this->getName() . '[]',
+            'name' => $this->getName().'[]',
             'lazyLoad' => $this->getShouldLazyLoad(),
             'creatable' => $this->getCanCreate(),
             'multi' => $this->getIsMultiple(),
@@ -320,7 +320,7 @@ 
         return array_merge(
             parent::getAttributes(),
             [
-                'name' => $this->getName() . '[]',
+                'name' => $this->getName().'[]',
                 'style'=> 'width: 100%'
             ]
         );
@@ -433,7 +433,7 @@ 
         $titleField = $this->getTitleField();
 
         $query = $source
-            ->filter($titleField . ':PartialMatch:nocase', $term)
+            ->filter($titleField.':PartialMatch:nocase', $term)
             ->sort($titleField)
             ->limit($this->getLazyLoadItemLimit());