From 4051ae7bff7858f65afb920da0a5ac3adde138ee Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marek=20Noco=C5=84?= Date: Thu, 9 Apr 2026 14:31:59 +0200 Subject: [PATCH 1/2] Added doc for language configuration --- .../quable/configure_quable_connector.md | 4 ++++ docs/product_catalog/quable/install_quable.md | 19 +++++++++++++++---- 2 files changed, 19 insertions(+), 4 deletions(-) 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: '' ``` From 3b6dc4d495ea09dd93c8ace711db7c1e6c3bbed3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marek=20Noco=C5=84?= Date: Tue, 14 Apr 2026 09:42:30 +0200 Subject: [PATCH 2/2] Apply suggestion from @mnocon --- docs/product_catalog/quable/install_quable.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/product_catalog/quable/install_quable.md b/docs/product_catalog/quable/install_quable.md index 746a4801e7..b522fafb93 100644 --- a/docs/product_catalog/quable/install_quable.md +++ b/docs/product_catalog/quable/install_quable.md @@ -113,7 +113,7 @@ ibexa_connector_quable: 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 =]]. +The system uses the language map to retrieve data in the correct language from [[= pim_product_name =]]. After configuring the map, rerun the `ibexa:quable:languages:check` command to confirm all languages are correctly mapped.