Converzo Makelaar

By Converzo

★ 5.0/5 (1 ratings)0+ active installationsVersion 0.2.2

Property listings for Dutch estate agents, synced from the agency software (Realworks, Kolibri/Tiara or Yes-co).

Description

Converzo Makelaar puts an estate agent’s listings on their WordPress site. It pulls the properties from the agency software, keeps them up to date on a schedule, and shows them in an overview with filters, a detail page per property, and blocks to place listings on any page.

The plugin is aimed at Dutch estate agents (“makelaars”). The admin screens and the front end are in Dutch; the plugin is translation-ready.

What you get

  • Properties (“Huizen”) as their own post type, with town and property type as taxonomies, so every town gets its own archive page such as /plaats/amsterdam/.
  • An overview with filters on sale or rent, town, price, living area and number of rooms, plus sorting.
  • A detail page with a photo strip, key features, floor plans, brochures and open house dates.
  • Two blocks (Property overview and Property filters), and the same as shortcodes.
  • Templates your theme can override completely.
  • Photos served straight from the agency software, or optionally stored in the media library.
  • Safe syncing: a failed or empty sync never removes properties.
  • Per-property lock, so manual edits survive the next sync.

Premium

Converzo Makelaar Premium adds three extensions:

  • Neighbourhoods — looks up the municipality, district and neighbourhood of every property from the Dutch government’s open address service and offers them as a filter.
  • Multilingual listings — uses the English description from the agency software on English-language sites, and makes labels that come from the coupling translatable with WPML or Polylang.
  • Purchase portfolio — shows the properties the agency bought on behalf of clients on a separate “bought by us” overview.

The free version is fully functional on its own; nothing in it is locked.

External services

The plugin connects to one of the following services: the one you choose as data source, and only once you configure it.

Realworks (api.realworks.nl). The plugin fetches the agency’s listings with the API token you enter in the settings. Nothing is sent except that token and, if you set one, your branch code. Without a token the plugin makes no requests. See the Realworks terms of delivery and privacy statement.

Property photos are loaded from the URLs Realworks provides, so visitors’ browsers request those images from Realworks unless you enable storing photos locally.

Kolibri (sitelink.kolibri24.com, formerly Tiara). The plugin downloads the agency’s listings through Kolibri SiteLink with the SiteLink token you enter in the settings; that token is the only thing sent. Photos, floor plans and brochures are downloaded from the URLs in that feed to your own media library, because Kolibri does not allow showing them from its servers. See the Kolibri terms and privacy policy.

Yes-co (webservice.yes-co.com). The plugin fetches the agency’s listings from the Yes-co 3MCP feed with the collection ID, user name and password you enter in the settings; nothing else is sent. Photos and floor plans are downloaded with the same login to your own media library, so visitors’ browsers never contact Yes-co. See the Yes-co terms and conditions, which also cover how Yes-co handles data.

No data about your site’s visitors is ever sent anywhere by the plugin.

Installation

  1. Upload the plugin to /wp-content/plugins/converzo-makelaar/, or install it through the WordPress plugin screens.
  2. Activate the plugin.
  3. Go to Huizen › Instellingen, choose your agency software as data source and enter its credentials.
  4. Click Verbinding testen (test connection), then Nu synchroniseren (sync now).

The listings then appear at /huizen/. You can change that URL in the settings.

FAQ

Where do I find the Realworks API token?

In Realworks under Settings › Couplings. Realworks gives the token in the form rwauth <token>; you can paste it with or without that prefix.

Where do I find the Kolibri token?

The agency requests a SiteLink token from within Kolibri and receives it by e-mail. Paste the token (or the whole SiteLink URL) in the settings. Kolibri allows 10 downloads a day (24 with Kolibri PRO); the plugin stays below that limit by itself, and “Verbinding testen” counts as one download.

What do I need for Yes-co?

The collection ID (UUID) of the system link in Yes-co, plus the user name and password that belong to it. Yes-co provides these to the agency or its web developer.

Do I need to enter a branch code?

Only if your token gives access to several branches and you want to show one (or some) of them. Separate multiple codes with a comma. Leave the field empty to show everything that belongs to the token.

What happens to sold properties?

You decide. By default they stay in the overview with a “Verkocht” (sold) ribbon for as long as the agency software provides them. For an archive of sold properties, also enable fetching inactive objects in the coupling settings.

Can I change the design?

Yes. All colours and sizes are CSS custom properties on .cvzw, so a few lines in your theme are enough. For full control, copy a file from the plugin’s templates/ folder to converzo-makelaar/ in your theme; your copy always wins.

Are photos stored on my server?

With Realworks not by default: they are loaded from the agency software directly. That keeps the media library empty and leaves nothing behind when a property is sold. To store them locally, enable “Foto’s lokaal opslaan”; downloading then happens in the background, one property at a time.

With Kolibri and Yes-co photos are always stored locally: Kolibri does not allow showing them from its servers, and Yes-co keeps them behind a login. A new property therefore gets its photos a few minutes after the sync.

Does this work with agency software other than Realworks?

Realworks, Kolibri (formerly Tiara) and Yes-co are included. Other packages can be added: a data source is a separate class with its own field mapping.

Changelog

0.2.2

  • Fixed: the upgrade button led back to the settings screen instead of the hosted checkout.

0.2.1

  • Upgrading now opens the hosted checkout directly, in Dutch for Dutch-language sites, so iDEAL is available. The English pricing page inside wp-admin is skipped.

0.2.0

  • New data sources: Kolibri (formerly Tiara, through SiteLink) and Yes-co (3MCP feed).
  • For these sources photos, floor plans and documents are always stored in the media library.

0.1.1

  • Translations are now loaded by WordPress itself; the plugin no longer calls load_plugin_textdomain().

0.1.0

  • First release: Realworks coupling, property post type, overview with filters, detail page, blocks and shortcodes.