WordPress Makelaar plugin

Het aanpassen van de volgorde op basis van status is standaard niet mogelijk. De plugin is namelijk gemaakt op basis van het verwerken van gegevens. hierdoor kunnen we alleen sorteren op informatie die we hebben gekregen van de woningen. 

Dit is vanuit de plugin daarom enkel de status, waarbij we kunnen sorteren op alfabetische volgorde. 

Om te kunnen sorteren op een eigen en/of andere volgorde moeten we data toevoegen aan andere waarden, zodat daar op gesorteerd kan worden. Voor meer informatie hierover kun je contact met ons opnemen.

Het aanpassen van de volgorde op basis van status is standaard niet mogelijk. De plugin is namelijk gemaakt op basis van het verwerken van gegevens. hierdoor kunnen we alleen sorteren op informatie die we hebben gekregen van de woningen. 

Dit is vanuit de plugin daarom enkel de status, waarbij we kunnen sorteren op alfabetische volgorde. 

Om te kunnen sorteren op een eigen en/of andere volgorde moeten we data toevoegen aan andere waarden, zodat daar op gesorteerd kan worden. Voor meer informatie hierover kun je contact met ons opnemen.

Dat kan. Via de knop aan de onderzijde kom je in onze demo omgeving terecht.

Standaard werkt de makelaars plugin niet met WPML. Dit houdt in dat de objectgegevens in de pagina templates van onze plugin niet vertaald kunnen worden. 

Om toch aan de vraag te kunnen voldoen om de pagina templates en de objectgegevens vertaalbaar te maken met WPML hebben we een add-on ontwikkeld. 

Binnen het CRM pakket kan je aangeven in hoeverre je de objecten wil vrijgeven. Als je niet alle informatie ziet die je verwacht te zien dan kan dit komen doordat je niet de gewenste informatie hebt vrijgegeven. 

Om te weten hoe je de informatie vrijgeeft kan je het beste contact opnemen met de CRM aanbieder, zij kunnen je uitleggen hoe dit werkt binnen het CRM dat je gebruikt.

Binnen een aantal CRM pakketten kun je dit vinden onder de volgende instellingen:

Profiel icoon > instellingen > API > API manager, daar moet onder object level ook "object gegevens" aangevinkt staan.

Transactiegegevens worden niet standaard meegestuurd met de koppeling, dit moet bij de meeste CRM pakketten specifiek worden geactiveerd. 

Om te weten hoe je de transactiegegevens vrijgeeft kan je het beste contact opnemen met de CRM aanbieder, zij kunnen je uitleggen hoe dit werkt binnen het CRM dat je gebruikt.

Om Streetview te kunnen tonen bij een object, maken we gebruik van de diensten van Google. Dit is de reden dat je de Geocoding API en de Maps Javascript API hebt ingesteld. 

Met de Geocoding API kunnen we er via Google voor zorgen dat het adres van een object kunnen omzetten in coördinaten. Met deze informatie komt ook de data mee waarmee we een Streetview kunnen tonen, dit gaat allemaal automatisch. 

Het kan bij nieuwe objecten voorkomen dat Google nog de verkeerde informatie toestuurt en dat de Streetview bijvoorbeeld de verkeerde kant op staat.

Dit kunnen we alleen aanpassen met maatwerk, neem hiervoor contact met ons op.

Met vrijwel alle informatie die wordt meegestuurd met de makelaars plugin kunnen we een extra aanbod pagina maken, de enige voorwaarde hiervoor is dat de informatie juist en consequent wordt ingevuld.

Daarnaast mag het object maar 1x deze informatie mee krijgen, denk hierbij aan de verdiepingen van een object. Het kan zijn dat er van elke verdieping informatie meegestuurd wordt, deze informatie wordt als een bundel meegestuurd en zo kunnen er meerdere verdiepingen zijn. Een extra aanbod pagina over de verdiepingen is daarom niet mogelijk.

Meer informatie over het aanmaken van een extra aanbod pagina vind je in onze documentatie.

Dit kan voorkomen wanneer een object tegelijk met de status wijziging wordt ingetrokken. Het object is direct uit de koppeling verwijderd door de intrekking en daardoor gaat de status wijziging niet meer mee, de plugin ontvangt geen informatie meer over dit object en kan om die reden geen wijzigingen meer aanbrengen aan het object.

