Handleiding

Alles wat u moet weten om
met Stepconfigurator te werken.

Van installatie tot offertes en prijskaarten. Deze handleiding loopt stap voor stap door alle onderdelen van de plugin.

Installatie

Na betaling ontvangt u een leveringsmail met een downloadlink naar de plugin (een .zip bestand) en uw licentiesleutel.

  1. Log in op uw WordPress beheerderspaneel.
  2. Ga naar Plugins → Nieuwe plugin → Plugin uploaden.
  3. Kies het bestand stepconfigurator-x.x.x.zip en klik op Nu installeren. Pak de zip niet eerst uit: WordPress wil het zip bestand zelf.
  4. Klik op Plugin activeren.

Na activatie opent de welkomstpagina. Die vindt u later terug onder Stepconfigurator → Welkom, met vinkjes voor wat al gedaan is.

Vereisten

WordPress 6.0 of hoger, PHP 8.0 of hoger en een actieve installatie van WooCommerce. De configurator draait op een eigen pagina en werkt met vrijwel elk WooCommerce thema.

Licentie activeren

Zolang er geen geldige licentie is, doet de plugin niets op uw site. U ziet dan alleen het menu Stepconfigurator met de licentiepagina.

  1. Ga naar Stepconfigurator (of Stepconfigurator → Licentie).
  2. Plak uw licentiesleutel in het veld. Het formaat is STEPCONFIG-XXXX-XXXX-XXXX.
  3. Klik op Activeren.

De plugin controleert de sleutel bij stepconfigurator.com. Daarna ziet u de status Geactiveerd met de verloopdatum. Vanaf dat moment controleert de plugin eenmaal per dag of de licentie nog geldig is. Is stepconfigurator.com tijdelijk onbereikbaar, dan blijft alles gewoon werken.

Domein en testomgevingen

De licentie hoort bij het domein waarop u hem activeert. Met of zonder www maakt niet uit. Een test- of stagingomgeving op een ander domein heeft een eigen sleutel nodig. Die testlicentie krijgt u gratis op aanvraag.

Configurator-pagina

De configurator draait op een eigen WordPress-pagina, standaard met de slug /samenstellen/. Bezoekers komen daar via de knop op de productpagina. Zonder deze pagina krijgen ze een 404.

Ontbreekt de pagina, dan ziet u bovenaan het beheer een melding met de knop Maak pagina automatisch aan. Dezelfde knop staat op Stepconfigurator → Help onder Setup status.

Liever zelf maken? Maak een pagina met de slug samenstellen, zet de shortcode [stepconfigurator] als enige inhoud en publiceer hem.

Andere slug

Wilt u een ander adres, bijvoorbeeld /configureren/? Pas de slug aan bij Stepconfigurator → Instellingen → Paginaslug (vanaf versie 1.22.1), geef de pagina dezelfde slug en klik daarna op Instellingen → Permalinks → Wijzigingen opslaan.

Configurator op een product

  1. Open een product onder Producten. Gebruik een eenvoudig of variabel product.
  2. Scroll naar het blok Configurator opties.
  3. Vink Configurator inschakelen aan en werk het product bij.

Op de productpagina vervangt een knop nu de gewone winkelwagenknop. De tekst stelt u in bij Instellingen → Knoptekst op productpagina. Kiest de klant op de productpagina al een kleur of uitvoering, dan staat die in de configurator vooraf geselecteerd.

Een product gebruikt standaard de globale stappen. Wilt u voor dit product eigen stappen, vink dan Productspecifieke stappen aan. Welke producten de configurator gebruiken, ziet u op Stepconfigurator → Producten overzicht.

Stappen: globaal of per product

Een configurator bestaat uit stappen die de klant doorloopt, bijvoorbeeld Uitvoering, Accessoires en Service. U kunt ze op twee plekken maken.

  • Globale stappen (menu Stepconfigurator → Globale stappen): een sjabloon voor alle producten zonder eigen stappen. Handig bij veel vergelijkbare producten.
  • Per product: in het blok Configurator opties, met Productspecifieke stappen aangevinkt.

Klik op Stap toevoegen, geef de stap een label en eventueel een intro tekst. Stappen, groepen en opties versleept u om de volgorde te wijzigen. Ingeklapte stappen blijven ingeklapt als u later terugkomt.

