ショートコードの使い方

SportsPress のショートコードを使用すると、WordPress の任意の投稿、ページ、またはテキストウィジェットに試合日程、テーブル、選手統計、その他のスポーツコンテンツを埋め込むことができます。

クラシックエディターの「S」ボタン

クラシック（TinyMCE）エディターで投稿またはページを編集する際、SportsPress は「S」ツールバーボタンを追加します。クリックすると、タイプ別（試合、選手など）にグループ化された利用可能なショートコードのメニューが開きます。選択すると、正しい投稿 ID に置き換えるプレースホルダー id 属性を持つショートコードタグがカーソル位置に挿入されます。

編集画面のショートコードパネル

カレンダー、リーグテーブル、選手リスト、スタッフ名鑑、トーナメント、または試合の投稿の編集画面では、SportsPress が右側のサイドバーにショートコードメタボックスを表示します。このパネルは現在の投稿の正しいショートコードを自動生成します。投稿 ID が既に入力された状態で表示されるため、ID を手動で調べることなく任意のページまたは投稿に直接コピーして貼り付けることができます。

id パラメーター

特定の SportsPress 投稿（カレンダー、リーグテーブル、選手リストなど）からデータを表示するすべてのショートコードは、そのレコードの WordPress 投稿 ID を値とする id パラメーターを受け付けます。

ループの中（単一の試合、選手、またはチームページ）では id を省略できます。テンプレートは自動的に get_the_ID() にフォールバックします。

ループの外（スタンドアロンページ、テキストウィジェット、または表示したいアイテムの単一投稿ページ以外のページ）では id パラメーターは必須です。これがないと、ショートコードはデータを取得する投稿を持てず、何も出力しないかランダムな投稿 ID を使用してしまいます。

例 — ループ内で id を省略する場合：

[league_table]

例 — 別のページに埋め込む場合は id が必要：

[league_table id="42"]

投稿 ID を最初の位置引数として渡すこともできます（キー名なし）：

[league_table 42]

どちらの形式も同等です。

投稿 ID の調べ方

最も簡単な方法は、WordPress 管理の一覧表示で投稿タイトルにカーソルを合わせることです。ステータスバーの URL に post=123 が含まれており、123 が ID です。または、投稿を開いてブラウザのアドレスバーの URL を確認します。

ページと投稿へのショートコードの貼り付け

ショートコード文字列をコピーします（例：[event_list id="99"]）。
コンテンツを表示したいページまたは投稿を開きます。
クラシックエディターでは「テキスト」タブに貼り付けるか「S」ボタンを使用します。ブロックエディターではショートコードブロックを使用して文字列を内部に貼り付けます。
保存してページをプレビューします。

注意： SportsPress は WordPress のパーマリンクを「基本」以外の設定（少なくとも「日付と投稿名」）にする必要があります。基本パーマリンクでは、スケジュールされた試合やカレンダーナビゲーションが正しく動作しません。