Voor de integratie van het online reserveringssysteem in WordPress hebben we een plugin ontwikkeld. Deze plugin omvat basis 'views' van onze boekkingsstraat. Indien je meer mogelijkheden wilt op gebied van instellingen, gebruik dan de handleiding voor Integratie in website. Dit is voor een meer 'custom' integratie (zonder gebruik van shortcodes).
Belangrijk: Onderstaande stappen zijn benodigd om jouw integratie goed te laten draaien.
1. Installatie en configuratie (plugin)
- Download de laatste versie van de Recranet plugin in het .zip formaat.
- Ga in WordPress naar 'Plugins' -> 'Nieuwe plugin' -> 'Plugin uploaden'.
- Selecteer de zojuist gedownloade plugin en klik op 'Nu installeren'.
- De plugin is nu geïnstalleerd, klik op 'Plugin activeren'.
- De Recranet plugin staat nu tussen de lijst met plugins.
- Ga naar het menu 'Instellingen' -> 'Recranet' om de plugin te configureren.
- De Organisatie ID heeft u ontvangen via de e-mail.
2. HTML5 Routing instellen
De ondersteuning voor HTML5 routing is verplicht. Voeg aan het .htaccess bestand de volgende regels toe. Deze regel gaat uit van de url /reserveren als pagina waarop de (hoofd) Recranet module is ingeladen.
De pagina id 999 dient te worden vervangen door de daadwerkelijke pagina id van de url.
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^reserveren/.* /index.php?page_id=999 [L]
</IfModule>
Het uiteindelijke bestand wordt dan het volgende. Neem de code na #BEGIN WORDPRESS niet over, dit is enkel ter verduidelijking opgenomen:
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^reserveren/.* /index.php?page_id=999 [L]
</IfModule>
# BEGIN WordPress
# De richtlijnen (regels) tussen `BEGIN WordPress` and `END WordPress` worden
# dynamisch aangemaakt en zouden enkel aangepast mogen worden via WordPress filters.
# Elke wijziging aan deze richtlijnen tussen deze markeringen worden overschreven.
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress
De HTML5 Routing Mode kan worden getest door te navigeren naar een accommodatie detailpagina en vervolgens de pagina te verversen. Als vervolgens opnieuw dezelfde pagina wordt geladen is de HTML5 Routing Mode juist geconfigureerd.
In Wordpress moeten ook de 'Permalink instellingen' worden aangepast naar onderstaande configuratie.
3. Beschikbare 'Views'
Accommodatie lijstweergave met uitgebreide filters of card weergave
De onderstaande shortcode geeft het accommodatie overzicht weer, deze wordt meestal op de pagina 'Reserveren' geplaatst. Het baseURL attribuut moet verwijzen naar de 'Reserveren' pagina.
Standaard wordt de weergave met uitgebreide filters ingeladen, indien je alleen gebruik wilt maken van de zogenaamde 'cards' weergave kun je als attribuut 'layoutType="cards"' toevoegen aan de shortcode, zie onderstaande voorbeelden.
Het is ook mogelijk om een "accommodatie categorie" of "locatie categorie" te forceren. Op deze manier laadt Recranet Booking in met accommodaties uit deze categorieën, de opties voor keuze uit een andere accommodatie categorie verdwijnt, zie onderstaande code. De 'accommodationCategory' en 'localityCategory' parameters zijn optioneel.
[recranet_accommodations baseUrl="/reserveren"]
[recranet_accommodations layoutType="cards"]
[recranet_accommodations accommodationCategory="xxxx" localityCategory="xxxx"]
Uitgelichte accommodatie weergeven
De onderstaande shortcode geeft een selectie van accommodatie's weer, deze kun je bijvoorbeeld neerzetten op de homepagina. In onderstaande shortcode moet het attribuut baseURL verwijzen naar de 'Reserveren' pagina. Voor een meertalige website moet deze weergave meermaals worden ingeladen met een verwijzing van de 'Reserveren' pagina per taal.
[recranet_featured_accommodations baseUrl="/reserveren"]
Arrangementen weergeven
De onderstaande shortcode geeft het arrangementen-overzicht weer, deze wordt meestal op de pagina arrangementen geplaatst. Het baseUrl attribute moet verwijzen naar de 'Reserveren' pagina. Voor een meertalige website moet deze balk meermaals worden ingeladen met een verwijzing van de 'Reserveren' pagina per taal.
[recranet_packages baseUrl="/reserveren/"]
Zoek en boek balk weergeven
De onderstaande shortcode geeft de zoek en boek balk weer. Het 'action attribute' moet verwijzen naar de 'Reserveren' pagina. Voor een meertalige website moet deze balk meermaals worden ingeladen met een verwijzing van de 'Reserveren' pagina per taal.
[recranet_search_bar action="/reserveren/"]
Uitgelichte review weergeven
De onderstaande shortcode geeft een uitgelichte review weer. Het baseURL attribuut moet verwijzen naar de 'Reserveren' pagina. Voor een meertalige website moet deze weergave meermaals worden ingeladen met een verwijzing van de 'Reserveren' pagina per taal.
[recranet_featured_reviews baseUrl="/reserveren/"]
Google Maps kaart met accommodaties weergeven
De onderstaande shortcode geeft een kaart weer met accommodaties. Het baseURL attribuut moet verwijzen naar de 'Reserveren' pagina. Het height attribuut moet de hoogte in pixels worden meegegeven aan de kaart.
[recranet_featured_maps height="800px" baseURL="/reserveren"]
Interactieve kaart (plattegrond) met accommodaties weergeven
De onderstaande shortcode geeft een plattegrond weer met accommodaties. Het baseURL attribuut moet verwijzen naar de pagina waarop de shortcode wordt geplaatst (bijv. '/boeken-op-de-kaart'). Het height attribuut moet de hoogte in pixels worden meegegeven aan de kaart.
``` [recranet_map height="800px" baseURL="/boeken-op-de-kaart"]