本プラグインは2022年4月29日以降、開発・更新を停止しております。代わりに同機能を持つ「HA Language Overwrite」をリリースしておりますので、そちらをご利用ください。
WordPressは、本体、テーマ、プラグインに対して、言語ファイル（.moファイル）を作成し、適切なファイル名、場所へアップロードすることで、自身の環境に合った文字列を表示できるようになっています。
翻訳ファイルは有志によってWordPress公式サイトで作成され、WordPress本体と同様定期的に更新されていきます（翻訳に参加してみたい方は公式サイトの翻訳ハンドブックを参照ください）。
また、前述したように独自の言語ファイル（.moファイル）を作成して、適切な場所へアップロードすることで、独自の表現ができるようになっています。
しかしながら、プラグインフォルダやテーマフォルダ内の翻訳ファイル用フォルダへアップロードした独自の翻訳ファイルは、プラグインやテーマの更新によって消失することがあり、また、WordPress本体内の翻訳ファイル用フォルダへアップロードした独自に翻訳ファイルについても、WordPressの更新と同時に上書きや消失をしてしまう可能性があります（恐らくこのページをご覧いただいている方は経験があることでしょう）。
今回紹介する【HA Force Translate Files】は、上記の「プラグインやテーマ内の翻訳ファイル用フォルダ」や「WordPress本体の翻訳ファイル用フォルダ」ではなく、独自の場所へ翻訳ファイルをアップロードし、アップロードした翻訳ファイルを最優先に適用するために作成した、ひまあーと独自のプラグインです。
このプラグインを使用することで、
- 独自の翻訳ファイルを適用してたはずなのに、いつの間にか違う文字列になってしまった
- 更新により、独自の翻訳ファイルが上書きされてしまい、再翻訳を余儀なくされた
といった不都合が解消されます。
また、WordPress本体やプラグイン等の更新による翻訳ファイルの更新がされても、本プラグインでアップロードした翻訳ファイルが最優先に適用されますので、他のプラグインなどを使って翻訳ファイルの更新を停止するという措置も必要なく、普通に運営しながら、独自の翻訳ファイルを維持・継続使用することができるようになります。
【HA Force Translate Files】はWordPress公式サイトで配布しているプラグインではなく、私ひまあーとが独自に作成したプラグインになります。自身の持ついくつかの環境・サイトにおいて動作確認をしたもです。お使いの環境によっては正常に動作しない可能性がありますので、了承の上お使いください。
【HA Force Translate Files】の動作要件
【HA Force Translate Files】が動作するための必要要件です。開発とテストを行った環境における推奨値ですので、満たしていなくても動作するかも知れません。
- WordPressバージョン：5.5以降
- PHPバージョン：7.0以上
【HA Force Translate Files】の入手方法
ここまででご紹介した通り、WordPress公式サイト上では配布しておりません。以下のボタンをクリックして【HA Force Translate Files】プラグインをダウンロードしてください。
本プラグインは2022年4月29日以降、開発・更新を停止しており、ダウンロードも停止しております。代わりに同機能を持つ「HA Language Overwrite」をリリースしておりますので、そちらをご利用ください。
【HA Force Translate Files】のインストール方法
プラグインファイルを入手されましたら、通常のプラグインと同様にインストールと有効化を行ってください。
プラグインのインストールと有効化手順
１．WordPressサイトの管理画面から、「プラグイン」→「新規追加」をクリックします
２．「プラグインのアップロード」をクリック後、「ファイルを選択」をクリックして、ダウンロード（保存）した【HA Force Translate Files】プラグインのファイルを選択します
３．「今すぐインストール」をクリックします
４．次に表示される画面で「有効化」をクリックします
５．管理画面左のメニュー内に「HA Force Translate Files」という項目が追加されれば有効化完了です。
翻訳ファイルのアップロード方法・メンテナンス方法
翻訳ファイルのアップロードは
- 圧縮された翻訳ファイルをメディアにアップロードし、そこから適用させる方法
- 翻訳ファイル（.moおよび.poファイル）を個別にアップロードする方法
の２つの方法があります。本プラグインは、当サイトでプラグインやテーマの翻訳ファイルをご購入いただいた方の利便性向上のために配布させていただくことに主眼を置いておりますので、前者の方法から説明します。
テーマの翻訳ファイルをアップロードする場合、ファイル名を「テキストドメイン-ja.mo」「テキストドメイン-ja.po」にする必要があります。WordPressの仕様上、テーマ本体にある翻訳ファイルは「ja.po」「ja.mo」とテキストドメインが含まれていませんのでご注意ください。
圧縮された翻訳ファイルをメディアにアップロードし、そこから適用させる方法
当サイトにて翻訳ファイルをご購入いただいた方はこちらの方法が便利です。
１．翻訳ファイル御購入後、ダウンロードした圧縮ファイル（ファイル名.zip）をサイトのメディアへアップロードします。
２．アップロード後、メディア一覧から「編集」をクリックします
３．メディア編集画面右側にある「URLをクリップボードにコピー」をクリックします。
WordPressのバージョンが古い場合には、「URLをクリップボードにコピー」ボタンが表示されないことがあります。その際は、「ファイルのURL」欄に書かれているURLをコピーしてください。
４．WordPress管理画面左のメニュー一覧にある「HA Force Translate Files」をクリックします
５．「ZIPファイルのURL」右側の空欄に、３のURLをペースト（「右クリック」→「貼り付け」など）します
６．「アップロード」をクリックします
７．画面上に「〇〇（ファイル名）はアップロードされました」と表示され、画面下の一覧にアップロードしたファイルが追加されていれば完了です。
７まで問題なく完了しましたら、１でメディアへアップロードしたファイルは削除いただいて構いませんが、万が一ファイルが消失したり、忘失したりしてしまったときのため、そのまま残しておくことをおすすめします。
すでに同名の翻訳ファイルが存在する場合には、エラーが表示されます。その際、今回アップロードするファイルで上書きしてもよい場合には、「ファイルを上書きする」にチェックを入れることでファイルが上書きされます（上書き前のファイルは復元できませんのでご注意ください）。
翻訳ファイル（.moおよび.poファイル）を個別にアップロードする方法
パソコン内に翻訳ファイル（.mo および .poファイル）が存在する場合のアップロード方法です
１．WordPress管理画面右のメニュー一覧にある「HA Force Translate Files」をクリックします
２．「アップロードするファイル」項目右側の「ファイルを選択」をクリックし、ファイルを選択してアップロードします
３．「HA Force Translate Files」画面内の「アップロード」ボタンをクリックします
４．画面上に「〇〇（ファイル名）はアップロードされました」と表示され、画面下の一覧にアップロードしたファイルが追加されていれば完了です。
実際に翻訳に使われるのは「.mo」ファイルのみですので、「.mo」ファイルのみをアップロードすれば翻訳されますが、再翻訳などを行う場合には「.po」ファイルがあった方がスムーズですので、忘失しないためにも「.po」ファイルもアップロードしておくことをおすすめします。
すでに同名の翻訳ファイルが存在する場合には、エラーが表示されます。その際、今回アップロードするファイルで上書きしてもよい場合には、「ファイルを上書きする」にチェックを入れることでファイルが上書きされます（上書き前のファイルは復元できませんのでご注意ください）。
メンテナンス（ファイルの削除）方法
「HA Force Translate Files」では不要になった翻訳ファイルを削除する機能を設けています。ファイルの削除は以下の手順で行います。
１．WordPress管理画面右のメニュー一覧にある「HA Force Translate Files」をクリックします
２．「HA Force Translate Files」の設定画面下部に、既にアップロード済のファイルが一覧表示されますので、削除対象となるファイルを選択します
３．画面下部の「削除」ボタンをクリックします
削除したファイルを復元することはできませんのでご注意ください
さいごに
このプラグインの設定画面からアップロードした翻訳ファイルは、以下の場所に格納されるようにしています。
「HA Force Translate Files」のプラグインフォルダ/optionlangs
個別にファイルをダウンロードする場合にはFTPクライアントツールなどを使って上記場所からダウンロードしてください。
また、このプラグインは、データベースへの情報追加等を一切行いませんので、FTPを使ってプラグインフォルダごとパソコンへ保存し、他のサイトへそのまま流用することができます。
このプラグインはPoMo UploaderというWordPress公式プラグインのソースコードを参考に、ファイルが上書きされないように改修し、翻訳を優先適用する機能を加えたものになります。
本記事の更新履歴
| 更新日 | 更新内容 |
|---|---|
| 2021年 1月28日 | 記事を公開しました |
| 2021年 1月29日 | プラグインの翻訳文字列（一部）を変更しました |
| 2021年 6月17日 | zipからのアップロード適用方法の画像を追加しました。 |
ポチップ
ポチップ
