その処理、テーマに書いて大丈夫? mu-pluginとテーマの使い分けの判断基準

「functions.phpが長くなってきた。この処理、テーマに書いてよいのだろうか」

WordPressでサイトを作っていると、こうした迷いが必ず出てきます。置き場所の候補は、テーマ、通常のプラグイン、そして mu-plugin の3つです。

この記事では、置き場所を決める判断基準と、mu-pluginを使うときの注意点を、公式ドキュメントで確認した内容とあわせて整理します。

先に結論:「テーマを替えたら消えて困るか」で決める

  • テーマを替えたら消えて困る:mu-plugin(またはプラグイン)に置く
  • 消えても困らない(見た目や表示に関わる):テーマに置く

この一文は、筆者が実務で使っている判断基準です。公式ドキュメントがこの形で定めているわけではありません。以下、その理由を順に見ていきます。


1. 判断基準:「テーマを替えたら消えて困るか」

テーマは、サイトの見た目を担当する部品です。デザインの刷新などで、将来差し替える可能性があります。

そのテーマの functions.php に「サイトの動き」まで書いておくと、テーマを替えた瞬間に、その動きも一緒になくなります。しかも、エラーが出るとは限らないので、気づきにくいのが厄介なところです。

公式にも近い線引きがある

WordPress.orgのテーマ審査要件では、デザインや表示と関係のない機能をテーマに含めないよう求めています。カスタム投稿タイプやショートコードは含めないものとして挙げられ、コンタクトフォームやアクセス解析は、プラグインの領域の例として挙げられています。

ただし、これはWordPress.orgのテーマディレクトリに登録するテーマ向けの審査要件です。自分のサイトで使うテーマが従う義務はありません。あくまで、考え方の参考として見てください。

2. mu-pluginとは何か

mu-plugin(Must-Use Plugin)は、wp-content/mu-plugins に置いたPHPファイルが、自動で有効になる仕組みです。

  • 管理画面のプラグイン一覧では、通常のリストには出ず、「Must-Use」という別の区分に表示されます
  • 管理画面からは無効にできません。無効にするには、ファイルを削除します
  • 通常のプラグインより先に読み込まれます(アルファベット順)。そのため、mu-pluginで追加したフックは、他のプラグインにも効きます

3. 通常のプラグインではなく、mu-pluginを選ぶ場面

公式ドキュメントは、mu-pluginを「常に動かすべきで、管理画面から誤って無効化されたくないコード」に向くものとして説明しています。

mu-pluginに向くmu-pluginに向かない
ホスト固有の連携(キャッシュ、監視など)管理画面で有効化・無効化したいもの
通常のプラグインより前に読み込む必要がある、サイト固有の初期化コード有効化・無効化・アンインストールのフックに依存するもの
サイト全体で常に有効にしておきたい、セキュリティ・パフォーマンス・保守の機能通常のプラグインのような更新通知が必要なもの
配布して、通常のプラグインとして管理するもの
サイトの管理者が、任意で切れるべきもの

4. mu-pluginの落とし穴

便利な反面、公式ドキュメントが注意点として挙げているものがあります。

  • 更新通知が出ない:更新の把握と作業は、自分で行う必要があります
  • 有効化フックが実行されない:有効化時のセットアップ処理に頼るコードは、正しく動かないことがあります
  • サブフォルダの中は、自動では読み込まれない:mu-pluginsの直下にあるPHPファイルだけが対象です

3つ目は、直下に「ローダー」となる小さなPHPファイルを置いて、サブフォルダ内のファイルを読み込ませる形で対処できます。

wp-content/
  mu-plugins/
    load.php
    site-core/
      site-core.php
<?php // mu-plugins/load.php
require WPMU_PLUGIN_DIR . '/site-core/site-core.php';

もうひとつ、大事な注意があります。mu-pluginは常に読み込まれるため、壊れるとサイト全体に影響します。また、乗っ取られた場合も、通常のプラグイン一覧から切れないので、気づきにくくなります。公式ドキュメントは、小さく保つこと、そして、なぜ存在するのか・誰が保守するのか・どう更新するのかを記録しておくことを勧めています。

