Documentatie

Wat is de Allround Web Realite-koppeling?

Deze plugin verbindt je WordPress-website met Realite. Je woningaanbod wordt daardoor automatisch bijgewerkt: nieuwe panden verschijnen vanzelf op je site en panden die niet meer beschikbaar zijn, verdwijnen automatisch. Je hoeft niets handmatig over te typen.

Belangrijkste functies

• Automatische synchronisatie van panden en hoofdpanden.
• Foto’s worden automatisch meegenomen.
• Aanbod tonen met eenvoudige shortcodes.
• Werkt met de opmaak van je eigen thema.

Wat heb je nodig?

• Een WordPress-website.
• Een licentiesleutel van Allround Web.
• Een API-key van Realite.

Stap voor stap installeren

1. Log in op je WordPress-dashboard.
2. Ga naar Plugins › Nieuwe plugin › Plugin uploaden.
3. Kies het zip-bestand van de Allround Web Realite-koppeling en klik op Nu installeren.
4. Klik op Plugin activeren.
5. In het menu links verschijnt nu Realite. Daar vul je je sleutels in (zie het tabblad “Licentie & API-key”).

Licentiesleutel (van Allround Web)

Wat is het? Je persoonlijke sleutel die bewijst dat je een geldige licentie hebt.
Waarvoor? Hiermee activeer je de plugin en ontvang je updates.
Hoe krijg je deze? Je ontvangt de sleutel van Allround Web.

Vul de sleutel in bij Realite › Instellingen en klik op Activeren.

API-key (van Realite)

Wat is het? De toegangssleutel tot jouw woningaanbod bij Realite.
Waarvoor? Hiermee haalt de plugin jouw panden op.
Hoe krijg je deze? Via je Realite-account of -beheerder.

Vul de API-key in bij Realite › Instellingen en sla op.

Let op: zonder een geactiveerde licentie én een ingevulde API-key wordt er geen aanbod opgehaald.

Hoe komt mijn aanbod op de site?

Zodra je licentie is geactiveerd en de API-key is ingevuld, haalt de plugin je aanbod automatisch op. Dit gebeurt op de achtergrond – je hoeft hier niets voor te doen.

• Het aanbod wordt elke ~15 minuten bijgewerkt.
• Nieuwe en gewijzigde panden komen er vanzelf bij.
• Panden die bij Realite zijn verwijderd, worden ook op je site opgeruimd.

De eerste keer kan het een paar minuten duren voordat alle panden en foto’s binnen zijn.

Waar vind ik de instellingen?

Alle instellingen staan onder het menu-item Realite in je WordPress-dashboard. Daar beheer je:

• de licentiesleutel (activeren / status bekijken);
• de API-key van Realite.

Meer hoef je niet in te stellen – het ophalen van het aanbod gaat daarna vanzelf.

Aanbod tonen met shortcodes

Met een shortcode plaats je het aanbod op elke pagina of bericht. Plak de shortcode in een tekst- of shortcode-blok.

Alle panden tonen

[ aw_realite ]

Alle hoofdpanden tonen

[ aw_realite_main ]

Eén pand of hoofdpand (op een detailpagina)

[ aw_realite_single ]\n[ aw_realite_main_single ]

Parameters

• posts – aantal panden dat je toont (standaard 12).
  

  [ aw_realite posts="6" ]

• status – filter op beschikbaarheid (meerdere mag, met komma’s).
  

  [ aw_realite status="Available" ]

• orderby & order – sorteren (bijv. title of date) en richting (ASC of DESC).
  

  [ aw_realite orderby="title" order="ASC" ]

Deze parameters werken ook op [ aw_realite_main ].

Veelgestelde vragen

Ik zie geen panden op mijn site.
Controleer het volgende:

• Is de licentiesleutel geactiveerd?
• Is de API-key ingevuld?
• Wacht een paar minuten – de eerste synchronisatie moet nog draaien.
• Staat de juiste shortcode op de pagina?

Hoe vaak wordt mijn aanbod bijgewerkt?
Automatisch, elke ~15 minuten.

Een verkocht pand staat er nog op.
De plugin ruimt verdwenen panden automatisch op (elk uur). Even geduld dus.

Handige tips

