Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions docs/product_catalog/quable/configure_quable_connector.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,9 @@ ibexa_connector_quable:
api_token: '<your_api_token>'
channel_code: '<channel_code>'
webhook_secret: '<webhook authorization header>' # 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:
Expand All @@ -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) |
| <nobr>`throw_on_invalid_criteria`</nobr> | <nobr>`%kernel.debug%`</nobr> | Controls behavior for unsupported search criteria: `true` throws an exception, `false` only logs unsupported criteria. |
| <nobr>`throw_on_invalid_mapping`</nobr> | <nobr>`%kernel.debug%`</nobr> | 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). |
Expand Down
19 changes: 15 additions & 4 deletions docs/product_catalog/quable/install_quable.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -152,9 +164,8 @@ In `config/packages/ibexa_connector_quable.yaml`, specify the configuration for

``` yaml
ibexa_connector_quable:

# Existing configuration (...)

# ...
webhook_secret: '<webhook authorization header>'
```

Expand Down
Loading