Spring naar de hoofdinhoud

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.custom_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;parent_field; ?>
</div>

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

 

 

ExtraAttributen attributen toevoegen aan veldentoevoegen/wijzigen

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

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

Dit werkt d.mv. magic methods, er is dus geen controle op valide HTML attributen.

 

Tonen van label labels

Je kunt het label van een veld tonen d.m.v. de label() method, ook is het mogelijk om je eigen label titel mee te geven.

echo $zoekopdracht->field->label();
echo $zoekopdracht->field->label('Custom title');

 

 

Terug naar boven