Ontwikkeling

De Zoekopdrachten add-on komt geleverd met een "default" formulier, mocht dit formulier niet voldoen aan jouw wensen dan is het mogelijk eentje custom op maat te (laten) maken.

In de voorbeelden gebruiken we voorbeeld velden, je kunt alle beschikbare velden vinden onder de velden documentatie.

 

---

Template

Het standaard template van de add-on kun je vinden in onderstaand pad binnen de plugin en kun je eventueel gebruiken als voorbeeld.
/wp-content/plugins/tussendoor-zoekopdracht-addon/templates/public/form.php

Om bovenstaand pad te wijzigen en te verwijzen naar je eigen kan d.m.v. een filter.

add_filter('zoekopdracht_form_path', function($path) {
	return get_stylesheet_directory().'/form.php';
});

 

---

Conditionele weergave van velden

Het kan voorkomen dat er specifieke eisen zijn om velden op een bepaalde manier weer te geven, bijvoorbeeld omdat ze afhankelijk zijn van andere velden. Om te voorkomen dat deze logica overal door het thema opnieuw geschreven wordt biedt de plugin een manier om dit voor elkaar te krijgen.

Een veld uit onze plugin is een object en kan naast het terug geven van zijn waarde nog veel meer informatie terug geven. Zo kunnen de volgende methods worden gebruikt:

<div>
	<?= $zoekopdracht->woonwens->objectsoort; ?>
</div>

<div data-show-when="objectsoort:WOONHUIS_OF_APPARTEMENT,APPARTEMENT,WOONHUIS">
	<!--
		Dit veld komt pas tevoorschijn wanneer objectsoort
		"WOONHUIS_OF_APPARTEMENT", "APPARTEMENT" of "WOONHUIS" is
	-->
	<?= $zoekopdracht->woonwens->nieuwbouw; ?>
</div>

 

---

 

Extra attributen toevoegen aan velden

Het is mogelijk extra attributen zoals bijv placeholder, title, aria-* toe te voegen of overschrijven.

echo $zoekopdracht->veld->placeholder('Mijn awesome placeholder');
echo $zoekopdracht->veld->title('Mijn awesome title');
echo $zoekopdracht->veld->aria_hidden('true');

 

---

Tonen van label