# Traduit: WCPOS Polylang

Ajoute la prise en charge de [Polylang](https://polylang.pro/) à WCPOS afin que le PDV n'affiche que les produits d'une seule langue — plus de traductions en double dans la recherche de produits, la grille du catalogue ou les flux de caisse. Les boutiques WCPOS Pro peuvent définir une langue par boutique ; les installations gratuites utilisent la langue par défaut de Polylang.

## Fonctionnement[​](#what-it-does "Lien direct vers Fonctionnement")

* Filtre les requêtes REST de produits et de déclinaisons WCPOS par langue.
* Intercepte les routes de **synchronisation rapide** WCPOS (les requêtes légères `posts_per_page=-1` + `fields` utilisées par le PDV pour rafraîchir son index local) afin que les doublons traduits n'atteignent jamais le client.
* Sur les installations gratuites, applique la langue par défaut de Polylang.
* Sur les installations Pro, chaque boutique peut choisir sa propre langue via une nouvelle section **Langue** dans l'éditeur de boutique.
* Respecte la visibilité produit **PDV uniquement** de WCPOS lors de la construction du contenu de synchronisation rapide.

L'intégration se désactive proprement lorsque Polylang n'est pas actif — vous pouvez installer l'extension avant d'activer Polylang sans provoquer d'erreurs.

## Installation[​](#installation "Lien direct vers Installation")

1

#### FR: Installer Polylang

Installez [Polylang](https://wordpress.org/plugins/polylang/) (ou Polylang Pro) et configurez les langues de votre site normalement. Assurez-vous qu'au moins une langue est définie comme langue par défaut.

2

#### FR: Installer WCPOS Polylang

Installez depuis le répertoire des extensions WCPOS dans `WP Admin > POS > Réglages > Extensions`, ou téléchargez la dernière version depuis la [page des releases GitHub](https://github.com/wcpos/wcpos-polylang/releases) et importez-la via `Extensions > Ajouter > Téléverser une extension`.

3

#### FR: (Pro) Définir une langue par boutique

Si vous utilisez [plusieurs boutiques](/fr/stores/.md) avec WCPOS Pro, accédez à `POS > Boutiques`, modifiez une boutique et sélectionnez sa langue dans la section **Langue** de la barre latérale. Laissez sur *Par défaut* pour utiliser la langue par défaut de Polylang.

## Langue par boutique (Pro)[​](#per-store-language-pro "Lien direct vers Langue par boutique (Pro)")

Avec WCPOS Pro, l'extension ajoute une section **Langue** dans la barre latérale de l'éditeur de boutique. Chaque boutique peut être associée à un slug de langue Polylang unique — les produits servis à cette boutique sont filtrés pour cette langue uniquement. Les boutiques laissées sur *Par défaut* utilisent la langue par défaut de Polylang.

La valeur par boutique est enregistrée dans l'article de la boutique sous la méta `_wcpos_polylang_language` et est exposée via l'API REST des boutiques WCPOS Pro (`/wcpos/v1/stores`), ce qui permet un aller-retour via le PDV comme tout autre réglage de boutique.

## Notes de compatibilité[​](#compatibility-notes "Lien direct vers Notes de compatibilité")

* **Produits réservés au PDV :** lorsque le mode réservé au PDV est activé dans les réglages WCPOS, les identifiants des produits en ligne uniquement sont exclus du payload de synchronisation rapide afin qu'ils n'apparaissent pas dans le PDV.
* **Installations gratuites :** il n'y a pas d'interface pour changer la langue par boutique — le plugin utilise la langue par défaut de Polylang. Si vous avez besoin de langues par boutique, passez à [WCPOS Pro](/fr/getting-started/pro-license.md).
* **Plugin indisponible :** si Polylang est désactivé, le plugin ne fait rien silencieusement. Il ne génère pas d'erreurs et ne bloque pas le PDV.

## Hooks pour développeurs[​](#developer-hooks "Lien direct vers Hooks pour développeurs")

Pour une utilisation avancée, le plugin expose quelques filtres :

| Filtre                             | Fonction                                                                                            |
| ---------------------------------- | --------------------------------------------------------------------------------------------------- |
| `wcpos_polylang_resolved_language` | Remplace la langue utilisée pour une requête donnée. Reçoit le slug résolu et la `WP_REST_Request`. |
| `wcpos_polylang_default_language`  | Remplace la langue de secours lorsqu'aucune valeur par boutique n'est définie.                      |
| `wcpos_polylang_is_supported`      | Force l'activation ou la désactivation du plugin indépendamment de la détection de Polylang.        |
| `wcpos_polylang_minimum_version`   | Exige une version minimale de Polylang (par défaut : aucune restriction de version).                |

## Prérequis[​](#requirements "Lien direct vers Prérequis")

FR: WooCommerce

<!-- -->

: WooCommerce installé et activé

FR: Polylang

<!-- -->

: Polylang (gratuit ou Pro) avec au moins une langue configurée

FR: WCPOS

<!-- -->

: La version gratuite fonctionne ; la sélection de la langue par boutique nécessite WCPOS Pro

## Voir aussi[​](#related "Lien direct vers Voir aussi")

* [WCPOS WPML](/fr/extensions/wpml.md)
* [WCPOS WP Multilang](/fr/extensions/wp-multilang.md)
* [Multi-boutique](/fr/stores/.md)
* Source : [github.com/wcpos/wcpos-polylang](https://github.com/wcpos/wcpos-polylang)