Groepen en opties

Binnen een stap werkt u met groepen, en groepen bevatten opties. Een groep heet bijvoorbeeld "Kleur" en de opties zijn "Rood", "Zwart" en "Wit". Klik op + Groep toevoegen. Een groep heeft vier tabbladen: Algemeen, Opties, Conditie en Geavanceerd.

Bij Type kiest u Radio (klant kiest één), Checkbox (meerdere) of Variatie (gekoppeld aan WooCommerce, zie hieronder). Bij Display stijl kiest u Lijst, Kaarten, Raster of Pakketten. Verder kunt u een groep verplicht maken, als aanbevolen markeren of inklapbaar maken.

Per optie stelt u in:

  • Label en beschrijving: wat de klant ziet.
  • Afbeelding: uit de mediabibliotheek.
  • Meerprijs: komt bovenop de productprijs.
  • Oude prijs: toont een doorgestreepte van/voor prijs.
  • Standaard geselecteerd en Aanbevolen.
  • Exclusief: sluit bij keuze de andere opties in een checkboxgroep uit. Handig voor een optie als "Geen accessoires".

Met het kopieer-icoon dupliceert u een groep of optie en past u alleen de verschillen aan.

Groepsbibliotheek

Terugkerende groepen, zoals een set accessoires, maakt u eenmalig aan onder Stepconfigurator → Groepsbibliotheek. In een product laadt u ze met de keuzelijst Bibliotheekgroep inladen. De groep wordt dan in het product gezet. Past u de bibliotheek later aan, laad de groep dan opnieuw in bij de producten waar dat nodig is.

WooCommerce variaties koppelen

Bij een variabel product kunt u een groep direct aan een attribuut koppelen, zoals kleur of uitvoering. Prijs en voorraad komen dan uit WooCommerce.

  1. Zorg dat het product variabel is en minstens één gepubliceerde variatie heeft.
  2. Voeg een groep toe en kies bij Type voor Variatie (WooCommerce).
  3. Kies bij Variatie attribuut het attribuut uit de lijst. U ziet meteen welke waarden erbij horen.

Kiest u de display stijl Pakketten, dan vult u bij Extra info per waarde per waarde een korte kop, voordelen en een foto in. Elke regel wordt een voordeel met vinkje. Begin een regel met een min-teken voor een nadeel.

Tip

Combineer variatiegroepen met gewone groepen. Gebruik variaties voor alles met voorraad en eigen groepen voor extra’s zoals accessoires of service.

Conditioneel tonen

Een groep kan alleen verschijnen als de klant eerder iets bepaalds koos. Zo blijft de configurator kort en relevant.

  1. Open de groep en ga naar het tabblad Conditie.
  2. Zet Conditioneel tonen aan.
  3. Kies bij Afhankelijk van groep de groep waarvan de keuze bepalend is.
  4. Vink onder Toon als één van deze opties is gekozen de opties aan.

Voorbeeld: een groep "Topkoffer kleur" verschijnt alleen als bij "Accessoires" de topkoffer gekozen is.

Prijzen en winkelwagen

De basisprijs komt uit WooCommerce, bij een variabel product van de gekozen variatie. Meerprijzen van opties komen erbovenop en het totaal loopt live mee in het overzicht.

De complete samenstelling gaat als één regel naar de winkelwagen, met alle keuzes erbij. U en uw klant zien in de bestelling precies wat er besteld is. Onder Instellingen → Extra tekst onder prijs zet u desgewenst een korte regel onder de prijs, zoals "Inclusief btw en bezorging".

Pakketten

Met de display stijl Pakketten toont u een groep als grote kaarten met foto's, voordelen en de inhoud van het pakket. Handig voor een accessoirepakket of een complete uitvoering.

  • Plek van de pakketten: in een vaste kolom links naast de stap, of gewoon tussen de andere groepen.
  • Inhoud van het pakket: kies artikelen die al als optie in uw configurator staan. Prijs en montagetijd lopen dan automatisch mee, en de klant kan niets dubbel bestellen.
  • Pakketprijs: een vaste prijs, of de som van de artikelen met een korting in euro of procent. De klant ziet wat hij bespaart.
  • Uitgelicht: markeert het pakket dat u wilt aanraden.

Montage of installatie

