トラブルシューティング
よくある問題とその解決方法をまとめています。
著者ボックスが表示されない
原因: 投稿タイプが有効化されていない、または著者プロフィールが未入力
1
設定画面で対象の投稿タイプにチェックが入っているか確認
2
ユーザー > プロフィール で著者データが入力されているか確認
3
テーマが the_content() フィルターを使用しているか確認
プラグインは投稿タイプごとにthe_content()の使用を自動検出します。カスタムテーマで独自のコンテンツ出力を使用している場合は、ショートコード [ksas_author] で手動挿入を検討してください。
JSON-LDスキーマが出力されない
原因: スキーマモードが「なし」に設定されている
1
設定画面の「スキーマ設定」タブを確認
2
「構造化データ（スキーマ）」で「スキーマなし」以外を選択
3
設定を保存
著者ボックスのスタイルがテーマと競合する
原因: テーマのCSSがプラグインのスタイルを上書きしている
1
プラグインのCSSは!importantで保護されているため、通常は競合しない
2
問題が発生する場合はブラウザの開発者ツールで競合箇所を特定
3
テーマのCSSで該当箇所を調整
プラグインのCSSファイル（assets/style.css）を直接編集すると、アップデート時に上書きされます。テーマ側のCSSで調整してください。
SNSアイコンが表示されない
原因: URLの形式が正しくない
1
プロフィール設定のSNS URL欄に正しいURLを入力しているか確認
2
URLは https:// から始まる完全なURLを入力する
3
1行に1つのURLを入力する
40以上のSNSサービスに対応しています。URLからサービスを自動検出してアイコンを表示します。
動作要件
| 項目 | 要件 |
|---|---|
| WordPress | 5.8以上 |
| PHP | 7.4以上 |
| 必要な拡張 | なし（WordPress標準ライブラリのみ使用） |
| 対応ブラウザ | モダンブラウザ（Chrome, Firefox, Safari, Edge） |
技術仕様
- データ保存: wp_usermeta（著者情報）、wp_options（プラグイン設定）
- カスタムテーブル: なし
- 外部通信: なし（全データローカル処理）
- Cronイベント: なし
- メール送信: なし
- セキュリティ: nonce検証、capability チェック、入出力サニタイズ
プラグインのアーキテクチャ
