Transmiterea unui parametru către funcțiile de filtru și acțiune

Folosește funcții anonime în PHP:

$my_param = 'numele temei mele';
add_filter('the_content', function ($content) use ($my_param) {
    //$my_param este acum disponibil pentru tine
    if (is_page()) {
        $content = $my_param . ':<br>' . $content;
    }
    return $content;
}, 10, 1);

Modul corect, foarte scurt și cel mai eficient de a transmite orice număr de argumente către filtrele și acțiunile din WordPress este cel propus de @Wesam Alalem aici, care utilizează o funcție anonimă (closure).

Aș adăuga doar că puteți face acest lucru și mai clar și mult mai flexibil separând logica principală de funcția anonimă. Pentru aceasta, pur și simplu apelați metoda din closure, după cum urmează (exemplu modificat din răspunsul lui @Wesam Alalem).

În acest fel, puteți scrie oricât de lungă sau complicată logica doriți, în afara closure-ului folosit pentru a apela funcția principală.

// ... în interiorul unei clase

private function myMethod() {
    $my_param = 'numele temei mele';
    add_filter('the_content', function ($content) use ($my_param) {
        // Acesta este closure-ul anonim care permite transmiterea 
        // oricărui număr de parametri prin cuvântul cheie 'use'.
        // Acesta este doar o singură linie de cod.
        // $my_param este disponibil acum prin 'use' de mai sus
        return $this->doThings($content, $my_param);
    }, 10, 2);
}

private function doThings($content, $my_param) {
    // Aici puteți apela alte metode pentru a face lucruri suplimentare
    // oricât de complicate doriți.
    $morethings = '';
    if ($content = 'alte lucruri') {
        $morethings = (new MoreClass())->get();
    }
    return $my_param . ':<br>' . $content . $morethings;
}

Crează o funcție cu argumentele necesare care returnează o funcție. Transmite această funcție (funcție anonimă, cunoscută și sub numele de closure) la hook-ul wp.

Exemplu prezentat pentru un mesaj de administrare (admin notice) în backend-ul WordPress.

public function admin_notice_func( $message = '')
{
$class = 'error';
    $output = sprintf('<div class="%s"><p>%s</p></div>',$class, $message);
    $func = function() use($output) { print $output; };
    return $func;
}
$func = admin_notice_func('Mesaj');
add_action('admin_notices', $func);

După cum s-a menționat în alte răspunsuri, transmiterea unui parametru către funcția de callback nu este posibilă în mod implicit. OOP și funcțiile anonime din PHP sunt soluții alternative, DAR:

1. Codul tău poate să nu fie OOP
2. Poate fi necesar să elimini acel filtru ulterior

Dacă acesta este cazul tău, există o altă soluție pe care o poți folosi: utilizează funcțiile add_filter și apply_filters pentru a face acel parametru disponibil în funcția de callback:

// Soluție alternativă pentru a "salva" parametrul care trebuie transmis funcției de callback.
add_filter( 'pass_param', function() use ( $param ){ return $param; } );

// Conectează funcția ta la filtrul pe care dorești să-l filtrezi.
add_filter( 'actual_filter', 'myCallback' );

// Funcția ta de callback care filtrează efectiv ceea ce dorești.
function myCallback()
{
   // Obține parametrul pe care nu am putut să-l transmitem direct acestei funcții.
   $param = apply_filters( 'pass_param', '' );

   // Folosește parametrul transmis indirect pentru a filtra.
   return $param;
}

Poți folosi întotdeauna variabilele globale..

  global $my_param;

În loc să apelezi o funcție direct, fă-o într-un mod mai elegant: folosește o funcție anonimă ca callback.

De exemplu:

Am o singură funcție pentru a traduce titlul, conținutul și rezumatul postărilor mele. Așadar, trebuie să transmit funcției principale câteva argumente care să indice cine o apelează.

add_filter( 'the_title', function( $text ) { 
    return translate_text( $text, 'title', 'pl' );
});

