# WCPOS Polylang

Ergänzt WCPOS um Unterstützung für [Polylang](https://polylang.pro/), 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[​](#what-it-does "Direkter Link zu 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[​](#installation "Direkter Link zu Installation")

1

#### Polylang installieren

Installieren Sie [Polylang](https://wordpress.org/plugins/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](https://github.com/wcpos/wcpos-polylang/releases) 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](/de/stores/.md) 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)[​](#per-store-language-pro "Direkter Link zu 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[​](#compatibility-notes "Direkter Link zu 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](/de/getting-started/pro-license.md).
* **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[​](#developer-hooks "Direkter Link zu Entwickler-Hooks")

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

| Filter                             | Zweck                                                                                                       |
| ---------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `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_supported`      | Erzwingt das Ein- oder Ausschalten des Plugins unabhängig von der Polylang-Erkennung.                       |
| `wcpos_polylang_minimum_version`   | Verlangt eine Mindestversion von Polylang; standardmäßig gibt es keine Versionsprüfung.                     |

## Voraussetzungen[​](#requirements "Direkter Link zu 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

## Verwandte Themen[​](#related "Direkter Link zu Verwandte Themen")

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