Wordpress 子テーマのプラグイン内の翻訳関数をフックに利用する方法

Question

以下の質問の続きです。
Wordpress　プラグイン　カスタマイズについて
＜回答＞
フック（ add_action() add_filter() ）による変更が基本になります。
フックが無い場合は、場合によって対応が変わります。（プラグインの目的にもよります）

プラグイン内部で使用されている関数の内部にあるフックを使う
例えば、多言語化されたプラグインの場合、文字を出力する箇所で
__() _e() などの翻訳関数を使っていることがあるため、その関数自体のフックを利用する。

---------------------------------------------------------------以上引用終わり----

回答の中で、『 __() _e() など翻訳関数自体をフックに利用』とありますが、
書き方がわかりません。

(例)プラグイン　events-manager

//翻訳関数
<label for='booking_comment'><?php _e('Comment', 'events-manager') ?></label>

//翻訳関数へのフック
function add_before_after( $data ){
    $data = "ここから". $data . "ここまで";
    return $data;
}
add_filter('Comment', 'add_before_after', 11);

上記の翻訳関数によるラベルにフィルターフックを掛けることは可能ですか？
例えば、ラベル名'booking_comment'の前後に文字を付け加えるfilterフック。
上記サンプルコードの修正点を教えてください。

又、通常フック[do_action() apply_filters()]と翻訳関数自体のフックでは
処理速度やシステムの安定性に差が出ますか？

もしくは通常フック以外は、出来るだけ避けた方が良いですか？

どうぞよろしくお願い致します。

Answer 1

まず、_eの'Comment'はフィルター名ではありません。
_eとは何をしているのかを確認すると

function _e( $text, $domain = 'default' ) {
 echo translate( $text, $domain );
}

となっており、translate関数を出力しているだけですね。
ではtranslate関数はどうなているかを確認すると

function translate( $text, $domain = 'default' ) {
    $translations = get_translations_for_domain( $domain );
    $translation  = $translations->translate( $text );
    $translation = apply_filters( 'gettext', $translation, $text, $domain );
    $translation = apply_filters( "gettext_{$domain}", $translation, $text, $domain ); 
    return $translation;
}

となっています。
＊参考
https://developer.wordpress.org/reference/functions/translate/

ここで翻訳した結果を返しているわけですが、その前にapply_filtersが二つあります。
このフィルターを使うといいでしょう。
試していませんが

add_filter('gettext_events-manager', 'add_before_after', 11,3);
function add_before_after($translation, $text, $domain ){
 if($text = 'Comment'){
  $translation = "ここから". $translation . "ここまで";
 }
return $translation;
}

でいけるのではないでしょうか？

Comments

[kei344]

gettext_with_contextとかを通る可能性もあるので、場合によってはそのあたりも対応する必要があるとは思います。

【WordPressで翻訳ファイルを修正せずにテキストを変更する方法 – Simple Colors】
https://www.warna.info/archives/1581/

[jo-ji]

＞＞でいけるのではないでしょうか？
いけました。回答ありがとうございます。「翻訳関数にフックする」意味が分かりました。

ただ、プラグイン内のすべての_e()翻訳関数? ラベル？'Comment'?やダッシュボードに、
フィルターが作用しています。
フックポイントを限定する対策はありますか(ファイル名を追加するなど)？
対策が見つかりませんでした。対策があれば教えてください。

引数について教えてください。
関数の引数($translation, $text, $domain)は、どうして3つなのですか？
＄domainは、フィルター名[gettext_events-manager]で指定するから、不要では？
又、引数名は自由に選んでよいですか？　(例)$label,$comment,$pluginなど
引数名の記載順番は、自由にしても良いですか？(例) $text, $domain,$translation
引数の意味が良くわかりませんでした。

[gogoweb_ikeda]

>ただ、プラグイン内のすべての_e()翻訳関数? ラベル？'Comment'?やダッシュボードに、
>フィルターが作用しています。
>フックポイントを限定する対策はありますか(ファイル名を追加するなど)？
>対策が見つかりませんでした。対策があれば教えてください。
特定のページや投稿時のみに限定するならis_pageやis_singleで判定するといいでしょう。
管理画面以外にするなら!is_adminがいいかもしれません。

＊引数について
引数が３つなのは元のapply_filtersで３つの引数を渡しているからです。
使わない引数でも元のapply_filtersの引数の数だけ指定したほうが無難化と思います。

add_before_afterで使用している引数の名前は自由に変更できますが、順番はapply_filtersで指定された順番になります。
$foo = apply_filters("hoge",$arg1,$arg2,$arg3);
add_filter("hoge","hogeFunc",10,3);
function hogeFunc($a,$b,$c){

}
だった場合は$arg1の内容が$aに、$arg2の内容が$bに、$arg3の内容が$cにはいることになります。
同じ変数名にしておいた方が混乱が少ないと思われます。

>kei344さん。
今回は_e()のみの表示でしたが他の翻訳関数も考慮にいれるならそちらの修正もしたほうがよさそうですね。

[jo-ji]

>gogoweb_ikedaさん

親切かつ丁寧な説明、ありがとうございました。　m(_ _)m
今までの疑問が解けてスッキリしました。　深く感謝いたします。

Answer 2

【WordPress 翻訳 フック - Google 検索】
https://www.google.com/search?safe=off&q=WordPress+%E7%BF%BB%E8%A8%B3+%E3%83%95%E3%83%83%E3%82%AF

Comments

[jo-ji]

kei344さん。あなたの約5年前の回答が、テラテイルで一番参考になっています。
今回も含め、回答ありがとうございました。