選手リスト

[player_list] ショートコードは、設定された統計列を持つ選手のロスターテーブルを表示します。選手のソート、ページネーション、ポジションによるグループ分け、チームやシーズンによるフィルタリングが可能です。

表示される内容

選手ごとに 1 行のデータテーブル。最初の列には選手名（オプションの写真と国旗付き）が表示されます。続く列には設定されたパフォーマンス統計が表示されます。grouping="position" が設定されている場合、選手をポジションの見出しでグループ分けできます。

使用するタイミング

任意のページで使用します。SportsPress 選手リスト投稿を指す id を指定してください。選手リスト投稿ページのループ内では id を省略できます。

パラメーター

パラメーター	タイプ	デフォルト	説明
`id`	整数	`get_the_ID()`	選手リストの投稿 ID。ループ外では必須です。
`title`	文字列/真偽値	`false`	表示する見出しを上書きします。
`number`	整数	`-1`	表示する最大選手数。`-1` はすべてを表示（またはリスト自体の数値設定を使用）。
`columns`	文字列/配列	`null`	リストの列選択を上書きするカンマ区切りのパフォーマンス列スラッグ（例：`'appearances,goals'`）。レガシーパラメーター名 `performance` も受け付けます。
`grouping`	文字列/null	リストから	選手のグループ分け：ポジションでグループ分けする場合は `'position'`、グループ分けなしは空。デフォルトは選手リストのグループ設定から。
`grouptag`	文字列	`'h4'`	グループ分けが有効な場合のグループラベルの HTML 見出しタグ（例：`'h3'`、`'h4'`）。
`orderby`	文字列	`'default'`	ソートする列スラッグ。`'default'` はリスト自体のソート設定を使用。
`order`	文字列	`'ASC'`	ソート方向：`'ASC'` または `'DESC'`。
`leagues`	整数/文字列	`null`	選手の統計をリーグでフィルタリングするリーグターム ID。
`seasons`	整数/文字列	`null`	選手の統計をシーズンでフィルタリングするシーズンターム ID。
`team`	整数	`null`	現在のチームで選手をフィルタリングするチーム投稿 ID。
`show_all_players_link`	真偽値	`false`	`1` でテーブルの下に「全選手を表示」リンクを表示します（`id` が必要）。
`show_title`	真偽値	設定から	`1` で選手リストのタイトルを見出しとして表示します。
`show_player_photo`	真偽値	設定から	`1` で名前列に選手写真を表示します。
`show_player_flag`	真偽値	設定から	`1` で名前列に国旗を表示します。
`team_format`	文字列	設定から	チーム列の表示方法：`'name'`、`'logo'`、または `'both'`。
`link_posts`	真偽値	設定から	`1` で選手名を選手ページにリンクします。
`link_teams`	真偽値	設定から	`1` でチーム名をチームページにリンクします。
`sortable`	真偽値	設定から	`1` でクライアント側の列ソートを有効にします。
`responsive`	真偽値	設定から	`1` でレスポンシブテーブルモードを有効にします。
`scrollable`	真偽値	設定から	`1` で横スクロールを有効にします。
`paginated`	真偽値	設定から	`1` でテーブルをページネーションします。
`rows`	整数	設定から	ページネーション有効時の 1 ページあたりの行数。デフォルトはリスト > 行数設定（`10`）から。

使用例

最小限 — 全選手リスト：

[player_list id="55"]

ポジションでグループ分けされた上位 10 得点者、降順ソート：

[player_list id="55" number="10" orderby="goals" order="DESC" grouping="position" grouptag="h3"]

特定チームの選手リスト、写真あり、名前リンクあり、「全選手を表示」リンクあり：

[player_list id="55" team="12" show_player_photo="1" link_posts="1" show_all_players_link="1"]

ページネーションなし、カスタム列のコンパクトなリスト：

[player_list id="55" columns="appearances,goals,assists" paginated="0"]