Wanneer je het object op de site wil laten staan als verkocht is de enige manier om de status te veranderen via de database. Binnen je database kan je navigeren naar prefix_realworks_wonen, zoek de juiste woning en zoek daar de status. Verander dit in “VERKOCHT”. Neem contact met ons op als je wil dat wij dit voor je doen.

Lees hier (Verwijderen ingetrokken objecten) meer over het intrekken van woningen.

Dit kan voorkomen wanneer een object tegelijk met de status wijziging wordt ingetrokken. Het object is direct uit de koppeling verwijderd door de intrekking en daardoor gaat de status wijziging niet meer mee, de plugin ontvangt geen informatie meer over dit object en kan om die reden geen wijzigingen meer aanbrengen aan het object.

Wanneer je het object op de site wil laten staan als verkocht is de enige manier om de status te veranderen via de database. Binnen je database kan je navigeren naar prefix_realworks_wonen, zoek de juiste woning en zoek daar de status. Verander dit in “VERKOCHT”. Neem contact met ons op als je wil dat wij dit voor je doen.

Lees hier (Verwijderen ingetrokken objecten) meer over het intrekken van woningen.

De plugin kan ingesteld worden om automatisch bij te werken, dit kan binnen de instellingen bij “rooster”:

Controleer of het automatisch bijwerken staat ingesteld en of dit één keer per dag of met een interval is. 

Stel bijvoorbeeld een interval van om de 3 uur in als dit nog niet zo staat ingesteld. Een interval korter dan 3 uur raden we niet aan. Je moet namelijk voorkomen dat er twee bijwerk-processen tegelijk actief zijn. Een proces moet de tijd hebben om afgerond te worden.

Als dit goed ingesteld stond, controleer dan of er al een bijwerk-proces is afgerond voor de huidige dag. 

Doe dit door binnen het dashboard van de plugin aan de rechterzijde - onder “opslaan” - op bijwerken te klikken. Hier vind je de logs van de plugin. 

Als er nog geen bijwerk-proces is gestart terwijl dit wel stond ingesteld, neem dan contact met ons op. 

Als het bijwerken goed verloopt, controleer dan binnen je CRM of de missende objecten goed staan vrijgegeven. Het kan zijn dat deze niet meegestuurd worden met de koppeling.
 

Ja en nee. De makelaars plugin werkt niet out of the box met een page builder, maar bepaalde functionaliteit kan ingebouwd worden.

De pagina’s om de objecten te tonen, zoals de aanbod pagina met de zoekfilters en de detailpagina van een object, kunnen niet gemaakt worden met een page builder. 

Dit komt omdat we de data van objecten verwerken in de database. Dit tonen we vervolgens door gebruik te maken van eigen geschreven templates die uitgelezen worden door WordPress met behulp van onze plugin. 

Als je gebruik maakt van een page builder dan heb je dus geen beschikking over alle kenmerken van een object die je hebt toegevoegd in je CRM.

Vanuit WordPress is het adres, de aanbiedingstekst en de uitgelichte foto van een object standaard wel beschikbaar, mocht je alleen deze informatie willen gebruiken voor bijvoorbeeld je aanbod omgeving dan is dit wel mogelijk met een page builder. 

Houd er in dat geval rekening mee dat je niet gebruik kunt maken van het live-zoeken zoals we vanuit onze templates wel kunnen bereiken.

Ook is het mogelijk om elementen op te bouwen die je vervolgens oproept met shortcodes. Deze shortcodes kun je vervolges weer gebruiken in en via je page builder. Op die manier kun je bepaalde blokken me objecten ook vrijer inzetten en weergeven.

Wanneer gebruik gemaakt wordt van een page builder moet je er rekening mee houden dat we niet garant kunnen staan voor de functionaliteiten van onze plugin.

Bepaalde thema’s bieden de mogelijkheid om pagina’s te maken waarop je het aanbod kunt tonen. Je hebt dan een vooraf bepaalde styling voor de aanbod- en de detail pagina. Je kunt vaak het aanbod invoeren in het beheer van WordPress. 

Het nadeel hieraan is dat je het aanbod zowel in de website als in je CRM moet invoeren. Dubbel werk dus. Je vraagt je wellicht af of onze plugin de koppeling tussen dit thema en het CRM kan leggen.

Het antwoord is zowel ja als nee.

Ja; onze plugin werkt met je thema, je kan de plugin installeren en de koppeling maken. Daarnaast kan je de vormgeving zo maken dat het binnen je thema past.

