Beginnen met Probo Connect plug-in voor Wordpress WooCommerce

Een vliegende start

Wil je snel beginnen met de plug-in? Hieronder staan de benodigdheden en acties zodat je direct aan de slag kunt.

• Een basiskennis van WordPress en/of WooCommerce. Heb je die niet? Neem dan contact op met een WordPress-specialist bij jou in de buurt.

• Installeer WordPress en WooCommerce als je dit nog niet gedaan hebt.

• Zorg ervoor dat je jouw Probo API-token bij de hand hebt.

• Download Probo Connect via de plug-in directory in WordPress.

• Activeer Probo Connect.

• Volg de stappen op het Probo Dashboard binnen WooCommerce.

Goed om te weten: de Probo-uploader werkt alleen in combinatie met de klassieke cart. De Probo-verzenddatums werken alleen in combinatie met de klassieke checkout.

Veelgestelde vragen.

Hieronder hebben we geprobeerd zoveel mogelijk veelvoorkomende vragen te beantwoorden.

Algemeen

Hebben jullie een demo-omgeving?

Wij hebben er bewust voor gekozen om geen demo-omgeving te maken. Je kunt de plug-in installeren op je eigen (test)omgeving of eventueel testen in de WordPress Playground.

Helpen jullie met installatie en implementatie?

Probo helpt niet bij de installatie en implementatie van de plug-in. Dit klinkt misschien raar, maar we bieden alleen technische ondersteuning op onze eigen plug-in. In deze FAQ staan hopelijk de handvatten om je verder te helpen. Mocht je er niet uitkomen, dan denken we graag met je mee of verwijzen we je door. Neem contact op via api@probo.nl.

Zitten er kosten aan het gebruik van de API en/of plug-in?

Nee. De Probo API en de WooCommerce-plug-in zijn gratis voor onze klanten.

Hoe krijg ik een Probo-account?

Meer informatie daarover staat hier → https://apidocs.proboprints.com/requesting-a-probo-account

Hoe krijg ik een Probo API-token?

Als je account is goedgekeurd en je de mogelijkheid hebt om op rekening te betalen, dan kun je een API-token aanvragen via Mijn Account → Gegevens en Voorkeuren → API-koppeling. Vul de sleutel daarna in bij WooCommerce → Instellingen → Probo Connect.

Werkt dit ook voor Shopify?

Nee, deze plug-in werkt alleen voor WordPress in combinatie met WooCommerce.

Installatie & vereisten

De plugin activeert niet of geeft een fout bij activeren

Controleer de minimumvereisten: WordPress 6.7 of hoger, PHP 8.0 of hoger en een actieve WooCommerce-installatie. Op PHP 7.4 of een oudere WooCommerce-versie werkt de plug-in niet betrouwbaar. Weet je niet welke versies je draait? Kijk dan onder WooCommerce → Status of vraag je hostingpartij.

Ik zie de Probo-instellingen nergens

De instellingen staan onder Probo Connect → Instellingen of WooCommerce → Instellingen → Probo Connect. Zie je dat tabblad niet? Dan is WooCommerce niet actief of niet volledig geladen. Activeer eerst WooCommerce en kijk daarna opnieuw.

Werkt de plugin met HPOS (High-Performance Order Storage)?

Ja, Probo Connect ondersteunt HPOS. Toont WooCommerce toch een “incompatible”-waarschuwing? Dan komt dat door een ándere ordergerelateerde plug-in die niet HPOS-compatibel is — niet door Probo Connect.

Producten

Wanneer kies je welk product?

API Products zijn standaard WooCommerce-producten (simpel of variabel) die gekoppeld zijn aan een Probo-productcode. Jij bepaalt het drukwerkbestand, jij bepaalt de prijs en je klant ziet gewoon een normale productpagina. API Products beheer je via je Probo-platform.

**Configurable Products ** laten je klanten zélf productopties kiezen (formaat, materiaal, afwerking, aantal), hun eigen ontwerp uploaden en realtime de prijs zien — allemaal via de Probo-configurator op de productpagina.

Ik wil de configurator op een andere plek plaatsen

De configurator wordt standaard automatisch ingeladen op de productpagina. Wil je hem ergens anders? Controleer dan de instellingen onder Probo → Instellingen → Geavanceerde instellingen. Je kunt daar het automatisch inladen uitzetten en zelf de shortcode [connect_configurator] plaatsen waar jij wilt.

De configurator staat in het Spaans, maar de opties niet

We hebben de standaardelementen van de configurator vertaald. De taal stel je in via de instelling probo_configurator_language. De opties van de configurator (labels en waarden uit de Probo API) worden niet automatisch meevertaald. Die kun je zelf aanpassen via de Editor bij een Probo Configurable-product.

Prijzen kloppen niet

Controleer je marge-instellingen (probo_default_margin_multiplier en eventuele rush-marges) en de prijsmodus/BTW-instellingen van de configurator (probo_configurator_price_mode en probo_configurator_price_tax). Goed om te weten: prijzen kunnen bewust niet vanaf de frontend worden aangepast — dat is een beveiligingsmaatregel.

