Appearance
ADM-006 機種表示マッピング管理画面
概要
db_kishu_display_mappingの一覧・追加・更新・削除、および登録データへの表示名反映（マイグレーション）を行う管理画面。- WordPress 設定サブメニューとして登録。操作はすべて 同一 URL への POST（リダイレクト＋クエリ通知）。admin-ajax は使用しない。
外部インターフェース
管理画面 URL
| 項目 | 値 |
|---|---|
| URL | /wp-admin/options-general.php?page=kishu-display-mapping-admin |
| メニュー名 | 機種表示マッピング |
| 権限 | manage_options |
フォーム POST（同期 CRUD / マイグレーション）
POST options-general.php?page=kishu-display-mapping-admin。
kishu_display_mapping_action 値 | 処理 |
|---|---|
add | 新規行追加 |
update | 既存行更新 |
delete | 指定 ID 削除 |
apply_to_data | 登録データへの表示名反映（db2023・db_daily_article_kishu_single_day_summary・db_daily_article_kishu_count_delta・db_birthday_kishu の kishu を一括更新） |
Nonce フィールド: kishu_display_mapping_nonce（検証アクション: kishu_display_mapping_admin）
主な POST パラメータ
| フィールド | 操作 | 説明 |
|---|---|---|
kishu_display_mapping_id | update/delete | 対象 ID |
kishu_display_mapping_data_kishu | add/update | データ側機種名（必須、最大 255 文字相当の UTF-8 長チェック） |
kishu_display_mapping_display_kishu | add/update | 表示側機種名（必須、最大 255 文字相当の UTF-8 長チェック） |
kishu_display_mapping_heatmap_abbreviation | add/update | ヒートマップ略称（任意） |
kishu_display_migration_dry_run | apply_to_data | 1 のときドライラン（更新件数のみ報告） |
リダイレクト後クエリ（通知）
| クエリ | 内容 |
|---|---|
kdm_success | 1 / 0 |
kdm_msg | メッセージ（URL エンコード済みで渡る場合あり） |
編集モード GET
| GET パラメータ | 説明 |
|---|---|
kdm_edit | 編集対象行 ID |
データ
テーブル: db_kishu_display_mapping
| カラム | 説明 |
|---|---|
id | 主キー |
data_kishu | データ上の機種名 |
display_kishu | 表示用機種名 |
heatmap_abbreviation | ヒートマップ略称 |
created_at / updated_at | タイムスタンプ |
エラー
| 条件 | ユーザー向け挙動 | メッセージ / ログ |
|---|---|---|
| nonce 不正 | リダイレクト＋エラー | Messages::AUTH_FAILED |
| 必須項目空・長さ超過 | リダイレクト＋エラー | KISHU_DISPLAY_MAPPING_* 系 |
| 追加・更新時の重複等 | リダイレクト＋エラー | KISHU_DISPLAY_MAPPING_ADD_DUPLICATE 等 |
マイグレーション Throwable | リダイレクト＋エラー | KISHU_DISPLAY_MIGRATION_APPLY_FAILED |