トラブルシューティング

よくある問題の原因と対処法、そして技術仕様（DB スキーマ／REST API／nonce／フック一覧）を実装ベースで詳細にまとめています。

よくある問題と解決策

著者パネルが何も表示されない

原因: ID 指定が空、すべて無効値、指定 ID のエンティティが存在しない、またはブロック配置後に参照先エンティティが削除されたケース。

Custom モードの JSON-LD が出力されない

原因: ほぼ必ず以下のいずれかです。

ブロックエディタに登録済みエンティティが表示されない

原因: REST API の権限不足、または nonce の有効期限切れ。

使用中の記事セクションに表示されない

原因: KAPM_Database::get_posts_using_entity() の検出対象には制約があります。以下に該当する場合、参照されていても表示されません。

• post_status が publish 以外（下書き／非公開／予約投稿／ゴミ箱／revision）
• ショートコード [author_panel persons="..."] で配置した場合（ブロック属性の JSON 形式とパターンが一致しないため検出されない）
• ブロック属性の ID 文字列フォーマットが変則的な場合（通常の "persons":"1,2" 以外）

なお v1.0.1 から、Group / Columns / Row / Reusable ブロック内にネストされた kapm/author-panel も検出されるようになりました（v1.0.0 は top-level ブロックのみ走査）。

パネルのスタイルが壊れる・テーマと衝突する

原因: テーマ側の a タグや .wp-block-* への広範な CSS リセットが、パネル内のリンクやアイコンに波及しているケース。

sameAs のアイコンが汎用 Web アイコンになる

原因: 入力された URL のホスト名が 44 ドメインのマッピングのどれにも一致していないか、URL が FILTER_VALIDATE_URL を通過していない。

技術仕様: データベーススキーマ

プラグイン有効化時に KAPM_Database::create_tables() が dbDelta() で 3 テーブルを生成します。以下は class-database.php の実定義に基づく完全なカラム一覧です。{prefix} は WordPress の $wpdb->prefix（通常 wp_）に置換されます。

{prefix}apm_persons テーブル

{prefix}apm_corporations テーブル

{prefix}apm_organizations テーブル

カラム構成は apm_corporations と完全同一（同じ 10 カラム）ですが、別テーブルに保存されます。JSON-LD では Organization 型、apm_corporations は Corporation 型として出力される点だけが異なります。

技術仕様: REST API

ブロックエディタのサイドバーがエンティティ一覧を取得するための読み取り専用エンドポイントです。管理画面のリストは PHP 直接呼び出しで取得するため、REST API には依存しません。

技術仕様: nonce アクション名一覧

管理画面側の保存・削除処理は、すべて nonce 検証 + capability チェックで保護されています。以下が 6 種類の nonce アクション名とフィールド名です（トラブル切り分け時に URL や POST データを確認する際に使えます）。

これらに加え、管理画面全体は current_user_can('manage_options')（管理者権限）でガードされ、入力値は sanitize_text_field() / sanitize_textarea_field() / esc_url_raw() で保存時に無害化、出力時は esc_html() / esc_attr() / esc_url() でエスケープされます。

技術仕様: 登録フック一覧

本プラグインが登録している WordPress アクション／フィルタは以下のとおりです。トラブル時は WP_DEBUG + Query Monitor 等でフック実行順を確認してください。

技術仕様: フロントエンド資産

技術仕様: アンインストール挙動

DROP TABLE IF EXISTS {prefix}apm_persons;
DROP TABLE IF EXISTS {prefix}apm_corporations;
DROP TABLE IF EXISTS {prefix}apm_organizations;

技術仕様: 他プラグイン・テーマとの互換性

本プラグインは構造化データを「追加出力」する設計で、既存の投稿データ・タクソノミー・ユーザー情報には一切触りません。既知の互換性上の注意点は以下のとおりです。

技術仕様: パフォーマンス計測の観点

本プラグインの性能影響を確認する際は、以下の観点で計測してください。

動作要件と対応環境