トラブルシューティング
Kashiwazaki SEO Auto Tag Linker の使用中に発生しうる問題と対処法、動作要件、技術仕様について解説します。
よくある問題と対処法
タグリンクが表示されない
| 考えられる原因 | 対処法 |
|---|---|
| プラグインが有効化されていない | 管理画面の「プラグイン」一覧で、本プラグインが有効になっていることを確認してください。 |
| 投稿にタグが設定されていない | 投稿にタグが付与されていること、かつコンテンツ内にそのタグ名のテキストが含まれていることを確認してください。 |
| 最小文字数フィルタで除外されている | 対象タグの文字数が最小文字数の設定値以上であることを確認してください。 |
| 除外タグに登録されている | 設定画面の「除外タグ」リストに対象タグが含まれていないことを確認してください。 |
| 対象投稿タイプが無効になっている | 設定画面で該当する投稿タイプが有効になっていることを確認してください。 |
リンクスタイルが反映されない
| 考えられる原因 | 対処法 |
|---|---|
| テーマのCSSが上書きしている | ブラウザの開発者ツールで、テーマのCSSがリンクスタイルを上書きしていないか確認してください。 |
| キャッシュプラグインが古いCSSを配信している | キャッシュプラグインのキャッシュをクリアしてください。 |
テーマが wp_head() を呼び出していない |
テーマの header.php に <?php wp_head(); ?> が記述されていることを確認してください。 |
意図しないテキストがリンクに変換される
| 考えられる原因 | 対処法 |
|---|---|
| タグ名が一般的な単語と一致している | 該当タグを除外リストに追加するか、最小文字数フィルタを引き上げてください。 |
| 最大リンク数の設定が多すぎる | 1投稿あたりの最大リンク数を適切な値に減らしてください。 |
ページの表示速度が低下した
| 考えられる原因 | 対処法 |
|---|---|
| 大量のタグが登録されている | キャッシュ機能が有効であることを確認してください。不要なタグの整理も検討してください。 |
| キャッシュプラグインとの相互作用 | ページキャッシュプラグインを使用している場合、タグリンクの結果もキャッシュされるため、通常は速度低下は発生しません。 |
ヒント
問題が解決しない場合は、一度プラグインを無効化してから再有効化してみてください。設定値はデータベースに保持されるため、再有効化後も設定は維持されます。
動作要件
| 項目 | 要件 |
|---|---|
| WordPress | 5.0 以上 |
| PHP | 7.4 以上 |
| 対応ブラウザ | Chrome、Firefox、Safari、Edge（最新版） |
技術仕様
- データ保存: wp_options (ksatl_options)
- カスタムテーブル: なし
- 外部通信: なし
- Cronイベント: なし
- メール送信: なし
- セキュリティ: nonce検証、manage_options権限チェック、入出力サニタイズ
アーキテクチャ
Kashiwazaki SEO Auto Tag Linker は以下のコンポーネントで構成されています。
フロントエンド
- インラインCSSのみで動作（
wp_head経由で出力） - JavaScriptは一切使用せず、Core Web Vitalsへの影響をゼロに
the_contentフィルタでタグリンクを動的に挿入
バックエンド
- 設定データは
wp_optionsテーブルにksatl_optionsキーで一元管理 - タグデータのキャッシュにより繰り返しのデータベースクエリを削減
- 管理画面は
manage_options権限のユーザーのみアクセス可能 - すべてのフォーム送信に nonce 検証を実施
リンク変換フロー
1
the_content フィルタがトリガーされると、投稿のタグ一覧をキャッシュから取得します。
2
除外リスト・最小文字数・セルフリンク防止のフィルタを適用し、有効なタグのみを抽出します。
3
コンテンツ内でタグ名をテキスト検索し、HTMLタグ内の一致を除外した上で、最大リンク数まで変換を実行します。
4
変換後のコンテンツを返却し、設定されたリンクスタイルがインラインCSSとして適用されます。
補足
カスタムテーブルやCronイベントは使用しないため、プラグインの削除時にデータベースに不要なデータが残ることはありません。wp_options の設定値のみが削除対象です。