add_filter( 'the_content', function( $text ) { 
    return translate_text( $text, 'content', 'pl' );
});

add_filter( 'the_excerpt', function( $text ) { 
    return translate_text( $text, 'excerpt', 'pl' );
});

Astfel, funcția principală translate_text primește câți parametri doresc, tocmai pentru că am folosit o funcție anonimă ca callback.

Sunt de acord că răspunsul lui fuxia de mai sus oferă abordările preferate. Dar în timp ce încercam să înțeleg soluția OOP, am dat peste o modalitate de a o face care setează și apoi anulează atât filtrul, cât și o variabilă globală:

function my_function() {
    
    // Declară variabila globală și setează-o la o valoare
    global $my_global;
    $my_global = 'ceva';
        
    // Adaugă filtrul
    add_filter( 'some_filter', 'my_filter_function' );
    
    // Execută orice ai nevoie de filtrul respectiv
    echo $filtered_stuff; 
    
    // Elimină filtrul (pentru a nu afecta altceva care se execută mai târziu)
    remove_filter( 'some_filter', 'my_filter_function' );

    // Anulează variabila globală (deoarece nu ne plac variabilele globale rătăcitoare în cod)
    my_unset_function( 'my_global' );
    
}

function my_filter_function( $arg ) {
    
    // Declară variabila globală
    global $my_global;

    // Folosește $my_global pentru a face ceva cu $arg
    $arg = $arg . $my_global;

    return $arg;

}

function my_unset_function( $var_name ) {

    // Declară variabila globală
    $GLOBALS[$var_name];

    // Anulează variabila globală
    unset($GLOBALS[$var_name];

}

Sunt un dezvoltator fără pregătire formală și lucrez strict pe propriile site-uri, așa că vă rog să luați această schiță cu rezerve. Funcționează pentru mine, dar dacă este ceva greșit în ceea ce fac aici, aș fi recunoscător dacă cineva mai cunoscător ar indica problema.

În soluția mea OOP am folosit simplu o variabilă membru a clasei care este apelată în funcția de callback. În acest exemplu post_title este filtrat după un termen de căutare:

class MyClass
{
  protected $searchterm = '';

  protected function myFunction()
  {
    query = [
      'numberposts' => -1,
      'post_type' => 'my_custom_posttype',
      'post_status' => 'publish'
    ];

    $this->searchterm = 'xyz';
    add_filter('posts_where', [$this, 'searchtermPostsWhere']);
    $myPosts = get_posts($query);
    remove_filter('posts_where', [$this, 'searchtermPostsWhere']);
  }

  public function searchtermPostsWhere($where)
  {
    $where .= ' AND ' . $GLOBALS['wpdb']->posts . '.post_title LIKE \'%' . esc_sql(like_escape($this->searchterm)) . '%\'';
    return $where;
  }
}

dacă creezi propriul tău hook, iată un exemplu.

// să presupunem că avem trei parametri [ https://codex.wordpress.org/Function_Reference/add_filter ]
add_filter( 'filter_name', 'my_func', 10, 3 );
my_func( $first, $second, $third ) {
  // cod
}

apoi implementează hook-ul:

// [ https://codex.wordpress.org/Function_Reference/apply_filters ]
echo apply_filters( 'filter_name', $first, $second, $third );

Știu că a trecut ceva timp, dar am avut o problemă cu transmiterea propriului meu parametru până când am descoperit că al 4-lea parametru din add_filter reprezintă numărul de parametri transmiși inclusiv conținutul de modificat. Deci dacă transmiți 1 parametru suplimentar, numărul ar trebui să fie 2 și nu 1 în cazul tău

add_filter('the_content', 'my_content', 10, 2, $my_param)

și folosind

function my_content($content, $my_param) {...}

Am sperat să fac același lucru, dar din moment ce nu este posibil, cred că o soluție simplă ar fi să apelez o altă funcție, cum ar fi add_filter('the_content', 'my_content_filter', 10, 1);

Apoi, my_content_filter() poate pur și simplu să apeleze my_content() transmitându-i orice argument dorește.