---
title: "Configuration"
manual: "Cart"
version: "12.4"
permalink: "https://docs.typo3.org/permalink/extcode/cart:configuration@12.4"
source: "Administrator/Configuration/Index.rst"
rendered: "2026-11-20T20:45:06+00:00"
---

# Configuration {#configuration}

The following pages contain needed information for the configuration of the
extension with TypoScript, PageTS and YAML.

-   [Base](https://docs.typo3.org/permalink/extcode/cart:base-1@12.4)
-   [Cart](https://docs.typo3.org/permalink/extcode/cart:cart@12.4)
    -   [Consent Checkboxes](https://docs.typo3.org/permalink/extcode/cart:consent-checkboxes@12.4)
    -   [Validating and hiding fields](https://docs.typo3.org/permalink/extcode/cart:validating-and-hiding-fields-1@12.4)
    -   [Multi-Step Checkout](https://docs.typo3.org/permalink/extcode/cart:multi-step-checkout@12.4)
    -   [Cart form sections](https://docs.typo3.org/permalink/extcode/cart:cart-form-sections@12.4)
-   [Currency](https://docs.typo3.org/permalink/extcode/cart:currency-1@12.4)
-   [Email](https://docs.typo3.org/permalink/extcode/cart:email@12.4)
    -   [Email addresses](https://docs.typo3.org/permalink/extcode/cart:email-addresses@12.4)
    -   [Email attachments](https://docs.typo3.org/permalink/extcode/cart:email-attachments@12.4)
    -   [Static email content](https://docs.typo3.org/permalink/extcode/cart:static-email-content@12.4)
    -   [Emails on status changes](https://docs.typo3.org/permalink/extcode/cart:emails-on-status-changes@12.4)
-   [Number Generator](https://docs.typo3.org/permalink/extcode/cart:number-generator@12.4)
-   [Payment methods](https://docs.typo3.org/permalink/extcode/cart:payment-methods@12.4)
-   [Shipping methods](https://docs.typo3.org/permalink/extcode/cart:shipping-methods@12.4)
    -   [Flexible prices for shipping](https://docs.typo3.org/permalink/extcode/cart:flexible-prices-for-shipping@12.4)
-   [Tax classes](https://docs.typo3.org/permalink/extcode/cart:tax-classes@12.4)
-   [Backend module](https://docs.typo3.org/permalink/extcode/cart:backend-module@12.4)
-   [Dashboard widgets](https://docs.typo3.org/permalink/extcode/cart:dashboard-widgets@12.4)
-   [AJAX](https://docs.typo3.org/permalink/extcode/cart:ajax@12.4)

## Site sets {#configuration-site-sets}

The payment methods, the shipping methods, the tax classes and the email
addresses can also be configured with site sets and site settings instead of
TypoScript. Site settings are typed and can be edited in the backend module
"Site Settings".

| Site set | Site settings | Loader interface |
| --- | --- | --- |
| `extcode/cart-payments` | `extcode.cart.payments` | `\Extcode\Cart\Configuration\Loader\PaymentMethodsLoaderInterface` |
| `extcode/cart-shippings` | `extcode.cart.shippings` | `\Extcode\Cart\Configuration\Loader\ShippingMethodsLoaderInterface` |
| `extcode/cart-taxclasses` | `extcode.cart.taxClasses` | `\Extcode\Cart\Configuration\Loader\TaxClassLoaderInterface` |
| `extcode/cart-mail` | `extcode.cart.mail` | `\Extcode\Cart\Configuration\Loader\MailConfigurationLoaderInterface` |

The site settings use the namespace `extcode.cart` with the keys of the
TypoScript, e.g. `plugin.tx_cart.taxClasses` becomes
`extcode.cart.taxClasses`. The special options (`plugin.tx_cart.specials`)
can only be configured with TypoScript.

To use a site set:

1.  Add the site set to the dependencies of the site:

    **config/sites/\<site>/config.yaml**

    ```yaml
    dependencies:
      - extcode/cart-payments
      - extcode/cart-shippings
      - extcode/cart-taxclasses
    ```
1.  Adapt the site settings in the backend module "Site Settings" or in
    `config/sites/<site>/settings.yaml`.
1.  The payment methods, the shipping methods and the tax classes are read from
    TypoScript by default. Use the site sets loaders with an alias of the loader
    interface, each configuration can be moved separately:

    **EXT:sitepackage/Configuration/Services.yaml**

    ```yaml
    services:
      Extcode\Cart\Configuration\Loader\PaymentMethodsLoaderInterface:
        alias: Extcode\Cart\Configuration\Loader\SiteSets\PaymentMethodsLoader
        public: true
      Extcode\Cart\Configuration\Loader\ShippingMethodsLoaderInterface:
        alias: Extcode\Cart\Configuration\Loader\SiteSets\ShippingMethodsLoader
        public: true
      Extcode\Cart\Configuration\Loader\TaxClassLoaderInterface:
        alias: Extcode\Cart\Configuration\Loader\SiteSets\TaxClassLoader
        public: true
    ```

    The email addresses of the site set `extcode/cart-mail` are always read
    from the site settings. They are used with the feature toggle
    `cart.useNewOrderMailSender`, see [Email addresses](https://docs.typo3.org/permalink/extcode/cart:mail-addresses@12.4).
    The emails on status changes use them too, their rules are site settings
    in `extcode.cart.statusChange.mail`, see [Emails on status changes](https://docs.typo3.org/permalink/extcode/cart:status-change-emails@12.4).

Differences to TypoScript:

-   The values are typed, e.g. `extra: 7.95` is a number and the email
    addresses are lists instead of comma separated strings.
-   The TypoScript copy syntax `at < .de` does not exist in YAML. Use an anchor
    and aliases to use the configuration of a country for other countries:

    **config/sites/\<site>/settings.yaml**

    ```yaml
    extcode:
      cart:
        payments:
          countries:
            de: &de
              preset: 1
              options:
                1:
                  title: 'Prepayment'
                  extra: 0.0
                  taxClassId: 1
                  status: 'open'
            at: *de
            ch: *de
    ```
-   The payment methods, the shipping methods and the tax classes are read from
    the site of the current request, the email addresses from the site of the
    storage page of the order.
