プラグインに問題がある場合、私たちは喜んでお手伝いし、問題のトラブルシューティングを行います。

まず、”Matomo Analytics => Diagnostics”（古いバージョンでは “Matomo Analytics => System Report “というメニューがあります）でエラーや警告がないか確認してください。プラグインがインストールされなかったり、すぐにクラッシュした場合でも、システムレポートを見ることができます。システムレポートにエラーがない場合、トラブルシューティングのために、WordPressのデバッグモード （WP_DEBUGを有効にしてください）

デバッグを有効にする

デバッグを有効にするにはwp-config.phpファイルに以下の行を追加します：

 define( 'WP_DEBUG', true );
    

デフォルトでは、エラーと警告はHTMLページ内に表示されます（他の定数WP_DEBUG_DISPLAYはデフォルトでtrueに設定されています）以下の行を追加することで、すべてのエラーを/wp-content/ディレクトリ内のdebug.logファイルに保存することもできます。

define( 'WP_DEBUG_LOG', true );
    

詳細はWP_DEBUG WordPress.orgをご覧ください。

可能であれば、一般的なPHPやウェブサーバーのエラーログも見ることをお勧めします。

システムレポートの取得とコピー

WordPressの管理画面で、「Matomo Analytics」の「診断」をクリックします（古いバージョンでは「システムレポート」というメニューがあります）

システムレポートをコピーするボタンをクリックして、レポートをクリップボードにコピーします。

注：プラグインをインストールすることさえできない場合は、プラグインをインストールする前にwp-config.phpファイルに以下の行を追加してください：

define( 'MATOMO_SAFE_MODE', true );
    

これにより、プラグインをインストールできない場合でも、Matomo Systemレポートが機能するようになります。

システム・レポートの取得方法に関する詳しいステップ・バイ・ステップのFAQはこちらをクリックしてください。

すべてのロギングを無効にするには？

WP_DEBUGを常に有効にしていて、Matomo for WordPressが有用でないメッセージを記録している場合、以下の行をWordPressのログに追加することで、Matomo固有のログメッセージの記録を無効にすることができます。（バージョン1.3.1以降が必要）：

define( 'MATOMO_DEBUG', false );
    

すべてのメッセージをログに記録するには？

プラグインにすべてのメッセージを記録させたい場合(デバックのため)wp-config.phpに以下の行を追加してください（バージョン1.3.1以降が必要です）：

define( 'MATOMO_DEBUG', true );
    

アーカイブとレポートが機能しない？

こちらのFAQをご覧ください。

Matomoのレポート、管理者、またはタグマネージャーページが機能していませんか？

こちらのFAQをご覧ください。

Github で課題を作成し、System レポートを貼り付けます。

次のステップはMatomo for WordPress issue trackerにissueを作成します。issueの説明では、issueをできるだけ詳細に説明し、システムレポートとエラーまたは警告メッセージを貼り付けてください。

その後、再びデバッグモードを無効にする

トラブルシューティングが済んだら、wp-config.phpファイルを編集し、定数をfalseに設定します：

 define( 'WP_DEBUG', false );