Stap voor stap uitleg bij Provisual Klantportaal: de plugin die je klanten een eigen inlogomgeving geeft in WordPress, gekoppeld aan je Moneybird-administratie. Van installeren tot en met problemen oplossen.
Inhoud
  1. Wat is het Klantportaal?
  2. Wat heb je nodig?
  3. Installeren
  4. Licentie activeren
  5. Moneybird koppelen
  6. De portalpagina maken
  7. Afzender van de inlogmail instellen
  8. Huisstijl: logo, kleur en lettertype
  9. Snelheid en bewaarde gegevens
  10. Zo gebruiken je klanten het portaal
  11. Beveiliging en privacy
  12. Updaten en licentie verlengen
  13. Problemen oplossen
  14. Hulp nodig?
Wat is het Klantportaal?

Met Provisual Klantportaal krijgen je klanten een eigen inlogomgeving op jouw WordPress-site, gekoppeld aan jouw eigen Moneybird-administratie. Je klanten hebben geen WordPress-account nodig: ze loggen in met een link die naar hun e-mailadres wordt gestuurd.

Na het inloggen kunnen je klanten:

  • hun bedrijfs- en contactgegevens bekijken en wijzigen (de wijziging komt direct in Moneybird te staan);
  • bovenaan in één oogopslag zien hoeveel er openstaat en wat te laat is;
  • al hun facturen zien, met de status betaald, open of te laat, en ze doorzoeken en filteren op status of jaar;
  • een factuur als PDF downloaden;
  • bij een openstaande factuur doorklikken naar de betaalpagina van Moneybird;
  • openstaande offertes bekijken en goedkeuren;
  • hun facturenoverzicht downloaden als CSV-bestand, bijvoorbeeld voor de boekhouder.

Elke installatie gebruikt zijn eigen Moneybird-token en -administratie. De plugin is dus niet gekoppeld aan de boekhouding van Provisual.

Het portaal past zich aan je huisstijl aan en laadt snel: zie Huisstijl: logo, kleur en lettertype en Snelheid en bewaarde gegevens.

Wat heb je nodig?
  • een WordPress-site met WordPress 6.0 of nieuwer en PHP 7.4 of nieuwer;
  • een Moneybird-administratie waarin je klanten als contact staan, met hun e-mailadres erbij;
  • een licentiesleutel voor de plugin (die krijg je na je bestelling);
  • een site die e-mail kan versturen, want de inloglink gaat per e-mail naar de klant.
Installeren
  1. Log in op het klantportaal van Provisual en ga naar Mijn licenties. Klik bij Provisual Klantportaal op Download laatste versie.
  2. Ga in WordPress naar Plugins → Nieuwe plugin → Plugin uploaden en kies het zip-bestand dat je hebt gedownload.
  3. Klik op Nu installeren en daarna op Activeren.

Er verschijnt nu een nieuw item Klantportaal in het menu aan de linkerkant van WordPress. Daar doe je de volgende stappen.

Licentie activeren

Zonder actieve licentie werkt het klantportaal voor je klanten niet. Je activeert de licentie zo:

  1. Ga naar Klantportaal in het WordPress-menu.
  2. Plak je sleutel in het veld Licentiesleutel en klik op Activeren.
  3. Bovenaan staat nu de status active, met de datum waarop de licentie verloopt.

Een licentie is gekoppeld aan het webadres van je site. Op de pagina Mijn licenties in het klantportaal van Provisual zie je op welke sites je licentie actief is.

Ga je verhuizen naar een ander domein? Klik dan eerst op Deactiveren op de oude site. Daarna kun je de sleutel op de nieuwe site activeren.

De instellingenpagina van Provisual Klantportaal met de blokken Licentie, Moneybird-koppeling en Portal

De instellingenpagina onder Klantportaal in het WordPress-menu: licentie, Moneybird-koppeling en portal.

Moneybird koppelen

Om de gegevens van je klanten op te halen, heeft de plugin toegang nodig tot je Moneybird-administratie. Dat regel je met een API-token en het administratie-ID.

API-token aanmaken

  1. Log in op Moneybird en maak een nieuw token aan op moneybird.com/user/applications/new.
  2. Kies persoonlijk API-token. Vink daar alleen de rechten voor verkoopfacturen en offertes aan en geen andere. Het portaal heeft niets anders nodig. Een token met minder rechten kan veel minder, ook als het ooit in verkeerde handen zou komen.
  3. Kopieer het token.

Administratie-ID opzoeken

