Op deze pagina staat hoe je de Recras WordPress-plugin kunt installeren en integreren met je eigen WordPress-website. Ben je geïnteresseerd wat de WordPress-plugin kan integreren kijk dan op de informatiepagina over de Recras WordPress koppeling.

Installatie

Let op: Deze stappen zijn alleen beschikbaar voor gebruikers met de rol Beheerder. Ben je (nog) geen beheerder? Vraag dan je websitebeheerder om de benodigde rechten voor het installeren en inrichten van de plug-in.

  1. Ga in de WordPress-adminomgeving in het menu Plugins naar Nieuwe plug-in
  2. Vul rechtsboven in het vak Plugins zoeken ‘recras‘ in en druk op Enter.
  3. De Recras-plugin komt naar voren. Druk op Nu installeren. Als erom gevraagd wordt, vul je je FTP-gegevens in.
  4. De plugin staat nu in het lijstje met geïnstalleerde plug-ins, maar is nog niet geactiveerd. Klik op Activeren.
  5. Ga in het menu Recras naar de pagina Instellingen.
  6. Vul je eigen Recras-naam in (bijv. demo als je demo.recras.nl gebruikt) en wijzig eventueel de andere instellingen. Je bent nu klaar om je data te integreren!
  7. De plugin is ook te installeren via Composer. Doordat de plug-in gebruik maakt van Composer Installers wordt deze automatisch in de map /wp-content/plugins/ geïnstalleerd. Om de plug-in via Composer te installeren gebruik je: composer require recras/recras-wordpress-plugin

Het koppelen van Recras met de website

Let op: onderstaande tekst geldt voor WordPress 5 en hoger. Voor WordPress 4 maak je gebruik van de knopjes in de menubalk van de Visuele editor ( voor een arrangement,  voor arrangement-beschikbaarheid,  voor online boeken,  voor een contactformulier,  voor een product, en  voor tegoedbonverkoop). De werking en mogelijkheden zijn hetzelfde.

In WordPress 5 zijn alle blokken te vinden onder het kopje Recras, met hetzelfde icoontje als hierboven. Je kunt alle blokken ook zien als je /recras intypt bij het toevoegen van een nieuw blok.

Arrangementen

Gebruik het blok Recras/Arrangement. Kies dan :

  • welk arrangement het betreft
  • welke eigenschap je wilt tonen

Als je de eigenschap Programma kiest, verschijnen er nog twee opties:

  1. de starttijd van het arrangement (standaard staat deze op 0:00)
  2. de header – Van/Tot/Activiteit – die getoond (kan) worden.

Beschrijving van de eigenschappen

  • Titel – de naam van het arrangement (“Naam naar klant“)
  • Beschrijving – de uitgebreide beschrijving van het arrangement
  • Duur – de duur van het arrangement (de tijd van het begin van de eerste activiteit tot en met het einde van de laatste activiteit)
  • Startlocatie – de locatie van de eerste activiteit
  • Minimum aantal personen – het minimum aantal personen
  • Prijs p.p. excl. btw – de prijs van het arrangement per persoon, exclusief btw
  • Prijs p.p. incl. btw – de prijs van het arrangement per persoon, inclusief btw
  • Totaalprijs excl. btw – de totaalprijs van het arrangement, exclusief btw
  • Totaalprijs incl. btw – de totaalprijs van het arrangement, inclusief btw
  • Programma – een tabel met alle activiteiten
  • Afbeelding-tag – de afbeelding die bij het arrangement hoort
  • Afbeelding-URL – de URL van de afbeelding die bij het arrangement hoort

Contactformulieren

Gebruik het blok Recras/Contactformulier. Je kunt dan de volgende eigenschappen instellen:

  • Contactformulier – welk formulier je wilt integreren
  • Toon titel – of de titel van het formulier automatisch ingevoegd wordt
  • Toon labels – of de labels van de velden getoond worden
  • Toon placeholders – of er tijdelijke tekst in de velden getoond wordt
  • Arrangement – welk arrangement automatisch ingevuld wordt, als het contactformulier dit ondersteund. Als dit leeg gelaten wordt kan de gebruiker dit zelf invullen
  • HTML-element – als welk HTML-element het formulier wordt gemaakt
  • Element voor “enkele keuze” – welk HTML-element gebruikt wordt voor opties waar één keuze gemaakt moet worden
  • Tekst op knop Versturen – Welke tekst er op de verzendknop komt te staan, standaard is dit Versturen
  • Doorsturen na versturen – als hier een pagina of bericht wordt gekozen, wordt de klant daarheen gestuurd nadat het contactformulier succesvol is verzonden.
    Dit kan bijvoorbeeld een bedankpagina zijn. Indien je kiest voor “Niet doorsturen” verschijnt alleen een melding onderaan het formulier