Producten synchroniseren niet of tonen verouderde data

De synchronisatie draait op de achtergrond via WP-Cron en werkt alleen producten bij die daadwerkelijk gewijzigd zijn. Loop deze punten na:

• Draait WP-Cron op je site? Op sites met weinig verkeer of met een externe cron kan het zijn dat de sync niet vanzelf start.

• Heeft het product een geldige Probo API-code?

• Zet Advanced → Logging → Products sync aan (probo_logging_products_sync) om te zien wat er gebeurt.

WooCommmerce

Hoe stel ik de klassieke cart en klassieke checkout in?

Sinds een aantal jaar gebruikt WooCommerce standaardblokken (blocks) voor de winkelwagen en checkout. De Probo-uploader en de Probo-verzenddatums werken alleen met de klassieke varianten. Zo zet je die terug:**

• Ga naar Pagina’s in je WordPress-dashboard.

• Open de pagina Winkelwagen (Cart) en bewerk deze.

• Verwijder het bestaande winkelwagen-blok.

• Voeg het blok Klassieke winkelwagen toe of een Shortcode-blok toe en plaats daarin: [woocommerce_cart]

Sla de pagina op.

Doe daarna hetzelfde voor de checkout:

• Open de pagina Afrekenen (Checkout) en bewerk deze.

• Verwijder het bestaande checkout-blok.

• Voeg het blok Klassiek afrekenen toe of een Shortcode-blok toe en plaats daarin: [woocommerce_checkout]

Sla de pagina op.

Tip: test na het omzetten altijd even een volledige bestelling in je (test)omgeving, zodat je zeker weet dat alles goed doorloopt. 

Troubleshooting

De verbinding met Probo lukt niet

Meest voorkomende oorzaken:

• API-sleutel verkeerd gekopieerd (spatie of afgekapt).

• Server blokkeert uitgaand HTTPS-verkeer naar api.proboprints.com (firewall/proxy). Vraag dit na bij je hostingpartij.

• Verkeerde omgeving: sandbox vs. productie.

Zet Advanced → Logging → Uitgaande API-calls aan (probo_log_outgoing_api_calls) om te zien wat de API precies teruggeeft. De Authorization-header wordt nooit gelogd, dus je API-sleutel blijft veilig.

Mijn order wordt geannuleerd — wat is er gebeurd?

Controleer eerst of sandbox-modus niet per ongeluk aan staat (probo_sandbox_mode); sandbox-orders worden niet echt uitgevoerd. Stel een error-e-mail in (probo_error_email) om foutnotificaties te ontvangen, en raadpleeg het order-log (probo-order-{id}) via WooCommerce → Status → Logs.

Mijn order komt niet door naar Probo

Stel een error-e-mail in (probo_error_email) om foutnotificaties te ontvangen, en raadpleeg het order-log (probo-order-{id}).  Mocht je niet uit de foutmelding komen die je ontvangt. Controlleer dan de payload via de Bestelling Actie; Log Probo Payload.

De configurator wordt niet getoond

De configurator wordt standaard ingeladen op de Woo-actie woocommerce_single_product_summary. Het kan zijn dat jouw thema deze actie heeft aangepast of verwijderd. Je kunt de actie aanpassen via Probo → Instellingen → Geavanceerde instellingen.

Controleer daarnaast:

• Zijn je API-credentials ingevuld en geldig?

• Heeft het product een geldig Probo product-ID / API-code gekoppeld?

Elementor: gebruik de Elementor-widget voor de configurator, of gebruik de shortcode [connect_configurator] op de productpagina. Vergeet niet het automatisch inladen van de configurator uit te zetten.

Divi: gebruik de shortcode op de gewenste plek. Vergeet ook hier niet het automatisch inladen uit te zetten.

Bij custom thema’s of page builders is de shortcode vaak betrouwbaarder dan het automatisch inladen.

De configurator laadt wél, maar blijft hangen op een spinner

De configurator praat via je eigen website met Probo, zodat je API-sleutel niet zichtbaar is voor bezoekers. Die verbinding gebruikt een beveiligingscheck (same-site check). Gebruik je caching, een CDN of een reverse proxy? Dan kunnen die checkverzoeken worden geblokkeerd. Je kunt tijdelijk testen met de instelling probo_bypass_same_site_check — maar let op: begrijp de beveiligingsimplicatie voordat je dit in productie laat staan. 

Producten worden dubbel aan de winkelwagen toegevoegd

Dit was een bekend probleem bij snel klikken en is opgelost. Zie je dit nog steeds? Update naar de nieuwste versie van de plug-in.

De uploader toont niet

Onze uploader werkt alleen in combinatie met de klassieke cart. Zorg ervoor dat je deze beschikbaar hebt gemaakt (zie “Hoe stel ik de klassieke cart en klassieke checkout in?”). Gebruik je alleen simpele producten en niet de Probo-uploader, dan hoef je de klassieke cart niet te gebruiken.

