トラブルシューティング
SportsPress および SportsPress Pro のよくある問題とその解決策。
インストール後にページが見つからない（404）
症状： プラグインを有効化した直後に試合、チーム、選手、その他の SportsPress ページをクリックすると、404「ページが見つかりません」エラーが返される。
原因： SportsPress のカスタム投稿タイプのスラッグを含むように WordPress のパーマリンクルールが再生成されていない。
解決策： パーマリンクキャッシュをフラッシュします。
WordPress 管理画面で設定 > パーマリンク設定に移動します。
変更を保存をクリックします（変更は不要です — 保存するだけでルールが再生成されます）。
これにより WordPress は書き換えルールを再構築し、すべての SportsPress のルートを登録します。
試合に「Missed Schedule」と表示される
症状： スケジュールされた（将来の）試合がフロントエンドで今後の試合として表示される代わりに、「Missed schedule」ステータスが表示される。
原因： WordPress が「プレーン」パーマリンク設定を使用するよう設定されており、SportsPress がスケジュールされた試合の表示に必要な日付ベースの URL 構造をサポートしていない。
解決策： パーマリンク構造を少なくとも「日付と投稿名」に変更します。
設定 > パーマリンク設定に移動します。
日付と投稿名またはその他のカスタム構造を選択します。
変更を保存をクリックします。
「プレーン」パーマリンク設定のみがスケジュールされた試合の表示を破壊します。その他すべてのパーマリンク構造はサポートされています。
選手リストに選手が表示されない
症状： チームページの選手リストまたは手動で埋め込んだ選手リストのショートコードに、選手が表示されないか、期待より少ない選手しか表示されない。
よくある原因と解決策：
選手がチームに割り当てられていない — 選手の編集画面を開き、チームメタボックスでチームが選択されていることを確認します。選手はそのチームの選手リストに表示されるために、現在のチームとしてチームが割り当てられている必要があります。
選手リストがリーグ/シーズンでフィルタリングされている — 選手リストにリーグまたはシーズンのフィルターが設定されている場合、そのリーグまたはシーズンにも割り当てられている選手のみが表示されます。選手リストの設定と選手のタクソノミー割り当てを確認してください。
選手リストがチームにリンクされていない — 選手リストの編集画面で正しいチームが選択されていることを確認します。自動生成されるリストの場合、チームページの設定で「選手リスト」が有効になっている必要があります。
選手が過去のチームとしてのみ割り当てられている — 過去のチームメンバーとしてのみ割り当てられた選手は、デフォルトでは現在の選手リストに表示されません。選手リストが過去の選手を含むように設定されているか確認してください。
リーグテーブルにゼロが表示される
症状： 結果が入力された公開済みの試合があるにもかかわらず、リーグテーブルのすべての値がゼロで表示される。
よくある原因と解決策：
方程式が設定されていない — SportsPress > 設定 > リーグテーブル列に移動し、各列に有効な方程式があることを確認します。方程式がない列や変数参照が無効な列はゼロになります。
試合が正しいリーグまたはシーズンに割り当てられていない — リーグテーブルは特定のリーグとシーズンにスコープされています。試合はそれらと同じタームに割り当てられている必要があります。試合のリーグとシーズンの割り当てを確認してください。
試合に結果が入力されていない — リーグテーブルの計算は公開済みの試合結果によって行われます。計算に使用される試合が公開済みで結果が入力されていることを確認します。
テーブルに間違ったチームが選択されている — リーグテーブルの編集画面で正しいチームが一覧表示されていることを確認します。「自動」モードが選択されている場合、チームは割り当てられたリーグ/シーズンの試合から取得されます。
選手の統計がゼロになる
症状： 選手のプロフィールや選手リストの統計がゼロで表示される。
よくある原因と解決策：
試合が公開されていない — 統計は公開済みの試合からのみ計算されます。下書きまたはスケジュールされた試合は含まれません。選手のパフォーマンスデータが含まれる試合を公開してください。
結果が入力されていない — 試合には結果（スコア/結果種別）が入力されている必要があります。結果のない試合は統計に反映されません。
パフォーマンス列が設定されていない — SportsPress > 設定 > 選手パフォーマンスに移動し、列が設定されていることを確認します。パフォーマンス列が存在しない場合、統計を収集できません。
選手統計の方程式が存在しない変数を参照している — SportsPress > 設定 > 選手統計に移動し、各統計の方程式が既存のパフォーマンス列の変数名を参照していることを確認します。
選手が試合に登録されていない — 試合の編集画面を開き、選手がそのチームのボックススコアに表示されていることを確認します。
キャッシュプラグインの競合
症状： 変更を保存した後、SportsPress のデータ（リーグテーブル、選手リスト、試合結果）が古い状態のまま更新されない。ランダムなスポンサーのローテーションが機能しない。
影響が確認されているプラグイン：
Litespeed Cache — オブジェクトキャッシュが SportsPress のメタクエリの新しいデータの取得を妨げる可能性があります。
W3 Total Cache — オブジェクトキャッシュとデータベースキャッシュが動的な SportsPress クエリに干渉する可能性があります。
解決策：
SportsPress コンテンツを含むページのオブジェクトキャッシュを無効にするか、SportsPress 投稿タイプの URL（例：
/event/、/team/、/player/に一致するパス）にキャッシュ除外を設定します。Litespeed Cache では、SportsPress 投稿タイプのスラッグを「キャッシュしない URI」リストに追加します。
W3 Total Cache では、試合結果を変更してもテーブル/リストデータが更新されない場合は「データベースキャッシュ」を無効にします。
スポンサーはランダムローテーションのキャッシュをバイパスするために AJAX リクエストを使用します。キャッシュ設定が AJAX レスポンスをキャッシュしないようにしてください。
PHP エラーまたは白い画面
症状： PHP または SportsPress をアップグレードした後に管理画面で PHP 警告、致命的なエラー、または空白ページが表示される。
最小要件：
PHP 5.2.4 以上（PHP 7.4+ 推奨、PHP 8.x は最近のバージョンでサポート）
WordPress 3.8 以上
MySQL 5.0 以上
PHP メモリ制限：最低 64 MB 推奨
解決策：
SportsPress Pro を最新バージョンに更新します。PHP の各マイナーバージョンアップデートには互換性の修正が必要な場合があります。
PHP 8.x を使用している場合は、PHP 8.x の非推奨通知の修正を含む SportsPress Pro 2.7.18 以降を使用していることを確認します。
サーバーの PHP エラーログで具体的なエラーメッセージを確認します。よくある PHP 8.x の問題には、非推奨の関数シグネチャと null パラメーターの処理に関するものがあります。
致命的なメモリエラーが発生する場合は、
wp-config.phpにdefine('WP_MEMORY_LIMIT', '128M');を追加して PHP メモリ制限を増やします。