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().'/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->parent_field; ?>
</div>

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

Attributen toevoegen/wijzigen

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

echo $zoekopdracht->field->placeholder('My awesome placeholder');
echo $zoekopdracht->field->title('My awesome title');
echo $zoekopdracht->field->aria_hidden('true');
echo $zoekopdracht->field->min(0)->step(10000)->value(200000);

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

Een methode die gebruik maakt van een _ (laag streepje) zal worden vertaald naar een - (koppelstreepje) waardoor bijvoorbeeld aria attributen mogelijk zijn.

Tonen van labels

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

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