> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration types

> The types of configurations in WEBSALE V8s at a glance: .config, .dat, .cfg, .conf, and the legacy .ini configurations.

The definitions of the basic settings for a shop or subshop are made centrally in the Online Service Area (OSB) under "Configurations". Different configuration types exist for different definitions — for example, a configuration type for commercial settings and shop messages, one for product ratings, or lists containing delivery countries.

<Warning>
  The file names of the configurations must never be renamed! All configurations must be provided under exactly the names specified in the following sections. Otherwise, the shop cannot use the configurations.
</Warning>

The following sections introduce the types of configurations that can be edited in the Online Service Area. The page closes with a note about the .ini configurations from the previous version V7.

## ".config" configurations

".config" configurations are created in order to make individual settings. They serve either basic settings or feature-specific settings.

| Name                                      | Assignment                 | Reference                                 |
| ----------------------------------------- | -------------------------- | ----------------------------------------- |
| Configuration global.config               | global (subshop-wide)      | Configuration global.config               |
| Rating configuration (prodrating.config)  | global or subshop-specific | Rating configuration                      |
| Configuration wws-online-interface.config | subshop-specific           | Configuration wws-online-interface.config |
| Shop configuration shop.config            | subshop-specific           | Shop configuration shop.config            |

All ".config" configurations are divided into named sections delimited by start and end tags (angle brackets, as in HTML). The section names are specified by WEBSALE. Each section contains parameters and values that define functions or output texts.

Here is an example of the `<PaymentPrepayment-Txt>` section:

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<PaymentPrepayment-Txt>
   ...
   Allow              = yes
   Name               = Vorauskasse
   Discount           = abzüglich 3 % Rabatt         # Text
   Discount-Value     = 3                            # Wert
   BillCountry-Rule   = AllowCountries               # [DenyCountries|AllowCountries], standard=DenyCountries
   BillCountry-List   = DEU, AUT, CHE                # Kommaseparierte Liste der Länder im 3-stelligen ISO-Code
   ...
</PaymentPrepayment-Txt>
```

Depending on the suffix, the parameters expect a specific input:

* Parameters with the suffix "Allow" expect "yes" or "no" as input.
* Parameters with the suffix "Value" expect a numeric input, for example "10" or "12.50" (make sure to use the period as the separator before decimal places!).
* Parameters with the suffix "List" expect a comma-separated list, for example "DEU, AUT, CHE".
* Parameters with the suffix "Txt" appear as texts in the shop.
* Parameters with other suffixes, or none, expect specific values that are documented in the WEBSALE online documentation for the respective parameter or section.

## ".dat" configurations

The purpose of these configurations is to provide entries that are later displayed in selection lists (for example, list boxes) in the shop, such as a selection list of billing countries.

| Name                                                     | Assignment                 | Reference                                        |
| -------------------------------------------------------- | -------------------------- | ------------------------------------------------ |
| Exchange rate configuration (currency.dat)               | global (subshop-wide)      | Configuration currency.dat                       |
| Salutation configuration (salutation.dat)                | global or subshop-specific | Configuration salutation.dat                     |
| Title configuration (title.dat)                          | global or subshop-specific | Configuration title.dat                          |
| Discount configuration (discount.dat)                    | global or subshop-specific | Configuration discount.dat                       |
| Billing and delivery country configuration (country.dat) | subshop-specific           | Configuration country.dat and country\_deliv.dat |
| Delivery country configuration (country\_deliv.dat)      | subshop-specific           | Configuration country.dat and country\_deliv.dat |

All ".dat" configurations are tab-separated and are not divided into sections.

Here is an example excerpt from the configuration country.dat:

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
Name   Iso
DEUTSCHLAND   DEU
ÖSTERREICH   AUT
SCHWEIZ   CHE
AFGHANISTAN   AFG
ALBANIA   ALB
ALGERIA   DZA
```

## ".cfg" configurations

These configurations are created automatically and cannot be edited. They can be read in the OSB interface for verification and comparison purposes.

| Name                   | Assignment       | Reference            |
| ---------------------- | ---------------- | -------------------- |
| Import file (prod.cfg) | subshop-specific | Import file prod.cfg |

## ".conf" configuration

Only one configuration file of this type exists: ws\_access.conf. It is provided in the root directory of each shop or, if a subshop exists, in the subdirectory for that subshop. This configuration cannot be accessed via the OSB.

In terms of its capabilities and syntax, this file corresponds to an .access.conf of the Apache web server and should only be adjusted with the necessary expertise.

| Name                                   | Reference                            |
| -------------------------------------- | ------------------------------------ |
| Server configuration (ws\_access.conf) | Server configuration ws\_access.conf |

## ".ini" configurations (legacy logic)

".ini" configurations originate from WEBSALE version V7 and should no longer be used in V8s.

| Name                                 | Assignment                                                                                                    | Reference                      |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------- | ------------------------------ |
| websale.ini, design.ini, authent.ini | The ini configurations from V7 were combined in V8s into the subshop-specific shop configuration shop.config. | Shop configuration shop.config |


## Related topics

- [API reference configuration](/en/schnittstellen/admin-interface-api/api-referenz-konfiguration.md)
- [Configuration of the search module](/en/ws-search/konfiguration-des-such-moduls.md)
- [content - Catalogue (categories & products)](/en/konfiguration/content-katalog-kategorien-produkte.md)
- [Configuration deep links](/en/admin-interface/konfigurations-deeplinks.md)
- [$wsConfig - Configuration](/en/frontend/referenz/module/wsconfig.md)