Filter – Filtru
Filter este ( filtru ) este o funcție care poate fi conectată la un eveniment din WordPress (numite cârlige). În timpul execuției când evenimentul este declanșat, filtrul este aplicat la ieșirea datelor generate de cârligul evenimentului.
Este important să ne amintim că filtrele își efectuează acțiunile pe datele pe care le primesc și apoi returnează acele date înainte ca acestea să fie afișate în browser.
Filtrele trebuie să aibă întotdeauna date care intră și ies pentru a se asigura că datele sunt transmise în browser (conținutul dvs. poate fi transmis prin alte filtre înainte de a fi afișate în browser). Prin comparație, acțiunile, care sunt similare cu filtrele, nu necesită returnarea a nimic, deși datele pot fi returnate și prin acțiuni.
Exemplu: Să presupunem că dorim să afișăm o pictogramă de imagine atunci când este afișată o postare care aparține unei anumite categorii. În acest scenariu, creăm o funcție care verifică dacă o postare se află în acea categorie anume. Dacă este, afișează imaginea.
Apoi, conectăm această funcție la the_content eveniment. Acum, ori de câte ori are loc evenimentul the_content, funcționalitatea noastră este declanșată automat pentru a filtra rezultatul the_content eveniment.
// First we hook our own function with the_content event
add_filter( 'the_content', 'wpb_content_filter' );// Now we define what our function would do.
// In this example it displays an image if a post is in news category.
function wpb_content_filter( $content ) {
if ( in_category('news') )
$content = sprintf('<img class="news-icon" src="%s/images/news_icon.png" alt="News icon" title="" />%s', get_bloginfo( 'stylesheet_directory' ), $content);// Returns the content.
return $content;
}Practic, filtrele sunt funcții care pot fi utilizate în WordPress pentru a transmite date. Acestea permit dezvoltatorilor să modifice comportamentul implicit al unei funcții specifice.
Funcțiile utilizate pentru filtrarea datelor sunt numite hooks ( cârlige ). Filtrele și acțiunile împreună permit dezvoltatorilor o mare flexibilitate pentru a modifica evenimentele, filtrele și acțiunile implicite WordPress. Dezvoltatorii își pot crea propriile filter ( filtre ) și acțiuni personalizate, astfel încât alți dezvoltatori să își extindă pluginurile sau temele.
Filtrele sunt diferite de Acțiuni. Acțiunile WordPress sunt executate la evenimente cum ar fi când este activată o temă sau un plugin sau când este publicată o postare. Filtrele sunt folosite pentru a filtra ieșirea atunci când este trimisă fie în baza de date, fie în browserul unui utilizator.
Un alt exemplu de utilizare a unui Filter ( filtru ) WordPress:
function wpb_custom_excerpt( $output ) {
if ( has_excerpt() && ! is_attachment() ) {
$output .= wpb_continue_reading_link();
}
return $output;
}
add_filter( 'get_the_excerpt', 'wpb_custom_excerpt' );Exemplul de cod de mai sus adaugă o funcție wpb_custom_excerpt la filtrul get_the_excerpt.
API-ul pentru plugin WordPress are o listă extinsă de cârlige de filtrare disponibile în WordPress.
