Important

You are browsing documentation for version 5.1 of OroCommerce, supported until March 2026. Read the documentation for version 6.0 (the latest LTS version) to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Placeholders 

Filename

placeholders.yml

Root Node

placeholders

Sections

items 

type: map

The items option is a map that is used to create named items which will then later be assigned to different placeholders. Each key is a unique key which will later be used to refer to a certain item. The value is a map that controls how an item will be rendered when being assigned to a placeholder:

acl 

type: string

The item will only be rendered if the user is granted access to the configured access control list.

action 

type: string

A controller that will be called when rendering the item. This option is useful when some complex logic needs to be executed when rendering the placeholder item. For simple templates, you should use the template option instead.

applicable 

type: string

An expression that will be evaluated at runtime to determine whether or not the item should be rendered.

template 

A template reference that will be included when the item is rendered.

type: string

placeholders 

type: map

With the placeholders option you assign your defined items to some placeholders. The keys of this map are the names of placeholders items should be assigned to. Placeholders that do not exist will be ignored. The value of the map is another map with the only key being items:

items 

type: map

The map keys are the names of defined items. The value can be an optional map with order being the only allowed key. The value of the order option controls the order in which multiple items will be rendered within a placeholder. When the order is not important, the item can be appended to the list of existing items by using ~ (the YAML null value).