diff --git a/docs/product_catalog/quable/configure_quable_connector.md b/docs/product_catalog/quable/configure_quable_connector.md index 72a846d571..a789703440 100644 --- a/docs/product_catalog/quable/configure_quable_connector.md +++ b/docs/product_catalog/quable/configure_quable_connector.md @@ -18,6 +18,9 @@ ibexa_connector_quable: api_token: '' channel_code: '' webhook_secret: '' # Needed for webhook authentication + language_map: + eng-GB: en_GB + fre-FR: fr_FR throw_on_invalid_criteria: '%kernel.debug%' throw_on_invalid_mapping: '%kernel.debug%' cache: @@ -37,6 +40,7 @@ ibexa_connector_quable: | `api_token` | string | [Read Access API token](https://docs.quable.com/v5-EN/docs/system-api-tokens) used to authenticate requests to [[= pim_product_name =]]. | | `channel_code` | string | Code of the [[[= pim_product_name =]] channel](https://docs.quable.com/v5-EN/docs/content-channels) used as the source of product data. | | `webhook_secret` | string | Secret expected in the [webhook](https://docs.quable.com/v5-EN/docs/webhook) authorization header. | +| `language_map` | Empty | Maps [[= product_name =]] language codes (for example, `eng-GB`) to [[= pim_product_name =]] locale codes (for example, `en_GB`). For more information, see [Set up [[= pim_product_name =]] languages](/product_catalog/quable/install_quable.md) | | `throw_on_invalid_criteria` | `%kernel.debug%` | Controls behavior for unsupported search criteria: `true` throws an exception, `false` only logs unsupported criteria. | | `throw_on_invalid_mapping` | `%kernel.debug%` | Controls behavior for mapping errors during data transformation: `true` throws an exception, `false` only logs mapping errors. | | `cache.enabled` | `true` | Global cache switch for the connector. When `false`, cache decorators use only [in-memory cache](persistence_cache.md#in-memory-cache-configuration). | diff --git a/docs/product_catalog/quable/install_quable.md b/docs/product_catalog/quable/install_quable.md index 0a98f4681e..746a4801e7 100644 --- a/docs/product_catalog/quable/install_quable.md +++ b/docs/product_catalog/quable/install_quable.md @@ -97,13 +97,25 @@ ibexa: To use the products from [[= pim_product_name =]] within [[= product_name =]] content, make sure the [data languages](https://docs.quable.com/v5-EN/docs/data-languages) in [[= pim_product_name =]] have corresponding [languages](languages.md) in [[= product_name =]]. -To preview the current language configuration in both systems, run the following command: +To compare the language configuration in both systems, run the following command: ``` bash php bin/console ibexa:quable:languages:check ``` -Based on the returned data, adjust the language configuration as your use case requires. +Based on the command output, configure the `language_map` in `config/packages/ibexa_connector_quable.yaml`, mapping each [[= product_name =]] language code to its [[= pim_product_name =]] locale code as in the following example: + +``` yaml +ibexa_connector_quable: + # ... + language_map: + eng-GB: en_GB + fre-FR: fr_FR +``` + +The system uses the language map to resolve attribute values in the correct language when retrieving product data from [[= pim_product_name =]]. + +After configuring the map, rerun the `ibexa:quable:languages:check` command to confirm all languages are correctly mapped. ## Synchronize taxonomy @@ -152,9 +164,8 @@ In `config/packages/ibexa_connector_quable.yaml`, specify the configuration for ``` yaml ibexa_connector_quable: - - # Existing configuration (...) + # ... webhook_secret: '' ```