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

Relations (Many-To-Many) Editable

General

The relations editable provides many to many relation to other Pimcore elements (document, asset, object).

Configuration

Name	Type	Description
`width`	integer	Width for the widget in pixels (optional)
`height`	integer	Height for the widget in pixels (optional)
`title`	string	Title for the input-widget
`uploadPath`	string	Target path for (inline) uploaded assets
`disableInlineUpload`	boolean	Disable the inline upload for assets. If set to true, the inline upload functionality will be disabled.
`types`	array	Allowed types (document, asset, object), if empty all types are allowed
`subtypes`	array	Allowed subtypes grouped by type (folder, page, snippet, image, video, object, ...), if empty all subtypes are allowed (see example below)
`classes`	array	Allowed object class names, if empty all classes are allowed
`class`	string	A CSS class that is added to the surrounding container of this element in editmode
`reload`	boolean	`true` triggers page reload on each change

Methods

Name	Return	Description
`getElements()`	array	Array of the assigned elements
`current()`	int	Get the current index while looping
`isEmpty()`	boolean	Whether the editable is empty or not

Example

Basic Usage

The code below is responsible for showing a list of elements types related to the relations editable.

<p>{{ "Types of elements" | trans }}:</p>
{% if editmode %}
    {{ pimcore_relations("objectPaths") }}
{% else %}
<ul>
    {% for element in pimcore_relations("objectPaths") %}
        <li>{{ element.getType() }}</li>
    {% endfor %}
</ul>
{% endif %}

Picture below, presents the editmode preview:

Relations editable - editmode preview

The frontend part looks like that:

Relations editable - frontend preview

To better understand what exactly is the $element variable, have a look at the output below:

array(6) {
  [0] => string(27) "Pimcore\Model\DataObject\Folder"
  [1] => string(32) "Pimcore\Model\DataObject\BlogArticle"
  [2] => string(32) "Pimcore\Model\DataObject\BlogArticle"
  [3] => string(27) "Pimcore\Model\Document\Page"
  [4] => string(27) "Pimcore\Model\Document\Page"
  [5] => string(25) "Pimcore\Model\Asset\Image"
}

Example with allowed types and subtypes

Similar to the single relation editable, this editable also could specify allowed types, subtypes and classes. For example:

{{ pimcore_relations("objectPaths", {
    "types": ["asset","object"],
    "subtypes": {
        "asset": ["video","image"],
        "object": ["object"]
    },
    "classes": ["person"]
}) }}

Now, a user is not able to add other elements than specified in the types configuration part.