Ga naar de hoofdinhoud
Versie: 1.x

WCPOS Polylang

Voegt Polylang-ondersteuning toe aan WCPOS, zodat de POS alleen producten voor één taal toont. Daardoor verschijnen er geen dubbele vertalingen in productzoekopdrachten, het catalogusraster of kassaworkflows. WCPOS Pro-winkels kunnen een taal per winkel vastzetten; gratis installaties vallen terug op de standaardtaal van Polylang.

Wat het doet​

  • Filtert WCPOS REST-query's voor producten en variaties op taal.
  • Onderschept WCPOS-fast-sync-routes, de lichte posts_per_page=-1- en fields-aanvragen waarmee de POS de lokale index vernieuwt, zodat vertaalde duplicaten de client nooit bereiken.
  • Past bij gratis installaties de standaardtaal van Polylang toe.
  • Laat elke winkel in Pro-installaties een eigen taal kiezen via een nieuw gedeelte Taal in de winkeleditor.
  • Respecteert de WCPOS-zichtbaarheid alleen POS bij het opbouwen van de fast-sync-payload.

De integratie doet netjes niets wanneer Polylang niet actief is. Je kunt de plugin dus alvast installeren voordat je Polylang inschakelt, zonder fouten te veroorzaken.

Installatie​

1

Polylang installeren

Installeer Polylang of Polylang Pro en configureer de talen van je site zoals normaal. Zorg dat ten minste één taal als standaard is ingesteld.

2

WCPOS Polylang installeren

Installeer vanuit de WCPOS-extensiemap onder WP Admin > POS > Instellingen > Extensies, of download de nieuwste release van de GitHub-releasespagina en upload die via Plugins > Nieuwe toevoegen > Plugin uploaden.

3

(Pro) Een taal per winkel instellen

Gebruik je meerdere winkels met WCPOS Pro, ga dan naar POS > Winkels, bewerk een winkel en kies de taal in het zijbalkgedeelte Taal. Laat dit op Standaard staan om de standaardtaal van Polylang te gebruiken.

Taal per winkel (Pro)​

In WCPOS Pro voegt de plugin een gedeelte Taal toe aan de zijbalk van de winkeleditor. Elke winkel kan aan één Polylang-taalslug worden gekoppeld. Producten die aan die winkel worden geleverd, worden dan alleen op die taal gefilterd. Winkels die op Standaard blijven staan, gebruiken de standaardtaal van Polylang.

De waarde per winkel wordt opgeslagen als _wcpos_polylang_language-meta bij de winkelpost en beschikbaar gemaakt via de WCPOS Pro Stores REST API (/wcpos/v1/stores), zodat deze net als andere winkelinstellingen door de POS heen en terug synchroniseert.

Compatibiliteitsnotities​

  • POS-only producten: wanneer de POS-only modus in WCPOS-instellingen is ingeschakeld, worden online-only product-ID's uitgesloten van de fast-sync-payload zodat ze niet in de POS terechtkomen.
  • Gratis installaties: er is geen interface om de taal per winkel te wijzigen. De plugin gebruikt de standaardtaal van Polylang. Heb je talen per winkel nodig, upgrade dan naar WCPOS Pro.
  • Plugin niet beschikbaar: als Polylang is gedeactiveerd, doet de plugin stil niets. Hij veroorzaakt geen fouten en blokkeert de POS niet.

Ontwikkelaarshooks​

Voor geavanceerd gebruik stelt de plugin enkele filters beschikbaar:

FilterDoel
wcpos_polylang_resolved_languageOverschrijft de taal die voor een bepaalde aanvraag wordt gebruikt. Ontvangt de opgeloste slug en de WP_REST_Request.
wcpos_polylang_default_languageOverschrijft de terugvaltaal wanneer er geen winkelwaarde is ingesteld.
wcpos_polylang_is_supportedDwingt de plugin aan of uit, ongeacht Polylang-detectie.
wcpos_polylang_minimum_versionVereist een minimale Polylang-versie; standaard is er geen versiecontrole.

Vereisten​

WooCommerce: WooCommerce is geïnstalleerd en geactiveerd
Polylang: Polylang, gratis of Pro, met minimaal één geconfigureerde taal
WCPOS: De gratis versie werkt; taalkeuze per winkel vereist WCPOS Pro