Nee; onze plugin is geen plug-and-play plugin. Het is niet zo dat de objecten die we ophalen via de koppeling verwerkt worden binnen de al bestaande oplossingen van het thema. 

De object pagina’s moeten daarom zelf nagemaakt worden in de template bestanden die onze plugin uitleest.

Of je gebruik moet maken van een makelaars thema of niet is dus aan jezelf. Zie je een thema met betere opties en/of betere prestaties, dan kun je altijd de woning pagina's die je hebt gezien namaken. 

Omdat functies - zoals het zoeken en filteren - vanuit het makelaars thema niet werken, biedt het geen voordeel om voor het al bestande makelaars thema te kiezen. 

Binnen de plugin heb je 100% vrijheid in het opmaken en stijlen van de woning pagina's / woning elementen. Wil je een specifiek thema gebruiken of wil je elementen uit thema's combineren, dan kan dat dus. 

Kom je er niet uit? Dan kun je altijd gebruik maken van onze inbouwservice.

Het blijven tonen van ingetrokken woningen is een bekend probleem. 

Je kan binnen Realworks een woning op twee manieren op de status 'Ingetrokken' zetten. 

Het probleem ontstaat doordat bij een object de Eigen site optie onder het tabblad Marketing van het object op Ingetrokken is gezet. Hiermee wordt het object direct uit de koppeling verwijderd. 

Wanneer je een object afmeld via het tabblad financieel met de transactie status Ingetrokken dan komt deze wijziging door via de koppeling en kan de plugin hier naar naar handelen.

De ingetrokken woning is niet meer beschikbaar in de koppeling en kan niet meer via de plugin verwijderd worden. De status van deze woning is niet 'ingetrokken' maar 'beschikbaar'. 

De enige oplossing hiervoor is om deze woning handmatig te verwijderen en vervolgens de prullenbak te legen. 

1). Zet het bijwerk rooster van de plugin uit. Dit kan door vanaf het WordPress dashboard menu te navigeren naar 'Makelaar'. Klik vervolgens op 'Instellingen'. Bij het kopje 'Bijwerken' moet de optie voor het 'Rooster' op 'Geen' staan.

Externe cronjob via PHP CLI

2). Door het bestand wp-content/plugins/realworks/update.php als executable van een cronjob in te stellen zullen updates niet langer via Apache/Nginx worden uitgevoerd, maar direct door PHP CLI.

Externe cronjob via WP-CLI

2). Voeg de WP-CLI command toe:

WP_CLI::add_command('realworks', function ($args) {
if (in_array('update', $args)) {
     $result = Realworks::make('updater')->update();
     ($result) ? WP_CLI::success('Bijwerken voltooid') : WP_CLI::error('Bijwerken mislukt');
}
});

Voor elk bijwerk moment wat heeft plaatsgevonden is een JSON bestand gedownload. Om ruimte te besparen wordt het als een zip-archief opgeslagen. 

Om deze bestanden te benaderen heb je toegang nodig tot de FTP of een file manager binnen je hostingpakket. 

Het zip archief voor woningen kan je vinden binnen de map: 

wp-content/uploads/realworks/jaar/maand/dag/module-naam/**/

Voor elk bijwerk moment dat heeft plaatsgevonden is een JSON bestand gedownload. 

Om ruimte te besparen wordt het als een zip-archief opgeslagen. Om deze bestanden te benaderen heb je toegang nodig tot de FTP of een file manager binnen je hostingpakket. 

Het zip archief voor woningen kan je vinden binnen de map: 

wp-content/uploads/realworks/jaar/maand/dag/module-naam/**/

Tijdens de ontwikkeling van de Makelaar plugin hebben we met het ontvangen van aanbod van meerdere pakketten en/of kantoren rekening gehouden. Hierdoor kan je binnen de plugin meerdere koppelingen toevoegen. 

Elk object binnen de koppeling bevat informatie waarmee achterhaald kan worden van welke makelaardij of individuele makelaar de woning is. Dit kun je indien gewenst  weergeven.

Het is mogelijk om te migreren. Hier zijn echter wel een aantal punten van toepassing. De belangrijkste is de aangepaste structuur die voortkomt tussen de XML en API koppeling. 

Dit heeft meerdere gevolgen. 

