エンティティ管理

Person（個人）／ Corporation（企業）／ Organization（組織）の 3 種類のエンティティを、独立した 3 テーブルで管理します。各タブで全フィールドを個別に登録・編集・削除できます。

本プラグインの管理画面は admin.php?page=kapm に配置され、上部のナビゲーションタブで 3 つのエンティティ種別を切り替えます。デフォルトは Person タブで、URL クエリ &tab=corporation / &tab=organization で切り替わります。エンティティはすべて独立したカスタムテーブルに保存され、WordPress ユーザーとは関連付きません。

管理画面の共通操作

Person（個人）タブ

Person タブは、記事の執筆者・レビュアー・編集者など「個人」を登録するためのタブです。ここで登録したエンティティはブロックエディタや [author_panel] ショートコードから Person の ID で参照され、Schema.org の Person 型 JSON-LD として出力されます。

Person 編集画面。下部に「パネルのデザイン」「パネルのカラー」があり、カラーを「カスタム」にすると背景色・文字色・アクセント色のカラーピッカーが表示されます

Person の全フィールド（13 項目）

Person 登録フォーム（admin/views/person-form.php）の全フィールドと、対応する DB カラム・型・既定値・未入力時の挙動を以下にまとめます。

Person の Role フィールド推奨値

Role は自由入力テキストですが、ツールチップでは以下の 8 種類の値が推奨されています。ここに載っていない文字列を入れても保存は通りますが、Custom モードの JSON-LD 変換では未定義値として扱われます（既定の author にマップされる）。

Corporation（企業）タブ

Corporation タブは、記事の発行元や運営会社などの企業法人を登録するタブです。ここで登録したエンティティは Schema.org の Corporation 型として JSON-LD 出力されます。Corporation は Organization のサブタイプで、営利法人であることをより明示できます。

Corporation の基本フィールド（12 項目）

Corporation のフォーム（admin/views/corporation-form.php）は Person から job_title / bio / image_url を取り除き、description（説明）と logo_url（ロゴ画像）に置き換えた構成になっています。

このほか、住所・電話番号・メール・法人情報などの任意項目が 20 あります（v1.0.4 で追加）。住所・連絡先・法人情報を参照してください。

Corporation の Role フィールド推奨値

Corporation/Organization のツールチップでは、記事発行元という主な用途に合わせて 5 種類のみを推奨しています。Person と同様、未定義値は author にマップされます。

Organization（組織）タブ

Organization タブは、研究機関・業界団体・非営利組織・運営メディアなど、Corporation 以外の組織を登録するためのタブです。Schema.org の Organization 型として JSON-LD 出力されます。

Organization の基本フィールド（12 項目）

Organization のフォーム（admin/views/organization-form.php）のカラム構成は Corporation と完全に同一ですが、独立した DB テーブル {prefix}apm_organizations に保存され、Schema.org の型も異なります。Corporation と混在させず、営利法人以外は必ず Organization タブで登録してください。

このほか、住所・電話番号・メール・法人情報などの任意項目が 20 あります（v1.0.4 で追加）。住所・連絡先・法人情報を参照してください。

住所・連絡先・法人情報（Corporation / Organization 共通）

Corporation と Organization の編集画面には、基本の項目の下に「住所・電話番号」「メール・問い合わせ窓口」「法人情報」の 3 つのまとまりがあります（v1.0.4 で追加）。どれも任意で、空欄の項目は出力しません。入力した項目はすべて構造化データ（JSON-LD）に出力します。パネルでは、住所と電話番号を説明文の下に表示し、入力した項目の一覧を名前の横の i ボタンの吹き出しに表示します。Person にはこの項目はありません。

Corporation 編集画面の下部。Organization の編集画面にも同じ項目があります

項目一覧（20 項目）

DB の列はすべて varchar(255) NOT NULL、既定値は '' です。

出力のきまり

• 住所（address）は、郵便番号・都道府県・市区町村・番地・建物名のどれか 1 つでも入っているときだけ出力します。国コードだけでは出力しません（国コードには既定で JP が入るため）。
• 問い合わせ窓口（contactPoint）は、窓口の電話番号かメールアドレスがあるときだけ出力します。窓口の種類だけでは出力しません。
• 従業員数は、人数なら value、範囲なら minValue / maxValue で出力します。
• 書式が決まっている項目（国コード・メールアドレス・設立日・従業員数）に合わない値を入れて保存すると、その項目は空欄で保存され、画面上部に「「〇〇」は書式が正しくないため、空欄として保存しました。」と表示されます。国コード・メールアドレス・設立日は、保存する前にブラウザも書式を確認します。

パネルでの表示

住所と電話番号は説明文の下に表示され、名前の横に i ボタンが付きます

住所は、地図ピンのアイコン付きで 1 行にまとめて表示します。国コードが JP か空欄なら「〒郵便番号 都道府県市区町村番地・建物名」、それ以外の国なら「番地, 市区町村, 州 郵便番号」の順です。電話番号は受話器のアイコン付きで、入力したとおりの文字で表示し、タップすると電話をかけられるリンク（tel:）にします。アイコンには読み上げ用の名前（「住所」「電話番号」）が付いています。