Verkoopt u artikelen die u ook monteert of plaatst, dan rekent de plugin dat werk voor u uit.

  1. Ga naar Stepconfigurator → Instellingen → Montage.
  2. Vul het uurloon in, inclusief btw, en kies waarop bedragen worden afgerond.
  3. Geef het werk bij Benaming een naam, bijvoorbeeld "Montage", "Installatie" of "Plaatsing". Die naam gebruikt de configurator overal.
  4. Stel per optie bij Montage bij dit artikel in hoe het werk meetelt, en vul de montagetijd in minuten in.

Er zijn vier keuzes: geen montage, inbegrepen in de prijs, inbegrepen maar de klant mag het uitzetten, of optioneel. Bij "inbegrepen in de prijs" vult u de prijs in die de klant betaalt. Ligt die onder artikel plus montage, dan ziet de klant het verschil als korting.

Let op

Een betaalde optie mag volgens de Europese consumentenregels niet vooraf aangevinkt staan. Bij de keuze "optioneel" staat het vinkje daarom altijd uit.

Btw-vrij deel in de prijs

Zit er in uw prijs een bedrag waarover geen btw wordt gerekend, zoals leges, dan stelt u dat in bij Instellingen → Btw-vrij deel. Per product kunt u afwijken in het blok Configurator: btw-vrij deel: overnemen, uit, of een eigen bedrag.

Met In de winkelwagen splitsen komt het bedrag als aparte regel zonder btw in de winkelwagen. Het totaal blijft gelijk, maar WooCommerce rekent alleen btw over de rest.

Controleer

Doe na het aanzetten een testbestelling en laat uw boekhouder meekijken. Of een bedrag echt btw-vrij is, hangt af van uw situatie.

Offerte als PDF

Klanten kunnen hun samenstelling als PDF-offerte downloaden, via WhatsApp delen of printen. Zet dit aan bij Instellingen → Offerte als PDF → Offerteknop tonen.

U stelt daar ook uw logo, bedrijfsgegevens, een contactregel, de geldigheid in dagen en een voettekst in. Laat u de bedrijfsgegevens leeg, dan gebruikt de plugin de winkelgegevens uit WooCommerce. Bij Standaard inbegrepen zet u punten die altijd met een vinkje op de offerte komen, één per regel.

Alle offertes staan onder Stepconfigurator → Offertes. Er worden geen persoonsgegevens opgeslagen, alleen de samenstelling.

Prijskaarten en branche-opties

Voor een showroom of winkel maakt u prijskaarten als PDF, rechtstreeks vanuit de configurator. Zet dit aan bij Instellingen → Prijskaart en branche-opties → Prijskaarten maken.

Bent u ingelogd als beheerder of winkelmanager, dan staat in het overzicht van de configurator een blok Prijskaart. Stel het product samen zoals het in de winkel staat, typ eventueel extra punten en kies A5 liggend, A5 staand of A4. Bezoekers zien dit blok nooit.

De kaart toont uw logo, de productfoto, de prijsopbouw en een QR-code naar de productpagina. Het prijslabel, de eerste regel en de tekst bij de QR-code stelt u zelf in.

Scooter- en fietsdealers

Met de knop Instellingen voor scooter- en fietsdealers invullen zet u in één klik de prijskaart, snor/brom labels, in3 en SprayPay aan, met gangbare dealerteksten. Bestaande teksten blijven staan. Er wordt pas iets bewaard als u op Opslaan klikt.

Focusmodus

Met Instellingen → Focused mode → Afleidingsvrije pagina toont de configurator-pagina zonder het menu en de footer van uw thema. De klant ziet alleen het samenstellen en uw logo. Onderaan kunt u een korte vertrouwenstekst zetten, bijvoorbeeld over garantie of bezorging. Dit werkt met elk thema.

Uiterlijk aanpassen

Onder Stepconfigurator → Uiterlijk laat u de configurator bij uw huisstijl passen, met een live voorbeeld:

  • Kleuren: hoofdkleur, donkere variant, tekstkleur en de kleur van de hero-tekst.
  • Knoppen: kleuren van "In winkelmand" en "Direct afrekenen", en kleur en formaat van de knop op de productpagina.
  • Indeling: de breedte van de configurator.
  • Teksten: de titel en subtitel bovenaan de configurator-pagina.

