Wat is de Allround Web Pararius-koppeling?

Deze plugin verbindt je WordPress-website met Pararius. Je woningaanbod wordt daardoor automatisch bijgewerkt: nieuwe objecten verschijnen vanzelf en objecten die niet meer beschikbaar zijn, verdwijnen automatisch.

Belangrijkste functies

• Automatische synchronisatie van het woningaanbod (post type object).
• Foto’s worden automatisch meegenomen.
• Aanbod tonen met eenvoudige shortcodes (overzicht én losse onderdelen).
• Werkt met je eigen thema en is meertalig (Polylang/WPML).

Wat heb je nodig?

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

Stap voor stap

1. Log in op je WordPress-dashboard.
2. Ga naar Plugins › Nieuwe plugin › Plugin uploaden.
3. Kies het zip-bestand van de Allround Web Pararius-koppeling en klik op Nu installeren.
4. Klik op Plugin activeren.
5. In het menu verschijnt nu Pararius. Vul daar je sleutels in (zie volgende tab).

Licentiesleutel (van Allround Web)

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

Invullen bij Pararius › Instellingen (optie license) en activeren.

API-key (van Pararius)

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

Invullen bij Pararius › Instellingen (optie api_key) en opslaan.

Zonder geldige licentie én API-key wordt er geen aanbod opgehaald.

Hoe komt mijn aanbod op de site?

Zodra licentie en API-key zijn ingevuld, haalt de plugin je aanbod automatisch op de achtergrond op (via Action Scheduler). Je hoeft niets handmatig te doen.

• Nieuwe en gewijzigde objecten komen er vanzelf bij.
• Objecten die bij Pararius zijn verwijderd, worden ook op je site opgeruimd.
• De eerste synchronisatie kan enkele minuten duren.

Waar vind ik de instellingen?

Onder het menu-item Pararius in je dashboard. De belangrijkste opties:

• license – licentiesleutel
• api_key – Pararius API-key
• meta_fields – welke kenmerken worden opgeslagen/getoond
• hide_housenumber – huisnummer verbergen in het aanbod
• post_type_translatable – objecten vertaalbaar maken (Polylang/WPML)

Aanbod tonen met shortcodes

Plaats een shortcode in een pagina of bericht.

Overzicht van objecten

[ aw_pararius ]

Parameters van [ aw_pararius ]

• posts – aantal objecten (standaard 4).

  [ aw_pararius posts="9" ]

• cols – aantal kolommen in het grid (standaard 4).

  [ aw_pararius cols="3" ]

• cat – filter op een object-available-term (bijv. te-koop/verkocht).

  [ aw_pararius cat="verkocht" posts="6" ]

• status – filter op status. beschikbaarheid – aan/uit (standaard on).

Losse onderdelen van één object (op de detailpagina)

• [ aw_pararius_single ] – volledig object
• [ aw_pararius_single_gallery ] – fotogalerij
• [ aw_pararius_single_desc ] – omschrijving
• [ aw_pararius_single_kenmerk ] – kenmerken
• [ aw_pararius_single_price ] – prijs
• [ aw_pararius_single_map ] – kaart/locatie

Zo kun je een eigen detailpagina samenstellen uit losse blokken.

Veelgestelde vragen

Ik zie geen objecten op mijn site.

• Is de licentiesleutel geactiveerd?
• Is de API-key ingevuld?
• Wacht enkele minuten op de eerste synchronisatie.
• Staat de juiste shortcode op de pagina?

Hoe vaak wordt het aanbod bijgewerkt?
Automatisch op de achtergrond.

Een verkocht object staat er nog op.
De plugin ruimt verdwenen objecten automatisch op — even geduld.

Handige tips

• De synchronisatie gebruikt Action Scheduler. Krijgt je site weinig bezoek? Stel dan een echte cron-taak in.
• Maak regelmatig een back-up van je site.
• Stel met cols en posts het grid passend in voor je pagina-indeling.

De opmaak zelf bepalen

Plaats een bestand in je (child-)thema; bestaat jouw versie, dan gebruikt de plugin die.

Overzicht (grid)

themes/<jouw-thema>/templates/awpa_listing.php        // [ aw_pararius ]

Detailpagina (volledig)

themes/<jouw-thema>/single-object.php                  // volledige pagina
themes/<jouw-thema>/templates/single/awpa_single.php     // markup van het object

Losse onderdelen

themes/<jouw-thema>/templates/single/desc/awpa_descsingle.php
themes/<jouw-thema>/templates/single/gallery/awpa_gallerysingle.php
themes/<jouw-thema>/templates/single/kenmerk/awpa_kenmerksingle.php
themes/<jouw-thema>/templates/single/map/awpa_mapsingle.php
themes/<jouw-thema>/templates/single/price/awpa_price.php

Voor Polylang bestaan _polylang/_poly-varianten (bijv. awpa_single_polylang.php).

Kopieer als startpunt het meegeleverde bestand uit wp-content/plugins/aw-pararius-koppeling/public/… naar je thema.

Velden van een object

Elk object (post type object) heeft o.a. deze meta-velden:

Taxonomieën

• object-available – beschikbaarheid (filter met cat)
• object-status – status
• object-pand – type pand
• object-division – afdeling

Een veld aanroepen

$prijs = get_post_meta( $id, 'price', true );
$plaats = get_post_meta( $id, 'location', true );
$data  = get_post_meta( $id, 'p_data', true ); // overige kenmerken

Voor ontwikkelaars

pararius_get_posts_attr — de query van het grid

Volledige controle over welke objecten worden opgehaald.

add_filter( 'pararius_get_posts_attr', function( $args ) {
    $args['posts_per_page'] = 12;
    return $args;
} );

aw_pararius_koppeling_image_matches — afbeeldingen koppelen

add_filter( 'aw_pararius_koppeling_image_matches', function( $matches ) {
    return $matches;
} );

Daarnaast zijn er filters voor het backend-menu (allround_web_pararius_menu_items, aw_pararius_backend_menu_items_sorted).

Meertalig & vertalen

• De plugin werkt met Polylang én WPML: er zijn aparte template-varianten voor Polylang (_polylang/_poly).
• Zet objecten op vertaalbaar via de optie post_type_translatable (of awpa_post_type_translatable).
• De plugin-teksten zijn vertaalbaar via het tekstdomein van de plugin (taalbestanden in /languages/) — bijv. met Loco Translate.