WordPress
アクションとフィルタ

ワードプレスフック

WordPressで作業を開始するときに開発者を混乱させるものは、 apply_filters()とadd_action()です。コードでこれらのプラグイン/テーマを利用していることがよくありますが、そのコンセプトを理解していないと、それらを扱うのが難しくなります。

簡単に（非常に簡単に、プロセスの詳細なWordPressロードフローチャートを参照）、WordPressは次のようにロードされます。

1. wp-load.php - 関数など
2. mu-plugins - mu-pluginsフォルダにあるファイル - キャッシュされたオブジェクトを扱うためによく使用される
3. プラグイン - 特定の順序はなく、インストールされ、アクティブ化されたプラグインがロードされます
4. アクティブな子テーマ/親テーマ
5. init - 残りのデータ
6. テンプレート

開発者で機能ファイルを操作している場合、両方のファイルが処理中のファイルより前に読み込まれていることがわかります。つまり、後で実行される、またはまだ定義されていないプロセス（関数を上書きすることはできません）または変数を変更することはできません。また、テーマ開発者は、コードにフックを配置して、プラグインがフックするか、プラグインが他のプラグインが変数を上書きできるようにすることができます。今これはこれまでのところ混乱するかもしれませんが、そこにぶら下がっています。

add_filter()とadd_action()を理解するために、最初にフックがどのように作成されるかを調べる必要があります。

$arga= 'hello';
do_action('im_a_hook', $arga );

上記のWordPressに遭遇すると、フックim_a_hook接続されている関数が呼び出されます（プロセスの情報については$wp_filterを参照してください）。あなたの接続された関数で$argaは、接続された関数が利用できるようになります。

add_action('im_a_hook', 'attached_function');

function attached_function($arga){
     echo $arga;
}

これにより、ロードプロセスの特定の時点で変数を変更する強力な新しい機会が開かれます。以前テンプレートはプラグイン/テーマの後に読み込まれていたことを覚えていますか？ 1つの一般的なプラグインは、プロセスの後半に画面を作成するWooCommerceですが、 do_action例がプラグインでどのように見つかるかを文書化するつもりはありません。

do_action( 'woocommerce_after_add_to_cart_button' );

ここでは、変数を返さないフックを作成しましたが、それでも面白いことがあります：

add_action( 'woocommerce_after_add_to_cart_button', 'special_offer');

function special_offer(){
    echo '<h1>Special Offer!</h1>;
}

上記のadd_actionは、WooCommerce画面を作成するときのdo_action('woocommerce_after_add_to_cart_button')が配置されている特別提供の見出しをechoします。そこで、このフックを使ってhtmlを挿入することができます。他の用途には、別の画面にリダイレクトするなどがあります。

また、複数の変数を関数に渡すこともできます。あなたのテーマの機能でこれを試してください。利用可能な3つのパラメータを使用したいので、3に設定する最後のパラメータに注意してください。これを2に変更すると、2つしか返されず、未定義のエラーが発生します。

add_action('custom_hook', 'attached_function', 10, 3);

function attached_function($a,$b,$c){
    
    var_dump($a);
    var_dump($b);
    var_dump($c);
    
}
    

$arga = 1;
$argb = 2;
$argc = 3;

do_action('custom_hook', $arga, $argb, $argc);
exit;

フィルターと呼ばれる別のWPフックタイプがあります。フィルタはその使用法のアクションとは異なり、アクションは変数のみを受け取ることができます。明らかにこれらの変数はfunctionスコープ内にあります（google以外のPHPスコープは知っておく必要があります）。フィルタは返されたデータを返すので、変数の変更に使用できます。

$filter_me= apply_filters('im_a_filter', $variable_to_filter);

上記を見ると、返されるデータは変数に格納されている値になるので、 $filter_meの値を変更することができます。たとえば、この例では、 $variable_to_filterを$filter_meに変更してい$variable_to_filter 。

add_filter('im_a_filter', 'attached_function', 100);

function attached_function($filter_me){
    
    $filter_me= 'ray';
    
    return $filter_me;
    
}


$filter_me = 'bob';
$filter_me= apply_filters('im_a_filter', $filter_me);

$filter_me変数に'bob 'ではなく'ray'が含まれるようになりました.100の優先度を設定していますので、使用後に値を変更する人はいません（同じフックで複数のフィルタを実行できます）。 apply_filters()が存在する場合、 apply_filters()プロセスで使用される変数を変更できるようになりました。

複数のパラメータを渡すこともできますが、その値を変更することはできます。また、値を返す必要があります。そうでなければ、変数には何も含まれません。変数に値/配列/オブジェクトを代入するためにPHPを使う方法を理解しているなら、これはあなたには明らかです。

add_filter('im_a_filter', 'attached_function', 100, 3);

function attached_function($filter_me, $arga, $argb){
    
    $filter_me= 'ray'.$arga.$argb;

    $arga= 'you fool';
    
    return $filter_me;
    
}

$filter_me = 'bob';

$arga = ' middlename';
$argb = ' surname';

$filter_me= apply_filters('im_a_filter', $filter_me, $arga, $argb);

$filter_me変数に'ray middlename surname'が含まれるようになりました 。しかし、 $argaどうですか？これにはまだ'middlename'が含まれています。関数内で$argaを'あなたがだます 'に変更すると、範囲外の定義された値には何の効果もありません（方法、Googleグローバルなどがあります）

add_action（$ hook_name、$ function、$ priority、$ parameters）

add_filter（$フック名、$関数、$プライオリティ、$パラメータ）;