試合ブロック

[event_blocks] ショートコードは試合を垂直ブロックレイアウトで表示します。各試合は独自のカードにチームロゴ、日付、結果または時間、オプションの試合タイトル、リーグ、シーズン、会場、試合日が表示されます。

表示される内容

ページ分けされたブロックスタイルのテーブル。各行は 1 つの試合で、チームロゴが横並びで表示され、日付とスコアまたは予定時間が表示されます。オプションのメタデータフィールド（リーグ、シーズン、会場、試合日）がスコアの下に表示されます。

使用するタイミング

任意のページ、投稿、またはウィジェットで使用します。特定の SportsPress カレンダーから試合を取得するには id を指定します。id なしでは、ショートコードは get_the_ID() を使用します。

パラメーター

パラメーター	タイプ	デフォルト	説明
`id`	整数	`null`	SportsPress カレンダーの投稿 ID。
`event`	整数	`null`	特定の試合の投稿 ID にフィルタリングします。
`title`	文字列/真偽値	`false`	表示される見出しを上書きします。
`status`	文字列	`'default'`	試合ステータスフィルター：`'default'`、`'future'`、または `'publish'`。
`format`	文字列	`'default'`	試合形式フィルター。
`date`	文字列	`'default'`	日付プリセットフィルター。
`date_from`	文字列	`'default'`	日付範囲の開始（YYYY-MM-DD）。
`date_to`	文字列	`'default'`	日付範囲の終了（YYYY-MM-DD）。
`date_past`	文字列	`'default'`	含める過去の日数。
`date_future`	文字列	`'default'`	含める将来の日数。
`date_relative`	文字列	`'default'`	相対日付モード。
`day`	文字列	`'default'`	試合日フィルター。
`league`	整数/文字列	`null`	リーグのターム ID またはスラッグ。
`season`	整数/文字列	`null`	シーズンのターム ID またはスラッグ。
`venue`	整数/文字列	`null`	会場のターム ID またはスラッグ。
`team`	整数	`null`	試合をフィルタリングするチームの投稿 ID。
`teams_past`	整数	`null`	過去のチームの関連付けを含めるフィルター。
`date_before`	文字列	`null`	この日付以降の試合を除外します。
`player`	整数	`null`	試合をフィルタリングする選手の投稿 ID。
`number`	整数	`-1`	表示する最大試合数。`-1` はすべてを表示。
`columns`	文字列/配列	`null`	カレンダーのカラム設定を上書きするカンマ区切りのカラムスラッグ。
`orderby`	文字列	`'default'`	ソートするフィールド（例：`'date'`、`'day'`）。
`order`	文字列	`'default'`	ソート順：`'ASC'` または `'DESC'`。
`show_team_logo`	真偽値	設定から	`1` でチームロゴを表示します。デフォルトは試合ブロック > ロゴを表示設定（`yes`）に従います。
`link_teams`	真偽値	設定から	`1` でチームロゴをチームページにリンクします。
`link_events`	真偽値	設定から	`1` で日付とタイトルを試合ページにリンクします。
`paginated`	真偽値	設定から	`1` でページ分けします。デフォルトは試合ブロック > ページ分けする設定に従います。
`rows`	整数	設定から	1 ページあたりの行数。デフォルトは試合ブロック > 行数設定（デフォルト `5`）に従います。
`show_all_events_link`	真偽値	`false`	`1` で「すべての試合を表示」リンクを表示します（`id` が必要）。
`show_title`	真偽値	設定から	`1` でカレンダー名を見出しとして表示します。
`show_league`	真偽値	設定から	`1` で各試合スコアの下にリーグを表示します。
`show_season`	真偽値	設定から	`1` で各試合スコアの下にシーズンを表示します。
`show_matchday`	真偽値	設定から	`1` で各試合スコアの下に試合日を表示します。
`show_venue`	真偽値	設定から	`1` で各試合スコアの下に会場を表示します。
`hide_if_empty`	真偽値	`false`	`1` で試合がない場合にすべての出力を非表示にします。

使用例

最小限 — 特定のカレンダーのすべての試合：

[event_blocks id="30"]

将来の試合、ロゴと会場あり、5 件に制限：

[event_blocks id="30" status="future" show_team_logo="1" show_venue="1" number="5"]

試合日別にグループ化されたブロックレイアウト、リーグとシーズンのメタデータあり：

[event_blocks id="30" orderby="day" show_league="1" show_season="1"]