Goed om te weten: producten die géén bestand nodig hebben (bijvoorbeeld template-producten), tonen de uploader-knop bewust niet.

De uploader-status blijft hangen

Bij de “bestanden na bestelling”-flow controleert de plug-in regelmatig de status bij Probo. Controleer de uploader-sessies-pagina en het poll-interval (probo_uploader_polling_interval). Werkt het nog steeds niet, kijk dan of admin-ajax.php op je site bereikbaar is — sommige security-plug-ins blokkeren dit.

De verzendmethodes worden niet getoond

Onze verzendmethodeselectie werkt alleen met de klassieke checkout (zie “Hoe stel ik de klassieke cart en klassieke checkout in?”). Gebruik je die en zie je nog steeds niets? Controleer dan:

• Heb je de verzendmethode geconfigureerd?

• Heeft het product de verzendklasse Probo Delivery

Als laatste kan het nog zijn dat je van een oudere pluginversie komt. Gebruik dan de shipping-migratie-tool in de instellingen (probo_shipping_migration_settings) om je verzendinstellingen bij te werken.

Tip: je kunt de checkout optioneel blokkeren tot de klant een leverdatum/verzendmethode heeft gekozen (probo_require_shipping_selection).

Klanten kunnen afrekenen zonder bevestigde upload

Zet probo_require_confirmed_upload aan om de checkout te blokkeren totdat de Probo-uploader bevestigd is. De klant ziet dan een melding in de winkelwagen en bij “Bestelling plaatsen”.

Orderstatussen in WooCommerce updaten niet vanuit Probo

Statusupdates van Probo komen automatisch binnen op je website via een webhook. Werkt dit niet?

De webhook-endpoint moet publiek bereikbaar zijn. Security-plug-ins of firewalls die REST-routes blokkeren, breken dit.

Controleer je statusmapping (probo_status_mapping), zodat Probo-statussen op de juiste WooCommerce-statussen vallen.

Zet Advanced → Logging → Inkomende callbacks aan (probo_log_incoming_callbacks) om te controleren of de updates binnenkomen.

Werkt het met WooCommerce Shipping & Tracking?

Ja. Zodra een statusupdate een track & trace-code bevat, wordt die automatisch aan de order toegevoegd.

De contact_email-instelling werkt niet

Het adres bij probo_contact_email moet een bestaande Probo merchant-login zijn, anders weigert de API het. Gebruik dus het e-mailadres waarmee je inlogt op je Probo-account.

Diagnose & support

Hoe kan ik zelf de payload van een order bekijken (debuggen)?

Wil je precies zien welke gegevens er naar Probo worden gestuurd (adres, producten, configuratie, leverdatum)? Dat kan zonder code, via een ingebouwde debug-actie:

• Open de order via WooCommerce → Bestellingen.

• Kies in het Bestelling-acties blok (rechts, bij de "Update"-knop) de actie "Log Probo payload (debug)" en voer deze uit.

• De volledige payload die naar Probo zou gaan, wordt weggeschreven naar het order-log.

• Bekijk het log via WooCommerce → Status → Logs, of via de "View order log"-link in het Probo Order Panel. Elke order heeft een eigen logbron: probo-order-{id}.

Wil je de payload zien van elke order die daadwerkelijk gesynct wordt? Zet dan Advanced → Logging → Uitgaande API-calls aan (probo_log_outgoing_api_calls). Elke API-call wordt dan gelogd; de Authorization-header wordt nooit gelogd.

Belangrijk om te weten:

• Zet logging weer uit na het debuggen — het staat standaard uit voor de performance.

• De payload bevat klantgegevens (naam/adres). Deel logs dus niet zomaar.

Wil je iets aanpassen aan de payload in plaats van alleen te bekijken? Dat is maatwerk via hooks (probo_order_payload_filter_*) en vraagt om een developer.

Hoe debug ik problemen het beste?

Alle logging staat standaard uit (voor de performance) en zet je per categorie aan onder Advanced → Logging:

• Order-verwerking (probo_logging_orders)

• Products sync (probo_logging_products_sync)

• Algemeen (probo_logging_general)

• Inkomende callbacks (probo_log_incoming_callbacks)

• Uitgaande API-calls (probo_log_outgoing_api_calls)

Elke categorie heeft een “view log”-link. De logs vind je terug onder WooCommerce → Status → Logs. Order-logs zijn gegroepeerd per order (probo-order-{id}). Zet alleen aan wat je nodig hebt.

Ik heb veel vastgelopen scheduled actions

Gebruik de maintenance-tool (probo_clear_scheduled_actions) om Probo scheduled actions te annuleren en op te schonen. Met dezelfde tool kun je ook logbestanden per categorie wissen.

1. Extending the logic; hooks and filters
2. Creating a custom uploader
3. Changing the styling