Zum Hauptinhalt springen
Version: 1.x

WCPOS Polylang

Ergänzt WCPOS um Unterstützung für Polylang, damit das POS nur Produkte einer einzelnen Sprache anzeigt. So erscheinen keine doppelten Übersetzungen in der Produktsuche, im Katalograster oder in Kassiervorgängen. WCPOS-Pro-Filialen können eine Sprache pro Filiale festlegen; kostenlose Installationen verwenden die Polylang-Standardsprache.

Funktionsweise

  • Filtert WCPOS-REST-Abfragen für Produkte und Varianten nach Sprache.
  • Fängt WCPOS-Fast-Sync-Routen ab, also die schlanken posts_per_page=-1- und fields-Anfragen, mit denen das POS seinen lokalen Index aktualisiert, damit übersetzte Duplikate nie beim Client ankommen.
  • Verwendet bei kostenlosen Installationen die Polylang-Standardsprache.
  • Ermöglicht in Pro-Installationen, dass jede Filiale in einem neuen Abschnitt Sprache im Filial-Editor eine eigene Sprache auswählt.
  • Berücksichtigt die WCPOS-Sichtbarkeit Nur POS beim Aufbau der Fast-Sync-Nutzlast.

Die Integration bleibt sauber inaktiv, wenn Polylang nicht aktiviert ist. Sie können das Plugin also schon vor der Aktivierung von Polylang installieren, ohne Fehler auszulösen.

Installation

1

Polylang installieren

Installieren Sie Polylang oder Polylang Pro und konfigurieren Sie die Sprachen Ihrer Website wie gewohnt. Stellen Sie sicher, dass mindestens eine Sprache als Standard festgelegt ist.

2

WCPOS Polylang installieren

Installieren Sie die Erweiterung über das WCPOS-Erweiterungsverzeichnis unter WP Admin > POS > Einstellungen > Erweiterungen, oder laden Sie die neueste Version von der GitHub-Releases-Seite herunter und installieren Sie sie über Plugins > Neu hinzufügen > Plugin hochladen.

3

(Pro) Sprache pro Filiale festlegen

Wenn Sie mit WCPOS Pro mehrere Filialen betreiben, öffnen Sie POS > Filialen, bearbeiten Sie eine Filiale und wählen Sie die Sprache im Seitenleistenabschnitt Sprache. Lassen Sie die Auswahl auf Standard, um die Polylang-Standardsprache zu verwenden.

Sprache pro Filiale (Pro)

In WCPOS Pro fügt das Plugin dem Filial-Editor einen Abschnitt Sprache in der Seitenleiste hinzu. Jede Filiale kann an einen einzelnen Polylang-Sprachslug gebunden werden. Produkte, die an diese Filiale ausgeliefert werden, werden dann ausschließlich auf diese Sprache gefiltert. Filialen mit der Einstellung Standard verwenden die Polylang-Standardsprache.

Der Wert pro Filiale wird als _wcpos_polylang_language-Meta am Filial-Beitrag gespeichert und über die WCPOS-Pro-REST-API für Filialen (/wcpos/v1/stores) bereitgestellt. Dadurch wird er wie jede andere Filialeinstellung durch das POS synchronisiert.

Kompatibilitätshinweise

  • Nur-POS-Produkte: Wenn der Nur-POS-Modus in den WCPOS-Einstellungen aktiviert ist, werden IDs von reinen Online-Produkten aus der Fast-Sync-Nutzlast ausgeschlossen, damit sie nicht im POS erscheinen.
  • Kostenlose Installationen: Es gibt keine Oberfläche, um die Sprache pro Filiale zu ändern. Das Plugin verwendet die Polylang-Standardsprache. Wenn Sie Sprachen pro Filiale benötigen, wechseln Sie zu WCPOS Pro.
  • Plugin nicht verfügbar: Wenn Polylang deaktiviert ist, führt das Plugin stillschweigend nichts aus. Es wirft keine Fehler und blockiert das POS nicht.

Entwickler-Hooks

Für fortgeschrittene Anwendungsfälle stellt das Plugin einige Filter bereit:

FilterZweck
wcpos_polylang_resolved_languageÜberschreibt die Sprache für eine bestimmte Anfrage. Erhält den aufgelösten Slug und die WP_REST_Request.
wcpos_polylang_default_languageÜberschreibt die Ausweichsprache, wenn kein filialspezifischer Wert gesetzt ist.
wcpos_polylang_is_supportedErzwingt das Ein- oder Ausschalten des Plugins unabhängig von der Polylang-Erkennung.
wcpos_polylang_minimum_versionVerlangt eine Mindestversion von Polylang; standardmäßig gibt es keine Versionsprüfung.

Voraussetzungen

WooCommerce: WooCommerce ist installiert und aktiviert
Polylang: Polylang, kostenlos oder Pro, mit mindestens einer konfigurierten Sprache
WCPOS: Die kostenlose Version funktioniert; die Sprachauswahl pro Filiale erfordert WCPOS Pro