5. 置き場所の仕分け例

判断基準にしたがって分けると、たとえば次のようになります。

種類置き場所例
見た目・表示テーマCSS・JSの読み込み、titleタグ、パンくずの表示、固定ページの見せ方、フォームのラベルやHTML
サイトの動きmu-pluginフォームの迷惑メール対策、コメント機能の停止、XML-RPCの制御、フォーム入力の検証

これはあくまで一例です。迷ったときは、「テーマを替えたら消えて困るか」に立ち戻って判断します。

6. 境界線上の例

実際には、どちらとも言い切れない処理があります。3つ、取り上げます。

例1:プライバシーポリシーへの同意チェックの検証

Contact Form 7では、同意チェックを標準の acceptance タグで作れます。公式ドキュメントによると、既定で必須項目として動き、チェックしないと送信できません。まずは、標準の機能で足りないかを確認するのが先です。

標準で足りない要件があり、検証のコードを自作する場合は、置き場所が問題になります。Contact Form 7の検証は、フィルターとして実装されています。フック名は wpcf7_validate_ に、form-tagの種類名をつないだ形です。

この検証は、見た目ではなく「フォームの動き」にあたります。functions.php に書いてしまうと、テーマを替えたときに検証が外れますが、画面上は何も変わらないので、気づきにくいでしょう。そこで、検証は mu-plugin に置き、ラベルや文言といったHTMLの部品だけをテーマに残す形が考えられます。

例2:Contact Form 7のJS・CSSの読み込み

Contact Form 7は、既定ではJSとCSSを全ページで読み込みます。公式ドキュメントでは、これを止める方法として、定数(WPCF7_LOAD_JS と WPCF7_LOAD_CSS を false にする)か、フィルター(wpcf7_load_js と wpcf7_load_css を false にする)を案内しています。

ただし、止めると、フォームのあるページでも読み込まれなくなります。そのため、フォームのあるページで、wpcf7_enqueue_scripts() と wpcf7_enqueue_styles() を呼ぶ必要があります。これは wp_head() より前に呼ぶ決まりです。

公式の例は、どちらもテーマ側に書く形です。止める処理を mu-plugin に置き、呼び出しをテーマに置くと、フォームの動作が、そのテーマに依存することになります。テーマを替えると、フォームが動かなくなるかもしれません。

対処は2つ考えられます。ひとつは、止める処理と呼び出しを、同じ場所にまとめることです。依存が1か所に収まります。もうひとつは、分けたまま、「このフォームはテーマ側の読み込みに依存している」と、mu-pluginのコメントなどに記録しておくことです。

例3:XML-RPCの停止

XML-RPCを止めたいときは、xmlrpc_enabled フィルターを使います。ただし、公式のリファレンスには、名前に反して、このフィルターが制御するのは「認証が必要なメソッド」だけだと明記されています。ピンバックなど、認証が不要なものは対象外です。

「止めたつもり」にならないよう、注意が必要です。より細かく制御したい場合は、xmlrpc_methods や xmlrpc_element_limit といったフックが案内されています。置き場所は、サイトの動きなので mu-plugin です。

まとめ:置き場所を決める3つの質問

  1. テーマを替えたら、消えて困るか:困るなら、mu-pluginかプラグインに置く
  2. 管理画面で切り替えたいか。更新通知や有効化フックが必要か:必要なら、通常のプラグインにする
  3. mu-pluginに置くなら、理由と保守する人を記録したか:常に読み込まれ、一覧から切れないからこそ、記録を残す

置き場所は、一度決めると後から変えにくいものです。最初に基準を持っておくと、迷ったときの判断が安定します。

参考にした公式ドキュメント:

あわせて読みたい記事:


WordPressの設計・構築・運用まわりのご相談もお任せください。20年超のSIer経験をもとに、的確にサポートします。

▶︎ 制作・技術相談はこちら(Smile Creations お問い合わせフォーム)
▶︎ MENTAでのスポット相談はこちら

記事一覧に戻る