Warning: You are browsing the documentation from version 4 to 10 of Pimcore. Please visit https://pimcore.com/docs/platform/ for the latest versions of Pimcore.
Version: Edit on GitHub

Select Types with Dynamic Options

For the select & multiselect datatype you can specify a dynamic options provider class. This allows you to generate a list of valid options on-the-fly instead of using a static list. The select datatype also allows you to define the default option at runtime.

You can also add some additional static data which will be passed to the data provider.

Note that there are two ways to define an options provider.

Either simply specify the class name ...

Select Field

... or the name of a Symfony service (notice the prefix). Select Field

The services.yaml would then look like this one ...

Select Field

Depending on your datatype you have to implement the appropriate interface.

  • Pimcore\Model\DataObject\ClassDefinition\DynamicOptionsProvider\SelectOptionsProviderInterface for the Select data type options,
  • Pimcore\Model\DataObject\ClassDefinition\DynamicOptionsProvider\MultiSelectOptionsProviderInterface for the Multiselect options

Implement the following methods:

  • getOptions should return a list of valid options in the format indicated below
  • getDefaultValue (Select data type only) returning the default value
  • hasStaticOptions should return whether your options are depending on the object context (i.e. different options for different objects) or not. This is especially important for the object grid. For object-context depending option there will be no batch assignment mode. Also, filtering can only be done through a text field instead of the options list.
<?php

namespace Website;

use Pimcore\Model\DataObject\ClassDefinition\Data;
use Pimcore\Model\DataObject\ClassDefinition\DynamicOptionsProvider\SelectOptionsProviderInterface;


class OptionsProvider implements SelectOptionsProviderInterface
{
    /**
     * @param array $context 
     * @param Data $fieldDefinition 
     * @return array
     */
    public function getOptions($context, $fieldDefinition) {
        $object = isset($context["object"]) ? $context["object"] : null;
        $fieldname = "id: " . ($object ? $object->getId() : "unknown") . " - " .$context["fieldname"];
        $result = array(

            array("key" => $fieldname .' == A', "value" => 2),
            array("key" => $fieldname .' == C', "value" => 4),
            array("key" => $fieldname .' == F', "value" => 5)

        );
        return $result;
    }

    /**
     * Returns the value which is defined in the 'Default value' field  
     * @param array $context 
     * @param Data $fieldDefinition 
     * @return mixed
     */
    public function getDefaultValue($context, $fieldDefinition) {
        return $fieldDefinition->getDefaultValue();
    }

    /**
     * @param array $context 
     * @param Data $fieldDefinition 
     * @return bool
     */
    public function hasStaticOptions($context, $fieldDefinition) {
        return true;
    }

}

This will generate the following options.

Select Field

Context Information for the Provider Class

Note that depending the use case not all of the infos will be available. Especially the existence of the object paramater cannot be guaranteed because the provider class will also be called when a class is saved or if you programmatically call $class->getFieldDefinitions(). Layout definition calls can be distinguished from other ones by checking if the purpose parameter is set to layout

The purpose parameter can take the following values:

Value Description
null unknown
layout edit mode layout
gridconfig grid configuration - usually no need to specify dynamic options
gridview grid view

Object (top-level)

Name Description
object the "object"
fieldname the name of the select field (e.g. dynSelect)

Localizedfields

Name Description
ownerType "localizedfield"
ownerName the name of the localized field ("localizedfields")
object the "object"
fieldname the name of the select field (e.g. dynSelect)

Objectbricks

Name Description
containerType "objectbrick"
containerKey the type of the object brick
outerFieldname the object's object brick attribute
object the "object"
fieldName the name of the attribute inside the object brick

Fieldcollections

Name Description
containerType "fieldcollection"
containerKey the type of the fieldcollection
subContainerType sub container type (e.g. localized field inside a field collection)
outerFieldname the object's field collection attribute
object the "object"
fieldName the name of the attribute inside the fieldcollection

Classification Store

Name Description
ownerType "classificationstore"
ownerName the name of the classificationstore attribute
fieldname the name of the attribute inside the fieldcollection
groupId group id
keyId key id
keyDefinition the fielddefinition of the classificationstore attribute