Ga naar de hoofdinhoud
Versie: 1.x

Verbinding maken met uw winkel

Alleen desktop en mobiel

Dit scherm wordt alleen weergegeven in de desktop- en mobiele apps. Webgebruikers openen de POS rechtstreeks via yourdomain.com/pos en melden zich aan met hun WordPress-inloggegevens.

Overzicht van het scherm Verbinden

Wanneer u de WCPOS desktop- of mobiele app opent, ziet u het scherm Verbinden. Hier beheert u uw winkelverbindingen en gebruikersaanmeldingen.

Een nieuwe winkel toevoegen

  1. Voer de URL van uw WooCommerce-winkel in het tekstveld in (bijv. https://mystore.com)
  2. Klik op Verbinden
  3. U wordt doorgestuurd om in te loggen met uw WordPress-inloggegevens
  4. Na een geslaagde aanmelding keert u terug naar de app

Meerdere winkels

U kunt zoveel WooCommerce-winkels koppelen als nodig is. Elke winkel verschijnt als een afzonderlijke kaart op het scherm Verbinden, met:

  • Winkelnaam en favicon
  • Winkel-URL
  • Ingelogde gebruikers voor die winkel

Dit is handig als u meerdere locaties of bedrijven beheert.

Meerdere gebruikers per winkel

Elke winkel kan meerdere gebruikers tegelijk ingelogd hebben. Dit is handig voor:

  • Wisseling van diensten - Een nieuwe kassamedewerker kan inloggen voordat de vorige uitlogt
  • Set-ups met meerdere kassa's - Verschillende kassamedewerkers op verschillende apparaten
  • Snel wisselen - Wissel eenvoudig tussen gebruikersaccounts

Een gebruiker toevoegen

Klik op de knop naast "Ingelogde gebruikers" om nog een gebruiker aan die winkel toe te voegen.

Van gebruiker wisselen

Klik op een gebruikersbadge (bijv. "Brenda") om de POS als die gebruiker te openen.

Een gebruiker verwijderen

Klik op de × op een gebruikersbadge om die gebruiker uit te loggen bij de winkel.

Een winkel verwijderen

Klik op de rode ×-knop op de winkelkaart om deze uit je lijst te verwijderen. Hiermee worden alle gebruikers uitgelogd en wordt de winkelverbinding uit de app verwijderd.

Demowinkel

Onderaan het scherm zie je mogelijk een link "Demowinkel openen". Hiermee maak je verbinding met een demo-WooCommerce-winkel om WCPOS-functies uit te proberen zonder je eigen winkelgegevens te beïnvloeden.

Probleemoplossing

Eerste controle: X-Frame-Options

De desktop- en mobiele apps gebruiken iframes voor inloggen, betalingen en kassabonnen. Elke serverheader of plugin die X-Frame-Options: DENY of SAMEORIGIN verstuurt, verstoort het inloggen. Dit is de meest voorkomende oorzaak van mislukte app-aanmeldingen: controleer eerst de responseheaders van de inlogpagina (browserontwikkelaarstools, of curl -I https://yourstore.com/wp-login.php) voordat je iets anders controleert.

Kan geen verbinding maken met mijn winkel?
  • Zorg dat de WCPOS-plugin is geinstalleerd en geactiveerd op je WordPress-site
  • Controleer of je de juiste URL gebruikt (inclusief https:// — de WooCommerce REST API vereist SSL)
  • Probeer eerst yourdomain.com/pos in een webbrowser te openen om te bevestigen dat de plugin werkt
  • Controleer of de WooCommerce REST API toegankelijk is
  • Controleer of je gebruikersaccount toegangsrechten voor POS heeft
Inloggen mislukt in de desktop- of mobiele app

De meeste mislukte app-aanmeldingen worden veroorzaakt door een beveiligings- of cachingplugin die de login-iframe blokkeert:

  • X-Frame-Options-headers (ingesteld door een beveiligingsplug-in of je server) blokkeren de aanmeld-iframe — zie de opmerking hierboven. Schakel de beveiligingsplug-in tijdelijk uit, meld je aan en schakel deze daarna weer in (je sessie blijft ongeveer een week geldig).
  • Beveiligingsplug-ins — Wordfence, Really Simple Security, WPS Hide Login, iThemes/Solid Security en Defender Pro zijn vaak de oorzaak. Bekijk de volledige lijst en oplossingen in Plug-inconflicten.
  • Wordfence 2FA — het veld voor de 2FA-code wordt niet weergegeven in de aanmeld-iframe. Schakel 2FA voorlopig uit voor POS-gebruikers.
  • Aangepaste aanmeld-URL (bijv. WPS Hide Login) — de app kan de aanmeldpagina niet vinden. Gebruik de standaard-URL /wp-admin/.
  • Cacheplug-ins kunnen het geblokkeerde aanmeldformulier blijven aanbieden, zelfs nadat je de veroorzakende plug-in hebt uitgeschakeld — leeg de cache, of leeg de app-cache / installeer de desktopapp opnieuw.
"REST API vereist authenticatie" of een fout van een beveiligingsplug-in op het verbindingsscherm

Een plug-in (bijv. Force Login of een JWT-authplug-in) vereist authenticatie voor alle REST API-aanvragen, waardoor de app de openbare informatie van je site niet kan lezen. De app toont nu het daadwerkelijke serverbericht (bijv. "Alleen geauthenticeerde gebruikers hebben toegang tot de REST API") in plaats van het sitetype verkeerd te rapporteren.

Oplossing: configureer de beveiligingsplug-in om niet-geverifieerde toegang tot /wp-json/wcpos/ en /wp-json/wc/v3/ toe te staan, of schakel deze net lang genoeg uit om de eerste verbinding te voltooien.

"Lijkt geen WordPress-site te zijn" (desktopapp)

De desktopapp ontdekt de REST API via de HTTP Link-header. Als een plug-in (vaak Image Prioritizer of andere prestatieplug-ins) die header overspoelt of afkapt, mislukt de ontdekking. Oplossing: schakel plug-ins voor beeldoptimalisatie / prestatieplug-ins die headers wijzigen uit en probeer het opnieuw.

De app zegt dat er een update nodig is / crasht na een update

Controleer of er een versieverschil is tussen de app en de serverplug-in — de appwinkel kan een app-update hebben uitgerold terwijl de WCPOS-plug-in nog moet worden bijgewerkt (of andersom). Zorg ervoor dat de app en de WCPOS-plug-in dezelfde hoofdversie gebruiken. WCPOS v1.9.0+-apps vereisen dat de WCPOS-plug-in v1.8.0 of hoger is.

"Kan snelle winkeldatabase niet aanmaken"-fout

Dit is een race condition bij de eerste aanmelding. Sluit de app volledig af en probeer het opnieuw — meestal lukt het bij de tweede poging.

Vast op het scherm voor gebruikersselectie (desktop-app)

Na het aanmelden ziet u uw gebruikersnaam, maar geen duidelijke manier om verder te gaan. Klik op uw gebruikersnaam/naam om door te gaan naar de POS — de naam zelf is de knop.

Blijft de verbinding mislukken?
  • Probeer eerst yourdomain.com/pos in een webbrowser te openen om te controleren of de plugin werkt
  • Controleer de foutlogs van uw site op problemen
  • Controleer of uw host de REST API niet blokkeert — zie hostingspecifieke opmerkingen
  • Zorg ervoor dat uw server voldoet aan de minimumvereisten