ADM-11 min-repo Cookie 管理画面

概要

• min-repo.com の差枚取得などで利用する Cookie 文字列 を wp_options に保存する管理画面。
• 定数 MIN_REPO_SCRAPE_COOKIE が定義されている場合は定数が優先され、オプション値は min_repo_scrape_cookie フィルター経由で参照される（未定義時にオプションが供給される）。
• 手動貼り付け保存に加え、ローカルヘルパーから REST API で送信する経路を案内する。

外部インターフェース

管理画面 URL

項目	値
URL	/wp-admin/options-general.php?page=min-repo-cookie-admin
メニュー名	min-repo Cookie
権限	manage_options

フォーム POST（同期）

POST options-general.php?page=min-repo-cookie-admin。

min_repo_cookie_action 値	処理
save	Cookie 保存

Nonce フィールド: min_repo_cookie_nonce（検証アクション: min_repo_cookie_admin）

POST パラメータ

フィールド	説明
min_repo_cookie_value	生 Cookie 文字列。制御文字除去・前後 trim。最大長は MinRepoCookieOption::MAX_COOKIE_LENGTH（8192 バイト）

リダイレクト後クエリ（通知）

クエリ	内容
mrc_success	1 / 0
mrc_msg	メッセージ

REST API（ヘルパー用）

項目	値
メソッド	POST
ルート	/wp-json/slot-kouryaku/v1/min-repo-cookie（rest_url( 'slot-kouryaku/v1/min-repo-cookie' )）
ボディ	JSON {"cookie":"..."}（cookie 必須。印字可能 ASCII のみ許可など検証あり）
認証	アプリケーションパスワードによる Basic 認証（画面内ヘルプ参照）。実装は MinRepoCookieHandler＋PermissionChecker

成功時 HTTP 200、失敗時 400 / 500 と message を JSON で返す。

データ

wp_options

キー	説明
slot_kouryaku_min_repo_scrape_cookie	保存 Cookie 文字列（MinRepoCookieOption::OPTION_NAME）

エラー

条件	ユーザー向け挙動	メッセージ例
nonce 不正	リダイレクト	Messages::AUTH_FAILED
Cookie 空	リダイレクト	MinRepoMessages::COOKIE_PLEASE_INPUT
長さ超過	リダイレクト	MinRepoMessages::COOKIE_TOO_LONG（フォーマット付き）
update_option 失敗	リダイレクト	MinRepoMessages::COOKIE_SAVE_FAILED

変更履歴（設計書）

日付（JST）	変更内容	コード側の対応（PR 等）
2026-04-21	初版作成	—