TYPO3/Change configuration

From Aimeos documentation

Other languages:
Deutsch 100% • ‎English 100% • ‎русский 41%

There are a lot of configuration options available and documented in the Configuration section.


To add or overwrite configuration options in TYPO3, you can use TypoScript added to the setup section of a page TypoScript template to set the values.

The keys in the configuration documentation are always in the form:

client/html/catalog/filter/default/button = 1

To use such a key, replace the slashes (/) by dots (.) and prepend it with "plugin.tx_aimeos.settings.":

  1. plugin.tx_aimeos.settings.client.html.catalog.filter.default.button = 1

If the configuration key accepts an array of values, then you can add them this way via TypoScript:

  1. plugin.tx_aimeos.settings.client.html.catalog.filter.default.subparts {
  2.   0 = search
  3.   1 = tree
  4.   2 = attribute
  5. }

Per Plugin

Several plugins provide the possibility to add plug-in specific TypoScript configuration in the "Plugin" tab of the plug-ins placed on a page. Use the configuration keys from the documentation as in the example below:

client/html/catalog/filter/default/button = 1

Replace each slash (/) by a dot (.) and prepend nothing:

  1. client.html.catalog.filter.default.button = 1

The same works with arrays of values as well. Please have a look at into the section above for an example.


TYPO3 needs a special handling for configuration options that should affect what the plugins will show in their own options view when you edit a plugin placed on a page in the backend. This is called the Page TypoScript or PageTS. Aimeos only has one setting that affects the shown plugin options and this is the selection of the site if you have several ones:

  1. tx_aimeos.mshop.locale.site = myshop

If you have several shops in your TYPO3 installation, this setting will e.g. change categories shown in the plugin options view of the catalog filter plugin. In order to change this setting, you have to edit the page and go to the "Resources" tab. There's a text area where you can add the line above.

Administration Interface

Like the frontend, the shop administration interface can be configured as well. It's implemented as TYPO3 backend module which means that the prefix for the TypoScript configuration must be "module.tx_aimeos.settings." for all settings that should be handed over to the admin interface, e.g.

  1. module.tx_aimeos.settings.mshop.locale.site = myshop
  2. module.tx_aimeos.settings.client.extjs.panel.price.listuismall.showall = 1

It doesn't make sense to assign all frontend settings also to the backend module. This would only slow down loading the administration interface. There are only a few settings that you may want to share between frontend and backend for the same page, namely the "mshop.locale.site" setting. Besides that, only the configuration options prefixed with "client/extjs" are used in the administration interface.


All scheduler tasks allow adding specific TypoScript configuration for the jobs that should be executed. This is especially useful for setting or overwriting configuration values for e-mails that should be sent to customers. Use the configuration keys from the documentation as in the example below:

  1. client.html.common.content.baseurl = https://yourdomain/uploads/tx_aimeos
  2. client.html.catalog.detail.url.target = <shop detail page ID>

The same works with arrays of values as well:

  1. client.html {
  2.     common.content.baseurl = https://yourdomain/uploads/tx_aimeos
  3.     catalog.detail.url.target = <shop detail page ID>
  4. }
  5. controller.jobs.order.email.payment.default.status {
  6.     0 = 5
  7.     1 = 6
  8. }