名前の横の吹き出し（i ボタン）

i ボタンにマウスを乗せると、入力した項目の一覧が吹き出しで出ます

住所・連絡先・法人情報のどれかが入力されていると、名前の横に i ボタン（dashicons-info-outline）が付きます。ボタンにマウスを乗せるか、タップするか、キーボードで移動すると、入力した項目の「項目名」と「内容」の一覧が吹き出しで出ます。国コードしか入っていない場合（既定の JP だけの場合）は、ボタンは出ません。

• 並びは入力画面と同じです。住所は 1 行にまとめ、設立日は「2012年6月26日」、従業員数は「50人」「100〜999人」の形で表示します。国コードは住所の書き方の切り替えにだけ使い、一覧には出しません。
• 吹き出しは、名前の行のすぐ下に、パネルの情報欄（名前・説明文の列）の幅いっぱいで出します。i ボタンの位置に合わせないので、名前が長くても画面からはみ出しません。画面幅が 600px 以下のときは、項目名と内容を縦に並べます。
• 吹き出しは role="tooltip" で、ボタンから aria-describedby で参照しています。Esc キーで閉じられます。この Esc の処理だけは小さなスクリプト（ハンドル kapm-panel-info、フッターにインライン出力）で行い、吹き出しのあるパネルを出したページにだけ読み込みます。表示自体は CSS だけで行います。

JSON-LD の出力例

すべての項目を入力した Corporation の出力（整形済み、ほかの項目は省略）:

{
  "@type": "Corporation",
  "@id": "https://example.com/#corporation-2",
  "name": "株式会社サンプル",
  "url": "https://example.com/",
  "legalName": "Sample Kabushiki Kaisha",
  "email": "info@example.com",
  "telephone": "+81-3-1234-5678",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "千代田1-1 サンプルビル5F",
    "addressLocality": "千代田区",
    "addressRegion": "東京都",
    "postalCode": "100-0001",
    "addressCountry": "JP"
  },
  "contactPoint": {
    "@type": "ContactPoint",
    "contactType": "Customer Service",
    "telephone": "+81-3-1234-0000",
    "email": "support@example.com"
  },
  "foundingDate": "2012-06-26",
  "numberOfEmployees": {
    "@type": "QuantitativeValue",
    "minValue": 100,
    "maxValue": 999
  },
  "taxID": "1234567890123",
  "vatID": "T1234567890123",
  "iso6523Code": "0199:724500PMK2A2M1SQQ228",
  "duns": "123456789",
  "leiCode": "724500PMK2A2M1SQQ228",
  "globalLocationNumber": "4512345678906",
  "naics": "541810"
}

Role から Schema.org プロパティへの変換（role_to_property）

Custom モード（他プラグインの既存スキーマに著者情報を紐付ける出力方式）では、各エンティティの role フィールド値が class-shortcode.php の role_to_property() メソッドで Schema.org のプロパティ名に変換され、対象ノードに付与されます。対応表は以下のとおりです（大文字小文字は区別されません）。

パネルのデザインとカラー

各エンティティの HTML パネルの見た目は、「パネルのデザイン」（形）と「パネルのカラー」（色）の 2 項目で決まります。v1.0.2 までは 1 つの「パネルデザイン」に形と色（Dark）が混在していましたが、v1.0.3 で 2 項目に分けました。形と色を別々に選べるため、たとえば「カードの形でダーク」のような組み合わせも選べます。CSS は public/css/panel-style.css に定義されており、表示に JavaScript は使用しません。

デザインとカラーの組み合わせ見本（上から 標準・アクセント・ミニマル・カード × おまかせ、標準 × ダーク、カード × ブルー、アクセント × グリーン、アクセント × オレンジ、カード × カスタム）

パネルのデザイン（panel_style）— 形

パネルのカラー（panel_color）— 色

カスタムカラーの指定

「パネルのカラー」で カスタム（色を指定） を選ぶと、その下に 背景色・文字色・アクセント色 の 3 つのカラーピッカーが表示されます（ほかのカラーを選んでいる間は非表示）。指定した色は、カードの style 属性に CSS 変数（--kapm-bg / --kapm-text / --kapm-name / --kapm-accent）として出力されます。

• 背景色：パネルの背景
• 文字色：名前・肩書き・紹介文などの文字。名前の色にも使われます
• アクセント色：アクセント（左の太線）やカードのラベル、SNS アイコンにマウスを重ねたときの色

空のままにした色は既定値（背景 #ffffff・文字 #333333・アクセント #0073aa）になります。文字が読みにくくならないよう、背景色と文字色の明るさに十分な差をつけてください。

使用中の記事の確認

Person / Corporation / Organization の 編集画面下部に「使用中の記事」セクションが表示されます。そのエンティティを参照している投稿を自動検出して一覧表示する機能で、削除前の影響範囲確認に使えます。

実装は KAPM_Database::get_posts_using_entity() にあり、2 段階で記事を絞り込みます。

保存・削除処理のセキュリティ

3 つのエンティティすべてに対して、保存と削除のたびに nonce 検証と capability チェックが行われます。具体的なアクション名は以下のとおりです。

アンインストール時のデータ削除