WordPressのプラグインを作成する時に翻訳ファイルも作りたいけど毎回作り方を忘れてしまうので覚書。
前提
今回はプラグインのフォルダ内に「languages」フォルダを作り必要なpotやpoファイルを入れていくこととする。
ダウンロード
まだダウンロード、インストールしていない場合、先にダウンロードして設定しておく必要がある。
Poeditを開く
Poeditを開いた画面。隣には最近開いたファイルなども表示されるが今回は新規作成を行いたいため省略。
「ファイル」-「新規」をクリック。
翻訳言語を選択する。「日本語」を選択して「OK」をクリックする。
「ソースから抽出」をクリックすると「翻訳のプロパティ」-「ソースの検索パス」のウィンドウが表示された。が、
まずファイルを保存してください。保存するまでこのセクションは編集できません。
と表示されるので先にファイルを保存する。
ファイルの保存
「ファイル」-「保存」をクリック。
poファイル名の付け方
ファイル名はWordPressのプラグインの場合、{TextDomain}-{国}.poのような形で保存する。
プラグインが「my-plugin」だった場合、「my-plugin-ja.po」のようになる。
該当プラグインの保存場所にja.poファイルを作成した。
この状態で、もう一度「ソースから抽出」をクリックし、「翻訳のプロパティ」-「ソースの検索パス」の中に赤字で表示されていた保存を先にしろというメッセージが消え、プラグインのフォルダやファイルをドラッグすることができるようになっていればOK。
今回翻訳したいプラグインのフォルダまたはファイルをパスの箇所にドラッグする。
余談：moファイルのコンパイル
poファイル保存時にmoファイルをコンパイルするように設定をしておくと楽。
（私へ、moファイルが作れないなと思ったらデスクトップに言語フォルダを一旦おいて作成してください。コンパイルされます。私より）
ソース中のキーワードの設定
「ソース中のキーワード」タブをクリックし、追加キーワードの箇所の「＋」マークを押すとキーワードを増やしていくことができる。追加したキーワードを編集したい時は、該当キーワードを選択し鉛筆のマークをクリックすると編集できる。
追加できたら「OK」ボタンをクリックする。
翻訳が更新される
Poeditがドラッグしたファイルの中から、追加したキーワードをもとに探してくれる。
日本語訳を作成する
翻訳対象の一覧が表示される。
翻訳したい箇所を選択すると、選んだ原文（英語）が下に表示されるので、その原文に対する対訳（今回は日本語）を入力していく。
隣に対訳候補なども表示されるので、英語が弱いオタクは助かる。
翻訳中にエラーなどもでる
対訳をチェックして、たとえば句読点がないよ、みたいなエラーを出してきてくれたりします。
potファイルはどう作る？
Poeditのいまいちよくわからない箇所はファイル作成方法だったり保存方法だったりするんですよね。
すでにPOTファイルがあって、その日本語訳を作りたい！ということであればPOTファイルを参照に日本語を対訳としてja.poファイルを作成していくだけでいいんだけど…。
今回の場合のように新規作成した場合は、ja.poファイルを開いた状態で「ファイル」-「名前を付けて保存」を選んで、ファイルの種類はpoしか選べないんだけど、ファイル名を「.pot」にして保存することでなんとpotファイルとして保存することができるようだ。
potファイル名の付け方
ファイル名はWordPressのプラグインの場合、{TextDomain}.potのような形で保存する。
プラグインが「my-plugin」だった場合、「my-plugin.pot」のようになる。
よくありそうな質問
翻訳ファイルを置いたのに翻訳されない時に確認したい
作成したプラグインフォルダの中にlanguagesフォルダを作成し、.pot、.po、.moファイルをアップロードしても翻訳が反映されなかった。
それぞれのファイルの置き場所やファイル名などをチェックするなどいろいろ調べたが、結論としてはlanguagesフォルダの読み込み設定がうまくいっていなかった。
add_action('plugins_loaded', function () {
load_plugin_textdomain('TextDomain', false, dirname(plugin_basename(__FILE__)) . '/languages/');
});
TextDomainの箇所はプラグインのテキストドメイン名を入れること。
原文を検索したい
原文（英語）を検索できたらいいと思いませんか。私は思います。
「編集」-「検索」で表示される。
Ctrl+Fキーのショートカットもあるので覚えておくと楽かも。
