WordPressの自作プラグインの作り方：正しいやり方を初心者ができるように解説する初心者向けガイド

1. はじめに：自作プラグインって難しそう…？

WordPressを使っていると、

「この機能、自分で追加できたらいいのにな」
「テーマをいじるのは怖いけど、カスタマイズはしたい」

と思うこと、ありますよね。

そんなときに役立つのが 「自作プラグイン」 です。
プラグインというと「エンジニアしか無理」と思われがちですが、正しいやり方 を覚えれば、初心者ができるレベル のシンプルなプラグインなら十分作れます。

この記事は 完全初心者向け に、

WordPressの自作プラグインの作り方
正しいやり方（基本の流れ）
自作プラグインを Zip にまとめて「普通のプラグインと同じようにインストールする方法」

を、やさしく解説します。

2. 自作プラグインを作る前に知っておきたいこと

2-1. 必要なもの

最低限、次の3つがあればOKです。

WordPressが動いている環境
- ローカル環境（XAMPP / MAMP / Local など）推奨
- いきなり本番サーバーでテストするのはNG
テキストエディタ
- VS Code、Sublime Text、など
- メモ帳でも動きますが、コードが見づらいのであまりおすすめしません
PHPを少し触る覚悟
- 完璧に理解する必要はありません
- 「このコードを書くとこう動くらしい」くらいの気持ちでOK

2-2. なぜ「プラグイン」でカスタマイズするの？

WordPressのカスタマイズには、

テーマのfunctions.phpに直接書く
子テーマを作る
自作プラグインにする

などがありますが、おすすめは自作プラグインにまとめること です。

理由：

テーマを変更しても機能が消えない
コードがひとつのフォルダにまとまり、管理しやすい
不具合が起きたらプラグインだけ「無効化」して止められる

このやり方が「正しいやり方」と言われることが多いポイントです。

3. 自作プラグインの基本的な作り方（全体の流れ）

最初に、全体の流れをざっくり掴んでおきましょう。

wp-content/plugins/ フォルダの中に
自分のプラグイン用フォルダを作る
その中に メインのPHPファイル を作る
ファイルの先頭に「プラグイン情報（ヘッダー）」を書く
実際に動くコードを書く
管理画面の「プラグイン」から有効化する
必要なら Zip にまとめて、管理画面からアップロードインストールする

この型さえ覚えれば、あとは中身のコードを変えていくだけです。

4. 実際に作ってみよう：超シンプルな「挨拶メッセージ」プラグイン

ここでは例として、
「管理画面の上に”こんにちは！”というメッセージを表示するプラグイン」 を作ってみます。

4-1. プラグイン用フォルダを作る

WordPressをインストールしたフォルダを開く
wp-content → plugins とフォルダをたどる
my-first-plugin のような名前でフォルダを新規作成

例：
wp-content/plugins/my-first-plugin/

フォルダ名は英数字とハイフンにしておくと無難です。

4-2. メインのPHPファイルを作る

my-first-plugin フォルダの中に、
my-first-plugin.php という名前のファイルを作ります。

4-3. プラグイン情報（ヘッダー）を書く

作成した my-first-plugin.php をエディタで開き、先頭に以下を書きます。

<?php
/*
Plugin Name: My First Plugin
Description: 管理画面に「こんにちは！」と表示する、初心者向けの自作プラグインです。
Version: 1.0
Author: Your Name
*/

これが「プラグインヘッダー」と呼ばれるもので、
WordPressがこのファイルを「プラグインとして認識する」ために必要です。

Plugin Name: … プラグイン名（必須）
Description: … 説明文（任意だが書いておくと親切）

4-4. 実際に動くコードを書く（初心者向け）

次に、挨拶メッセージを表示する処理を書きます。
先ほどのコメントの下に、次のコードを追記してください。

// 管理画面の上部にメッセージを表示する関数
function my_first_plugin_admin_message() {
    echo '<div class="notice notice-success is-dismissible">';
    echo '<p>My First Plugin より：こんにちは！これは初心者が自作したプラグインのメッセージです。</p>';
    echo '</div>';
}

// 管理画面でメッセージを表示するフックに登録
add_action('admin_notices', 'my_first_plugin_admin_message');

ここでは、