• De eerste is dat het aanbod van de website verwijderd moet worden.
• De tweede is dat de template bestanden doorlopen moeten worden om veldnamen - waar nodig - aan te passen. 
• De derde gevolg is dat zoekvelden opnieuw opgezet moeten worden. Hieronder ook alvast alle benodigde stappen die doorlopen moeten worden.

1. Verwijder woningen via WordPress;
2. Verwijder de plugin cache van de huidige plugin versie (v3). Dit kan via het dashboard van de plugin;
3. Maak een backup van de database;
4. Verwijder alle relevante database tabellen, dit begint normaal gesproken met wp_realworks_;
5. Installeer de nieuwe plugin;
6. Controleer of je nogmaals de cache kan verwijderen vanuit het dashboard van de nieuwe plugin;
7. Pas de velden in het thema aan naar de nieuwe velden. De XML velden vind je hier, en de API velden vind je hier;
8. Activeer de koppeling door het toevoegen van de juiste Realworks Token key in het dashboard;
9. Navigeer naar Bijwerken en klik vervolgens op de knop bijwerken om het aanbod opnieuw op te halen.

In de meest recente versie van onze makelaar plugin die geschikt is voor Realworks en Tiara  hebben we een optimalisatie doorgevoerd. Hierdoor worden alleen objecten die een wijziging hebben ondergaan bijgewerkt in de plugin. We slaan objecten die niet zijn aangepast dus over en dit versnelt het bijwerken enorm.

Om te zien of een object een wijziging heeft gehad sinds de vorige keer dat we het object hebben bijgewerkt controleren we de toegestuurde wijzigingsdatum. 

Het kan in sommige situaties voorkomen dat een object niet volledig is bijgewerkt en dat je bijvoorbeeld alleen een titel en 3 afbeeldingen ziet (een “half” object).

Ondervind je dit probleem, lees dan ondersatand artikel waarin we op deze fout inzoomen / oplossen.

Deze media items kan je invoeren binnen je CRM zodat de media met de koppeling meegestuurd wordt. De plugin verwerkt dit vervolgens zodat de informatie ook op de website bij de juiste woning bekend is. 

Let op; de media items kunnen worden uitgelezen op de website, maar het is nog wel van belang dat de code wordt geschreven om de media uit te lezen en te tonen aan de bezoeker.

De aanbiedingstekst wordt binnen de koppeling als platte tekst meegestuurd. Dit betekent dat dit uitsluitend bestaat uit letters, spaties, cijfers en leestekens. 

Hier zit geen opmaak in, zoals vet, cursief of onderstreept. 

Wanneer de API van een makelaar gekoppeld is aan een developer, dan is het mogelijk om de token in te zien. De developer kan dit op https://developers.realworks.nl/#/dashboard doen. Klik hiervoor op de Token knop. 

Wanneer je deze Token hebt, kun je binnen het dashboard van de Makelaar plugin navigeren naar Instellingen. 

Klik binnen dit tabblad op de knop Toevoegen naast de titel Koppeling. Voer de token in bij het veld API-Token. Let hierbij op dat voor het token het woord ‘rwauth’ moet komen te staan. 

De waarde in het veld Identificatie kan naar eigen wens worden ingevuld. Selecteer bij Geactiveerd de benodigde modules en klik op Toevoegen.

Je koppeling staat nu ingesteld. Om deze te testen kan je via de knop Bijwerken (rechterzijde in het menu) navigeren naar het bijwerk log.

• Klik binnen dit tabblad op de knop Nu bijwerken. 
• Klik binnen de modal die dan toont 1x op de blauwe knop Bijwerken. 

Wanneer dit is gedaan start het bijwerk proces en zal het aanbod ervan binnen gehaald worden.

Binnen het WordPress dashboard wordt een beperkte hoeveelheid informatie opgeslagen. Voor elke custom post type die de plugin toevoegt (Wonen, Bog, Nieuwbouw) wordt binnen een object alleen de titel, aanbiedingstekst, uitgelichte afbeelding en de overige media opgeslagen. De rest van de informatie wordt verwerkt binnen de database en kan aangeroepen worden via de API van de plugin.

Binnen het basis thema wat meegeleverd wordt kan je voorbeelden vinden hoe dit werkt.

Bij elke woning in de API wordt het ID van de bijbehorende makelaar meegestuurd. Naast dit ID wordt er verder geen andere informatie meegestuurd. Maar dit is al genoeg informatie om het tonen van een makelaar bij de woning te kunnen realiseren met wat extra programmeerwerk.

