「HA Force Update Plugin Language」は、設定画面からアップロードした翻訳ファイルをより確実にサイトへ適用させるためのプラグインで、以下のような翻訳の悩みを解決することができます。
- 独自の翻訳や購入した翻訳ファイルを適用させたいけど、転送方法や転送先が分からない
- 翻訳ファイルがいつの間にか上書きされ、翻訳内容が変わってしまう
- パソコン上で翻訳ファイルを管理するのが大変
プラグインの詳しい仕組み（プログラム）については、「HA Force Update Plugin Languageの仕組み」をご覧ください。
「HA Force Update Plugin Language」4.0をリリースしました
1.0では基本機能の実装、2.0では複数ファイルのアップロードを可能に、3.0ではセキュリティのアップデートと更新してきた「HA Force Update Plugin Language」ですが、新たにアップロード済ファイルのダウンロード機能を備えたバージョン4.0をにリリースしました。
これでもうこのプラグインに必要な機能はすべて実装を終え、あとは今後WordPressの仕様変更があった際に逐次対応していくのみの安定板となりました。
「HA Force Update Plugin Language」の動作要件
動作要件
現在、以下の環境で動作することを確認しています。
| PHPバージョン | 8.3.23 |
| WordPressバージョン | 6.9.1 |
使用しているコードに特別なものはありませんので、要件を満たさない場合でも動作はするかとは思いますが、確実に機能するかは不明です（WordPress6.6より古いバージョンでは有効化できないようにしています）
機能概要
常にオリジナルの翻訳ファイルを適用します
本プラグインの設定画面から、上書き対象となる翻訳ファイル（.mo .po .php .jsonに対応）をアップロードするとすぐに機能します。
本プラグインは画面の変化（管理画面の遷移、表示画面へのアクセスなど）時にアップロード済のファイルをWordPressのプラグイン翻訳ディレクトリへコピーします。
同名ファイルがWordPressの翻訳ディレクトリに存在する場合はアップロード済のファイルを強制的に上書きします
更新タイミングに関しては、あくまでもプログラム上ではという話であり、環境によっては100%確実に処理されない場合があります。開発・テストした限りでは、ある程度アクセスがあったり管理画面上で作業を行っているサイトであれば問題ないレベルかと思います
翻訳の自動更新を防止します
本プラグインの設定画面からアップロードした翻訳ファイル（.moファイル）から、プラグイン名を逆引きし、該当するプラグインの翻訳自動更新を無効にします。
この機能はバージョン2.0で追加しました
翻訳ファイル名によっては機能しないプラグインもあります。その場合には、管理画面の更新メニューで翻訳の更新を促す通知が表示されますが、無視していただければ大丈夫です（更新してしまっても本プラグインの上書き機能ですぐにオリジナルの翻訳が適用されますが、その後再び更新通知が復活してしまいます。これはWordPressの翻訳更新の仕様によるものでどうしようもありません）
使用上の注意点
このプラグインはWordPressのプラグイン翻訳ファイルを強制的に置き換えるもので使用方法を誤るとファイルが消失する可能性があるため、使用方法よりも先に注意事項を説明します。
使用前に必ず以下の注意事項を確認ください。
WordPress本体やテーマの翻訳には利用できません
本プラグインはWordPressのプラグイン翻訳ディレクトリ（「wp-content」→「languages」→「plugins」）にあるファイルに対してのみ上書き・削除を行う機能を提供しています。
従って、別ディレクトリから適用させるWordPress本体およびテーマの翻訳については、ファイル形式が共通のためアップロードすることはできますが適用されることはありません。
ファイルアップロード時の注意
前項で説明した通り、このプラグインは設定画面でファイルをアップロードした時点からすぐに機能し、あらゆる場面で翻訳ファイルがコピーされるような仕組みになっています。
そして同名ファイルが存在する場合には何かを警告することなく上書きするようになっています。
万が一の時に備え、WordPressプラグイン翻訳ディレクトリにある、本プラグインでアップロードするものと同名のファイルは予めバックアップを取るようにしてください。
本プラグインでファイルが上書きされ消失しても一切責任は負いません
ファイル削除時の注意
本プラグインにはアップロード済のファイルを選択して削除する機能を備えています。
この削除機能は、本プラグインのファイル保存場所にあるファイルとともに、WordPressのプラグイン翻訳ディレクトリにある同名のファイルを同時に削除します。
本プラグインの削除機能を使う際は万が一の時に備え、WordPressプラグイン翻訳ディレクトリにあるファイルのバックアップを取るようにしてください。
削除処理によりファイルが消失しても一切責任を負いません
プログラムコードや使用時のパフォーマンス等への影響について
セキュリティに配慮してプログラムを書いていますが、100%安全を保障するものではありません。
機能上、たくさんのファイルがある場合には、パフォーマンスの低下が起こる可能性があります。
「HA Force Update Plugin Language」のインストール方法・使用方法
インストールと有効化
以下のボタンをクリックすると、最新バージョンを入手いただけます。
プラグインをダウンロードして利用する前に、利用規約を確認ください（ダウンロードした時点で規約に同意したものとします）
累計ダウンロード数：6回
サイトの管理画面からプラグインメニューの「プラグインの新規追加」選択し、遷移した画面から「プラグインのアップロード」ボタンをクリック後、入手したファイルを選択してインストールし、有効化してください。
プラグインの使用方法
プラグインを有効化したら、管理画面の左メニューにある「HA Force Language」をクリックします。
以下が管理画面全体の画像です。
ファイルのアップロード
画面上の方にある「ファイルを選択」をクリックし、パソコン上の翻訳ファイルを選択後、「ファイルをアップロード」をクリックするだけです。
既に存在するファイルをアップロードするファイルで上書きする場合には「ファイルが存在する場合は上書きする」にチェックを入れます。
本プラグインはファイルのアップロード完了と同時に処理がスタートし、WordPressのプラグイン翻訳ディレクトリにあるファイルが上書きされます。念のため、ファイルアップロード前にバックアップを取ることをおすすめします
どのファイルがアップロード済なのかは画面中央にある白バックへ一覧表示されます。ファイルのアップロードが完了するとすぐに一覧へ反映されます。
ファイルの削除
削除したいファイルがある場合は、ファイル一覧の左にあるチェックボックスをONにした上で、「選択したファイルを削除」をクリックします。
ファイルの削除では、本プラグインのファイル保存フォルダ内のファイルとともに、WordPressプラグイン翻訳ディレクトリ内の同名ファイルも削除されます。削除前にバックアップを取ることをおすすめします
一度削除したファイルを元に戻すことはできませんのでご注意ください
ファイルのダウンロード（バックアップ）
本プラグインでアップロードした各種の翻訳ファイルを一括ダウンロードする機能です。
いざという時のバックアップとして、他のサイトで同一の翻訳ファイルを使用する際のファイルとしてお使いください。
解決できない既知の問題
翻訳ファイルの更新通知
ここまでで紹介した通り、このプラグインは、このプラグインの管理画面からアップロードしたファイルで、WordPressのプラグイン翻訳ディレクトリにあるファイルを定期的に上書きする機能を持たせています。
問題となるのが、既にwordpress.orgの翻訳システム上で有志の方が翻訳したファイルが存在する場合です。
WordPress本体およびテーマ・プラグインなどの翻訳ファイルは、それぞれの更新時と、管理画面の更新メニューをクリックした際にチェックが行われ、wordpress.orgの翻訳システム上に新しいファイルが存在する場合には以下のような通知を行って、翻訳の更新を手動で行うよう促されます。
これは、本プラグインを使って定期的に上書きされているファイルがwordpress.orgの翻訳システム上のファイルよりも古い場合（差分がある場合）にも反応します。
本プラグインの性質上、WordPressの翻訳の更新を行っても、次に画面が遷移するときには本プラグインで保存したファイルで上書きされるため、再度更新画面を表示した時にはこの通知が再び表示されてしまうという現象が発生します。
これを回避するためにいろいろと試行錯誤してみましたが、WordPressの翻訳更新に関して、特定のプラグインに対してのみ翻訳更新を停止するというアプローチができないようで改善が見込めないため、本プラグインを使用していて翻訳の更新通知が出続けるのが困るという方は、プラグインの使用をしないようにお願いします。
HA Force Update Plugin Languageの利用規約
－－ 基本事項 －－
この規約は現在のものです。本規約は予告なく変更することがあります。
本プラグインは、現在、ダウンロードおよびすべての機能を無料で使用いただけます。
本プラグインはすべての機能について、最新のWordPressバージョンやPHPバージョンで動作し続けることができるよう更新をし続けていく予定ですが、どうしても対応できない機能については廃止、改変等を行うことがあります。
また、本プラグインの制作者である私に万が一のことがあった場合、または、本プラグインに致命的な欠陥が見つかり、修正が困難となった場合などには、予告なく配布・更新の停止をすることがあります。
本プラグインは、本公開サイト上でのみ、開発・動作検証を行っており、すべてのテーマ・環境において動作を保証するものではありません。
本プラグインのインストール、有効化、使用時に起こった貴サイトでの不具合や不都合に関しては補償等一切いたしません。
また、予告なく機能の仕様の変更、廃止を行う場合があります。
本プラグインの全ファイルは、GPL（GNU General Public License）が適用されますので、コードの改変や部分的な使用等を制限することはありませんが、再配布や販売等をする場合には以下を遵守いただく必要があります。
- プラグイン名、作者、不具合発生時の連絡先等の情報は必ず自身のものへ変更すること
- コード中のユーザー定義関数名、変数名等は必ず自身のものへ変更すること
- 再配布・販売をしたプラグインについては、一切の責任を配布・販売者本人が負うこと
本プラグインは、私自身が管理を行うサイト向けに作成したプラグインを配布しているものです。したがって、機能のリクエスト、改善提案、不具合対応の連絡は原則受け付けておりません。
－－ プラグインの更新について －－
本プラグインの更新については、公式リポジトリのプラグインのように、自動で通知が行われません。
また、メール等を使用して更新等を通知することもしておりませんので、定期的に本ページをチェックいただき、最新バージョンへの更新をしてください。
HA Force Update Plugin Languageの仕組み
翻訳を強制適用させる仕組み
本プラグインでアップロードした翻訳ファイルは、WordPress本体やその他の機能で変更がされない独自の場所（uploadsフォルダ内に作成した専用フォルダ）に保存されます。
従って、そのフォルダを削除したり、本プラグインのファイル削除機能を使って削除しない限りは、そのファイルは保持されるため消失する可能性は低いため、パソコン上でバックアップを取っておくなどの作業が原則不要になります（転ばぬ先の杖でバックアップはおすすめしますが．．）。
そして本プラグインは、管理画面側の画面遷移をするたびに、WordPressのプラグイン翻訳ディレクトリ（/wp-contents/languages/plugins/）へ保存ファイルを上書きするように設計しています。
つまり、管理画面上でのあらゆる動作（ダッシュボードを表示する、投稿編集画面を開くなど）を行う度に、常に保存している翻訳が適用され、いつの間にか翻訳が変わってしまったというトラブルの発生を最小限にすることができます。
管理画面の操作時に限定しているのは、訪問者のアクセス時に動作することでパフォーマンスの低下やサーバーへ負荷をかけないための仕様です
翻訳が変更されないようにする仕組み
WordPressの翻訳ファイルの適用処理は、WordPress公式の翻訳サイトで変更や追加などがあった後、定期的にサイトでチェックされ、更新があれば自動的に適用（上書き）されます。
WordPressの翻訳の仕組みについてより詳しく．．
WordPressのプラグインは基本的に英語で表示するように作られており、その英語の文字列に対して翻訳ファイルを適用させることにより、日本語その他の言語でも使えるようになっています。
翻訳は、WordPress公式の翻訳サイトで、有志によって提案が行われ、権限を持つユーザーが承認を行うことで、翻訳文字列が完成していきます。
承認された翻訳文字列の割合が全翻訳対象文字列数の一定の割合を超えると、そのプラグインはその言語での使用が可能であると判断され、そのプラグイン用でその言語用の翻訳ファイルが作成され、WordPressサイト側が自動で適用を行っていきます。
これは新規に翻訳された場合に限らず、既に翻訳が適用されているものに対して修正や変更が行われた場合も同様に行われます。
常に最新の翻訳が行われてとても便利なのですが、仕組み上一度翻訳された文字列の再翻訳も可能なため、いつの間にか今までとは違う表現がされるようになったり、プラグインの更新によってある一定の翻訳割合を下回ると翻訳の一部や全部が適用されなくなったりすることがあります。
本プラグインは、前項のように常に自身で保存している翻訳ファイルを適用させる仕組みをとっているため、この問題は最小限に抑えられるものの、長期間管理画面側にアクセスしないような、いわゆる放置することの多いサイトではWordPressによる自動翻訳適用がされてしまう可能性があります。
そこで、本プラグインでは、翻訳ファイルのファイル名からプラグイン名を類推し、そのプラグインの翻訳の自動更新そのものを停止する機能を追加しています。
これにより、より確実に翻訳を適用し続けるようになります。
翻訳自動更新停止の機能は、WordPressの翻訳に関するプログラムの基準を満たしている場合のみ確実に機能するものであり、プラグインによっては更新の停止ができないものもあります
HA Force Update Plugin Languageの更新履歴
| 更新日 | バージョン | 更新内容 |
|---|---|---|
| 2024年11月 4日 | 1.0 | 初回リリース |
| 2024年12月 7日 | 2.0 | ・複数ファイルのアップロードに対応しました ・WordPress自動翻訳更新の抑制機能を追加しました |
| 2025年 3月 4日 | 2.1 | コードの軽微な修正を行いました |
| 2025年 9月10日 | 3.0 | WordPressのコード基準に準拠するようにコードの確認と修正を行いました |
