WordPress mu-plugin の作り方 • WP STAGING

WordPress 用に「mu-plugin」(must-use プラグイン) を作成すると、重要な機能をサイト上で常に有効な状態に保つことができます。このプラグインは自動的に有効化され、WordPress ダッシュボードから無効化することはできないため、必須の機能やカスタマイズに最適です。

mu-plugin のもう一つの活用例は、プラグインや WordPress コアに機能を追加することです。たとえば、WP Staging には多数のフィルターおよびフックが用意されており、WP Staging のステージングやバックアップ機能をさらに拡張できます。これらドキュメント化されたフィルターはすべて、独自の mu-plugin に組み込むことができます。

Must-Use プラグインの概要

mu-plugin、つまり「must-use」プラグインは、WordPress プラグインの特別な種類です。専用のディレクトリ (wp-content/mu-plugins) に格納され、WordPress によって自動的に読み込まれます。サイトのカスタム関数など、常に実行する必要があるコードに最適で、誤って無効化される心配がありません。

Mu-Plugin の利点

自動有効化: mu-plugin は自動的に有効化され、誤って無効化されることはありません。
セキュリティの向上: 管理画面から無効化できないため、重要な機能をより安全な方法で実装できます。
管理のしやすさ: 必須プラグインのメンテナンスがシンプルになるため、複数の WordPress サイトを運用する際に特に便利です。

Mu-Plugin の作成

1. サイトのファイルにアクセスする

FTP または Web ホストのファイルマネージャーを使って、サイトのファイルにアクセスします。

2. Mu-Plugin ディレクトリを探す

wp-content ディレクトリに移動します。
mu-plugins フォルダがあるか確認します。存在しない場合は作成してください。

3. Mu-Plugin ファイルを作成する

mu-plugin 用に新しい PHP ファイルを作成します。例: my-mu-plugin.php。
シンプルなテキストエディタを使って PHP コードを記述します。

4. Mu-Plugin にコードを追加する

mu-plugin は PHP の開始タグ <?php で始める必要があります。
以下は mu-plugin ファイルの基本的な構造です:

PHP

<?php
/*
Plugin Name: My Custom Mu-Plugin
Description: A custom must-use plugin to enhance my WordPress site.
Version: 1.0
Author: Mickey Mouse
*/

// Your custom code goes here

ステップ 5: Mu-Plugin をアップロードする

作成した .php ファイルをサーバー上の mu-plugins ディレクトリにアップロードします。

ステップ 6: 有効化を確認する

mu-plugin は自動的に有効化されるため、サイトを開いて独自コードが正しく動作しているか確認します。

サンプル Mu-Plugin: 管理画面フッターのカスタムテキスト

例として、WordPress 管理画面のフッターテキストを変更するシンプルな mu-plugin を作ってみましょう。

PHP

<?php
/*
Plugin Name: Custom Admin Footer
Description: Changes the footer text in the WordPress admin area.
Version: 1.0
Author: Your Name
*/

add_filter('admin_footer_text', function () {
    echo 'Customized by Tony Stark - Powered by WordPress';
});