Binnen het dashboard van de Makelaar plugin is het mogelijk om de cache te verwijderen. 

1. Kijk hiervoor bij Installatie;
2. Zoek naar de optie Cache; 
3. Klik vervolgens op Toon detail. 

Je krijgt nu een lijst te zien met de verschillende modules en de ge-cachte velddefinities. Via de verwijder knop kan je de cache per module legen.

Wanneer tijdens het bijwerkproces een aanvraag wordt gedaan om de coördinaten op te halen doet de plugin dit aan de hand van de adresgegevens van het project. Het kan voorkomen dat de nieuwe straatnaam en/of huisnummer nog niet bekend is binnen Google Map. Omdat deze informatie nog niet bekend is zal de aanvraag onjuiste coördinaten terugsturen. Dit antwoord is alleen niet te onderscheiden van aanvragen waarbij wel correcte coördinaten worden toegestuurd.

De oplossing hiervoor is om op Google Maps zelf de locatie te achterhalen. Vervolgens kan je de coördinaten over te nemen om deze deze binnen de database aan te passen.

Het toevoegen van een zoekoptie is uitgebreid beschreven in de documentatie van de plugin. Via de onderstaande knop kom je direct bij uitleg hiervoor.

Onze licenties zijn domein gebonden, zodra je jouw ontvangen licentie hebt gebruikt op een test omgeving zal deze niet meer kunnen werken op de live omgeving. Je kunt de plugin ook testen zonder actieve licentie, maar je kunt dan geen plugin updates ontvangen en het automatisch bijwerken zal niet werken. 

Om te testen kun je eenmalig handmatig bijwerken, doe dit door in het dashboard van de plugin naar “bijwerken” te navigeren. Klik links naast “Bijwerkgeschiedenis” op “nu bijwerken” en klik in de pop-up wederom op “bijwerken”. Klik maar 1x! Als het scherm nog niet reageert komt dat omdat het bijwerkproces gestart is en de server daar druk mee is. Ververs het scherm in dit geval. Je kunt maar 1x klikken omdat er anders 2 processen beginnen, dit kan voor onverwachte problemen zorgen. Als alles goed gaat heb je nu je het aanbod van de makelaar opgehaald, succes met testen!

