タイムライン

タイムラインモジュールは試合ページにプレーバイプレイのタイムラインを追加します。タイムラインは試合開始からフルタイムまでの試合の視覚的な表現に沿って、パフォーマンスイベント（ゴール、カード、交代、その他のタイム計測統計）をプロットして表示します。SportsPress Pro の一部です。

タイムラインの有効化

タイムラインセクションはオプションキー sportspress_event_show_timeline で試合ページテンプレートとして登録されています。デフォルト値は yes なので、モジュールが有効の場合はデフォルトで表示されます。

試合ページにタイムラインを表示するかどうかを制御するには、SportsPress → 設定 → 試合 に移動し、試合表示セクションの タイムライン トグルを確認します。

レイアウトオプション

SportsPress → 設定 → 試合 → タイムライン に移動してレイアウトを設定します。設定キーは sportspress_timelines_format です。

水平（horizontal）— デフォルトのレイアウト。イベントはキックオフ（KO）からフルタイム（FT）まで水平バーに沿って左から右にプロットされます。ホームチームのアイコンはバーの上、アウェイチームのアイコンはバーの下に表示されます。
垂直（vertical）— イベントが縦型タイムライン形式でリスト表示されます。

データソース

タイムラインは試合の sp_timeline 投稿メタキーから入力されます。このメタは、ボックススコアに分数を入力したときに設定されます。「タイム計測」対応の各パフォーマンス統計（パフォーマンス変数の sp_timed プロパティ）に対して、選手パフォーマンスメタボックスの統計数の下に分数入力フィールドが表示されます。各事象が発生した分数を入力します（例：23 分のゴールなら 23）。

交代時間もタイムラインに記録されます。選手のステータスが交代に設定されると、ステータス列に交代時間の分数入力が表示されます。

[sportspress_timeline] ショートコード

タイムラインモジュールはショートコード [sportspress_timeline] を登録し、サイト上のどこでも特定の試合のタイムラインを埋め込むことができます。

基本的な使用法：

[sportspress_timeline id="123"]

位置 ID（省略形）：

[sportspress_timeline 123]

パラメーター：

id — 試合の投稿 ID。試合ページの外で使用する場合は必須。試合自体のページで使用し id が省略された場合、get_the_ID() が自動的に使用されます。
format — レイアウトフォーマット。horizontal（デフォルト）または vertical を受け付けます。

例：

[sportspress_timeline id="456" format="vertical"]
[sportspress_timeline id="456" format="horizontal"]

テキストラベル

タイムライン出力で使用される以下のテキスト文字列は SportsPress → 設定 → テキスト でカスタマイズできます。

タイムライン — セクション見出しラベル。
KO — キックオフマーカーラベル。
FT — フルタイムマーカーラベル。