Extensies
WCPOS ondersteunt extensies die nieuwe functionaliteit toevoegen aan je point of sale. Met de extensiedirectory kun je beschikbare extensies bekijken, ze rechtstreeks vanuit de POS-instellingen installeren en updates beheren.
Het installeren en beheren van extensies vereist WCPOS Pro. De gratis versie toont de extensiecatalogus, maar schakelt de installatie- en activeringsknoppen uit.
Beschikbare extensies
Betaalgateways
Aangepaste afrekengateways ontworpen voor persoonlijk POS-gebruik.
Wil je je eigen extensie bouwen? Begin bij de Gateway Template — of bekijk het overzicht van aangepaste gateways voor de volledige lijst.
Meertalig
Filter POS-producten op taal zodat vertaalde duplicaten niet verschijnen in de kassierszoekfunctie en de catalogusgrid.
Coupons en winkeltegoed
Voorraad
Door extensies bladeren
Open de extensiedirectory via POS Settings > Extensions (in sommige versies ook aangeduid als Plugins).
De directory toont een rasterweergave van kaarten met beschikbare extensies. Elke kaart toont:
- Pictogram (of een puzzelstuk-terugval als de extensie er geen aanlevert)
- Naam en versie
- Beschrijving
- Categoriebadge
- Status — actief, inactief, update beschikbaar of niet geïnstalleerd
Filteren en zoeken
Gebruik de categoriepilknoppen bovenaan om extensies op categorie te filteren. Je kunt ook het zoekveld gebruiken om extensies te vinden op naam, beschrijving of tags.
Een extensie installeren
- Open
POS Settings > Extensions. - Zoek de gewenste extensie en klik op Install.
- De extensie wordt gedownload en geïnstalleerd met behulp van de WordPress-plugininstaller.
- Klik na installatie op Activate om deze in te schakelen.
Achter de schermen gebruikt WCPOS de native Plugin_Upgrader van WordPress om de installatie af te handelen, zodat extensies hetzelfde proces volgen als elke andere WordPress-plugin.
Activeren en deactiveren
Elke geïnstalleerde extensie heeft de knoppen Activate en Deactivate op de bijbehorende kaart.
- Activate schakelt de extensie in zodat deze in de POS kan draaien.
- Deactivate schakelt deze uit zonder te verwijderen. De extensiebestanden blijven op je server staan en kunnen op elk moment opnieuw worden geactiveerd.
Extensies bijwerken
Wanneer er een nieuwere versie van een geïnstalleerde extensie beschikbaar is, toont de kaart een Update Available-badge en een Update-knop.
Automatische updates
Extensies die vanuit de directory zijn geïnstalleerd, hebben automatische updates standaard ingeschakeld. Je kunt automatische updates per extensie in- of uitschakelen via de bijbehorende kaart in de directory. Wanneer automatische updates aanstaan, past WordPress nieuwe versies automatisch toe, net zoals bij plugins met automatische updates ingeschakeld.
Probleemoplossing
Bericht "Requires Pro" op knoppen
De knoppen voor installeren, activeren en bijwerken zijn uitgeschakeld in de gratis versie van WCPOS. Upgrade naar WCPOS Pro om extensies te beheren.
Extensie kan niet worden geïnstalleerd
- Controleer of je WordPress-server schrijfrechten heeft voor de map
wp-content/plugins. - Controleer of je server uitgaande HTTPS-verzoeken kan doen (sommige hosts blokkeren externe downloads).
- Bekijk de foutdetails in
WP Admin > POS > Support > Logs.
Extensie verschijnt niet na installatie
- Vernieuw de POS — de extensielijst wordt tot 12 uur in de cache bewaard.
- Bevestig dat de extensie is geactiveerd (geïnstalleerde maar inactieve extensies draaien niet).
Catalogus laadt niet
De extensiecatalogus wordt opgehaald uit een externe bron en lokaal 12 uur in de cache bewaard. Als de catalogus niet laadt:
- Controleer de internetverbinding van je server.
- Probeer het opnieuw nadat de cache is verlopen, of wis de transiëntcache van je server.
Voor ontwikkelaars
Een POS-extensie maken
Een WCPOS-extensie is een standaard WordPress-plugin die via WCPOS-hooks en -API's integreert met de POS. Om er een te maken:
- Begin met een WordPress-plugin. Je extensie heeft een standaard plugin-header en entrybestand nodig, net als elke WooCommerce- of WordPress-plugin.
- Integreer met WCPOS. Gebruik de hooks en filters die WCPOS biedt om functionaliteit toe te voegen aan de POS-interface of backend.
- Host releases op GitHub. De extensiedirectory gebruikt GitHub Releases om versies bij te houden en updates te leveren.
Indienen bij de directory
De extensiecatalogus wordt beheerd in de GitHub-repository wcpos/extensions. Om je extensie te laten vermelden:
- Bekijk het catalogusformaat en de metadatavereisten in de README van de repository.
- Open een pull request om de metadata van je extensie toe te voegen aan
catalog.json. - Nadat deze is samengevoegd, verschijnt je extensie in de directory voor alle WCPOS Pro-gebruikers.
Conventies voor GitHub-releases
De updatecyclus berust op GitHub Releases:
- Tag versies met semantische versionering (bijv.
v1.0.0,v1.2.3). - Voeg de plugin-zip toe als release-asset — dit is het bestand dat wordt gedownload wanneer een gebruiker installeert of bijwerkt.
- Publiceer de release (geen concept) zodat de directory deze kan detecteren.
Wanneer je een nieuwe release publiceert, zien gebruikers met je extensie geïnstalleerd de update beschikbaar in hun extensiedirectory. Als automatische updates zijn ingeschakeld, wordt deze automatisch toegepast.
Voor volledige details over het catalogusschema en het indieningsproces, zie de repository wcpos/extensions.