• De synchronisatie gebruikt Action Scheduler (achtergrondtaken). Krijgt je site weinig bezoek? Stel dan een echte cron-taak in, zodat het aanbod op tijd wordt bijgewerkt.
• Maak regelmatig een back-up van je website.

De opmaak zelf bepalen

Je kunt de HTML van het aanbod volledig overnemen door een bestand in je (child-)thema te plaatsen. Bestaat jouw versie? Dan gebruikt de plugin die; anders valt hij terug op de meegeleverde template.

Overzicht (grids)

themes/<jouw-thema>/templates/awrealite-listing.php        // panden-grid  [ aw_realite ]
themes/<jouw-thema>/templates/awrealite-main-listing.php   // hoofdpanden  [ aw_realite_main ]

Detailpagina (markup)

themes/<jouw-thema>/templates/single/awrealite-single.php        // detail van één pand
themes/<jouw-thema>/templates/single/awrealite-main-single.php   // detail van één hoofdpand

Volledige detailpagina (paginawrapper)

Wil je de héle pagina overnemen (buiten Elementor om)? Maak dan in de thema-root:

themes/<jouw-thema>/single-objects.php       // volledige pagina pand
themes/<jouw-thema>/single-mainobjects.php   // volledige pagina hoofdpand

Let op: gebruik je de Elementor Theme Builder voor de detailpagina, dan heeft die altijd voorrang. Kopieer als startpunt het meegeleverde bestand uit wp-content/plugins/awrealite-allround-web-realite-koppeling/public/templates/… naar je thema.

Welke variabelen heb ik in een template?

Panden-grid (awrealite-listing.php):

• $allposts – array met WP_Post-objecten
• $this->render_listing_card($post) – rendert één kaart
• $output – de string die je moet teruggeven

Pand-detail (single/awrealite-single.php):

• $id, $title, $city, $postalcode, $status
• $image_ids, $brochure_ids, $floorplan_ids – media-ID’s
• $features – alle velden als label => waarde
• $output – terug te geven string

Hoofdpand-detail (single/awrealite-main-single.php):

• $id, $title, $image_ids
• $children – WP_Query van de panden die bij dit hoofdpand horen

Een veld zelf aanroepen

$stad  = get_post_meta( $id, 'realite_address_city', true );
$prijs = get_post_meta( $id, 'realite_sale_buyprice', true );
$fotos = explode( ',', get_post_meta( $id, 'realite_aw_images', true ) );

Volledige lijst beschikbare velden

De feed wordt automatisch “platgeslagen” naar meta-sleutels realite_<veld>. De exacte set hangt af van wat de feed levert; dit zijn de standaardvelden:

Relaties

• Een pand verwijst naar zijn hoofdpand via meta _realite_mainobject.
• De beschikbaarheid staat ook als term in de taxonomie objects-status.

Voor ontwikkelaars

Met deze hooks pas je het gedrag aan zonder de plugin te wijzigen.

awrealite_listing_title — titel van een pand

add_filter( 'awrealite_listing_title', function( $title, $id ) {
    return $title . ' (te koop)';
}, 10, 2 );

awrealite_get_posts_attr — de query van de grids

Volledige controle over welke panden worden opgehaald (bijv. extra filters).

add_filter( 'awrealite_get_posts_attr', function( $args, $post_type, $atts ) {
    $args['posts_per_page'] = 24;
    return $args;
}, 10, 3 );

awrealite_single_features — kenmerken op de detailpagina

add_filter( 'awrealite_single_features', function( $features, $id ) {
    unset( $features['Updatedat'] );   // veld verbergen
    return $features;
}, 10, 2 );

awrealite_fetch_realite_data — handmatig synchroniseren

do_action( 'awrealite_fetch_realite_data' );

(Kan ook via de knop op de instellingenpagina.)

Meertalig & vertalen

• De plugin is volledig vertaalbaar via het tekstdomein awrealite-allround-web-realite-koppeling (taalbestanden in de map /languages/). Gebruik bijvoorbeeld Loco Translate of Poedit.
• Panden en hoofdpanden zijn gewone post-types. Meertalige plugins zoals WPML of Polylang behandelen ze als reguliere inhoud — zet de velden op “vertaalbaar” waar nodig.