CSV での試合インポート

SportsPress には試合用の CSV インポーター機能が内蔵されています。ツール → インポート に移動し、試合（CSV） を選択してファイルをアップロードします。

インポート前の準備

インポーターの開始画面には、サンプル CSV ファイル（SportsPress プラグインディレクトリの dummy-data/events-sample.csv）へのリンクがあり、LeagueLobster からエクスポートされた CSV ファイルに対応していると記載されています。

インポートオプション

列のマッピングの前に、インポーターは以下のオプションを表示します。

フォーマット — 試合フォーマットのラジオボタン（リーグ、フレンドリー、トーナメントなど）。インポートされたすべての試合はこのフォーマットを受け取ります。
リーグ — 既存のリーグのドロップダウン。インポートされたすべての試合がこのリーグに割り当てられます。リーグなしでインポートするには — 設定なし — のままにします。
シーズン — 既存のシーズンのドロップダウン。インポートされたすべての試合がこのシーズンに割り当てられます。シーズンなしでインポートするには — 設定なし — のままにします。
日付フォーマット — CSV ファイルの日付列に合わせたラジオボタン：
- yyyy/mm/dd（デフォルト）
- dd/mm/yyyy
- mm/dd/yyyy

CSV 構造

CSV は試合ごとに複数行のフォーマットを使用します。試合、チーム、選手はそれぞれ別の行を占有します。日付値が表示されるたびに新しい試合が始まります。

列リファレンス

列	必須	備考
日付（`post_date`）	新規試合に必須	新しい試合行の作成をトリガーします。選択した日付フォーマットと一致する必要があります。
時刻（`post_time`）	任意	24 時間形式（`HH:MM`）。省略するとデフォルトは `0:00:00` です。保存時に日付と組み合わされます。
会場（`sp_venue`）	任意	テキストとしての会場名。既存の会場に一致させ、新しい会場は自動的に作成されます。
チーム（`sp_team`）	任意	チーム名。日付行にホームチームを入力し、追加のチームは日付が空白の別の行に入力します。一致するものが見つからない場合、新しいチームが自動的に作成されます。
結果（`sp_results`）	任意	その行のチームのスコア。複数のリザルト変数の場合はパイプ `	`区切りを使用します（例：前半とゴールの場合` 1	2`）。値は設定された順序でリザルト変数にマッピングされます。
アウトカム（`sp_outcome`）	任意	その行のチームのアウトカムラベル。複数のアウトカムの場合はパイプ `	` 区切りを使用します。新しいアウトカムは自動的に作成されます。
選手（`sp_player`）	任意	選手名。チーム行に最初の選手を入力し、追加の選手は日付とチーム名が空白の後続の行に入力します。新しい選手は自動的に作成されます。
パフォーマンス統計	任意	設定済みのパフォーマンス変数ごとに 1 列（ゴール、アシストなど）、設定と同じ順序で。選手の行に値を入力します。

行レイアウト

試合は CSV 内で 3 レベルの階層構造を使用します。

試合行 — 日付、時刻、会場、任意で最初のチーム、リザルト、アウトカム、最初の選手を含みます。
チーム行 — 日付が空白の行に追加のチームを一覧表示します。各チーム行にはそのチームの最初の選手も含められます。
選手行 — 最新のチームの追加の選手。日付とチームの値が空白の行に。

自動作成の動作

チーム — CSV のチーム名が既存のチーム（タイトルで一致）に一致しない場合、新しいチーム投稿が作成されて公開されます。
会場 — 会場名が既存の会場タームに一致しない場合、新しい sp_venue タクソノミータームが作成されます。
アウトカム — アウトカムラベルが既存のアウトカム投稿に一致しない場合、新しい sp_outcome 投稿が作成されます。
選手 — 選手名が既存の選手投稿に一致しない場合、新しい sp_player 投稿が作成されます。選手は自動的にチームにもリンクされます（まだ割り当てられていない場合は現在のチームが設定されます）。

インポート後

インポーターはインポートされた試合とスキップされた試合の数を報告します。試合を表示 をクリックして結果を確認します。