# Erweiterungen

WCPOS unterstützt Erweiterungen, die neue Funktionen zur Kasse hinzufügen. Im Erweiterungsverzeichnis können verfügbare Erweiterungen durchsucht, direkt über die Einstellungen im POS installiert und Updates verwaltet werden.

Pro-Funktion

Für die Installation und Verwaltung von Erweiterungen ist [WCPOS Pro](/de/getting-started/pro-license.md) erforderlich. Die kostenlose Version zeigt den Erweiterungskatalog an, deaktiviert jedoch die Installations- und Aktivierungssteuerungen.

## Verfügbare Erweiterungen[​](#available-extensions "Direkter Link zu Verfügbare Erweiterungen")

### Zahlungsgateways[​](#payment-gateways "Direkter Link zu Zahlungsgateways")

Individuelle Checkout-Gateways für den Vor-Ort-Einsatz im POS.

[DE: Stripe TerminalDE: Vor-Ort-Kartenzahlungen mit Stripe Terminal-Hardware (S700, WisePOS E). Unterstützt MOTO- und Simulatormodus.](/de/payment/gateways/stripe-terminal.md)

[DE: SumUp TerminalDE: Akzeptieren Sie Kartenzahlungen über SumUp-Kartenlesegeräte.](/de/payment/gateways/sumup-terminal.md)

[DE: Vipps MobilePayDE: Telefonbasierte Zahlungen per QR-Code oder Push-Benachrichtigung. Vipps (Norwegen), MobilePay (Dänemark, Finnland).](/de/payment/gateways/vipps-mobilepay.md)

[DE: E-Mail-RechnungDE: Senden Sie dem Kunden einen Zahlungslink per E-Mail, um die Bestellung online zu begleichen.](/de/payment/gateways/email-invoice.md)

Möchten Sie ein eigenes erstellen? Beginnen Sie mit der [Gateway-Vorlage](/de/reference/gateway-template.md) — oder sehen Sie sich die [Übersicht benutzerdefinierter Gateways](/de/payment/gateways/.md) für die vollständige Liste an.

### Mehrsprachig[​](#multilingual "Direkter Link zu Mehrsprachig")

Filtern Sie POS-Produkte nach Sprache, damit übersetzte Duplikate nicht in der Kassensuche und im Katalograster erscheinen.

[DE: WCPOS PolylangDE: Polylang-Integration — sprachbewusste Produktsynchronisation und Sprachauswahl pro Filiale für WCPOS Pro.](/de/extensions/polylang.md)

[DE: WCPOS WPMLDE: WPML-Integration — POS-Produkte auf eine einzelne Sprache filtern.](/de/extensions/wpml.md)

[DE: WCPOS WP MultilangDE: WP-Multilang-Integration — POS-Produkte auf eine einzelne Sprache filtern.](/de/extensions/wp-multilang.md)

### Gutscheine und Ladenguthaben[​](#coupons-and-store-credit "Direkter Link zu Gutscheine und Ladenguthaben")

[DE: WCPOS StoreApps Smart CouponsDE: StoreApps Smart Coupons-Ladenguthaben in WCPOS einlösen, mit Guthaben-Anzeige auf dem Beleg und Prüfverlauf in den Bestellnotizen.](/de/extensions/storeapps-smart-coupons.md)

### Bestandsverwaltung[​](#inventory "Direkter Link zu Bestandsverwaltung")

[DE: WCPOS ATUM-IntegrationDE: WCPOS Pro-Filialen mit ATUM Multi-Inventory-Lagerorten verknüpfen für standortbezogenen Bestand, Preise und SKUs.](/de/extensions/atum.md)

## Erweiterungen durchsuchen[​](#browsing-extensions "Direkter Link zu Erweiterungen durchsuchen")

Das Erweiterungsverzeichnis kann über `POS Settings > Erweiterungen` geöffnet werden (in manchen Versionen als **Plugins** bezeichnet).

Das Verzeichnis zeigt ein Kartenraster der verfügbaren Erweiterungen. Jede Karte enthält:

* **Symbol** (oder ein Puzzleteil-Platzhalter, wenn die Erweiterung keines bereitstellt)
* **Name und Version**
* **Beschreibung**
* **Kategorie-Badge**
* **Status** — aktiv, inaktiv, Update verfügbar oder nicht installiert

### Filtern und Suchen[​](#filtering-and-search "Direkter Link zu Filtern und Suchen")

Verwenden Sie die **Kategorie-Buttons** oben, um Erweiterungen nach Kategorie zu filtern. Über das **Suchfeld** können Erweiterungen auch nach Name, Beschreibung oder Schlagwörtern gesucht werden.

## Eine Erweiterung installieren[​](#installing-an-extension "Direkter Link zu Eine Erweiterung installieren")

1. Öffnen Sie `POS Settings > Erweiterungen`.
2. Suchen Sie die gewünschte Erweiterung und klicken Sie auf **Installieren**.
3. Die Erweiterung wird über den WordPress-Plugin-Installer heruntergeladen und installiert.
4. Klicken Sie nach der Installation auf **Aktivieren**, um die Erweiterung zu aktivieren.

Im Hintergrund verwendet WCPOS die native WordPress-Klasse `Plugin_Upgrader` für die Installation, sodass Erweiterungen denselben Prozess wie jedes andere WordPress-Plugin durchlaufen.

## Aktivieren und Deaktivieren[​](#activating-and-deactivating "Direkter Link zu Aktivieren und Deaktivieren")

Jede installierte Erweiterung hat die Schaltflächen **Aktivieren** und **Deaktivieren** auf ihrer Karte.

* **Aktivieren** aktiviert die Erweiterung, sodass sie im POS ausgeführt werden kann.
* **Deaktivieren** schaltet die Erweiterung ab, ohne sie zu deinstallieren. Die Erweiterungsdateien verbleiben auf dem Server und können jederzeit wieder aktiviert werden.

