「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つの質問
- テーマを替えたら、消えて困るか:困るなら、mu-pluginかプラグインに置く
- 管理画面で切り替えたいか。更新通知や有効化フックが必要か:必要なら、通常のプラグインにする
- mu-pluginに置くなら、理由と保守する人を記録したか:常に読み込まれ、一覧から切れないからこそ、記録を残す
置き場所は、一度決めると後から変えにくいものです。最初に基準を持っておくと、迷ったときの判断が安定します。
参考にした公式ドキュメント:
- Must-Use Plugins(Advanced Administration Handbook)
- xmlrpc_enabled(Code Reference)
- Required(Theme Review Handbook)
- Custom validation(Contact Form 7)
- Acceptance checkbox(Contact Form 7)
- Loading JavaScript and stylesheet only when it is necessary(Contact Form 7)
あわせて読みたい記事:
- 「プラグインが使えない」非WordPressサイトの迷惑メール対策——多層防御で600件のスパムを止めた設計思想
- 長期メンテナンス中、503を返し続けてはいけない理由——検索結果の表示を守るステータスコード設計
WordPressの設計・構築・運用まわりのご相談もお任せください。20年超のSIer経験をもとに、的確にサポートします。
▶︎ 制作・技術相談はこちら(Smile Creations お問い合わせフォーム)
▶︎ MENTAでのスポット相談はこちら