WPML

WPMLサポートに質問する前のトラブルシューティングチェックリスト

WPMLのほとんどの問題は、ご自身で解決できます。サポートに質問する前にこのチェックリストを確認することで、双方の時間を節約でき、多くの場合、問題が完全に解決します。チェックリストで解決しない場合でも、サポートが最初に求める情報を質問に含める準備が整います。

  1. システムがWPMLの最小要件を満たしていることの確認

    WPML > サポートを開きます。サイトがWPMLの最小要件（PHPバージョン、必須のPHP拡張モジュール（SimpleXMLなど）、メモリ制限）を満たしていない場合、ページ上部に警告パネルが表示されます。パネルには、満たされていない各要件と対処法がリストされています。

    パネルにフラグが立てられているものがある場合は、まずそれを修正してください。「WPMLが壊れている」という症状の多くは、実際には「サーバーのリソース不足」が原因です。

  2. すべての更新

    WPML、WordPress、テーマ、または他のプラグインのバージョンが古いことは、WPMLの問題の2番目に多い原因です。

    • WPMLとそのアドオン。WPML > Activate & Updateを開き、「更新を確認」をクリックして、利用可能なものをインストールします。詳細については、WPMLの更新をご覧ください。
    • WordPressコア。ダッシュボード > 更新から更新します。
    • テーマと他のプラグイン。プラグイン > インストール済みプラグインおよび外観 > テーマから更新します。

    各更新の後に症状を再テストしてください。

  3. 競合の確認

    新しいプラグインのインストールやテーマの切り替え後に症状が現れた場合、それが主な原因として疑われます。最近何も変更していない場合でも、プラグインやテーマの更新が原因となることがあります。

    • 他のプラグインを無効化し、1つずつ（または半分ずつ）各ステップの後に再テストします。
    • 一時的にデフォルトのテーマに切り替えます（例：Twenty Twenty-Four）。症状が消えた場合、テーマが原因です。

    原因を見つけた場合、それはWPMLサポートが必要とする情報です。

  4. 関連する管理画面内ツールの試用

    ほとんどの症状には、WPML > サポートに専用のツールがあります。ページ上部の検索ボックスを使用して、症状を入力します（例：「stuck translation」、「language data」、「cache」、「duplicate」、「comments」）。適切なツールが表示されます。

    「自身で実行しても安全」の階層は、そのラベルの通り安全です。翻訳が滞っているように見える場合はFix translationsを実行し、言語の割り当てが間違っているように見える場合は言語データの修正を実行します。ツールごとのリファレンスについては、WPML > サポートのトラブルシューティングツールをご覧ください。

  5. 関連するログの確認

    症状が断続的であるか再現が難しい場合、WPML > サポートの読み取り専用のログ階層に答えがあることがよくあります。通信ログには、サイトと翻訳サービス間のAPIトラフィックが表示されます。高度な翻訳エディタのエラーログには、サーバー側のエラーが表示されます。翻訳管理ジョブログには、特定の翻訳ジョブに何が起こったかが表示されます。

    どの状況でどのログを確認すべきかについては、ログをご覧ください。

  6. デバッグ情報の収集

    上記のステップを実行しても症状が残る場合は、デバッグ情報を収集してください。サポートが最初にこの情報を求めます。

    1. WPML > サポート > システムチェックを開きます。
    2. デバッグ情報ブロックをクリップボードにコピーします。
    3. WPML > サポートページの下部にあるインストール済みプラグインセクションまでスクロールし、「Copy list to clipboard」をクリックします。
    4. 両方のブロックをサポートのご質問に貼り付けます。

    何を含めるべきか、およびサポートがサイト自体のコピーを必要とする場合については、サポートとのデバッグ情報の共有をご覧ください。

  7. 質問の投稿

    上記のチェックリストで解決しなかった場合は、WPMLサポートで質問してください。質問には以下を含めてください。

    • 症状を説明します。何が表示されているか、何を期待していたか、いつ始まったかを記載します。
    • すでに試したことをリストします。上記のステップに加えて、他に試したことがあれば記載します。
    • ステップ6で収集したデバッグ情報とインストール済みプラグインのリストを貼り付けます。
    • サポートがサイトから直接ライブデバッグ情報を読み取れるようにしたい場合は、WPML > サポートページで「Share diagnostic information with WPML Support」にチェックを入れます。このチェックボックスはオプトイン方式であり、いつでもオフにすることができます。

    これらの情報が添付されたご質問に対しては、サポートがすぐに対応できます。