A WordPress speciális visszahívó függvényei

Ha szoktunk kiegészítő PHP kódokat hozzáadni a functions.php fájlhoz, akkor valószínűleg találkoztunk már a __return_false, __return_true, __return_null és a többi __return-nel kezdődő paraméterrel. Mik ezek, mire jók, és hogyan kell használni őket?

Mik ezek?

A WordPress alapból definiál néhány egyszerű funkciót, amiknek önmagukban nincs sok értelmük: csak visszaadnak egy-egy alapértéket. Például:

$value = __return_true();
var_dump( $value ); // bool(true)

Mire jók?

Callback paraméterként használhatjuk őket, például a filter hookoknál.

Hogyan kell használni?

A filter hook-ok gyakran várnak ilyen alapértékeket a callback függvény eredményeként. Ha nincs szükségünk semmilyen logikára a callback-ben, akkor használhatjuk ezeket a függvényeket, gyors megoldásként. Például:

add_filter( 'pre_option_link_manager_enabled', 'link_manager_engedelyezese' );
function link_manager_engedelyezese() {
    return true;
}

// ^ A fenti helyett ez könnyebb:

add_filter( 'pre_option_link_manager_enabled', '__return_true' );

Milyen függvények léteznek?

  • __return_false — false Boolean értéket ad vissza.
  • __return_true — true Boolean értéket ad vissza.
  • __return_empty_array — Üres array értéket ad vissza.
  • __return_zero — 0-s értéket ad vissza, integerként.
  • __return_null — NULL értéket ad vissza.
  • __return_empty_string — Üres string értéket ad vissza: ''.

A Szerzőről
Piller Balázs senior webfejlesztő, SEO specialista, és a WordPress szakértője. Számos sikeres projektben vett részt vezető fejlesztőként. Az általa írt kód jelenleg több mint 1 000 000 webhelyen fut.

Vélemény, hozzászólás?

Az e-mail-címet nem tesszük közzé. A kötelező mezőket * karakterrel jelöltük