# WooCommerce instellen op KapsuleHost

Source: https://support.kapsulehost.com/nl-nl/wordpress-woocommerce

KapsuleHost heeft een speciaal WooCommerce-sitetype dat WordPress, WooCommerce en een set Nieuw-Zeelandse betaalgateways voor je installeert, en vervolgens winkelspecifieke tools aan het sitemenu toevoegt. Deze handleiding behandelt het aanmaken van de winkel, het koppelen van betalingen, de instellingen die belangrijk zijn voor een winkel onder belasting, en hoe je wijzigingen kunt doorvoeren zonder bestellingen kwijt te raken.

## De WooCommerce-site aanmaken

1. Log in bij [KPanel](https://kpanel.kapsulehost.com) en klik op **Websites** in de linkerzijbalk.
2. Klik op **Website toevoegen**, daarna op **Nieuwe Website**.
3. Kies **WooCommerce** als sitetype.
4. Geef de winkel een naam en rond de wizard af.

KapsuleHost richt WordPress in, maakt de database aan, installeert en activeert WooCommerce, en installeert vooraf de hieronder genoemde betaalgateway-plugins. PHP 8.3 wordt ingesteld als runtime, met de extensies die een winkel nodig heeft, inclusief beeldverwerking.

Heb je al een WordPress-site en wil je er een winkel aan toevoegen, installeer WooCommerce dan op de gebruikelijke manier via **Plugins**, daarna **Nieuw toevoegen** in wp-admin. De site behoudt zijn WordPress-sitetype, wat betekent dat de winkelspecifieke tabbladen die hier beschreven worden niet zullen verschijnen.

> **Note:** Migreer je een bestaande winkel in plaats van opnieuw te beginnen? Bouw deze niet handmatig opnieuw op. Gebruik **Migraties** in de linkerzijbalk, waarmee bestanden en database worden gekopieerd terwijl je huidige winkel de hele tijd actief blijft. Zie [Een Website Migreren Vanuit cPanel](https://support.kapsulehost.com/nl-nl/sites-migrate-cpanel).

## Betaalgateways

Open de winkel, daarna het tabblad **WordPress**, daarna **Betalingen**. Dit is een tabblad dat alleen voor WooCommerce geldt en niet verschijnt bij gewone WordPress-sites.

![Paneel voor betaalgateways van een WooCommerce-winkel](https://support.kapsulehost.com/help/screenshots/wordpress-woocommerce.475328e2.webp)

Er worden vijf gateways behandeld, waarbij de voor Nieuw-Zeeland relevante zijn gemarkeerd:

| Gateway | Dekt | Status bij een nieuwe winkel |
|---|---|---|
| Stripe | Kaarten, Apple Pay en Google Pay | Vooraf geïnstalleerd, inactief |
| Afterpay | Koop nu, betaal later | Vooraf geïnstalleerd, inactief |
| POLi | Nieuw-Zeelandse bankoverschrijving | Vooraf geïnstalleerd, inactief |
| PayPal | PayPal en kaarten | Vooraf geïnstalleerd, inactief |
| Windcave | Nieuw-Zeelandse kaartverwerking en EFTPOS | Beschikbaar, installeer via de leverancier |

Apple Pay en Google Pay zijn inbegrepen bij Stripe: er is voor geen van beide iets apart te installeren.

Gateways worden bewust **inactief** geïnstalleerd. Een ingeschakelde gateway zonder gegevens verbreekt het afrekenproces, dus niets gaat live totdat je je eigen merchant-accountgegevens invoert:

1. Klik op **Inschakelen** bij de gateway die je gebruikt.
2. Klik op **Configureren**, waarmee de instellingen van die gateway binnen wp-admin worden geopend.
3. Voer je eigen API-sleutels of merchantgegevens in en sla op.
4. Plaats een testbestelling voordat je de winkel aankondigt.

Windcave wordt door de leverancier verspreid en niet via de plugin-directory, dus het paneel toont een **Plugin ophalen**-link. Download deze, upload hem via **Plugins**, daarna **Nieuw toevoegen** in wp-admin, en kom daarna terug om hem hier te configureren.

> **Note:** Het tabblad **Betalingen** maakt deel uit van Managed WooCommerce. Bij andere abonnementen toont het in plaats daarvan een upgradepaneel. Je kunt nog steeds elke gateway rechtstreeks in wp-admin installeren en configureren, ongeacht het abonnement: het tabblad is een snelkoppeling, niet de enige route.

## Winkelprestaties

Een winkel doet per paginaweergave veel meer databasewerk dan een brochuresite, dus caching levert daar de grootste winst op.

**Volledige paginacache.** Op het tabblad **WordPress** van de site, daarna **Caching**, levert de volledige paginacache afgewerkte HTML aan anonieme bezoekers zonder PHP uit te voeren of de database aan te raken. De winkelwagen, het afrekenproces, de mijn-account-pagina's en de WooCommerce AJAX-eindpunten worden automatisch overgeslagen, en elke bezoeker met een actief winkelwagencookie krijgt altijd een live pagina te zien. De cache versnelt product- en categoriepagina's zonder ooit de winkelwagen van de ene klant aan een andere klant te tonen.

**Objectcache.** Op hetzelfde scherm bewaart de objectcache databaseresultaten en transients in het geheugen. Dit is degene die het WooCommerce-beheerpaneel bruikbaar maakt bij een grote catalogus.

**CDN.** Schakel dit in via **Prestaties**, daarna **Kapsule CDN** om productafbeeldingen en statische bestanden vanaf de edge te leveren, met beeldoptimalisatie en WebP-conversie bij abonnementen met Kapsule CDN+. Zie [De CDN Inschakelen](https://support.kapsulehost.com/nl-nl/cdn-enabling). Maak de cache leeg na een bulkwijziging van productafbeeldingen: [De CDN-cache Legen](https://support.kapsulehost.com/nl-nl/cdn-cache-purge).

> **Tip:** Volledige paginacache en objectcache zijn inbegrepen bij Managed WooCommerce. Als je winkel op een ander abonnement draait, toont het tabblad Caching wat de upgrade toevoegt. Schakel in beide gevallen eerst de CDN in: deze is inbegrepen bij elk Web Hosting-, WordPress-, Managed WordPress-, Managed WooCommerce- en Concierge-abonnement, en het is de goedkoopste prestatieverbetering die beschikbaar is bij een beeldintensieve winkel.

## PHP-instellingen voor een Winkel

Winkels zijn de meest voorkomende reden om van de standaardwaarden af te wijken. Op het tabblad **Instellingen**, daarna **PHP** van de site:

- **Geheugenlimiet**: verhoog van 256M naar 512M als de catalogus groot is of je abonnementen aanbiedt.
- **Maximale uitvoeringstijd**: verhoog van 30 naar 120 of 300 seconden als productimporten of rapportgeneratie vastlopen door een time-out.
- **Maximale invoervariabelen**: verhoog vanaf 3000 als je producten hebt met veel variaties, of een instellingenscherm dat velden stilletjes laat vervallen bij het opslaan.

Volledige details vind je in [De WordPress-geheugenlimiet Verhogen](https://support.kapsulehost.com/nl-nl/wordpress-memory-limit).

## Geplande Taken

WooCommerce voert op de achtergrond heel veel uit: statusovergangen van bestellingen, verlengingen van abonnementen, e-mails, voorraadsynchronisatie. Het gebruikt de ingebouwde planner van WordPress, die standaard alleen wordt geactiveerd wanneer iemand de site bezoekt. Bij een rustige winkel betekent dit dat verlengingen en e-mails te laat of helemaal niet worden uitgevoerd.

Vervang dit door een echt serverzijdig schema. Het tabblad **WordPress**, daarna de sectie **WP-Cron** heeft een actie **Systeem-cron inschakelen** die het schema toevoegt en tegelijkertijd de door bezoekers geactiveerde versie uitschakelt. Volledige uitleg en het handmatige alternatief vind je in [Cronjobs Instellen en Beheren](https://support.kapsulehost.com/nl-nl/cron-jobs).

Je kunt de wachtrij bekijken via **WooCommerce**, daarna **Status**, daarna **Geplande Acties** in wp-admin.

## Wijzigingen Doorvoeren Zonder Bestellingen Kwijt te Raken

Elke winkel is een live database waar klanten voortdurend naar schrijven, wat invloed heeft op hoe je met updates moet omgaan.

> **Important:** Push nooit een staging-database naar een live winkel. Bestellingen, klanten, abonnementen, kortingsbonnen en voorraadniveaus bevinden zich allemaal in de database, dus een databasepush verwijdert elke bestelling die is geplaatst sinds je laatste reset vanuit productie. Push **alleen bestanden**, wat voldoende is voor wijzigingen aan thema's, plugins en code. Zie [Staging Gebruiken: Pushen en Pullen](https://support.kapsulehost.com/nl-nl/wordpress-staging-workflow).

Een veilige updateroutine voor een winkel:

1. Maak een back-up: [Een Back-up Maken](https://support.kapsulehost.com/nl-nl/taking-a-backup).
2. Reset staging vanuit productie zodat het overeenkomt met de live winkel.
3. Pas de plugin-, thema- of WooCommerce-updates toe op staging.
4. Plaats een volledige testbestelling op staging, helemaal tot aan de bevestigingspagina.
5. Push **alleen bestanden** naar productie.
6. Plaats een kleine echte bestelling op productie en crediteer deze terug.

Bij managed abonnementen wordt de actie **Plugins bijwerken** onder **Snelle acties** vervangen door **Slimme update**: deze maakt een back-up, werkt plugins één voor één bij, voert na elke update een site-gezondheidscontrole uit, en draait automatisch alles terug wat de site breekt. Bij een winkel waar een kapot afrekenproces geld kost, is dat de moeite waard.

## Herstel naar Tijdstip

Dagelijkse back-ups herstellen een winkel naar de staat waarin deze zich bevond toen die back-up liep, wat bij een drukke winkel kan betekenen dat je een dag aan bestellingen kwijtraakt. WooCommerce-sites kunnen herstel naar tijdstip inschakelen via **Back-ups**, daarna **Herstel naar tijdstip**, en herstellen naar een gekozen minuut in plaats daarvan, met een bewaartermijn tot 30 dagen. Schakel dit in bij elke winkel die echt geld verwerkt. Zie [Een Back-up Maken](https://support.kapsulehost.com/nl-nl/taking-a-backup).

## Probleemoplossing

**Afrekenen mislukt zonder foutmelding.** Bijna altijd een ingeschakelde gateway met ontbrekende of onjuiste gegevens. Schakel gateways één voor één uit via het tabblad **Betalingen** totdat het afrekenen werkt, en configureer daarna degene opnieuw die het probleem veroorzaakte.

**E-mails voor bestellingen komen niet aan.** WordPress verstuurt e-mail standaard via PHP en de meeste netwerken weigeren dit. Controleer de bezorgwaarschuwing op het tabblad **WordPress**, daarna **Site-gezondheid**, en configureer correct geauthenticeerde verzending.

**Beheerderspagina's zijn traag of lopen vast.** Verhoog het geheugen en de uitvoeringstijd op het tabblad **PHP**, en schakel daarna de objectcache in. Een winkel met tienduizenden bestellingen heeft ook baat bij het opschonen van oude geplande acties.

**Productwijzigingen verschijnen niet op de front-end.** Maak de cache leeg via **WordPress**, daarna **Snelle acties**, daarna **Cache leegmaken**, en leeg ook de CDN.