Het administratie-ID is het lange getal in het webadres van Moneybird als je bent ingelogd: moneybird.com/<administratie-id>/....

Invullen in WordPress

  1. Ga naar Klantportaal en zoek het blok Moneybird-koppeling.
  2. Plak het token bij API-token en het getal bij Administratie-ID.
  3. Klik op Instellingen opslaan.

Controleren of het goed staat

Klik op Klantportaal → Veiligheid → Controleer koppeling. Het portaal test dan alleen-lezen (er verandert niets in Moneybird) of het token bij de klantgegevens, facturen en offertes kan. Heeft het token ook toegang tot dingen die het portaal niet nodig heeft, zoals banken, inkoopfacturen of tijdregistratie? Dan krijg je een waarschuwing. Maak in dat geval een nieuw token aan met alleen de juiste rechten en vervang het oude, en trek het oude token in Moneybird in.

Het token wordt versleuteld in de database van je website bewaard en staat nooit meer in de pagina. Het veld blijft na het opslaan leeg met de tekst “Token opgeslagen”. Laat het leeg als je het token wilt behouden. Wil je het wissen, zet dan een vinkje bij Opgeslagen token wissen.

De portalpagina maken
  1. Maak in WordPress een nieuwe pagina, bijvoorbeeld “Klantportaal” of “Mijn account”.
  2. Zet de volgende code in de pagina, in een blok Shortcode:
    [provisual_klantportaal]
  3. Publiceer de pagina en zet hem eventueel in je menu.
  4. Kies deze pagina bij Klantportaal → Portal → Portalpagina en sla op. Die keuze wordt alleen gebruikt voor de link naar het portaal in WordPress zelf.

Gebruik je een cacheplugin? Sluit de portalpagina dan uit van paginacaching. Die pagina toont persoonlijke gegevens van de ingelogde klant en mag nooit uit de cache aan een ander worden getoond.

Afzender van de inlogmail instellen

Onder Klantportaal → Portal bepaal je van wie de inlogmail lijkt te komen:

  • Afzendernaam: bijvoorbeeld de naam van je bedrijf;
  • Afzenderadres: bijvoorbeeld info@jouwdomein.nl.

Standaard worden de sitenaam en het beheerders-e-mailadres van WordPress gebruikt.

Gebruik een afzenderadres op je eigen domein. Mailproviders zijn dan minder snel geneigd de mail als spam te markeren.

Het logo en de kleur van de knop in deze mail stel je in bij Huisstijl: logo, kleur en lettertype.

Huisstijl: logo, kleur en lettertype Vanaf versie 0.2.0

Laat het klantportaal bij je merk passen. Ga naar Klantportaal in het WordPress-menu en zoek het blok Uiterlijk.

  • Logo: klik op Logo kiezen en kies een afbeelding uit je mediabibliotheek, of upload een nieuwe. Een PNG of JPG met een transparante of witte achtergrond werkt het best. Het logo staat boven het inlogscherm, boven het overzicht en in de inlogmail, en wordt maximaal 200 bij 56 pixels getoond. Met Logo verwijderen haal je het weer weg.
  • Accentkleur: de kleur van de knoppen, het actieve tabblad en de samenvatting. De tekstkleur op de knoppen wordt automatisch wit of donker gekozen, zodat hij leesbaar blijft. Met Standaardkleur ga je terug naar het blauw.
  • Lettertype: Zoals mijn thema (aanbevolen) gebruikt het lettertype van je website. Systeemlettertype gebruikt het standaardlettertype van het apparaat van de klant.
  • Hoeken: Scherp, Licht afgerond of Rond (ronde knoppen).

Het blok Uiterlijk op de instellingenpagina met logo, accentkleur, lettertype, hoeken en een voorbeeld

Het blok Uiterlijk, met onderaan een voorbeeld dat direct meebeweegt.

Onder Voorbeeld zie je meteen hoe het portaal eruitziet. Het wordt pas definitief als je op Instellingen opslaan klikt.

Ook de inlogmail krijgt je logo en kleur:

De inlogmail met het logo van het bedrijf en een gekleurde knop Inloggen

De inlogmail in je eigen huisstijl.

Sommige mailprogramma’s tonen afbeeldingen pas als de ontvanger dat toestaat. Tot die tijd staat in de mail de naam van je site in plaats van het logo.

Snelheid en bewaarde gegevens Vanaf versie 0.2.0

