自分で作った関数の引数が持つそれぞれの意味とは？

Question

前提・実現したいこと

このコードがなぜタイトルに　「　」　がつくのか教えてください。
これはthe_title();で出力した際に「the_title();」になるというフックのようです。
しかしこのfunctionはテンプレートタグでもなく独自で作ったものですし、$titleもグローバル変数ではないはずです。
なぜどんな意味を持つかも指定されていないはずの第一引数($title)を挟むことによって、「the_title();」が実現されるのでしょうか、教えてください。

発生している問題・エラーメッセージ

エラーメッセージ

該当のソースコード

ソースコード
function test_function( $title, $id = null){
  return '「'.$title.'」';
}
add_filter( 'the_title', 'test_function',10,2 );

試したこと

ここに問題に対して試したことを記載してください。

補足情報（FW/ツールのバージョンなど）

ここにより詳細な情報を記載してください。

Comments

[退会済みユーザー]

フィルターフックについては調べましたか？

Answer 1

onodaさんの回答と重複しますがWordPressのソースコードは読まれまたでしょうか？
一部抜粋すると、以下のようにapply_filters関数でthe_titleに紐づくフック関数をコールしています。
その際の1つめの引数がtitle、2つめの引数がidになるように設定しています。
ご自身が作成されたtest_function関数の戻り値がapply_filtersの戻り値になります。

wp-includes\post-template.php

function get_the_title( $post = 0 ) {
    $post = get_post( $post );
    $title = isset( $post->post_title ) ? $post->post_title : '';
    $id = isset( $post->ID ) ? $post->ID : 0;
    
    (省略)
    
    /**
     * Filters the post title.
     *
     * @since 0.71
     *
     * @param string $title The post title.
     * @param int    $id    The post ID.
     */
    return apply_filters( 'the_title', $title, $id );
}

Comments

[makii]

ありがとうございました！フックも奥が深いのですね

Answer 2

提示のコードはthe_titleフィルターフックにtest_function関数をフックしている、つまり、the_title関数を実行するとthe_title関数で出力される文字列がtest_function関数で処理されてから出力されるようになるということです。

the_titleフィルターの実体はwp-includes\post-template.phpのget_the_title関数内にあります。

「WordPress　フィルターフック」とかのキーワードで調べるとたくさんのページで解説されていますので、参考にしてみてください。

追記(以下二件のコメントを受けて)

回答ありがとうございます。フックの効果とはthe_titleが読まれた時に関数を実行するだけですよね？例えばthe_titleの後ろに！をつけたいなら、関数内は$title . '!' );になりますよね、、しかしなぜそれが変数で書かれているのか、しかも第一引数で指定したものなのかがわかりません。function test_function{ return linkbefore,linkafterとかでいいのではないのですか？なぜワードプレスは$titleをグローバル変数でもないのに、the_title();で出力されたタイトルの代わりと判断できるのですか？？

例えば、このフィルターフックの効果に、実行する関数の第一引数をタイトルと見なし、タイトルに付け加えたい記述は、’文字列’ . 第一引数で適当に決めたもの　. '文字列’で書きなさいと決められているならわかりますが、、

テンプレートタグでもないのに（独自の関数）、第一引数をタイトルがあるべきところとみなす、なんてワードプレスはわかるのですか？
’文字列’ . 第２引数で適当に決めたもの　. '文字列’　や、　’文字列’ . 引数に書いておらず、さらに変数でもないもの　. '文字列’　でもちゃんと文字列は付け加えられるのでしょうか。

• フィルターフックした関数にはapply_filterで指定された変数が順番に引数として渡される
• フィルターフックした関数に渡される第一引数はフィルターする値である
• フィルターフックした関数はフィルターした値（加工した値）を戻り値とする

と、WordPressの仕組みでで決まっているという点を理解してください。

フックした関数側では別に引数の名前はなんでもよいです。たとえば以下でも構いません。

function test_function( $aiueo, $id = null){
  return '「'.$aiueo.'」';
}
add_filter( 'the_title', 'test_function',10,2 );

もし、この構造に不自然さを感じるようであれば、ご自分でPHPコードを書いて、WordPressのフィルターフックの仕組みを変更すればよいと思います。

Comments

[makii]

回答ありがとうございます。フックの効果とはthe_titleが読まれた時に関数を実行するだけですよね？例えばthe_titleの後ろに！をつけたいなら、関数内は$title . '!' );になりますよね、、しかしなぜそれが変数で書かれているのか、しかも第一引数で指定したものなのかがわかりません。function test_function{ return linkbefore,linkafterとかでいいのではないのですか？なぜワードプレスは$titleをグローバル変数でもないのに、the_title();で出力されたタイトルの代わりと判断できるのですか？？

[makii]

例えば、このフィルターフックの効果に、実行する関数の第一引数をタイトルと見なし、タイトルに付け加えたい記述は、’文字列’ . 第一引数で適当に決めたもの　. '文字列’で書きなさいと決められているならわかりますが、、
テンプレートタグでもないのに（独自の関数）、第一引数をタイトルがあるべきところとみなす、なんてワードプレスはわかるのですか？
’文字列’ . 第２引数で適当に決めたもの　. '文字列’　や、　’文字列’ . 引数に書いておらず、さらに変数でもないもの　. '文字列’　でもちゃんと文字列は付け加えられるのでしょうか。

[makii]

ありがとうございます！そう決まってないとおかしいですよね、、フックの裏側のファイルの動作をのぞいてみる契機になりそうです！