SC-013 月別リンクショートコード

SC-005（デイリー記事上部表示）の統合タグ MakeArtist20230318 と同じ画面構成で使う分割タグの一つ。日別テンプレでは SC-014（BirthDayMachinePickUp）と並べて配置する。SC-006（BirthDayIndex・誕生日一覧）とは別タグ。

月別リンクカレンダーだけを出力する。

概要

• 指定年を基準とした月別リンクカレンダー（アコーディオン）のみを返す。誕生日ブロックは含まない。
• 日別記事テンプレでは [BirthDayMachinePickUp] と並べて使う（表示順はテンプレ側の並び）。統合タグ [MakeArtist20230318] の「月別リンク部分」と同じ見た目・契約を単体で呼び出す。

ワイヤーフレーム

同一 UI は SC-005 の MonthChipListBlock（B-1）および PUB-001 とブロック層で共有する。

ブロック一覧

ブロックID	ブロック名	表示内容	初期値	ユーザー操作	アクション
B-0	月別リンク	月チップ一覧（MonthChipListBlock）	常時表示	月リンク	-

表示条件・注記

• 属性: year 必須。
• 管理画面: 出力なし。
• SC-005 との関係: 統合タグの月別リンク部分と同一 UI（誕生日は含まない）。

外部インターフェース

ショートコードタグ

• タグ名: [MonthlyLinkByYear]
• 入力例: [MonthlyLinkByYear year="2024"]

属性一覧

属性	役割	必須
year	対象年（整数、2020〜2100）	○

エラー

条件	ユーザー向け挙動	メッセージ / ログ
year が未指定・非数値・範囲外（2020 未満 / 2100 超）	ValidationException メッセージをそのまま表示（esc_html 済み）	「年は数値で指定してください。」／「年は2020から2100の間で指定してください。」
Controller・Service・View 内での \Throwable	'エラーが発生しました：execute_if_not_admin' を表示	error_log（先頭 [ShortCodeHelper] + 例外クラス名・メッセージ・ファイル・行番号）
管理画面（is_admin() === true）	空文字を出力（非表示）	—

今後の更新で崩してはいけないところ（互換性契約）

公開契約（Breaking change 扱い）

• ショートコード名 MonthlyLinkByYear を変更しない（日別テンプレ・投稿本文に直書きされうるため）。
• 属性名 year を変更・削除しない。