.. include:: ../../../Includes.txt

Shipping methods
================

The shipping methods are defined via TypoScript for each shopping cart.
The standard template already comes with a shipping method (standard).

With the definition plugin.tx_cart.settings.allowedCountries the output of
the selector in the shopping cart is defined. The options can also be
translated by an own SelectViewhelper.

.. important::
   The provided TypoScript of the extension provides a configuration and
   translation for the German-speaking area.

The parameter plugin.tx_cart.settings.defaultCountry defines which country
should be preselected.

.. important::
   If different shipping methods are defined for different countries, the
   country of the delivery address is used. Only in the case that no different
   delivery address has been specified, the selection of the billing address
   is used as a basis.

.. container:: table-row

   Property
      plugin.tx_cart.shippings.countries.de.options.n.free.from
   Data type
      float
   Description
      If the gross price of the products is greater than or equal to the
      specified value, the price for the shipping method is 0.00.
      This can be used for free shipping from a defined order value.

.. container:: table-row

   Property
      plugin.tx_cart.shippings.countries.de.options.n.free.until
   Data type
      float
   Description
      If the gross price of the products is less than or equal to the specified
      value, the price for the shipping method is 0.00.

.. container:: table-row

   Property
      plugin.tx_cart.shippings.countries.de.options.n.available.from
   Data type
      Text
   Description
      Only if the gross price of the products is greater than or equal to the
      specified value, this shipping method is available, otherwise the
      fallback shipping method will be used.

.. container:: table-row

   Property
      plugin.tx_cart.shippings.countries.de.options.n.available.until
   Data type
      Text
   Description
      Only if the gross price of the products is less than or equal to the
      specified value, this shipping method is available, otherwise the
      fallback shipping method will be used.

.. container:: table-row

   Property
      plugin.tx_cart.shippings.countries.de.options.n.fallBackId
   Data type
      Text
   Description
      If the shipping method is not available, the shipping method with this
      ID will be used.

Zone configuration
""""""""""""""""""

If no individual country configuration can be found, it is also possible to
work with zones in the TypoScript.
This saves a lot of configuration work if you want to deliver to many
countries.

::

   plugin.tx_cart {
       shippings {
           zones {
               1 {
                   preset = 1
                   countries = de,at,ch
                   options {
                       1 {
                           title = Standard
                           extra = 0.00
                           taxClassId = 1
                           status = open
                       }
                   }
               }
           }
       }
   }

|

.. container:: table-row

   Property
      plugin.tx_cart.shippings.zones.n
   Data type
      int
   Description
      You can configure up to n different zones.

.. container:: table-row

   Property
      plugin.tx_cart.shippings.zones.n.countries
   Data type
      int
   Description
      List of countries for which this configuration is valid.

.. NOTE::
   * The system first searches for a suitable configuration in the list of country configurations.
   * The list of zone configurations is then looked through. The first matching configuration is used.

Deactivate shipping methods
"""""""""""""""""""""""""""

At the moment, the processing does not allow to completely dispense with the
shipping methods. A shipping method must always be be specified. If there is
only one shipping method, the selection block can be hidden.

::

   plugin.tx_cart {
        settings {
            showCartAction {
                showPartials {
                   shippingMethodForm = false
                }
            }
        }
   }

.. container:: table-row

   Property
      plugin.tx_cart.settings.showCartAction.showPartials.shippingMethodForm
   Data type
      boolean
   Description
      Enables/disables the display and selection of configured shipping methods
      in the shopping cart.
   Default
      true

.. toctree::
   :maxdepth: 5
   :titlesonly:

   MainConfiguration/Index
   FlexPrices/Index