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.
Für die Installation und Verwaltung von Erweiterungen ist WCPOS Pro erforderlich. Die kostenlose Version zeigt den Erweiterungskatalog an, deaktiviert jedoch die Installations- und Aktivierungssteuerungen.
Verfügbare Erweiterungen
Zahlungsgateways
Individuelle Checkout-Gateways für den Vor-Ort-Einsatz im POS.
Möchten Sie ein eigenes erstellen? Beginnen Sie mit der Gateway-Vorlage — oder sehen Sie sich die Übersicht benutzerdefinierter Gateways für die vollständige Liste an.
Mehrsprachig
Filtern Sie POS-Produkte nach Sprache, damit übersetzte Duplikate nicht in der Kassensuche und im Katalograster erscheinen.
Gutscheine und Ladenguthaben
Bestandsverwaltung
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
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
- Öffnen Sie
POS Settings > Erweiterungen. - Suchen Sie die gewünschte Erweiterung und klicken Sie auf Installieren.
- Die Erweiterung wird über den WordPress-Plugin-Installer heruntergeladen und installiert.
- 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
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
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
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
„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 erforderlich.
Erweiterung lässt sich nicht installieren
- Stellen Sie sicher, dass Ihr WordPress-Server Schreibrechte für das Verzeichnis
wp-content/pluginshat. - Ü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 > Protokollean.
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
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
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:
- Mit einem WordPress-Plugin beginnen. Ihre Erweiterung benötigt einen Standard-Plugin-Header und eine Einstiegsdatei, genau wie jedes WooCommerce- oder WordPress-Plugin.
- Integration mit WCPOS. Verwenden Sie die von WCPOS bereitgestellten Hooks und Filter, um dem POS-Interface oder Backend Funktionalität hinzuzufügen.
- Releases auf GitHub hosten. Das Erweiterungsverzeichnis verwendet GitHub Releases zur Versionsverfolgung und Bereitstellung von Updates.
Einreichung im Verzeichnis
Der Erweiterungskatalog wird im GitHub-Repository wcpos/extensions gepflegt. So listen Sie Ihre Erweiterung:
- Überprüfen Sie das Katalogformat und die Metadaten-Anforderungen in der README des Repositorys.
- Öffnen Sie einen Pull Request, um die Metadaten Ihrer Erweiterung zu
catalog.jsonhinzuzufügen. - Nach dem Merge erscheint Ihre Erweiterung im Verzeichnis für alle WCPOS Pro-Nutzer.
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-Repository.