Blog

Realworks WordPress plugin: API support

Door op | in Weblog

Yes. Eigenlijk dekt de titel al een groot gedeelte van de lading, maar we gaan er toch iets dieper op in. De Realworks plugin heeft vanaf nu API support.

Vorm van de update

De ondersteuning voor de compatibiliteit voor de Realworks API komt in de vorm van een compleet nieuwe release. Dit heeft diverse oorzaken en biedt tevens diverse voordelen. De grootste reden hiervan is dat Realworks de XML nog niet volledig heeft afgesloten.

Bestaande klanten kunnen namelijk nog gebruik blijven maken van hun XML koppeling, maar nieuwe klanten kunnen deze (zo bleek onlangs) niet meer aanvragen. Zij moeten dus gebruik maken van een API koppeling voor hun dataset.

Omdat de API compleet anders in elkaar steekt, ook qua velddefinities, en er vanuit Realworks geen informatie beschikbaar is voor een migratie-trajact hebben we besloten om de update en compatibiliteit uit te brengen in de vorm van een nieuwe release. Hiermee belasten we plugin in haar huidige vorm niet voor bestaande klanten, terwijl we nieuwe klanten wel volledig kunnen bedienen.

Realworks APIRealworks API

In ontwikkeling

De API is momenteel - naar wij begrijpen - nog in ontwikkeling. Althans, op diverse vlakken. Zo kunnen we gegevens wel uitlezen, maar is de veelgevraagde functie om gegevens in te schieten nog niet beschikbaar. Klantdata, bezichtigings-aanvragen en inschrijf- of zoekopdrachten kunnen we dus nog niet in Realworks inschieten.

Daarbij zijn, eveneens zover onze informatie reikt, momenteel enkel de koppelingen WONEN, BOG en NIEUWBOUW mogelijk bij de API. Hoe zich dit verhoudt ten opzichte van de koppelingen die XML bood (WONEN, BOG, NIEUWBOUW, VGM, VGM UNITS en A&LV) is voor ons op dit moment helaas onbekend. Ook hierin ontvangen we helaas nog niet de gevraagde informatie vanuit Realworks.

Update

De update is momenteel voor iedereen beschikbaar, al werkt deze iets anders dan je wellicht van updates gewend bent. Dit heeft met name te maken met het gegeven dat niet iedereen deze update nodig heeft. Immers kunnen bestaande klanten hun XML nog blijven gebruiken.

Ben je voornemens om over te stappen op de API mogelijkheid, houd er dan rekening mee dat bepaalde thema-bestanden aangepast moeten worden. Dit heeft te maken met de structuur die Realworks aanhoudt voor het aanleveren van data en omdat in sommige gevallen datasets zijn samengevoegd.

Met name als wij de initiële inbouw voor je hebben verzorgd en/of als je wil dat wij de migratie voor je uitvoeren is het verstandig om eerst contact met ons op te nemen alvorens over te stappen op de API koppeling.

Om over te stappen kun je ons een mail sturen (via deze link). Vermeld daarbij altijd je klantnummer en licentiecode. We kunnen op basis daarvan versie 4 van de plugin beschikbaar stellen.

Nieuwe klanten ontvangen vanaf dit moment enkel nog Realworks WordPress (API) versie 4.0, aangezien versie 3 met XML ondersteuning niet meer toereikend is.

Changelog

Hieronder vind je de complete changelog van de update.

3.4.0 (15 september 2018)

  • - Overzicht van beschikbare add-ons vanuit het admin dashboard.
  • - Compatibiliteit met WPML plugin.
  • - Het opslaan van wijzingen in de admin is versnelt.
  • - Probleem opgelost waarbij het laden van het admin dashboard (te) lang duurde.

3.3.0 (10 oktober 2017)

  • - Nieuw: ondersteuning toegevoegd voor vertraagd verwijderen van objecten.
  • - Compatibiliteit met Realworks BOG v20.
  • - Diverse optimalisaties in het bijwerken van zoekopties.
  • - Illuminate 4.1 dependencies zijn gerepackaged onder een custom namespace, om conflicten met andere plugins/themas te voorkomen.
  • - Probleem opgelost wanneer verwerking van media op de achtergrond halverwege faalde en resterende media niet meer verwerkt werd.
  • - Probleem opgelost met zoeken waarbij deselecteren van de default checkboxes direct wordt teruggevallen op de defaults als er niets meer geselecteerd is.

