WordPress.org

Ready to get started?Download WordPress

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

it:Riferimento funzioni/apply filters

Contents

Descrizione

Richiama le funzioni aggiunte all'aggancio di un filtro. Si veda Plugin API per una lista di agganci.

Le funzioni di callback connesse all'aggancio del filtro $tag sono invocate chiamando questa funzione che può essere usata per creare un nuovo aggancio di filtro specificando il nome del nuovo aggancio attraverso il parametro $tag.

Utilizzo

 <?php apply_filters$tag$value$var ... ); ?> 

Parametri

$tag
(string) (richiesto) Il nome dell'aggancio del filtro.
Default: Nessuno
$value
(mixed) (richiesto) Il valore che i filtri agganciati a $tag possono modificare.
Default: Nessuno
$var
(mixed) (opzionale) Una o più variabili aggiuntive passate alle funzioni del filtro. Questo parametro è disponibile dalla versione 1.5.1.
Default: Nessuno

Valori restituiti

(mixed) 
Il risultato di $value dopo che tutte le funzioni agganciate sono state applicate.

Nota: Il tipo restituito dovrebbe essere lo stesso di $value: una stringa o un array, ad esempio.

Esempio

Stampare dopo aver filtrato

echo apply_filters( $tag, $value );

Filtrare

$myvar = apply_filters( $tag, $value );

Argomenti aggiuntivi nel filtro

$myvar = apply_filters( $tag, $value, $param, $otherparam );

Con il filtro the_title

$my_custom_title = apply_filters('the_title', '  Il mio titolo personalizzato (tm)  ');

$my_custom_title contiene ora 'Il mio titolo personalizzato ™', poiché il filtro the_title applica wptexturize() e trim(), tra gli altri.

Note

Log delle modifiche

  • Da: 0.71

File sorgente

apply_filters() si trova in wp-includes/plugin.php.

Correlati

Filters: has_filter(), add_filter(), apply_filters(), current_filter(), merge_filters(), remove_filter(), remove_all_filters()

Si veda anche l'indice di Riferimento funzioni e l'indice di Tag dei template.