## Erweiterungen aktualisieren[​](#updating-extensions "Direkter Link zu Erweiterungen aktualisieren")

Wenn eine neuere Version einer installierten Erweiterung verfügbar ist, wird auf der Karte ein **Update verfügbar**-Badge und eine Schaltfläche **Aktualisieren** angezeigt.

### Automatische Aktualisierungen[​](#auto-updates "Direkter Link zu Automatische Aktualisierungen")

Aus dem Verzeichnis installierte Erweiterungen haben **automatische Updates standardmäßig aktiviert**. Automatische Updates können pro Erweiterung über die jeweilige Karte im Verzeichnis ein- oder ausgeschaltet werden. Wenn automatische Updates aktiviert sind, wendet WordPress neue Versionen automatisch an – genau wie bei Plugins mit aktivierten automatischen Updates.

## Fehlerbehebung[​](#troubleshooting "Direkter Link zu Fehlerbehebung")

### „Pro erforderlich"-Meldung auf Schaltflächen[​](#requires-pro-message-on-buttons "Direkter Link zu „Pro erforderlich\"-Meldung auf Schaltflächen")

Die Schaltflächen zum Installieren, Aktivieren und Aktualisieren sind in der kostenlosen Version von WCPOS deaktiviert. Für die Verwaltung von Erweiterungen ist ein Upgrade auf [WCPOS Pro](/de/getting-started/pro-license.md) erforderlich.

### Erweiterung lässt sich nicht installieren[​](#extension-fails-to-install "Direkter Link zu Erweiterung lässt sich nicht installieren")

* Stellen Sie sicher, dass Ihr WordPress-Server Schreibrechte für das Verzeichnis `wp-content/plugins` hat.
* Überprüfen Sie, ob Ihr Server ausgehende HTTPS-Anfragen senden kann (einige Hoster blockieren externe Downloads).
* Sehen Sie sich die Fehlerdetails unter `WP Admin > POS > Support > Protokolle` an.

### Erweiterung wird nach der Installation nicht angezeigt[​](#extension-not-appearing-after-install "Direkter Link zu Erweiterung wird nach der Installation nicht angezeigt")

* Aktualisieren Sie das POS – die Erweiterungsliste wird bis zu 12 Stunden zwischengespeichert.
* Bestätigen Sie, dass die Erweiterung aktiviert ist (installierte, aber inaktive Erweiterungen werden nicht ausgeführt).

### Katalog wird nicht geladen[​](#catalog-not-loading "Direkter Link zu Katalog wird nicht geladen")

Der Erweiterungskatalog wird von einer externen Quelle abgerufen und lokal für 12 Stunden zwischengespeichert. Wenn der Katalog nicht geladen wird:

* Überprüfen Sie die Internetverbindung Ihres Servers.
* Versuchen Sie es erneut, nachdem der Cache abgelaufen ist, oder leeren Sie den Transient-Cache Ihres Servers.

***

## Für Entwickler[​](#for-developers "Direkter Link zu Für Entwickler")

### Eine POS-Erweiterung erstellen[​](#creating-a-pos-extension "Direkter Link zu Eine POS-Erweiterung erstellen")

Eine WCPOS-Erweiterung ist ein Standard-WordPress-Plugin, das sich über WCPOS-Hooks und APIs in das POS integriert. So erstellen Sie eine:

1. **Mit einem WordPress-Plugin beginnen.** Ihre Erweiterung benötigt einen Standard-Plugin-Header und eine Einstiegsdatei, genau wie jedes WooCommerce- oder WordPress-Plugin.
2. **Integration mit WCPOS.** Verwenden Sie die von WCPOS bereitgestellten Hooks und Filter, um dem POS-Interface oder Backend Funktionalität hinzuzufügen.
3. **Releases auf GitHub hosten.** Das Erweiterungsverzeichnis verwendet GitHub Releases zur Versionsverfolgung und Bereitstellung von Updates.

### Einreichung im Verzeichnis[​](#submitting-to-the-directory "Direkter Link zu Einreichung im Verzeichnis")

Der Erweiterungskatalog wird im GitHub-Repository [`wcpos/extensions`](https://github.com/wcpos/extensions) gepflegt. So listen Sie Ihre Erweiterung:

1. Überprüfen Sie das Katalogformat und die Metadaten-Anforderungen in der README des Repositorys.
2. Öffnen Sie einen Pull Request, um die Metadaten Ihrer Erweiterung zu `catalog.json` hinzuzufügen.
3. Nach dem Merge erscheint Ihre Erweiterung im Verzeichnis für alle WCPOS Pro-Nutzer.

### GitHub-Release-Konventionen[​](#github-release-conventions "Direkter Link zu GitHub-Release-Konventionen")

Der Update-Lebenszyklus basiert auf GitHub Releases:

* **Tag-Versionen** mit semantischer Versionierung vergeben (z. B. `v1.0.0`, `v1.2.3`).
* **Die Plugin-ZIP-Datei** als Release-Asset anhängen — diese Datei wird heruntergeladen, wenn ein Benutzer die Erweiterung installiert oder aktualisiert.
* **Das Release veröffentlichen** (nicht als Entwurf), damit das Verzeichnis es erkennen kann.

Wenn ein neues Release veröffentlicht wird, sehen Benutzer mit installierter Erweiterung das verfügbare Update in ihrem Erweiterungsverzeichnis. Falls die automatische Aktualisierung aktiviert ist, wird es automatisch angewendet.

Ausführliche Informationen zum Katalogschema und zum Einreichungsprozess finden Sie im [`wcpos/extensions`](https://github.com/wcpos/extensions)-Repository.