Als je wel graag je licentie wil gebruiken op een test omgeving dan zal je voor de livegang de licente vrij moeten geven. Kijk bij de vraag hieronder (#licentie-vrijgeven) hoe je dit moet doen.

Het enige dat je hoeft te doen is je klantnummer en licentiecode invoeren. Je klantnummer vind je bovenaan iedere factuur en de licentiecode vind je terug binnen je plugin en/of heb je ontvangen toen je de plugin bij ons besteld hebt.

Dit kan alleen voorkomen doordat het object opnieuw / extra is toegestuurd of dat de informatie dusdanig is aangepast dat het object als een nieuw object wordt herkend. Dit laatste komt overigens vrijwel nooit voor. 

Om dit probleem op te lossen zoek je de oudste versie van dit object op in de backend van WordPress, deze verwijder je permanent. Mocht het probleem zich hierna weer voordoen dan kan je het beste beide objecten permanent verwijderen en vervolgens opnieuw bijwerken. Doe dit alleen als je zeker weet dat het object nog met de koppeling wordt meegestuurd, controleer dit voor de zekerheid in je CRM.

Binnen de instellingen van de gebruikte module, bijvoorbeeld “Wonen”, kan je de “object status” instelling gebruiken. 

Meer informatie vind je hier:

Binnen de instellingen van de gebruikte module, bijvoorbeeld “Wonen”, kan je de “object status” instelling gebruiken. 

Meer informatie vind je hier:

Binnen de instellingen van de gebruikte module, bijvoorbeeld “Wonen”, kan je de “object status” instelling gebruiken. 

Meer informatie vind je hier:

Indien een object niet beschikbaar is op de website dan is deze in alle waarschijnlijkheid niet vrijgegeven voor de koppeling. Dit kan je binnen het woning beheer systeem van je CRM pakket aanpassen.

Je kan ook de koppeling zelf controleren. Hiervoor heb je FTP toegang nodig. Navigeer binnen een reguliere WordPress installatie naar wp-content/uploads. 

De plugin maakt hier een map aan. De naam hiervoor kan verschillen maar het is één van de volgende opties:

• eyemove;
• goesenroos;
• realworks;
• tiara;
• pyber;
• venum;
• skarabee.

Wanneer je in deze map zit navigeer je naar de huidige dag. Dit kan je doen door het correcte jaar, maand en vervolgens dag te openen. 

Maak  een keuze uit de correcte module en open de koppeling waar het object zich in bevind. Hier vind je een XML of JSON bestand, eventueel kunnen deze bestanden ook in een zip-archief zijn verwerkt. 

Kijk in het betreffende XML en JSON bestand of je hier het object terug kan vinden.

Een voorbeeld voor de correcte plaats is: 

wp-content/uploads/realworks/2021/10/15/wonen/**/

De beschikbare koppelingen voor deze plugin zijn allemaal los van elkaar opgezet. Dit in combinatie met de vele verschillen in de veldstructuur maakt het voor ons praktisch onmogelijk om dit vervolgens gezamenlijk op te slaan binnen een enkele custom post type. 

Het is wellicht mogelijk wanneer je genoeg programmeer kennis hebt om de berichten van deze custom post types te combineren. Wij raden dit echter  niet aan en kunnen vanwege de vele problemen hiermee er geen support op leveren.

De beschikbare koppelingen voor deze plugin zijn allemaal los van elkaar opgezet. Dit in combinatie met de vele verschillen in de veldstructuur maakt het voor ons praktisch onmogelijk om dit vervolgens gezamenlijk op te slaan binnen een enkele custom post type. 

Het is wellicht mogelijk wanneer je genoeg programmeer kennis hebt om de berichten van deze custom post types te combineren. Wij raden dit echter  niet aan en kunnen vanwege de vele problemen hiermee er geen support op leveren.

De beschikbare koppelingen voor deze plugin zijn allemaal los van elkaar opgezet. Dit in combinatie met de vele verschillen in de veldstructuur maakt het voor ons praktisch onmogelijk om dit vervolgens gezamenlijk op te slaan binnen een enkele custom post type. 

Het is wellicht mogelijk wanneer je genoeg programmeer kennis hebt om de berichten van deze custom post types te combineren. Wij raden dit echter  niet aan en kunnen vanwege de vele problemen hiermee er geen support op leveren.

De geïnstalleerde Makelaar plugin is op dit moment geschikt voor één CRM pakket. Wanneer je veranderd van Makelaar CRM aanbieder dan heb je hier een andere plugin voor nodig. 

Aan de plugin switch zelf zijn geen kosten verbonden. Informeer voor de kosten van het omzetten van de licentie via mail of telefonisch.

Binnen de documentatie kan je voor de nieuwe plugin de velddefinities veranderen.

Wij raden aan om de volgende stappen te doorlopen om er voor te zorgen dat je een schone installatie hebt:

• Verwijder alle woningen.
• Verwijder de plugin cache via het dashboard van de plugin.
• Verwijder alle database tabellen van je huidige plugin
• Verwijder de huidige plugin, installeer de nieuwe en activeer deze.
• Stel de nieuwe plugin juist in (als je een blank scherm ziet, gebruik dan Google Chrome en/of doe een hard refresh).
• Haal de woningen opnieuw binnen.
• Zet je zoekvelden opnieuw op
• Je kan de code van je vorige template bestanden voor een groot deel hergebruiken. Pas hierbij de velden aan naar de nieuwe veld definities.

Het is mogelijk om woninginformatie dynamisch toe te voegen aan de meeste formulier plugins. 

Wanneer het formulier op een andere pagina staat kan je gebruik maken van URL parameters. Deze informatie kan door het formulier correct op te zetten meegestuurd worden via niet zichtbare velden.

Indien het formulier op de object pagina zelf staat is het ook mogelijk deze dynamisch te vullen. De manier waarop dit kan verschilt per plugin.

Indien er geen gebruik wordt gemaakt van de ALV koppeling kan er gemigreerd worden naar de nieuwe API koppeling. Let hierbij op dat je vanwege de vele verschillen tussen XML en API koppeling een nieuwe reeks van de plugin nodig hebt. 

Aan de plugin upgrade zelf zijn geen kosten verbonden. Informeer voor de actuele kosten voor het omzetten van de licentie per mail of telefonisch.

Mocht er qua inbouw-werkzaamheden aan onze zijde e.e.a. moeten worden uitgevoerd dan wordt dit apart begroot.

Na de periode van een maand wordt automatisch de XML licentie bij ons stopgezet en worden via de XML de woningen niet meer bijgewerkt. Mocht na deze periode extra tijd nodig zijn, dan dient er een extra licentie afgenomen te worden. Dit kan in periodes van zes maanden gedurende een migratie-traject.

Binnen de documentatie  kan je zien welke velddefinities veranderd zijn.

Wij raden aan om de volgende stappen te doorlopen om er voor te zorgen dat je een schone installatie hebt:

• Verwijder alle woningen.
• Verwijder de plugin cache via het dashboard van de plugin.
• Verwijder alle database tabellen die _realworks bevat in de naam.
• Verwijder de huidige plugin, installeer de nieuwe en activeer deze.
• Stel de nieuwe plugin juist in (als je een blank scherm ziet, gebruik dan Google Chrome en/of doe een hard refresh).
• Haal de woningen opnieuw binnen.
• Loop de zoekvelden na en pas waar nodig de velden aan.
• Controleer de template bestanden en en pas waar nodig de veldnamen aan.

Het is mogelijk om objecten op de homepage te tonen. Er zijn verschillende manieren om dit te realiseren (shortcode of query opzetten). De optie waar je voor kiest hangt af van hoe het thema op is gezet. Voor beide oplossingen is basiskennis van PHP vereist. De cruciale onderdelen binnen onze documentatie zijn als volgt.

• Bekijk querying
• Bekijk collections

Het eerste onderdeel legt uit hoe de query opgezet kan worden. Het tweede onderdeel bevat informatie voor het opzetten van de loop en post collection.

Voor het opzetten van een shortcode kan je gebruik maken van de WordPress API hiervoor. Meer informatie kan je vinden op de WordPress codex.

Het missen van kenmerken kan meerdere oorzaken hebben. De meest voorkomende is dat de waarde niet beschikbaar is binnen de koppeling. Zodoende kan de plugin deze ook niet verwerken en uiteindelijk niet getoond worden.. De achterliggende oorzaak hiervan kan zijn dat deze niet is ingevuld in het betreffende object beheersysteem.

Een tweede oorzaak kan zijn dat het een nieuw veld betreft en dat de plugin deze nog niet verwerkt. In dit geval kan je altijd contact met ons opnemen (info@tussendoor.nl) en dan kunnen wij dit toevoegen via een plugin update.

We hebben voor het opzetten van een zoekopdracht een addon voor onze Makelaars plugin geschikt voor Realworks ontwikkeld. Hiermee kan je het zoekopdracht formulier toevoegen aan een pagina waarmee bezoekers een eigen zoekopdracht kunnen opzetten.

Het standaard formulier is vrij uitgebreid, maar er is ook de mogelijkheid om de velden zelf te bepalen via template bestanden.

Voor het tonen van POI op de Google Map van bijvoorbeeld een woning detail pagina hebben wij een Addon ontwikkeld die in combinatie met onze Makelaar plugin werkt. 

Hiermee is het mogelijk om via een extra icoontjes op de map bijvoorbeeld: restaurants, winkels, supermarkten, scholen of openbaar vervoer te tonen.

Omdat de vormgeving en gewenste functionaliteit die hiervoor opgezet kan worden kan variëren raden we je aan om hiervoor contact met ons op te zoeken. 

Let hier wel bij op dat je voor deze functionaliteit gebruik moet maken van de Places API van Google. Dit kan bij veel gebruik, extra kosten met zich meebrengen.

Het is mogelijk om handmatig het bijwerk proces te starten. Dit kan je doen door vanaf het dashboard van de plugin te navigeren naar ‘Bijwerken’. Op deze pagina kan je het bijwerklog van de plugin vinden. Door op de knop ‘Bijwerken’ rechts van ‘Bijwerkgeschiedenis’ te klikken open je de popup waarbinnen je het handmatige bijwerk proces kan starten. Klik binnen deze popup vervolgens 1x op ‘Bijwerken’.

Het bijwerk proces is hiermee gestart maar het kan even duren voordat het proces start. De koppeling moet namelijk eerst opgehaald worden. Wanneer dit gebeurd wordt je automatisch naar dit bijwerk proces gestuurd. Mocht dit niet gebeuren, dan kan je altijd de pagina opnieuw laden en weer navigeren naar ‘Bijwerken’. In het log zie je dan het gestarte bijwerk proces.

Het is mogelijk om aan de homepage, of elke andere pagina die je wilt, een zoekformulier toe te voegen. Zolang dit formulier de zoekactie doorstuurt naar de aanbod pagina dan zal dit werken.

Voor het opzetten ervan heb je twee opties. Via een shortcode, of direct binnen het template bestand van de betreffende pagina. De optie waar je voor kiest hangt af van hoe het thema is opgezet. Voor beide oplossingen is kennis van PHP vereist.

Creëer binnen de template bestanden van de gewenste module een nieuw bestand. Dit bestand zal de zoekvelden bevatten die je op de homepage wilt gebruiken. 

Laad dit template bestand in een <form> element in. Als voorbeeld voor wonen: 

<?= Wonen::template('search-frontpage') ?>. 

Zorg ervoor dat de action van dit formulier naar de overzicht pagina van deze module wijst. Als voorbeeld voor wonen: 

action="<?= Wonen::archive() ?>".

Voor het opzetten van een shortcode kan je gebruik maken van de WordPress API. Meer informatie kan je vinden in de WordPress Codex.De bovenstaande informatie kan ook gebruikt worden om de shortcode te vullen.

Het NVM nummer wordt niet meegestuurd wanneer er maar één koppeling wordt afgenomen. Hiervoor moet je minimaal twee API koppelingen afnemen.

Dit probleem kan voorkomen wanneer er veel bijwerk momenten zijn op één dag. Tijdens elk bijwerk moment worden er logbestanden aangemaakt en een JSON bestand met de woninginformatie binnengehaald. Om ruimte te besparen wordt dit bestand als een zip-archief opgeslagen.

Waar de plugin geen mogelijkheden heeft om deze bestanden automatisch te verwijderen, kan dit wel handmatig. 

Dit kun je doen door vanaf het dashboard van de plugin te navigeren naar Bijwerken (rechterzijde in het menu). Vervolgens kan je een maand selecteren binnen de bijwerk geschiedenis. Dan heb je een keuze om alleen de zip-archieven te verwijderen of de zip-archieven en log bestanden.

Deze foutmelding kan plaatsvinden wanneer het IP adres wat op de whitelist staat niet overeenkomt met het IP adres van de server. 

Neem hiervoor contact op met de developer aan wie jullie API is gekoppeld. Via https://developers.realworks.nl/ kan dit opgelost worden.

Deze foutmelding heeft meerdere oorzaken. Een veel voorkomende reden is het missen van de facturatiegegevens binnen je Google Cloud console. Dit kan je op de volgende pagina toevoegen https://console.cloud.google.com/billing/linkedaccount.

De tweede reden kan een niet correct ingestelde Geocoding API key zijn.

Het enige dat je hoeft te doen is je klantnummer en licentiecode invoeren. Je klantnummer vind je bovenaan iedere factuur en de licentiecode vind je terug binnen je plugin en/of heb je ontvangen toen je de plugin bij ons besteld hebt.

Licenties kunnen maximaal op één domein tegelijk gebruikt worden. Als je de melding ziet dat het maximale aantal activaties is bereikt, is er hoogstwaarschijnlijk al een licentie actief terwijl je op een andere website / domeinnaam de plugin probeert te activeren.

Om de licentie te activeren, dien je de andere licentie eerst te deactiveren en vrijgeven. Zodra de licentie is vrijgegeven, kan je de licentie opnieuw activeren. 

Je kunt de licentie eenvoudig vrijgeven vanuit jouw account. 

Gebruik je onze makelaars plugin en ontvang je een foutcode 403? Dan is de oplossing gelukkig vaak eenvoudig. Via onderstaande button kom je op een pagina om foutcode 403 op te lossen.

Maak je gebruik van onze makelaar plugin en ontvang je een foutcode / foutmelding 401? Dan zijn er een aantal oplossingen mogelijk. We nemen de foutmelding 401 door op de volgende pagina.

Heb je onze makelaar plugin geïnstalleerd maar verwerkt deze tijdens bij bijwerk proces geen nieuwe objecten? Voer dan de volgende stappen uit. 

• Controleer of de licentie actief en correct is
• Controleer of de koppeling(en) zijn toegevoegd
• Controleer of er foutmeldingen in het bijwerkproces zijn zoals 401 of 403 fout.
• Controleer of alle objecten in het CRM vrijgegeven zijn
• Controleer of er een bijwerk tijdstip staat ingesteld in het rooster binnen de instellingen van jouw plugin
• Controleer of de WP cron actief is