WordPressテーマおよびプラグインとのWPML互換性の設定 – 設定とカスタムwpml-config.xml

このページは、それ以外のもの、つまり、あまり人気のないテーマやプラグイン、WPMLの互換性が追いつく前に開発者がリリースしたごく最近のリリース、および特定の症状が発生したサイト向けの少数の汎用ヘルパーのために存在します。ほとんどのクライアントがここを開くことはありません。ここを開く場合、通常はWPMLサポートから特定のトグルや貼り付けるwpml-config.xmlを指示されたときです。

互換性については2つの設定サブページがあり、このページではその両方を説明します。設定 > 互換性には、一般的な症状に対するトグルが含まれています。設定 > カスタム XML 設定は、独自のwpml-config.xmlを記述する場所であり、このページの後半で説明します。最も一般的なデフォルト（投稿タイプ別、タクソノミー別、フィールド別の翻訳設定）のUIは、翻訳されるものとされないもので説明されている別の設定ページにあります。ほとんどのクライアントはそのUIを使用し、必要な設定がそこにない場合にのみこのページを開きます。

互換性トグル

WPML > 設定 > 互換性を開きます。このページには4つのカードがあります。各カードは、特定の種類の互換性の問題を対象としています。

ローカライズオプション – 翻訳が読み込まれないテーマとプラグイン向け

テーマやプラグインに独自のUI翻訳（/languages/フォルダー内の.moファイル）がすでに含まれているにもかかわらず、その翻訳がサイトに表示されない場合、ローカライズオプションカードにある3つのトグルが、WPMLによる翻訳の検索と適用に役立ちます。

• 「load_textdomainを使用してテーマの.moファイルを自動的にロードする」 WPMLにテーマのテキストドメインのload_textdomain()を強制的に呼び出させます。テーマの翻訳がディスク上にあるのに表示されない場合に使用します。
• 「テキストドメインを入力」 自動検出されたテキストドメインを上書きします。一部のテーマは非標準的な方法でテキストドメインを登録しますが、このフィールドを使用すると明示的に指定できます。
• 「gettextの呼び出しに文字列リテラルが使用されていない場合は、テーマまたはプラグインのテキストドメインを使用する」 リテラル文字列の代わりに可変引数を使用して__()を呼び出すテーマ/プラグイン用の互換性フラグです。WPMLはこれらを自動検出できませんが、このトグルを使用すると翻訳を適用できるようになります。

WPMLサポートからここを開くよう指示された場合は、どのトグルとどのテキストドメインを設定すべきか伝えられます。

テーマの多言語対応

「多言語機能のためにIDを調整する」 単一言語を前提としてハードコードされているテーマ（例：「アイキャッチ画像ID」を一度保存し、すべての言語で同じ画像を使用するテーマなど）向けの互換性レイヤーです。

最新のWPML互換テーマのほとんどはこれを必要としません。古いテーマやWPMLをあまり考慮していないテーマでは必要になる場合があります。コンテンツの参照（画像、メニュー、おすすめのアイテム）が言語間で誤って漏れているのを確認した場合は、これをオンにします。

AJAX操作の言語フィルタリング

「AJAXの言語フィルタリングをサポートするために言語Cookieを保存する」 一部のプラグインは、フィルタリングされた商品リスト、AJAXでページ分割された投稿リスト、入力中の検索結果などのコンテンツを取得するためにAJAXを使用します。言語Cookieがないと、AJAXエンドポイントはどの言語で応答すべきか分からず、間違った言語の結果を返します。

フランス語のページにいる訪問者が、AJAXで読み込まれたセクションから英語の結果を受け取るという症状が見られる場合は、Cookieをオンにします。これは、この種のバグ全体に対する1つのチェックボックスによる修正です。

ログインおよび登録ページ

「ログインおよび登録ページの翻訳を許可する」 WordPressに組み込まれている/wp-login.phpと登録画面は、WPMLが翻訳する通常のコンテンツの一部ではありません。これらはテーマのテンプレートチェーンの外部に存在します。このトグルにより、これらがWPMLの翻訳可能なページのセットに追加されます。

サイトがnginxで実行されている場合、このトグルにはサーバー設定の微調整も必要です。このページには、正確な設定ブロックが記載されたWPMLのnginxガイドへのリンクがあります。

テーマとプラグインのテキスト – ここでの設定と別の場所でのスキャナー

テーマ/プラグインの文字列に関する2種類の作業は、2つの画面に分かれています。