Het portaal vraagt de gegevens van een klant bij Moneybird op: zijn gegevens, facturen en offertes. Om de pagina snel te laten laden bewaart het die gegevens een paar minuten op je eigen website, per klant. Moneybird hoeft dan niet bij elke klik opnieuw te worden aangeroepen.

  • Gegevens bewaren: onder Klantportaal → Snelheid stel je het aantal minuten in. Standaard is dat 2. Vul 0 in om niets te bewaren; het portaal vraagt dan bij elke klik alles opnieuw op en kan trager zijn.
  • Past de klant zijn gegevens aan of keurt hij een offerte goed? Dan worden zijn bewaarde gegevens direct gewist en ziet hij meteen het nieuwe resultaat.
  • De klant kan onderaan zelf op Vernieuwen klikken.
  • Heb je zelf iets aangepast in Moneybird en wil je dat klanten het direct zien? Klik onder Klantportaal → Bewaarde gegevens wissen op Alles nu wissen. Dat gebeurt ook vanzelf als je het Moneybird-token of het administratie-ID wijzigt.

Het blok Snelheid met het aantal minuten en daaronder Bewaarde gegevens wissen

Het blok Snelheid en de knop om alles te wissen.

De bewaarde gegevens staan tijdelijk in de database van je eigen website, nergens anders. Ze verdwijnen vanzelf na de ingestelde tijd en worden ook verwijderd als je de plugin verwijdert.

Zo gebruiken je klanten het portaal

Inloggen

  1. De klant opent de portalpagina en vult zijn e-mailadres in. Dat moet hetzelfde adres zijn als bij zijn contact in Moneybird.
  2. Hij klikt op Stuur inloglink en ontvangt een e-mail.
  3. In de e-mail klikt hij op de inlogknop. Op de pagina die opent klikt hij op Inloggen.

Het inlogscherm van het klantportaal met je logo, een e-mailveld en de knop Stuur inloglink

Stap 1: de klant vult zijn e-mailadres in.

Het scherm met de knop Inloggen nadat de klant op de link in de e-mail heeft geklikt

Stap 3: na de klik op de link in de e-mail bevestigt de klant met één knop.

De link is 15 minuten geldig en kan één keer gebruikt worden. Daarna blijft de klant 8 uur ingelogd, of tot hij op Uitloggen klikt.

Het tussenstapje “Inloggen” is bewust. Veel e-mailprogramma’s openen links automatisch om ze op virussen te controleren. Door eerst een knop te tonen, wordt de inloglink daardoor niet verbruikt.

Het scherm meldt altijd hetzelfde, ook als het e-mailadres niet bekend is: “Staat dit e-mailadres bij ons geregistreerd? Dan ontvang je zo een inloglink.” Zo kan niemand uitproberen welke adressen klant zijn.

Het overzicht na het inloggen

Bovenaan staat een begroeting, met je logo als je dat hebt ingesteld. Daaronder staat een samenvatting met drie blokjes:

  • Openstaand: het bedrag dat de klant nog moet betalen en het aantal facturen;
  • Te laat: de facturen die voorbij de vervaldatum zijn. Dit blokje kleurt rood zodra er iets te laat is;
  • Offertes: hoeveel offertes er op een reactie van de klant wachten. Dit blokje staat er alleen als de klant offertes heeft.

Elk blokje is een knop: een klik toont direct de bijbehorende facturen of offertes. Staat er iets open, dan volgt een balk met één knop. Is het één factuur, dan is dat Betaal nu; zijn het er meer, dan Bekijk openstaande facturen.

Het overzicht van het klantportaal met begroeting, samenvatting, tabbladen en de lijst met facturen

Het overzicht: samenvatting bovenaan, daaronder de tabbladen Facturen, Offertes en Mijn gegevens.

Facturen

De klant ziet al zijn facturen, de nieuwste bovenaan, met nummer, datum, bedrag en status. Bij een openstaande factuur staat de vervaldatum onder de datum. Is een factuur voor een deel betaald, dan staat onder het bedrag hoeveel er nog openstaat. Met de knop PDF downloadt de klant de factuur. Bij een openstaande factuur staat een knop Betaal nu die naar de betaalpagina van Moneybird gaat.

Boven de lijst staan een zoekveld en twee keuzelijsten:

  • Zoeken: op factuurnummer, referentie of bedrag, bijvoorbeeld 0291 of 241,95;
  • Status: alle statussen, Openstaand, Te laat of Betaald;
  • Jaar: alle jaren of één jaar.