De contactformulieren maken gebruik van HTML5-elementen voor datum- en tijdselectie. Zie voor meer informatie het kopje Datum-/Tijdselectie hieronder.

Producten

Gebruik het blok Recras/Product. Kies dan :

  • om welk product het gaat
  • welke eigenschap van het product je wilt laten zien

Beschrijving van de eigenschappen

  • Titel – de titel van het product
  • Beschrijving (kort) – de korte beschrijving van het product
  • Beschrijving (lang) – de lange beschrijving van het product
  • Duur – de duur van het product, bijvoorbeeld 02:30 voor een product van twee uur en dertig minuten.
  • Afbeelding-tag – de afbeelding die bij het product hoort
  • Afbeelding-URL – de URL van de afbeelding die bij het product hoort
  • Minimumaantal – het minimumaantal van dit product
  • Prijs (incl. btw) – de prijs van het product

Online Boeking

Om een onlineboekingsformulier aan je site toe te voegen gebruik je het blok Recras/Online boeking. Er zijn diverse opties:

  • Arrangement – of er een vooraf ingevuld arrangement is of niet
  • Nieuwe methode gebruiken? – of de nieuwe methode van online boeken gebruikt moet worden of niet
  • Toon voorbeeldtijden in programma – alleen beschikbaar voor de nieuwe methode – of, na het kiezen van datum en tijd, voorbeeldtijden in het programma getoond worden
  • Doorsturen na versturen – alleen beschikbaar voor de nieuwe methode – of er na het boeken doorgestuurd moet worden naar een bepaalde pagina of bericht
  • Automatisch schalen? – alleen beschikbaar en nodig voor de oude methode – of de hoogte van het iframe automatisch wordt aangepast aan de hoogte van de inhoud ervan

Beschikbaarheidskalender

Om een beschikbaarheidskalender van een arrangement toe te voegen aan je site gebruik je het blok Recras/Beschikbaarheidskalender.

Tegoedbonnen

Voor het verkopen van tegoedbonnen gebruik je het blok Recras/Tegoedbonverkoop.

Styling

De plug-in past geen styling toe, zodat de arrangementen en contactformulieren over het algemeen naadloos integreren met de rest van de website. Indien gewenst zijn er diverse CSS-classes beschikbaar. Deze zijn te vinden in het style.css-bestand. Als je hier gebruik van wilt maken zul je deze classes in je eigen thema moeten gebruiken, aangezien het bestand niet wordt ingeladen door de plugin.

Datum-/Tijdselectie

Voor het selecteren van data en tijden maakt de plugin gebruik van bestaande standaarden. Helaas wordt dit momenteel nog niet in alle browsers evengoed ondersteund. Om dit voor alle bezoekers goed te laten werken bevat de plugin de instelling “Gebruik datum-/tijdselectiescript“. Op het moment van schrijven (maart 2019) wordt aanbevolen om dit aan te zetten als een groot deel van de bezoekers gebruik maakt van Internet Explorer (niet Edge, die ondersteunt dit wel) of Safari voor desktops.

Caching

Omdat het ophalen van alle gegevens uit jouw Recras even kan duren, worden deze gegevens tijdelijk opgeslagen op je eigen website. Dit zorgt ervoor dat het proces sneller wordt. De gegevens worden maximaal 24 uur bewaard, dus als je ingrijpende wijzigingen maakt in je Recras -bijvoorbeeld door de prijs van een arrangement te verhogen – dan is het aan te raden om deze cache daarna te legen. Anders kunnen je klanten een verouderde prijs op de website tegenkomen. Je doet dit in de WordPress-adminomgeving op de pagina Cache in het menu Recras.

Integratie met Google Analytics

Integratie met Google Analytics is mogelijk op de menupagina Recras – Instellingen. Of je nu werkt met een handmatig toegevoegde code, of met Tag Manager, of met een plugin, dit zou altijd moeten werken zonder verdere configuratie.

Ondersteuning

We stellen het op prijs als je gebruik maakt van onze GitHub-pagina om fouten en verbeterwensen te melden. Heb je geen GitHub-account? Dan kun je ook gebruik maken van het WordPress-forum van onze plugin.

We ondersteunen de plugin alleen op de laatste versie van WordPress en op actief ondersteunde PHP-versies.