Integrazione WCPOS Polylang
Aggiunge a WCPOS il supporto per Polylang, 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
- Filtra per lingua le query REST di prodotti e varianti WCPOS.
- Intercetta le route WCPOS fast-sync (le richieste leggere
posts_per_page=-1+fieldsche 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
Installa Polylang
Installa Polylang (o Polylang Pro) e configura normalmente le lingue del sito. Assicurati che almeno una lingua sia impostata come predefinita.
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 e caricala tramite Plugin > Aggiungi Nuovo > Carica plugin.
(Pro) Imposta una lingua per negozio
Se gestisci piu negozi 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)
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
- 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.
- 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
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). |