WPMLは、テーマやプラグインで翻訳が必要なものを指示する設定ファイルを読み込むことができます。このファイルの名前はwpml-config.xmlで、プラグインまたはテーマのルートフォルダーに配置されます。
言語設定ファイルの目的
WPMLとの互換性を実現する一環として、今後のリリースでも互換性を維持するのに役立つ設定ファイルを作成する必要があります。WPMLはWordPressサイト上のあらゆるものを翻訳できますが、何を翻訳する必要があるかをWPMLに指示する必要があります。このファイルがその役割を果たします。
WPML→ 設定ページに移動します。
このページは、翻訳または同期するカスタムフィールド、多言語化するカスタム投稿やタクソノミー、さらには翻訳する管理テキストなど、WPMLが必要とするすべての情報を指示します。
言語設定ファイルにはこの情報が含まれているため、各ユーザーが管理画面で手動入力する必要はありません。
一部のテーマやプラグインについては、当社のサーバーで言語設定ファイルをホストしています。リストはこちらで確認できます。これは、テーマやプラグインのルートフォルダーに配置されたローカルの言語設定ファイルを上書きするように設定されています。
WPMLでは、テーマやプラグインの言語設定ファイルによって読み込まれた設定を手動で上書きすることもできます。これは、テーマやプラグインのルートフォルダー内にある言語設定ファイルと、当社のサーバーでホストされている言語設定ファイルの両方に適用されます。
サードパーティ製テーマとプラグインの翻訳オプションの設定
WPMLは多くの人気テーマやプラグインと互換性があり、それらについては言語設定ファイルを作成する必要はありません。
ただし、WPMLの高度な翻訳エディタでコンテンツが正しく表示されないテーマやプラグインを使用している場合は、翻訳オプションを手動で設定する必要があるかもしれません。
サードパーティ製テーマやプラグインの翻訳オプションを設定するには、WPML → 設定に移動し、カスタム XML 設定タブをクリックします。wpml-config.xmlファイルを作成する場合と同様に、このページのテキストエディタを使用してコードを入力します。
wpml-config.xmlファイルの自動生成
XMLファイルの作成に慣れていない方のために、当社のチームはこの作業を簡単にするMultilingual Toolsプラグインを作成しました。これは当初、テーマやプラグインの開発者が製品を多言語対応（Multilingual Ready）にするのを支援するツールとして考案されましたが、独自のwpml-config.xmlファイルを生成するためにも簡単に使用できます。
wpml-config.xmlファイルの生成について詳しくは、Multilingual Toolsプラグインのページをご覧ください。具体的には、How do I generate language configuration files using Multilingual Tools?のセクションをご覧ください。
設定ファイルを作成したら、テーマフォルダーのルートに追加します。すでにファイルがある場合は、上書きしないでください。代わりに、元のXMLファイルを編集し、Multilingual Toolsプラグインで生成されたコードを追加します。
このプラグインは、公開されている本番サイトでの使用を想定していないことにご注意ください。
このチュートリアルを読み、テーマやプラグインの言語設定ファイルを構築するには、このサンプルのwpml-config.zipから始めることができます。
編集が必要になりますが、このファイルのセクションと構造を使用できます。
構造と構文
WPMLでは、wpml-config.xmlファイルを使用して多数の要素を設定できます。特定のサイト要素を翻訳可能にする方法に関する追加情報と手順については、以下のガイドをご利用ください。
- WPMLを使用したカスタムショートコードの翻訳
- 翻訳するページビルダーコンテンツの登録
- 翻訳するカスタムページビルダーウィジェットの登録
- WPML設定ファイルを使用したカスタムフィールドの翻訳オプションの設定
- カスタムターム、Types、タクソノミーを翻訳可能として登録
- カスタムGutenbergブロックを翻訳可能にする
- テーマやプラグインがwp_optionsに保存するテキストの翻訳
- WPML設定ファイルを使用したWPML言語スイッチャーのカスタマイズ
- 翻訳用の数値の有効化
子テーマでのWPML言語設定ファイルの使用
子テーマを使用している場合、親テーマの言語設定ファイルが子テーマにあるファイルを上書きします。WPMLには、カスタム設定でこれを簡単に上書きできる設定ページが用意されています。
親テーマの言語設定ファイルで、カスタム投稿タイプ「Property」が翻訳可能に設定されている例を考えてみましょう。
子テーマを使用していて、カスタム投稿タイプ「Property」を翻訳不可に設定したい場合は、WPML → 設定ページに移動し、カスタム XML 設定タブをクリックします。エディタを使用して、カスタム投稿タイプ「Property」を翻訳不可に設定します。単に、translate属性の値を1ではなく0に設定するだけです。
