Makelaar Plugins LET OP: Momenteel zijn we niet compatible met onderstaande PHP versies:- 8.2.12, 8.2.13 en hoger- 8.1.25, 8.1.26 en hogerGeschikt voor de CRM aanbieders:- Realworks- Pyber- Skarabee- Kolibri- Goes & Roos- Eyemove- Tiara Introductie LET OP: Momenteel zijn we niet compatible met onderstaande PHP versies: - 8.2.12, 8.2.13 - 8.1.25, 8.1.26 Welkom bij de documentatie voor onze makelaar plugins. Voor de onderstaande CRM aanbieders hebben wij een plugin ontwikkeld om jouw website met de CRM aanbieder te koppelen: - Realworks - Pyber - Skarabee - Kolibri - Goes & Roos - Eyemove Features Koppeling met meerdere accounts is mogelijk wanneer je CRM aanbieder dit ondersteunt. Bijwerkgeschiedenis in kunnen zien, status van bijwerkproces live volgen en annuleren. Zoekvelden eenvoudig maar uitgebreid instellen vanuit de admin. Per zoekoptie weergeven hoeveel resultaten er voor zullen zijn. Direct bijwerken van de resultaten bij het wijzigen van een zoekoptie. Mogelijkheid om resultaten op de gewenste manier te sorteren. Zeer uitgebreide controle over weergave van velden. Google Maps ondersteuning. Kwaliteit gewaarborgd door circa 400 geautomatiseerde tests. Eigen page templates. * Basis thema met voorbeeld code. * De vormgeving is naar wens aan te passen door het schrijven van eigen HTML, CSS, PHP en JS. * Uitgebreide documentatie. Dit basis thema kan je als child-theme van je hoofdthema installeren. Installatie Installeer de plugin door de ontvangen plugin naar /wp-content/plugins/ te uploaden. Activeer de plugin vervolgens vanuit de WordPress admin. Plugin updates worden beschikbaar gesteld via de WordPress plugin pagina. Ook is op het dashboard van de plugin te zien of de plugin up-to-date is. Vereisten PHP 7.4 of hoger (Wij raden het gebruik van PHP 8+ aan) Als hier niet aan voldaan wordt zal het activeren van de plugin mislukken of kan het zijn dat de site niet meer wordt geladen. In dat geval moet de plugin map worden hernoemd of verwijderd om het probleem te verhelpen. Verder zijn de volgende vereisten noodzakelijk voor het soepel laten verlopen van updates: Geen max_execution_time limiet Geheugenlimiet minstens 128MB, hoger gewenst Licentie Bij de aanschaf van de plugin heb je een licentiecode gekregen. Het is van belang dat deze wordt ingevoerd om de plugin zonder restricties te laten werken en om plugin updates te kunnen ontvangen. Schijfbevoegdheden Na het activeren van de plugin in WordPress is het van belang om te controleren dat de plugin voldoende schijfbevoegdheden heeft. Als hier niet aan wordt voldaan zullen plugin instellingen niet kunnen worden opgeslagen en zal bijwerken foutmeldingen geven. Instellingen Alle instellingen van de plugin worden opgeslagen in de thema-map. Dit heeft als voordeel dat een site gemakkelijk gekopieerd kan worden waarbij alle instellingen ook worden overgenomen. Bij het wisselen van het actieve WordPress thema worden de instellingen niet automatisch meegenomen. Wissel dus eerst naar het gewenste thema en begin pas daarna met het instellen van de plugin, of verplaats na de thema-wisseling de instellingen map handmatig naar het nieuwe thema. Controleer vervolgens de schijfbevoegdheden opnieuw. Tussendoor B.V. Sixmastraat 66-B 8932 PA Leeuwarden e. info@tussendoor.nl w. http://www.tussendoor.nl Admin Deze sectie van de documentatie is bedoeld voor het gebruik van de plugin vanuit de WordPress omgeving. Dashboard Het dashboard dient als centraal beginpunt van de plugin. Zo biedt het beknopt inzicht in het bijwerkproces en over de installatie. Na de activatie kan de plugin vanaf het dashboard geactiveerd worden door de meegeleverde licentiecode in te vullen. Verder kan de schijfbevoegdheden direct vanaf het dashboard worden gecontroleerd. Het is belangrijk dat deze in orde zijn voor het juist functioneren van de plugin, wanneer er problemen zijn wordt dit duidelijk gemaakt door rood gearceerde tekst. Mocht je zelf niet de kennis hebben om dit op te lossen, neem dan contact op met je hosting provider. Tevens slaat de plugin cache op in het actieve thema, voor het oplossen van specifieke problemen kan het soms voorkomen dat de cache verwijderd moet worden. Via de instellingen tab kan ook de cache verwijderd worden, dit kan heel eenvoudig door op ‘Toon details’ naast ‘Cache’ te klikken en door vervolgens op ‘verwijderen’ bij de specifieke koppeling te klikken. Instellingen Instellingen die van toepassing zijn op de gehele plugin kunnen in het tabblad "Instellingen" worden aangepast. Deze instellingen hebben betrekking tot het bijwerken vanaf jouw CRM aanbieder, alle overige instellingen zijn specifiek per koppelingstype (woningen, bedrijven, enz.). Allereerst moet de koppeling met je CRM aanbieder worden ingevoegd. Geef hiertoe de benodigde gegevens op, afhankelijk van je CRM kan je ook specifieke kantoornummers opgeven. Wanneer dit voor jou van toepassing is kan je deze bij de koppeling toevoegen, scheid de kantoornummers met een komma. Vervolgens moet nog worden opgegeven om welk type koppeling het gaat, zo maakt jouw CRM aanbieder onderscheid in woningen en bedrijven. Zij bieden deze objecten in verschillende feeds (met verschillende eigenschappen) aan. Wanneer voor dezelfde gebruiker verschillende kantoren moeten worden opgegeven voor bijvoorbeeld woningen en bedrijven, voeg dan een tweede koppeling toe met dezelfde inloggegevens maar met een andere module en kantoornummer('s). Voor alle instellingen geldt dat ze expliciet moeten worden opgeslagen, via de blauwe knop rechtsboven. Afhankelijk van je CRM pakket kan het dashboard van de plugin er nét iets anders uit zien, zo hoeft er bijvoorbeeld voor het Kolibri CRM alleen een token ingevuld te worden voor de koppeling. Specifieke instellingen Nadat een koppeling is ingesteld voor een bepaalde module, is uitgebreidere configuratie van die module mogelijk aan de hand van een nieuw tabblad. Vanuit hier kunnen instellingen van toepassing op deze module worden ingesteld en kunnen zoekvelden worden gedefinieerd. Voor ieder object afkomstig vanuit de feed wordt een WordPress post aangemaakt. De titel, inhoud en auteur van deze posts kunnen naar wens worden aangepast. De titel bepaalt hoe de URL van een object eruit ziet, dit is een standaard WordPress functionaliteit. Wanneer je de titel van een object anders vorm wil geven zullen daarom de posts opnieuw aangemaakt moeten worden, verwijder daarvoor de objecten en haal ze opnieuw binnen. Let er daarbij op dat alleen objecten die nog in de feed zitten opnieuw worden opgeslagen, het kan voorkomen dat een verkocht object niet meer in de feed zit en dat deze niet opnieuw opgeslagen kan worden. De inhoud bepaalt de content van een post, hier plaatsen we standaard de aanbiedingstekst van een object in. Dit wordt ingevuld binnen het CRM van je aanbieder, bijvoorbeeld binnen het CRM van Pyber. Als er een typefout in de tekst zit en dit wordt binnen het CRM aangepast, dan wijzigen we de aanbiedingstekst alleen in de database. Haal daarom altijd de waarde uit de database en niet uit the_content() . De post wordt namelijk niet volledig opnieuw opgeslagen waardoor the_content() de typefout behoudt. Bij onbeschikbaar Als een object is verkocht of om een andere reden niet langer beschikbaar is, verdwijnt deze over het algemeen na een aantal dagen uit de feed. Voor deze objecten kan worden ingesteld wat er moet gebeuren: Verwijder van website: het object en alle media zullen definitief worden verwijderd. Bewaar met laatste bekende status: het object zal niet worden aangepast en behoudt de laatst bekende post status . Verander de status: hiermee kan de status van een object die niet langer beschikbaar is worden aangepast, bijvoorbeeld op 'concept' om deze objecten te verbergen maar nog wel binnen WordPress te houden. Object status Ieder object heeft een bepaalde status zoals 'Beschikbaar' of 'Verkocht', dit wordt ingesteld binnen het CRM. Om deze status te vertalen in de zichtbaarheid van het object kan hier de WordPress post status van worden afgeleid. Het is ook mogelijk om alleen objecten met bepaalde eigenschappen, zoals de status, te importeren. Hiervoor kun je alle objecten die niet aan die eigenschap voldoen overslaan, meer informatie . Overig Vanuit de meeste CRM pakketten worden geen GPS coördinaten van de objecten meegestuurd, echter kan de plugin automatisch de locatie van een object opvragen via Google Maps. Hiervoor is een Geocoding API key van Google nodig. De Google API key kan je invullen binnen de instellingen. Om vervolgens een Google Map te kunnen tonen is ook de Maps Javascript API noodzakelijk, deze dient verwerkt te worden in het actieve thema. Ook voor koppelingen met een CRM aanbieder die wél GPS coördinaten meesturen kan het handig zijn om een Google API key toe te voegen, want als een object dan geen coördinaten mee gestuurd krijgt kunnen we deze automatisch via Google ophalen. Verder geven de meeste CRM pakketten een lijst van media op in de feed. Het hotlinken van deze media is niet toegestaan. Tijdens het bijwerkproces word deze media lokaal gedownload voor verder gebruik op de website. De uitzondering hierop zijn de diensten van derde partijen (bijv. virtuele touren, floorplanners, enz). Ook is het mogelijk om specifieke media niet te downloaden (bijv. video's) om ruimte te besparen op de server.   Zoekvelden Vanuit de admin kunnen zoekvelden worden toegevoegd, met hun zoekopties en bijbehorende zoekopdracht. Hieronder zie je een voorbeeld van een zoekveld voor de wonen module, met dit zoekveld kan er op status gezocht worden. Links zie je een opsomming van de toegevoegde zoekvelden, wanneer je daar op '+ Nieuw' klikt kan er een nieuw zoekveld toegevoegd worden. De naam van een zoekveld is belangrijk, hiermee koppel je het zoekveld aan een zoekveld binnen je thema. Plaats geen hoofdletters, spaties of streepjes in de naam. Dit kan voor onverwachte problemen zorgen. Opties In het voorbeeld hierboven willen we het zoekveld 'status' in een dropdown op de pagina tonen, om de dropdown te vullen met zoekopties kan je binnen de instellingen van het zoekveld opties toevoegen. Op deze opties moet uiteindelijk gezocht kunnen worden, geef daarom een duidelijk label op zodat bezoekers van de website weten wat voor zoekresultaat ze kunnen verwachten. Het label van de zoekoptie zie je links in de rij en rechts in de grijze bol zie je de waarde. De plugin zoekt binnen de objecten naar deze waarde. Als voorbeeld zie je het label 'Verkocht' met de waarde 'VERKOCHT'. Wanneer een woning verkocht is wordt de status aangepast van 'Beschikbaar' naar 'Verkocht, in de database staat dit als 'VERKOCHT'. Wanneer de bezoeker op het mooi vormgegeven label 'Verkocht' klikt zoekt de plugin dus naar objecten met de status waarde 'VERKOCHT'. De plugin weet natuurlijk niet automatisch op welk veld er gezocht moet worden en de naam 'status' van het zoekveld is niet genoeg. Je moet daarom nog een zoekopdracht toevoegen waardoor de plugin weet dat het veld 'status' gebruikt moet worden. Lees verder op de pagina om er achter te komen hoe je dit doet. Helemaal links in de rij kan je aan zoekoptie de- of activeren, met het kruisje helemaal rechts kan een optie worden verwijderd en de checkbox er links naast bepaalt of de optie standaard geselecteerd is. Automatisch bijwerken In het voorbeeld hierboven willen we zoeken op 'status' en je ziet dat onder de naam van het zoekveld 'automatisch bijwerken' op het veld status is ingesteld. Voor sommige zoekvelden is het makkelijk om alle mogelijke waardes automatisch beschikbaar te stellen. Door bij ‘Automatisch bijwerken’ het zoekveld te koppelen aan één van de velden, zoekt de plugin door de database naar alle waarden van dit veld binnen de aanwezige objecten (in het voorbeeld zijn dit woningen, omdat dit een zoekveld voor woningen betreft). Bij het opslaan van de instellingen worden direct alle opties toegevoegd die momenteel beschikbaar zijn, dus handmatig invoeren is dan niet nodig. Labels en waarden worden automatisch toegevoegd. Primaire opties Het kan gewenst zijn om bepaalde opties bovenaan de lijst te tonen, zodat ze bijvoorbeeld bovenaan in een dropdown staan. Door deze opties bovenaan in de lijst te schuiven zullen nieuw toegevoegde opties worden ingevoegd vanaf het punt waar deze primaire opties stoppen , dit is waar de alfabetische volgorde onderbroken wordt. De gekozen opties blijven dus altijd bovenaan staan en nieuwe opties worden alsnog alfabetisch toegevoegd. Slepen doe je door op het grid-icoon helemaal links in een zoekoptie rij te klikken en vervolgens te slepen. Afhankelijke zoekvelden Opties kunnen worden gekoppeld aan de waarde van een ander veld. Als voorbeeld hieronder zie je het veld ‘plaats’, deze is afhankelijk van het zoekveld ‘land’. Voor elke plaats kan dan worden opgegeven bij welk land deze plaats zichtbaar moet zijn. Dus stel een bezoeker filtert op in het zoekveld voor 'land' naar 'Duitsland' dan wordt in dit geval in het zoekveld voor 'plaats' alleen nog 'Berlijn' getoond. Wanneer er nog geen land is gekozen door de bezoeker zal het zoekveld voor plaats leeg zijn.   Zoekopdracht Zoals eerder aangegeven is het niet voldoende om alleen opties toe te voegen, de plugin weet dan namelijk nog niet op welke waarde er gezocht moet worden. Om dit aan de plugin door te geven moet er een zoekopdracht toegevoegd worden. In veel gevallen is voor iedere optie dezelfde zoekopdracht van toepassing, dan kan een algemene zoekopdracht worden ingesteld. Ook kan voor een optie specifiek een aangepaste zoekopdracht worden opgegeven. Algemeen Een algemene zoekopdracht kan onderaan de pagina worden ingevuld bij 'zoekopdracht'. Een ingestelde zoekoptie kan argumenten aan deze zoekopdracht meegeven zodat elke zoekoptie toch een ander resultaat kan geven. Zoals in het voorbeeld van het status zoekveld stellen we algemeen in dat de plugin op het veld 'status' moet zoeken. Per zoekoptie vullen we een andere waarde in en na het klikken (door een bezoeker) op een zoekoptie zal de plugin zoeken naar objecten met de status van de zoekoptie die is aangeklikt. Rechts naast het label van een optie zie je, zoals eerder aangegeven, de waarde van de zoekoptie in een grijs bolletje. In een algemene zoekopdracht refereer je naar deze waarde met #{0} . Als een optie geen argumenten heeft wordt de algemene zoekopdracht niet toegepast! Het is ook mogelijk om nog een argument toe te voegen, na het aanpassen van je eerste waarde druk je op tab waardoor er nog een grijs bolletje ontstaat. Hier kan je je extra waarde invullen. Vanuit de algemene zoekopdracht wordt aan het eerste argument gerefereerd door #{0} , meer argumenten zijn #{1} , #{2} enz. Zo kan je bijvoorbeeld de status 'Verkocht onder voorbehoud' en 'Verhuurd onder voorbehoud' als volgt onder 'Beschikbaar' plaatsen. Een bezoeker ziet dus alleen het label 'beschikbaar' maar de plugin zoekt direct ook naar objecten die verkocht/verhuurd onder voorbehoud zijn. Bij de zoekopdracht stel je nu 'minstens een' in zodat de plugin zoekt naar objecten die OF de status 'beschikbaar' OF de status 'verkocht onder voorbehoud' OF de status 'verhuurd onder voorbehoud' hebben. Complexe zoekopdrachten zoals hierboven kunnen worden bereikt door meerdere regels toe te voegen, of zelfs meerdere groepen met regels. Voeg regels toe via het blauw omcirkelde plusje rechts naast een regel, en groepen via de rood omcirkelde plus aan het begin van de groep.  Een groep bevat vaak zelf ook meerdere regels, je kan instellen of een object aan alle regels binnen een groep moet voldoen of minstens een. Boven een groep heb je namelijk opnieuw deze keuze zoals je nu ook in het screenshot naar 'zoekopdracht' ziet staan. Met het aanmaken van groepen kan je bijvoorbeeld een zoekoptie maken waarmee in één keer gezocht wordt op appartementen die beschikbaar, verkocht- of verhuurd onder voorbehoud zijn. Specifiek Het komt ook voor dat je een zoekveld wil aanmaken waarvoor geen algemene zoekopdracht mogelijk is, bijvoorbeeld wanneer elke optie op een ander veld moet zoeken. In zo'n geval kan je per optie een zoekopdracht meegeven, belangrijk hiervoor is dat je de waarde (in het grijze bolletje) verwijdert. Daarna klik je op de asterisk om een specifieke zoekopdracht id te stellen, dit gaat op gelijke wijze als de algemene zoekopdracht, maar hier stel je vaste waardes in en maak je dus geen gebruik van #{0} of #{1} .  In het voorbeeld met de status waar het label 'Beschikbaar' op 'Beschikbaar' 'Verkocht onder voorbehoud' en 'Verhuurd onder voorbehoud' moet zoeken ziet dat er als volgt uit: Als je goed kijkt zie je in het bovenstaande voorbeeld dat de statussen 'Verkocht' en 'Verhuurd' nog wel van de algemene zoekopdracht gebruik maken. Dit is dus ook mogelijk.   Geavanceerde instellingen De admin interface biedt toegang tot een klein aantal instellingen, meer geavanceerde instellingen kunnen worden toegepast via het admin tabblad ‘Geavanceerd’. Dit geeft de mogelijkheid om het ruwe bestand met instellingen direct te wijzigen, waaronder ook instellingen die niet gewijzigd zouden moeten worden. Hieronder geven we enkele instellingen die wél zonder risico’s kunnen worden aangepast. Bij verkeerde aanpassingen van de instellingen kunnen fouten in de plugin worden veroorzaakt die niet op te lossen zijn vanuit het dashboard. Wees daarom altijd voorzichtig. Sorteren Om resultaten te sorteren moeten de sorteerrichtingen via de geavanceerde instellingen handmatig worden toegevoegd. In search.orderings kan een array van objecten worden opgegeven waarbij de key orderby verplicht is en aangeeft op welke velden er gesorteerd moet worden. Door voor een object "default": true op te geven wordt deze sorteervolgorde als standaard toegepast. Eventueel andere keys zijn beschikbaar vanuit de template. Meerdere velden worden gescheiden door een komma, de volgorde zelf volgt op de naam van het veld met een dubbele punt en vervolgens asc voor oplopend, desc voor aflopend. { "search": { "orderings": [ { "orderby": "koopprijs:asc,huurprijs:asc", "label": "Prijs", "meta": "oplopend", "default": true }, { "orderby": "koopprijs:desc,huurprijs:desc", "label": "Prijs", "meta": "aflopend" } ] } } Om de bezoeker van de website vervolgens de mogelijkheid te geven om te switchen tussen sorteeropties kan je bijvoorbeeld een dropdown vullen met door jou ingestelde opties. Hoe je dat doet lees je binnen Ontwikkeling . Instellingen per module De titel van de pagina met woningen kan worden aangepast via post.archive.title . Het aantal weer te geven resultaten per pagina is eenvoudig aan te passen door post.archive.query.posts_per_page aan te passen. Overige parameters voor de WP_Query kunnen overigens ook via post.archive worden opgegeven. Andere WordPress plugins kunnen op hun eigen manier de titel aanpassen, waardoor het wijzigen van post.archive.title niet altijd invloed heeft. Er zijn WordPress thema's en WordPress plugins die de werking van het aantal berichten per pagina overschrijven waardoor het wijzigen van post.archive.query. posts_per_page niet altijd invloed heeft. URL's aanpassen Standaard is de pagina met een overzicht van woningen bereikbaar op /woningen/ en een enkele woning op /woning/{title}. Dit wordt bepaald door de registratie van WordPress’ custom post type, en kan dus worden aangepast door post.register.has_archive en post.register.rewrite.slug aan te passen. URL opdelen in componenten Normaal zal een woning met titel Leeuwarden - Celsiusweg 2 beschikbaar zijn onder de URL /woning/leeuwarden-sixmastraat-66-b. Om de titel op te delen in verschillende URL componenten, voor de URL /woning/leeuwarden/sixmastraat-66-b, kan bij instellingen in de titel #{/} worden ingevoegd om op die positie de dash (-) te vervangen door een slash (/): Extra zoekresultaten pagina’s Het is mogelijk om extra pagina’s toe te voegen waarop direct een zoekopdracht wordt uitgevoerd, zodat het aanbod onderverdeeld kan worden in landingspagina's. Denk hierbij aan een aparte URL voor koop-, huur- en verkochte woningen of een aparte URL per plaats in het aanbod. Om een pagina aan te maken begin je met het toevoegen van een zoekveld, we doen dit omdat de zoekvelden de basis zijn van een extra zoekresultaten pagina. Je geeft namelijk een zoekopdracht mee aan de pagina zodat de plugin direct weet welk type aanbod er getoond moet worden op deze pagina. In het onderstaande voorbeeld zie je hoe je een extra zoekresultaten pagina aanmaakt voor koop- en huurwoningen op basis van een koppeling met het Pyber CRM. Het zoekveld is gebaseerd op de woning informatie die is binnen gekomen via de koppeling, de eigenschappen "For sale" en "For rent" slaan we op in het veld koophuur . Voor het gemak hebben we het zoekveld ook de naam "koophuur" gegeven, dit kan je naar wens aanpassen. De volgende stap is om de de pagina daadwerkelijk op te zetten, doe dit voor woningen door binnen de 'Geavanceerde Instellingen' in de sidebar onder instellingen naar de module wonen te gaan. Het archive gedeelte in de documentatie ziet er als volgt uit, daarbij gaat het nu dus om archive.pages : "archive": { "title": "Woningen", "query": { "posts_per_page": 12 }, "pages": [ { "url": "woningen/{naamvanzoekveld}", "query": { "naamvanzoekveld": "#{naamvanzoekveld}" }, "name" : "paginanaam" } ] }, Heb je geen archive.pages in je geavanceerde instellingen staan? Dan kan je deze zelf toevoegen. Je ziet de naam van ons zoekveld "koophuur" nu nog niet terug komen, bovenstaande zou gekoppeld zijn aan een zoekveld die letterlijk "naamvanzoekveld" heet. Om te koppelen beginnen we aller eerst met de url , daar zetten we de naam van ons zoekveld als volgt in: { "url": "aanbod/{koophuur}", } De string bepaalt de URL van de pagina en de URL bepaalt ook welke zoekopdracht wordt uitgevoerd. In de afbeelding van het zoekveld zie je twee zoekopties, namelijk "koop" en "huur". Zet je één van de opties in de url dan wordt de bijbehorende zoekopdracht uitgevoerd. URL Zoekopdracht Resultaat /aanbod/ koop koophuur = koop Alleen woningen met de eigenschap 'For sale' worden gevonden. /aanbod/ huur koophuur = huur Alleen woningen met de eigenschap 'For rent' worden gevonden. In query kunnen variabelen worden opgegeven met een waarde, dit is de plek waar je het ingestelde zoekveld daadwerkelijk koppelt aan de nieuwe pagina. Dat ziet er als volgt uit: { "query": { "naamvanzoekveld": "#{naamvanzoekveld}" } } Naast het koppelen van het juiste zoekveld moet je de pagina ook een naam geven, dit helpt bij de ontwikkeling omdat je daarmee bepaalde code kunt uitvoeren op de pagina voor bijvoorbeeld alleen koopwoningen. Doet dit door tekst "naam" aan te passen naar de gewenste naam, in ons voorbeeld zou "koophuur" het meest voor de hand liggen aangezien dit hetzelfde is als de naam van ons zoekveld. Dus als volgt: { "name" : "koophuur" } Zet geen spaties, hoofdletters of bijzondere karakters in de naam. TIP: Geef de pagina dezelfde naam als je zoekveld, dit maakt het makkelijker om mee te werken. Je kan ook een slechts een aantal zoekopties beschikbaar maken voor de extra zoekresultaten pagina's, dit kun je doen wanneer je maar een paar plaatsen een landingspagina wil geven bijvoorbeeld. Door in de URL deze opties vast te leggen wordt er met door middel van een regex voor gezorgd dat alleen deze optie's mogelijk zijn. De standaard regex die gebruikt wordt [^/]+ , dit betekent dat alles wordt geaccepteerd en dat iedere zoekoptie dus een extra pagina kan aanmaken. Een aangepaste regex kan worden opgegeven, doe dit na de naam van je zoekveld door de naam en de zoekopties te scheiden met een : . Voor een zoekveld met de naam "plaats" en de zoekopties "Leeuwarden", "Groningen" en "Amsterdam". Willen we met onderstaande code alleen een landingspagina voor "Leeuwarden" en "Groningen" aanmaken. Daarnaast geven we de extra zoekresultaten pagina de naam "plaatsnamen". { "url": "aanbod/{plaats:leeuwarden|groningen}", "query": { "plaats": "#{plaats}" }, "name" : "plaatsnamen" } De pagina’s maken allemaal gebruik van het archive.php template. Om onderscheid te maken tussen de verschillende pagina’s kunnen we de huidige pagina toetsen aan de ingestelde naam, hierboven was dat "plaatsnamen". In de archive.php toetsen we de huidige pagina met de functies Wonen::isArchive($name, array $query = []) en Wonen::isArchive(array $query) . Het argument $query is om op specifieke waardes van variabelen te testen. Als voorbeeld: Wonen::isArchive('plaatsnamen'); // Geeft 'true' terug wanneer we op de landingspagina voor Leeuwarden of Groningen zitten // Geeft 'false' terug wanneer we op de normale zoekresultaten pagina zitten Wonen::isArchive(array('plaatsnamen' => 'leeuwarden')); // Geeft 'true' terug wanneer we op de landingspagina voor Leeuwarden zitten // Geeft 'false' terug wanneer we op de landingspagina voor Groningen zitten // Geeft 'false' terug wanneer we op de normale zoekresultaten pagina zitten Google Map De plugin is zo gemaakt dat GPS data van de binnengekomen objecten opgehaald kunnen worden op basis van het toegestuurde adres. Hiervoor wordt gebruik gemaakt van de diensten van Google. Voorheen was deze dienst gratis en onbeperkt te gebruiken, maar dit is sinds 11 juni 2018 niet meer het geval. Om de fysieke adresgegevens om te zetten in coördinaten is een Geocoding API key nodig en deze kan je vanuit de admin in de meeste makelaar plugins verwerken met een input field. Niet elke plugin heeft deze optie, maar vanuit de geavanceerde instellingen kan je een Geocoding API key gemakkelijk toevoegen. Dat ziet er als volgt uit: { "updater": { "sources": [ { "user": "TestMakelaar", "password": "rwauth abcd-1234-zyxw-9876-voorbeeld", "offices": "", "entities": [ "wonen" ] } ], "attempts": 5, "schedule": { "interval": "daily", "time": "09:30", "earliest": "08:30", "latest": "23:59" }, "notify": { "enabled": true, "email": "info@tussendoor.nl" }, "executor": { "memory-limit": "1024M" } }, "maps": { "api-key": "" } } In het bovenstaande voorbeeld kan je op lijn 29 de Geocoding API key toevoegen. Let op: Vul hier alleen een Geocoding API in en geen (gecombineerde key met de) Maps Javascript API key. De Maps Javascript API key wordt gebruikt om de Google Map daadwerkelijk op een pagina te tonen, dit wordt bereikt vanuit het thema en hiervoor is deze API key noodzakelijk. Deze twee API's kunnen niet gecombineerd worden omdat je voor de Geocoding API de server op basis van IP moet whitelisten, terwijl je voor de Maps Javascript API juist het webadres op de whitelist moet zetten. Dit doe je door het instellen van restricties binnen de instellingen van de Google Cloud Console. Hoe je de Google Map in je thema inbouwt en hoe je daarvoor de Maps Javascript API key gebruikt lees je binnen Ontwikkeling . Ontwikkeling Bij de aanschaf van onze Makelaar plugin ontvang je een standaard thema, deze kan je als child-theme naast je hoofd thema installeren. Hierdoor kan je je hoofdthema up-to-date houden en verlies je geen instellingen van onze plugin. Binnen dit thema werk je aan de ontwikkeling van de betreffende pagina's, zoals het overzicht en de detailpagina van de objecten. Je schrijft zelf de HTML, CSS, PHP en eventueel extra Javascript om de pagina's vorm te geven. Je kan deze pagina's niet bewerken vanuit WordPress, ook niet met page builders zoals Elementor. In de onderstaande beschrijvingen wordt alleen de module voor woningen uitgelicht, de werking is hetzelfde voor alle andere modules. Daarnaast worden er veel velden gebruikt in de voorbeeldcode, het kan zijn dat er voor de koppeling met jouw CRM pakket een (net iets) ander veldnaam gebruikt moet worden. Bijvoorbeeld bij het gedeelte " Afhankelijkheden van andere velden " wordt er gebruik gemaakt van de velden koopprijs en koopconditie , dit is voor de koppeling met het CRM van Realworks. Alle velden voor de koppeling met jouw CRM pakket vind je onder Velden . Templates Het standaard thema is opgedeeld in verschillende templates. Template Beschrijving wonen/ archive.php Wordt door WordPress geladen op de archiefpagina van woningen. wonen/ search.php Bevat het zoekformulier op de archiefpagina. Aparte template i.v.m. live zoeken. wonen/ loop.php Bevat de resultaten op de archiefpagina. Aparte template i.v.m. live zoeken. wonen/ item.php Compacte weergave van een woning, gebruikt vanuit loop.php om resultaten te renderen. wonen/ map-info.php Inhoud van een Google Map info venster. Wordt ingeladen door de Google Maps ondersteuning binnen de plugin. wonen/ none.php Wordt ingeladen vanuit archive.php als er geen zoekresultaten zijn. wonen/ single.php Wordt door WordPress geladen wanneer een enkele woning wordt bekeken. Om het template wonen/item.php te renderen vanuit een ander template kan het volgende gebruikt worden: Naast de template bestanden worden er standaard de volgende bestanden automatisch ingeladen. Bijvoorbeeld wanneer de plugin gekoppeld wordt met het Realworks CRM: realworks/functions.php en wonen/functions.php. De eerst genoemde om code van toepassing op alle onderdelen van de plugin te plaatsen en de tweede functions is specifiek voor de module woningen. WordPress laadt de archive, single en de functions in omdat we via de geavanceerde instellingen van de plugin het pad aangeven naar de templates. Als je het thema anders op wil bouwen moet je daarom de paden aanpassen. Globals Binnen de loop worden zonder zoekopdracht alle woningen opgehaald en op het moment dat de bezoeker een zoekopdracht instelt worden hier de woningen getoond die voldoen aan die zoekopdracht. In deze loop is de huidige woning in de iteratie beschikbaar in de variabele $woning . Het is over het algemeen niet nodig om deze variabele expliciet als  global te declareren wanneer een template gebruikt wordt, de plugin zal dit voor zijn rekening nemen. Met deze variabele kan je informatie van de woning tonen in de item.php. Let op: Wanneer er geen gebruik gemaakt wordt van een template is de globale variabele $woning leeg. We raden daarom het gebruik van templates aan. Caching We raden aan om een WordPress caching plugin te gebruiken om het laden van de site te versnellen. Voor het ophalen van de data voor alle woningen zijn veel database query's nodig, wat alles bij elkaar enkele tientallen milliseconden in beslag kan nemen. Om dit te versnellen, raden we aan om templates waarin gegevens van een woning worden opgevraagd te cachen. Bijvoorbeeld binnen de loop tijdens het weergeven van de woningen: cache(); ?> Templates worden gecached op basis van de naam en ID van de huidige woning. Weergave van velden Het kan voorkomen dat er specifieke eisen zijn om velden op een bepaalde manier weer te geven, soms afhankelijk van andere velden en soms omdat je een prijs als een prijs wil formatten. Om te voorkomen dat deze logica overal door het thema opnieuw geschreven wordt biedt de plugin een aantal manieren om dit op een prettige manier te laten verlopen, waarbij alles op een centrale plek aangepast kan worden. Een veld uit onze plugin is een object en kan naast het terug geven van zijn waarde nog veel meer informatie terug geven. Zo kunnen de volgende methods worden gebruikt: $woning->plaats; // Het volledige object voor het veld 'plaats' $woning->plaats->render(); // De plaats van de woning na transformaties $woning->plaats->value(); // De waarde van het veld plaats $woning->plaats->label(); // Label van het veld plaats $woning->plaats->is('Leeuwarden'); // Is de plaats Leeuwarden? $woning->plaats->is('Leeuwarden', 'Groningen'); // Is de plaats Leeuwarden of Groningen? $woning->plaats->isnt('Leeuwarden'); // Is de plaats niet Leeuwarden? $woning->plaats->isEmpty(); // Heeft de plaats geen waarde? $woning->plaats->hasValue(); // Heeft de plaats een waarde? TIP: Doordat onze plugin gebruik maakt van Magic Methods ( __toString() ) kunnen we voor het tonen van de plaats ook simpel het volgende schrijven plaats; ?> . Voor een simpele echo is ->render() niet nodig. Veld types Elk veld heeft een bepaald type zodat het weergeven ervan automatisch gebeurt. Ieder van de types heeft verder specifieke methodes als hulp. Voor de onderstaande veldtypes worden letterlijke voorbeelden in de objecten gezet, er zijn echter geen velden die letterlijk ‘list’, ‘boolean’, ‘date’, ‘dateTime’, ‘integer’ of ‘double’ heten. Deze velden referen naar velden met dat type waarde. De velden die geschikt zijn voor jouw CRM pakket vind je allemaal terug onder het hoofdstuk 'velden'. Arrays $woning->list->render($separator = ', '); $woning->list->count(); $woning->list->all(); $woning->list->first(); $woning->list->last(); $woning->list->implode($glue); In plaats van komma gescheiden waardes kan ook gebruik worden gemaakt van een lijst. Verander hiervoor de formatter in list , waarbij als standaard een