SC-003 ランダム広告ショートコード

概要

• 日別記事作成画面向けに、AppConstants::ADSENSE_SLOTS_CREATE_DAILY_ARTICLE に登録された複数の AdSense スロットからランダムに 1 件を選び、広告 HTML を出力する。記事ごとに異なるスロットを表示できる。
• adsbygoogle.js はページあたり 1 回だけ enqueue する（重複防止あり）。

外部インターフェース

ショートコードタグ

• タグ名: [random_adsense_ad]
• 入力例: [random_adsense_ad]

属性一覧

属性	役割	必須
—	なし	—

エラー

条件	ユーザー向け挙動	メッセージ / ログ
処理中の Throwable（Twig レンダリング失敗など）	固定文言（エラーが発生しました：execute_if_not_admin）	error_log（ShortCodeHelper、先頭 [ShortCodeHelper]）

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

公開契約（Breaking change 扱い）

• ショートコード名 random_adsense_ad を変更しない
  • 理由: 過去投稿本文に文字列が直書きされているため
• AdSense Publisher ID ca-pub-8709674592133889（Google アカウント設定と一致させる）
• CSS クラス .adsense-wrap, .adsbygoogle, .adsense（外部 CSS・AdSense JS が依存）
• data-ad-format="auto", data-full-width-responsive="true"（レスポンシブ表示の前提）
• adsbygoogle.js の handle 名 google-adsense（wp_script_is 等との整合）