WPML

WPML Troubleshootingツール

WPMLサポートページには、WPMLサイト用のすべてのトラブルシューティングツールが、実行時の危険度に応じて3つの階層に分類されてリストされています。

ツールの3つの階層

自身で実行しても安全
WPMLサポートの関与なしで実行できるセルフサービスツール。
ログ – 読み取り専用
WPMLの動作を確認できる読み取り専用のビューです。断続的な問題の診断に役立ち、状況を悪化させることはありません。ログを参照してください。
高度なツール – WPMLサポートから指示された場合のみ
破壊的または元に戻すのが困難なツールです。自身では実行しないでください。高度なツールを参照してください。

このページでは「自身で実行しても安全」の階層について説明します。

修復ツールは別のプラグインです

WPML 5.0以降、修復ツールはWPML Troubleshootingプラグインによって提供されます。WPMLActivate & Update（またはwpml.orgのダウンロードページ）からインストールし、WPMLサポートを開きます。プラグインがない場合、サポートページには読み取り専用ツールと「Clear cache」が保持され、プラグインを案内する1行が表示されます。プラグインが必要なツールについては以下に記載されています。

適切なツールの検索

WPMLサポートの上部にある検索ボックスは、3つの階層すべてにわたるすべてのツールとサブアクションをスキャンします。発生している症状、壊れているものの名前、または実行したい操作（「stuck」、「cache」、「taxonomy」、「duplicate」、「sitekey」など）を入力すると、一致するツールが階層バッジとともに表示されます。

ツールがどの階層にあるかを覚えておく必要はありません。

自身で実行しても安全

システムチェック

機能：

WPMLサポートが最初に要求するデバッグ情報を表示し、WPMLのサーバーに対する接続テストを実行し、WPMLが必要とするPHP拡張機能をリストし、ローカルのライセンスデータキャッシュを更新できるようにします。

使用するタイミング：

  • サポートのご質問をする場合。「Debug information」ブロックをコピーします。他に含めるべき内容については、サポートとのデバッグ情報の共有を参照してください。
  • WPMLがwpml.orgに到達できず、接続の問題であることを確認したい場合。
  • サブスクリプションの変更がWPMLに反映されない場合。「Refresh license data」でアカウントのステータスを再取得します。
  • サーバーにWPMLが必要とするPHP拡張機能（SimpleXMLなど）があるか確認したい場合。

これは、ほとんどの状況で最初に使用すべきツールです。

言語データの修正

WPML Troubleshootingプラグインが必要です。

機能：

WPMLが各投稿やタームに対して保存している言語の割り当てを修復します。「Set language information」（言語が設定されていないコンテンツへの言語の割り当て）、「Synchronize posts taxonomies」（タクソノミーの翻訳を投稿に再リンクする）、「Remove comments that don't match the content's language」、「Fix terms count」（言語ごとのターム数の再計算）、「Fix post type assignment」の5つのサブアクションが含まれます。

使用するタイミング：

  • 投稿またはタームが翻訳ダッシュボードの誤った言語列に表示される場合。
  • WPMLがデフォルト言語を翻訳として報告している場合。
  • タクソノミーの翻訳が投稿から切断されているように見える場合。
  • 言語コード（例：en-gbからen）を変更し、既存のコンテンツを再割り当てする必要がある場合。以下の既存コンテンツの言語コードの変更を参照してください。
  • コメントが言語間で正しくフィルタリングされない場合。

翻訳の修正

「Clear cache」を除き、WPML Troubleshootingプラグインが必要です。

機能：

翻訳のステータスを修復します。WPMLのキャッシュのクリア、停止した自動翻訳の再試行、翻訳サービスとの接続の更新、言語スイッチャーのドメイン名の更新（移行後）、複製への翻訳ステータスの割り当て、進行中の自動ジョブのキャンセル、優先翻訳サービスのリセット、プロの翻訳ステータスのリセットの8つのサブアクションがあります。

「Clear cache」はWPML自体に保持されます。プラグインがない場合は、「自身で実行しても安全」の下に単独のタイルとして表示されます。プラグインがある場合は、以前と同様に「Fix translations」の最初のセクションになります。

使用するタイミング：

  • 翻訳が停止しているように見える場合。「In progress」のまま変わらないか、WPML翻訳翻訳ジョブで進捗が表示されません。
  • サイトを新しいドメインに移行したばかりで、言語スイッチャーがまだ古いドメインを指している場合。
  • 翻訳サービスとの接続に問題が発生し、クリーンにリセットしたい場合。
  • 翻訳としてマークされるべき複製された投稿が、翻訳として扱われていない場合。

WPML Troubleshootingプラグインが必要です。

機能：

WPML 4.7より前に作成された投稿をスキャンし、その内部リンクを正しい翻訳バージョンに再配線します。新しい投稿のリンクは自動的に調整されるため、このツールは古いバージョンのWPMLからコンテンツを引き継いだサイトにのみ適用されます。

使用するタイミング：

WPML 4.7より前の投稿がある、長期運用されているサイトでの1回限りのクリーンアップ作業です。実行が完了するとこのセクションは消えます。サイトごとに1回実行するだけで済みます。

すべてのメッセージと通知の削除

機能：

サイト上のすべてのWPML管理画面の通知を非表示にし、非表示にできる警告（dismissible）をリセットして、再発した場合に再表示できるようにします。

使用するタイミング：

WPMLの管理画面が適用されなくなった古い通知で散らかっている場合、または長年の問題を解決したばかりで、不要になった警告をクリーンアップしたい場合。

WCMLステータス

機能（WooCommerceサイトのみ）：

WooCommerce Multilingualの読み取り専用ステータスパネルです。サブセクションには、WooCommerceストアページの翻訳ステータス、翻訳が不足している商品、翻訳が不足しているタクソノミー、マルチ通貨のステータス、サイト上のWPML対応プラグインのステータス、およびストアのWPML Mediaのステータスが表示されます。

使用するタイミング：

  • WooCommerceストアページが翻訳された言語で表示されない場合。
  • ショップのある言語バージョンから一部の商品が欠落している場合。
  • マルチ通貨が設定されているが、価格が正しく切り替わらない場合。
  • WooCommerce関連のサポートのご質問をする前に、ステータスパネルをコピーして質問に含める場合。

WCML翻訳の修正

WPML TroubleshootingプラグインとWooCommerce Multilingualが必要です。

機能（WooCommerceサイトのみ）：

WooCommerce固有の翻訳ステータスを修復します。サブアクションには、商品バリエーションの同期、商品画像ギャラリー、商品カテゴリーのタクソノミー、商品とバリエーションの在庫、不足している商品レビューの翻訳の許可、商品属性の不足している翻訳の作成、「Product Type」タクソノミーの翻訳が含まれます。

使用するタイミング：

  • 商品バリエーションが正常に翻訳されない場合。
  • 同じ商品の言語バージョン間で在庫が同期されない場合。
  • ある言語で商品属性が欠落している場合。
  • ある言語バージョンで商品レビューが表示されない場合。

既存コンテンツの言語コードの変更

すでにその言語のコンテンツがあるサイトで言語コード（例：en-gbからen）を切り替えることは、サーバーの移行ではなく、データベース内での複数ステップの変更になります。

手順：「言語を編集」の下にあるWPML設定言語で言語コードを変更し、WPMLサポート言語データの修正Set language informationを使用して既存の投稿と翻訳の言語を再割り当てします。本番環境で実行する前に、ステージングのコピーで一度手順を確認してください。