Gebruikt u een cache-plugin, leeg dan de cache na het opslaan.

Taal

Bij Instellingen → Taal / Language kiest u Nederlands of Engels voor alle vaste teksten die de klant ziet, zoals knoppen, het overzicht en de offerte. Labels die u zelf invoert, zoals groeps- en optienamen, blijven zoals u ze typt.

Een meertalige webshop met WPML of Polylang ondersteunt de plugin niet standaard. Neem gerust contact op, dan kijken we samen naar uw situatie.

Gespreid betalen tonen

De plugin kan onder de prijs tonen wat de klant per termijn of per maand betaalt. Dat is een indicatie: de echte betaling loopt via de betaalmethoden in WooCommerce.

  • IN3: administratiekosten in procent, een vast bedrag en een maximumbedrag waarboven de regel verdwijnt.
  • SprayPay: de maandfactor uit uw overeenkomst, een vast bedrag en een maximumbedrag.

Beide staan bij Instellingen, zijn los aan en uit te zetten en hebben een eigen logo. Nieuwe installaties hebben ze standaard uit staan.

Updates installeren

Updates komen niet via de gewone WordPress-updates. Bij een nieuwe versie krijgt u een e-mail met een downloadlink.

  1. Download de nieuwe stepconfigurator-x.x.x.zip.
  2. Ga naar Plugins → Nieuwe plugin → Plugin uploaden en kies het bestand.
  3. WordPress ziet dat de plugin al bestaat. Kies Vervang huidige versie door geüploade versie.
  4. Leeg daarna uw cache.

Belangrijk

Verwijder de plugin nooit eerst. Gebruik altijd "Vervang huidige versie". Uw stappen, instellingen en offertes blijven dan gewoon staan.

Licentie verlengen

Ongeveer twee weken voor de verloopdatum ontvangt u automatisch een verlengingsfactuur. Na betaling wordt de licentie met twaalf maanden verlengd. U hoeft op uw site niets te doen.

Verlengt u niet, dan blijft de configurator op uw webshop werken, zodat uw klanten gewoon kunnen blijven bestellen. U kunt de configurator dan niet meer aanpassen en u ontvangt geen updates en support meer. In het beheer ziet u in dat geval het scherm Licentie vereist.

Veelvoorkomende problemen

De knop op de productpagina geeft een 404

Controleer op Stepconfigurator → Help of de configurator-pagina bestaat en gepubliceerd is. Bestaat hij wel, ga dan naar Instellingen → Permalinks en klik op Wijzigingen opslaan zonder iets aan te passen. Dat lost de meeste 404-problemen op.

Wijzigingen zijn niet zichtbaar voor bezoekers

Vrijwel altijd een cache. Leeg uw cache-plugin (LiteSpeed Cache, WP Rocket en dergelijke), eventueel uw CDN, en controleer in een privévenster.

Het attribuut staat niet in de lijst bij Variatie attribuut

Het product moet variabel zijn en minstens één gepubliceerde variatie hebben. Werk het product eerst bij en open het daarna opnieuw.

De prijs in de winkelwagen klopt niet

Controleer de basisprijs van het product in WooCommerce, de prijzen van de variaties en of er kortingen of coupons actief zijn. Gebruikt u het btw-vrije deel met splitsen in de winkelwagen, doe dan een testbestelling.

De licentie wordt niet geaccepteerd

Controleer of u de volledige sleutel hebt geplakt in het formaat STEPCONFIG-XXXX-XXXX-XXXX en of u activeert op het domein waarvoor de licentie is uitgegeven. De foutmelding op de licentiepagina vertelt wat er aan de hand is. Komt u er niet uit, mail dan de sleutel en uw domein naar info@stepconfigurator.com.

Ik zie het scherm "Licentie vereist"

Uw licentie is verlopen of niet (meer) geldig op dit domein. Uw klanten kunnen bij een verlopen licentie gewoon blijven bestellen, maar aanpassen kan pas weer na verlenging. Ga naar Stepconfigurator → Licentie voor de details.

Vraag er niet bij?

Wij helpen graag. Stuur een bericht via het contactformulier en u krijgt binnen een werkdag antwoord.

Stel uw vraag

Bijgewerkt voor versie 1.22, september 2026.