# Integrazione WCPOS Polylang

Aggiunge a WCPOS il supporto per [Polylang](https://polylang.pro/), in modo che il POS mostri solo i prodotti di una singola lingua: nessuna traduzione duplicata nella ricerca prodotti, nella griglia del catalogo o nei flussi di lavoro della cassa. I negozi WCPOS Pro possono fissare una lingua per ciascun negozio; le installazioni gratuite usano come fallback la lingua predefinita di Polylang.

## Cosa fa[​](#what-it-does "Collegamento diretto a Cosa fa")

* Filtra per lingua le query REST di prodotti e varianti WCPOS.
* Intercetta le route WCPOS **fast-sync** (le richieste leggere `posts_per_page=-1` + `fields` che il POS usa per aggiornare il proprio indice locale), così i duplicati tradotti non raggiungono mai il client.
* Nelle installazioni gratuite, applica la lingua predefinita di Polylang.
* Nelle installazioni Pro, ogni negozio può scegliere la propria lingua da una nuova sezione **Lingua** nell'editor del negozio.
* Rispetta la visibilità dei prodotti WCPOS **solo POS** durante la creazione del payload fast-sync.

L'integrazione non esegue alcuna operazione quando Polylang non è attivo: è possibile installare il plugin prima di abilitare Polylang senza errori.

## Installazione[​](#installation "Collegamento diretto a Installazione")

1

#### Installa Polylang

Installa [Polylang](https://wordpress.org/plugins/polylang/) (o Polylang Pro) e configura normalmente le lingue del sito. Assicurati che almeno una lingua sia impostata come predefinita.

2

#### Installa WCPOS Polylang

Installa dalla directory delle estensioni WCPOS in `WP Admin > POS > Impostazioni > Estensioni`, oppure scarica l'ultima versione dalla [pagina delle release GitHub](https://github.com/wcpos/wcpos-polylang/releases) e caricala tramite `Plugin > Aggiungi Nuovo > Carica plugin`.

3

#### (Pro) Imposta una lingua per negozio

Se gestisci [piu negozi](/it/stores/.md) con WCPOS Pro, vai a `POS > Negozi`, modifica un negozio e scegli la sua lingua dalla sezione **Lingua** della barra laterale. Lasciala su *Predefinito* per usare la lingua predefinita di Polylang.

## Lingua per negozio (Pro)[​](#per-store-language-pro "Collegamento diretto a Lingua per negozio (Pro)")

In WCPOS Pro, il plugin aggiunge una sezione **Lingua** alla barra laterale dell'editor del negozio. Ogni negozio puo essere associato a un singolo slug di lingua Polylang — i prodotti forniti a quel negozio vengono filtrati solo per quella lingua. I negozi lasciati su *Predefinito* usano la lingua predefinita di Polylang.

Il valore per negozio viene salvato nel post del negozio come meta `_wcpos_polylang_language` ed e esposto tramite la REST API dei negozi WCPOS Pro (`/wcpos/v1/stores`), quindi viene sincronizzato attraverso il POS come qualsiasi altra impostazione del negozio.

## Note sulla compatibilita[​](#compatibility-notes "Collegamento diretto a Note sulla compatibilita")

* **Prodotti solo POS:** quando la modalita solo POS e abilitata nelle impostazioni WCPOS, gli ID dei prodotti solo online vengono esclusi dal payload di sincronizzazione rapida, cosi non compaiono nel POS.
* **Installazioni gratuite:** non è disponibile alcuna UI per modificare la lingua per negozio: il plugin usa la lingua predefinita di Polylang. Se servono lingue diverse per ogni negozio, passa a [WCPOS Pro](/it/getting-started/pro-license.md).
* **Plugin non disponibile:** se Polylang è disattivato, il plugin non esegue alcuna operazione in modo silenzioso. Non genererà errori né bloccherà il POS.

## Hook per sviluppatori[​](#developer-hooks "Collegamento diretto a Hook per sviluppatori")

Per l'uso avanzato, il plugin espone alcuni filtri:

| Filtro                             | Scopo                                                                                                  |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------ |
| `wcpos_polylang_resolved_language` | Sovrascrive la lingua usata per una determinata richiesta. Riceve lo slug risolto e `WP_REST_Request`. |
| `wcpos_polylang_default_language`  | Sovrascrive la lingua di fallback quando non è impostato alcun valore per negozio.                     |
| `wcpos_polylang_is_supported`      | Forza l'attivazione o la disattivazione del plugin indipendentemente dal rilevamento di Polylang.      |
| `wcpos_polylang_minimum_version`   | Richiede una versione minima di Polylang (predefinito: nessun vincolo di versione).                    |

## Requisiti[​](#requirements "Collegamento diretto a Requisiti")

WooCommerce

<!-- -->

: WooCommerce installato e attivato

Polylang

<!-- -->

: Polylang (gratuito o Pro) con almeno una lingua configurata

WCPOS

<!-- -->

: La versione gratuita funziona; la selezione della lingua per negozio richiede WCPOS Pro

## Correlati[​](#related "Collegamento diretto a Correlati")

* [Integrazione WCPOS WPML](/it/extensions/wpml.md)
* [Integrazione WCPOS WP Multilang](/it/extensions/wp-multilang.md)
* [Multi-negozio](/it/stores/.md)
* Fonte: [github.com/wcpos/wcpos-polylang](https://github.com/wcpos/wcpos-polylang)