Kiest de klant iets uit een keuzelijst, dan past de lijst zich meteen aan. Bij het zoekveld klikt hij op Zoeken. Met Wissen staat alles weer terug. Heeft de klant meer dan 15 facturen, dan staan ze op meerdere pagina’s met knoppen Vorige en Volgende.

De lijst met facturen gefilterd op Openstaand, met de link Wissen en onderaan het aantal facturen en Download overzicht

De lijst gefilterd op openstaande facturen.

De onderkant van de facturenlijst met aantal, paginering, Download overzicht en Vernieuwen

Onderaan: het aantal facturen, de pagina’s, het CSV-overzicht en de knop Vernieuwen.

Overzicht downloaden voor de boekhouder

Onder de lijst staat Download overzicht (CSV). De klant krijgt dan een bestand met precies de facturen die op dat moment in de lijst staan, dus met de gekozen zoekopdracht, status en jaar. Per factuur staan er nummer, datum, vervaldatum, status, referentie, bedrag zonder en met btw en wat er nog openstaat in. Het bestand opent in Excel met de juiste tekens en kolommen. Handig voor een jaaroverzicht: kies bij Jaar bijvoorbeeld 2026 en download het bestand.

Offertes

Het tabblad Offertes verschijnt alleen als de klant offertes heeft; een getal naast de naam toont hoeveel er op een reactie wachten. Offertes in concept zijn niet zichtbaar. Een verstuurde offerte kan de klant bekijken, en zolang hij open staat ook goedkeuren met Keur goed. De status verandert dan in Moneybird.

Het tabblad Offertes met een openstaande en een geaccepteerde offerte en de knoppen Keur goed en Bekijken

Offertes met hun status en de knoppen Keur goed en Bekijken.

Mijn gegevens

De klant kan zijn bedrijfsnaam, voor- en achternaam, telefoonnummer en adres aanpassen. Na Wijzigingen opslaan staan die gegevens meteen in Moneybird. Het e-mailadres kan de klant hier niet zelf wijzigen.

Het tabblad Mijn gegevens met bedrijfsnaam, naam, telefoon en adres

Mijn gegevens: het e-mailadres staat vast, de rest kan de klant wijzigen.

Gegevens vernieuwen

Onderaan staat een regel als “Gegevens van 14:32” met de link Vernieuwen. Het portaal bewaart de gegevens kort om snel te laden (zie Snelheid en bewaarde gegevens). Heeft de klant net betaald of is er net iets veranderd in Moneybird, dan haalt Vernieuwen direct de actuele gegevens op. Dat kan hooguit eens in de 15 seconden.

Beveiliging en privacy
  • Klanten hebben geen WordPress-account. Ze komen nooit in het beheer van je site.
  • Inloglinks zijn eenmalig, 15 minuten geldig en worden alleen als onleesbare code (hash) bewaard.
  • Het aanvragen van inloglinks is beperkt: maximaal 5 per e-mailadres en 20 per IP-adres per 15 minuten. Dat voorkomt misbruik.
  • Je Moneybird-token staat nooit in de pagina-code en is alleen zichtbaar voor de server. In de database staat het versleuteld (libsodium), met een sleutel die uit het bestand wp-config.php volgt. Een database-export of back-up bevat het token dus niet in leesbare tekst. Verander je de geheime sleutels in wp-config.php, dan vraagt het portaal je het token opnieuw in te vullen.
  • Maak het token met zo min mogelijk rechten (alleen verkoopfacturen en offertes) en gebruik Controleer koppeling om dat te controleren.
  • Updates zijn ondertekend. Elke nieuwe versie van de plugin krijgt een digitale handtekening van Provisual, gezet met een geheime sleutel die op een aparte, offline computer staat en nooit op onze server. De plugin installeert alleen updates met een geldige handtekening, ook als onze updateserver zelf ooit zou worden overgenomen.
  • De portalpagina kan niet in een kader op een andere site worden geladen (bescherming tegen clickjacking) en geeft de inloglink niet door aan andere sites.
  • De link in de inlogmail wijst altijd naar je eigen portalpagina en kan niet via een aangepast formulier naar een andere pagina worden omgeleid.
  • Een klant kan alleen offertes goedkeuren die hij zelf ziet en die nog openstaan, en alleen facturen downloaden die hij zelf ziet.
  • Een klant ziet alleen zijn eigen gegevens, facturen en offertes.
  • Gegevens van een klant worden hooguit enkele minuten tijdelijk bewaard in de database van je eigen website (zie Snelheid en bewaarde gegevens) en verdwijnen daarna vanzelf. Elke klant heeft zijn eigen, gescheiden kopie.