3.2.2 (18 augustus 2016)

  • - Incompatibiliteit met WordPress 4.6.0 opgelost.
  • - Compatibiliteitsproblemen op Windows verholpen.
  • - Probleem verholpen met verwerken van afbeeldingen thumbnails.
  • - Problemen omtrent verschillen in tijdzones opgelost.

3.2.1 (29 maart 2016)

  • - Ondersteuning toegevoegd om woning permalinks op te splitsen in componenten.
  • - De provincie is beschikbaar in het veld *provincie*, alleen indien Google Maps is ingeschakeld.
  • - Opslaan van instellingen duurt minder lang.
  • - Probleem opgelost met tellen van array velden.

3.2.0 (5 januari 2016)

  • - Vernieuwde API voor handmatig zoeken naar woningen in het thema.
  • - Eenvoudig nabijgelegen woningen opvragen via `$woning->nearby('10km')`.
  • - Een geldige licentie is verplicht voor dagelijks bijwerken en verdere plugin updates.
  • - Ondersteuning voor PHP 7.0 toegevoegd.

3.1.1 (10 december 2015)

  • - Problemen met bijwerken worden voorkomen door altijd de nieuwste versie van de koppeling te gebruiken.

3.1.0 (9 december 2015)

  • - Ondersteuning toegevoegd voor Nieuwbouw en A&LV koppelingen.
  • - Ondersteuning voor infinite scrollen bij zoekresultaten toegevoegd.
  • - Eenvoudig meerdere pagina's aanmaken zodat zoekresultaten kunnen worden onderverdeeld.
  • - Ondersteuning voor het weergeven van array velden in een lijst, in plaats van alleen kommagescheiden.
  • - Uitgebreidere mogelijkheden om listings aan te passen per veld.
  • - Alle opties van een zoekveld zijn beschikbaar als JSON voor gebruik vanuit Javascript.
  • - Wijzigingen doorgevoerd waardoor het laden tot 2.5 keer sneller is, dit vereist wijzigingen in het thema.
  • - Menu toegevoegd in WordPress admin bar voor snellere toegang tot instellingen.
  • - Het veld *medialijst
  • - is beschikbaar met de exacte media informatie zoals beschikbaar in de XML.
  • - Iedere verdieping heeft naast het veld *badkamer
  • - nu ook lijst van alle badkamers in het veld *badkamers*.
  • - Foutmeldingen bij downloaden van data vanaf Realworks zijn weer beschikbaar.
  • - Bij het downloaden van woningen en afbeeldingen is de kans op timeouts verkleind.
  • - Verwijderen van woningen zal ook de WordPress media posts verwijderen, naast de media bestanden.
  • - Probleem opgelost met zoeken binnen straal wanneer voor geen van de woningen een locatie bekend is.
  • - Probleem opgelost waarbij overzichtspagina's geen objecten toonden in WordPress 4.4.
  • - Probleem opgelost waarbij de plugin niet geactiveerd kan worden met PHP ouder dan 5.3.9.
  • - Probleem opgelost waarbij items in collections beschikbaar blijven terwijl niet langer in bijwerkfeed.
  • - Probleem opgelost waarbij bepaalde `include_path` instellingen verhinderen de plugin te activeren.

3.0.1 (20 maart 2015)

  • - Bijwerkgeschiedenis overzicht is verbeterd, met inzicht in gewijzigde waardes.
  • - Mogelijkheid toegevoegd om een bijwerkmoment opnieuw uit te voeren.
  • - Uitgebreidere mogelijkheid tot het beïnvloeden van de zichtbaarheid van een woning.
  • - Probleem met verwijderen van niet langer beschikbare woningen opgelost.
  • - Veld *woning.aantal
  • - hernoemd naar *woning.aantalVerdiepingen*.

3.0.0 (1 maart 2015)

  • - Volledig nieuwe Realworks plugin.