• このページの設定 テーマ/プラグインにすでに含まれている翻訳（load_textdomain、テキストドメインの上書き、非リテラルのgettext）の互換性を処理します。
• スキャナーは独自の画面です 翻訳用にまだ登録されていないテーマやプラグインの文字列を見つける必要がある場合は、管理テキスト翻訳画面を使用します。これは、翻訳の「お探しの文字列が見つかりませんか？」セクションにある文字列タブからアクセスできます。

文字列スキャンのワークフロー全体については、文字列の翻訳を参照してください。

カスタムwpml-config.xml

WPML互換のテーマとプラグインには、どのフィールド、投稿タイプ、タクソノミー、ショートコード、メタキーを翻訳可能にすべきかをWPMLに正確に伝えるwpml-config.xmlファイルが同梱されています。WPMLは有効化時にこれを読み取ります。主要で人気のあるすべてのテーマとプラグインにおいて、これは翻訳が追加の設定なしで正しく機能することを意味します。何もする必要はありません。

テーマやプラグインに同梱されているwpml-config.xmlがサイトにとって不十分な場合は、独自のものを記述します。WPMLは、テーマやプラグインに同梱されているものの上にそれを適用します。

独自のwpml-config.xmlを記述する場合

3つのシナリオがあります。

• 翻訳が必要なフィールドが、同梱のwpml-config.xmlにない場合 テーマやプラグインの開発者がカスタムフィールドを翻訳可能として宣言していませんが、サイトで翻訳する必要がある場合です。
• フィールドのデフォルトが間違っている場合 同梱のwpml-config.xmlが何かをコピーとしてマークしているが、翻訳にしたい場合、またはその逆の場合です。
• カスタムテーマまたはプラグインを構築している場合 コードにwpml-config.xmlファイルをバンドルする代わりに、WPMLの設定ページからその翻訳動作を宣言したい場合です。

どの場合でも、貼り付ける正確なwpml-config.xmlとともに、WPMLサポートからここを開くよう指示されることがあります。ほとんどの場合、これはサポート主導のアクションですが、開発者主導のアクションになることもあります。

テーマファイルではなくWPMLの管理画面でwpml-config.xmlを編集する理由

テーマやプラグイン自体のwpml-config.xmlを直接編集することもできます。しかし、その変更は次にテーマやプラグインが更新されたときに失われます。WPML > 設定 > カスタム XML 設定にあるWPMLの管理画面内エディタは、テーマやプラグインに同梱されているものの上にwpml-config.xmlを重ねるため、更新後も維持されます。これは、サイト固有の微調整を行うのに適した場所です。

wpml-config.xmlの構造

このページはXMLエディタです。<wpml-config>...</wpml-config>ブロックを貼り付けて保存すると、WPMLがwpml-config.xmlを適用します。

ショートコードを翻訳可能として宣言する最小限のwpml-config.xml：

<wpml-config>
  <shortcodes>
    <shortcode>
      <tag>add_to_cart_link</tag>
    </shortcode>
  </shortcodes>
</wpml-config>

通常宣言する要素タイプ：

• <custom-fields> カスタムフィールドをtranslate、copy、copy-once、またはnothingとしてマークします。
• <custom-types> カスタム投稿タイプを翻訳可能として宣言します。
• <taxonomies> カスタムタクソノミーを翻訳可能として宣言します。
• <shortcodes> WPMLがコンテンツを翻訳すべきショートコードをリストします。
• <custom-term-fields> タームメタデータ用です。

各要素には独自の属性（例：カスタムフィールドのaction="translate"）があります。完全なwpml-config.xmlリファレンス（すべての要素、すべての属性、すべての許可された値）については、WPML開発者情報を参照してください。

実践的なワークフロー

WPMLサポートから貼り付けるwpml-config.xmlブロックが提供された場合：

1. WPML > 設定 > カスタム XML 設定を開きます。
2. 提供されたXMLを既存の<wpml-config>ブロック内に貼り付けます（完全なブロックが提供された場合は内容を置き換えます）。
3. 保存します。
4. WPMLはwpml-config.xmlをすぐに適用します。新しい翻訳可能な投稿タイプやフィールドが宣言されている場合、そのエントリはすぐに設定 > 投稿タイプの翻訳 / カスタムフィールド翻訳に表示されます。

カスタムテーマまたはプラグインを構築しており、そのWPML設定をコードと一緒に同梱したい場合は、代わりにテーマまたはプラグインのルートにあるwpml-config.xmlファイルに同じ<wpml-config>ブロックを配置します。WPMLは有効化時にこれを読み取ります。管理画面内エディタはサイト固有の微調整用であり、バンドルされたファイルはテーマ/プラグイン自体のデフォルト用です。