本文へスキップ
TYP create

WordPressのプラグインが動かないときはここを確認してみよう

WordPress
WordPressのプラグインが動かないときはここを確認してみよう

WordPressは様々な拡張機能をプラグインを利用するだけで簡単に実装することが出来るので、コーディング初心者の方でも導入しやすいCMSですね。そんな便利なWordPressのプラグインたちですが、プラグイン情報をWordPressが出力するためには必須となるWordPressの記述があります。「設定をしたのにプラグインが動かない!」といった現象が起きた場合の対処法として、記述が必須となるwp_head();とwp_footer();の使い方をご紹介します。

先にポイント:動かないときは、2つの関数を確認

  1. wp_head();とwp_footer();がテーマにあるか確認:プラグインが動くための目印になります
  2. 書く位置も大切です:それぞれ決まった場所に書かないと、動かないことがあります
  3. 書いてあるのに動かないときは:チェックポイントを順に確認しましょう

「wp_head();」と「wp_footer();」を記述する位置

結論から言いますと、WordPressではheader.phpにwp_head、footer.phpにwp_footerを記述してあげないとプラグインが正常に動きません。この二つはWordPress側が持っている情報を自身のサイト内に出力してくれるとても重要な役割を持っているのです。

それぞれ出力される情報自体は、適用しているプラグインによって様々ですが、この二つはセットで覚えておきましょう。

wp_head();

【外観>テーマファイルエディター】から現在有効化しているWordPressテーマのheader.phpを開きます。

<!-- 略 -->

<?php wp_head(); ?>
</head>

<?php wp_head(); ?>は</head>の直前に挿入します。

さらに詳しい説明はWordPress公式リファレンス「wp_head()」を参照してみてください。

wp_footer();

同じく【外観>テーマエディター】からfooter.phpを開きます。

<!-- 略 -->

<?php wp_footer(); ?>
</body>
</html>

<?php wp_footer(); ?>は</body>の直前に挿入します。

さらに詳しい説明はWordPress公式リファレンス「wp_footer()」を参照してみてください。

書いてあるのに動かないときのチェックポイント

wp_head();とwp_footer();が正しく書かれているのに動かないときは、次の順番で原因を切り分けてみましょう。

  1. キャッシュを削除する:ブラウザやキャッシュ系プラグイン、サーバーのキャッシュが残っていると、変更が反映されないことがあります。
  2. プラグイン同士の競合を確認する:ほかのプラグインをいったんすべて停止し、1つずつ有効化して、どの組み合わせで動かなくなるかを確かめます。
  3. テーマを一時的に切り替える:WordPressの標準テーマで動く場合は、使っているテーマ側に原因があります。
  4. PHPのバージョンを確認する:古いプラグインは、新しいPHPに対応していないことがあります。プラグインの対応バージョンを確認しましょう。
  5. デバッグモードでエラーを確認する:wp-config.phpのWP_DEBUGをtrueにすると、エラーの内容が表示されます。確認が終わったら、必ずfalseに戻しましょう。

あわせて書いておきたい「wp_body_open();」

WordPress 5.2からは、<body>タグの直後にwp_body_open();を書くことが推奨されています。Googleタグマネージャーのように、body直後にコードを出力するプラグインが、この記述を使います。

<body <?php body_class(); ?>>
<?php wp_body_open(); ?>

気になるギモン

ブロックテーマでもwp_head();とwp_footer();は必要ですか?

ブロックテーマ(フルサイト編集のテーマ)では、WordPressが自動で出力するため、自分で書く必要はありません。header.phpとfooter.phpを使うクラシックテーマの場合に必要です。

wp_head();を書く場所を間違えるとどうなりますか?

</head>の直前以外に書くと、CSSやJavaScriptの読み込み順がずれて、表示が崩れたり、プラグインが正しく動かなかったりします。

子テーマを使っている場合は、どのファイルを確認すればいいですか?

子テーマにheader.phpやfooter.phpがあれば子テーマ側を、なければ親テーマ側のファイルを確認しましょう。

まとめ

「プラグインを有効化したのに動かない」「エラーが出てしまう」といったトラブルの時には、wp_head();とwp_footer();が正確に記述されているか、しっかり確認してみましょう。

関連する記事もあわせてどうぞ。

人気記事