Zit je site achter een proxy of CDN, zodat alle bezoekers hetzelfde IP-adres lijken te hebben? Een ontwikkelaar kan dan met het filter pvkp_client_ip het echte IP-adres doorgeven.

Updaten en licentie verlengen

Nieuwe versies verschijnen gewoon bij Dashboard → Updates en bij Plugins in WordPress. Updaten kan alleen met een actieve licentie.

Je licentie verlengt automatisch als je een lopend abonnement hebt. Op Mijn licenties in het klantportaal van Provisual zie je de vervaldatum en kun je de laatste versie downloaden. Heb je geen lopend abonnement? Stuur dan vóór de vervaldatum een supportticket.

Een verlopen licentie betekent dat het klantportaal voor je klanten niet meer werkt, tot de licentie is verlengd.

Updates worden gecontroleerd op een digitale handtekening voordat ze worden geïnstalleerd. Staat er bij het updaten een melding dat de handtekening ontbreekt of niet klopt? Dan is er niets gewijzigd aan je site. Probeer het later opnieuw; blijft het fout gaan, stuur dan een supportticket.

Problemen oplossen

“Deze plugin heeft geen actieve licentie”

Controleer onder Klantportaal of de licentiesleutel klopt en de status op active staat. Is de licentie verlopen? Dan zie je dat ook bij Mijn licenties in het klantportaal van Provisual. Staat je site al op het maximale aantal domeinen? Deactiveer de sleutel dan op de site die je niet meer gebruikt.

“De Moneybird-koppeling is nog niet ingesteld”

Vul het API-token en het administratie-ID in bij Klantportaal → Moneybird-koppeling en sla op.

De klant krijgt geen inlogmail

  • Controleer of het e-mailadres exact overeenkomt met het e-mailadres van het contact in Moneybird.
  • Kijk in de spammap.
  • Staat de afzender goed ingesteld? Zie Afzender van de inlogmail instellen.
  • Komen er helemaal geen e-mails van je site aan, bijvoorbeeld ook geen wachtwoordherstel? Dan verstuurt je server geen e-mail. Een SMTP-plugin lost dat meestal op.
  • Heeft de klant meerdere keren achter elkaar een link aangevraagd? Dan geldt de limiet van 5 aanvragen per 15 minuten. Even wachten helpt.

“Deze inloglink is verlopen of al gebruikt”

De klant vraagt gewoon een nieuwe link aan. Elke link werkt maar één keer en 15 minuten.

“Kon je gegevens nu niet ophalen bij Moneybird”

Moneybird reageert even niet of het token is ingetrokken. Probeer het later opnieuw. Blijft het fout gaan? Maak dan een nieuw token aan en vul dat in.

De pagina toont verkeerde of oude gegevens

Het portaal bewaart gegevens een paar minuten (standaard 2). Klik onderaan op Vernieuwen, of wis als eigenaar de bewaarde gegevens onder Klantportaal → Bewaarde gegevens wissen. Blijven de gegevens oud, dan is de portalpagina waarschijnlijk gecachet door een cacheplugin. Sluit hem dan uit van paginacaching.

“Het opgeslagen token kan niet meer gelezen worden”

De geheime sleutels in wp-config.php zijn veranderd (bijvoorbeeld bij een verhuizing of na een beveiligingsopschoning). Het token is versleuteld met de oude sleutels en dus niet meer te lezen. Vul het token gewoon opnieuw in bij Klantportaal → Moneybird-koppeling.

“De update is geweigerd: de handtekening ontbreekt of klopt niet”

De plugin installeert alleen updates die door Provisual zijn ondertekend. Er is niets aan je site veranderd. Probeer het over een uur nog eens; helpt dat niet, stuur dan een supportticket.

Hulp nodig?

Kom je er niet uit? Stuur een supportticket via je klantportaal. Vermeld daarbij het webadres van je site en, als er een melding op het scherm staat, de precieze tekst daarvan.

Wijzigingen per versie
Beveiligingsrelease: het Moneybird-token staat versleuteld in de database; updates worden alleen geïnstalleerd met een geldige digitale handtekening; ondertekende doorverwijzing in de inloglink; offerte goedkeuren en PDF downloaden strenger gecontroleerd; beveiligingskoppen op het portaal; nieuwe knop Controleer koppeling en kaart Veiligheid op de instellingenpagina.

Komt je hier niet uit? Stuur ons een supportticket.