De UwBoeking Reservations-plugin haalt accommodatiegegevens uit UwBoeking op en maakt daarvan WordPress-accommodaties. Daarnaast bevat de plugin blokken, shortcodes en Elementor-widgets voor onder meer zoeken, accommodatiekaarten, detailpagina’s en de boekingsmodule.

Toegang en installatie

Voor deze plugin heb je het installatiebestand en een Bearer API-sleutel nodig. Deze beschrijving hoort bij UwBoeking Reservations; de WordPress-tab in UwBoeking toont daarnaast een oudere aanvraagstroom en bevestigt niet welke pluginversie op je website is geïnstalleerd. Gebruik daarom geen oude downloadlink of API-code uit een eerdere handleiding. Installeer het aangeleverde zipbestand via Plugins > Nieuwe plugin toevoegen > Plugin uploaden en activeer daarna UwBoeking Reservations.

Na activatie verschijnt in WordPress het menu UwBoeking met:

  • Accommodations voor bedrijven en gesynchroniseerde accommodaties;
  • Faciliteiten wanneer lokale WordPress-faciliteiten zijn gekozen;
  • Vormgeving;
  • Settings.

Verbinding instellen

Open UwBoeking > Settings en vul onder Verbinding de API base URL, Bearer API key en taal in. Sla de instellingen op en gebruik Test connection. Deel de API-sleutel niet in een pagina, e-mail of schermafbeelding.

Onder Tools kun je vervolgens:

  • Nieuwe accommodaties ophalen om nog niet aanwezige accommodaties te importeren;
  • Synchroniseer accommodaties om bestaande accommodaties bij te werken.

De dagelijkse synchronisatie is apart aan of uit te zetten. Je bepaalt ook of foto’s naar de WordPress-mediabibliotheek worden geïmporteerd en of UwBoeking-gegevens lokale wijzigingen bij een volgende synchronisatie mogen overschrijven.

Accommodatiepagina’s

De plugin kan de gewone WordPress-pagina voor de ingestelde accommodatieslug zelf aanmaken en beheren. Kies bij Accommodation page welke pagina de accommodatie-URL gebruikt. Plaats daar bijvoorbeeld het blok of de Elementor-widget UwBoeking Zoek en Boek.

Voor detailpagina’s zijn er twee routes:

  • laat Accommodation detail template leeg om de meegeleverde plugin-template te gebruiken;
  • kies een gepubliceerde WordPress-pagina als globale detailtemplate en bouw die met UwBoeking Accommodation Detail-widgets op.

Je kunt bij een gesynchroniseerde accommodatie ook een eigen WordPress-pagina koppelen. Catalogus-, zoek- en Zoek en Boek-links gebruiken dan die pagina als detail-URL.

Accommodaties en faciliteiten beheren

Open UwBoeking > Accommodations. Je kunt vanuit het bedrijvenoverzicht naar de accommodaties van een bedrijf gaan, een accommodatie bewerken en de publicatiestatus bepalen. Nieuwe UwBoeking-accommodaties voeg je niet handmatig in WordPress toe; gebruik daarvoor Nieuwe accommodaties ophalen.

Bij Facility source kies je één bron:

  • Use facilities from UwBoeking synchroniseert faciliteiten uit UwBoeking;
  • Use local WordPress facilities laat je de faciliteiten in WordPress beheren en per accommodatie selecteren.

Wisselen naar lokale faciliteiten verwijdert eerder gesynchroniseerde UwBoeking-faciliteitstermen uit WordPress. Controleer daarom de filters en accommodatiekaarten na zo’n wijziging.

Blokken, widgets en shortcodes

De blokeditor bevat blokken voor de catalogus, zoekfunctie en boekingsmodule. Met Elementor zijn widgets beschikbaar voor de catalogus, zoekfunctie, Zoek en Boek, accommodatiegegevens en boekingsmodule.

De meest gebruikte shortcodes zijn:

  [uwb_catalog]
[uwb_search max_persons="6"]
[uwb_zoekboek limit="-1" max_persons="0"]
[uwb_accommodation_grid limit="12"]
[uwb_accommodation_detail part="all"]
[uwb_booking house_id="123" height="2500"]

[uwb_booking] gebruikt op een accommodatie- of gekoppelde pagina automatisch de huidige accommodatie als house_id ontbreekt. De detailshortcode kan met part ook één onderdeel tonen, zoals gallery, facts, description, facilities, location, price of booking.

Gebruik Vormgeving, shortcode-attributen of de instellingen van het gekozen blok of de Elementor-widget voor de presentatie. Test daarna minstens de lijst, filters, detailpagina, beschikbaarheid, prijs en boekingsmodule op desktop en mobiel.

Gegevens voorbereiden in UwBoeking

Open bij de accommodatie Uw advertentie aanmaken of wijzigen. Vul de relevante teksten, faciliteiten, foto’s, afstanden en prijsinformatie in. Controleer daarnaast prijzen, beschikbaarheid, capaciteit, opties en kortingen in de gewone accommodatie-instellingen. Alleen gegevens die de API aanbiedt en de WordPress-weergave gebruikt, verschijnen op de website.

Na een wijziging

Voer Synchroniseer accommodaties uit wanneer een wijziging niet vanzelf zichtbaar wordt. Controleer daarna de publicatiestatus van de accommodatie en leeg zo nodig de WordPress- of websitecache. Werk pluginupdates eerst in een test- of stagingomgeving bij wanneer die beschikbaar is.

Zie ook