WordPressプラグインの作り方を徹底解説！はじめての開発入門

この記事ではWordPressでのプラグインの作り方を開発の入門として分かりやすく解説します。

WordPressプラグイン開発の入口｜最初に知っておきたいこと

まず押さえたい！ プラグインとテーマの違い

それに対してプラグインは、サイトに新しい機能を追加するためのものです。たとえば、次のように整理するとイメージしやすいです。

項目	テーマ	プラグイン
主な役割	見た目を整える	機能を追加する
例	色、レイアウト、デザイン	お問い合わせ、検索強化、独自機能
テーマ変更時	変わることが多い	基本的に残したい
向いている内容	表示の調整	再利用したい機能

私は初心者の方に説明するとき、テーマは洋服、プラグインは道具箱のようなものですとお伝えすることがあります。

洋服を着替えても、道具箱の中身はそのまま使えたほうが便利です。

そのため、長く使いたい機能はプラグインとして分けておくと管理しやすくなります。

functions.phpに書くのと何が違う？

WordPressに少し触れたことがある方ほど、functions.phpに書けばよいのではと感じるかもしれません。

たしかに小さな調整ならfunctions.phpでも動きます。

ただ、機能として育てていくなら、最初からプラグインにしておいたほうが安心です。

主な理由は次の通りです。

• テーマを変えても機能が残りやすいです
• 機能ごとに整理しやすいです
• 不具合が出たときに切り分けしやすいです
• ほかのサイトでも再利用しやすいです

たとえば、管理画面に独自の設定を追加したい場合、最初は小さなコードでも、あとから保存項目や表示条件が増えていくことがあります。

そのときfunctions.phpだと、テーマ関連の処理と混ざって見づらくなりがちです。

最初からプラグインとして分けておくと、後で自分が見返したときもかなり楽になります。

作り方の基本は「小さく作って育てる」

プラグイン開発の入門でいちばん大切なのは、最初から完璧を目指さないことです。

はじめは本当に小さな機能で十分です。

おすすめの進め方は次の順番です。

• まずは1ファイルで動く最小構成を作る
• 管理画面で有効化できることを確認する
• フックを1つ使って簡単な動作を追加する
• 設定画面や保存機能をあとから足す
• 必要に応じてファイルを分ける

この順番にすると、どこでつまずいたのかが分かりやすくなります。

逆に、いきなり設定画面、データ保存、見た目の調整まで同時に始めると、エラーの原因が見えにくくなります。

作る前にここを整える｜開発を始める前の準備

先にそろえたい開発環境

特に用意しておきたいものは次の通りです。

準備するもの	役割	初心者へのおすすめ度
テスト用WordPress環境	安全に試す場所	高い
コードエディタ	ファイルを編集する	高い
バックアップ手段	失敗したときに戻す	高い
メモ帳や設計メモ	機能や流れを整理する	中くらい

本番サイトで直接試すと、画面が真っ白になったり、管理画面に入れなくなったりすることがあります。少し大げさに聞こえるかもしれませんが、初心者のうちは本当によくあることです。

だからこそ、まずは安心して失敗できる場所を用意することが大切です。

フォルダとファイルの基本をイメージする

開発入門では、ファイルの置き場所を知るだけでも大きな一歩です。基本は、WordPressの中にあるpluginsフォルダへ、自分のプラグイン専用フォルダを作ります。

イメージは次のようになります。

• pluginsフォルダの中に、自作プラグイン用のフォルダを作る
• その中にメインとなるPHPファイルを置く
• 必要に応じて、画像やCSS、JavaScript用のフォルダを分ける

最初の段階では、ファイルを増やしすぎないほうが分かりやすいです。

私は学習の最初は、メインファイルひとつで動く形から入るのがいちばん理解しやすいと感じています。

最初に決めておくと迷いにくい3つのこと

開発前に次の3つを決めておくと、途中でぶれにくくなります。

• このプラグインで何をしたいか
• 管理画面が必要かどうか
• 自分だけで使うのか、ほかのサイトでも使いたいのか

たとえば、記事の最後に定型文を表示したいだけなら、かなりシンプルな構成で始められます。一方で、入力内容を管理画面から変更したいなら、設定を保存する仕組みも必要です。

最初に目的を短く言葉にしておくだけで、必要な機能が見えやすくなります。

まずはここから｜動くプラグインを最小構成で作る

最小構成の流れをつかむ

最初の成功体験を作るなら、流れをシンプルに覚えるのが近道です。

基本の流れは次の通りです。

1. プラグイン用フォルダを作る
2. メインのPHPファイルを作る
3. プラグイン情報を書く
4. 管理画面で有効化する
5. 小さな機能を1つ追加する

この段階では、見た目のきれいさより、管理画面で認識されることが大事です。

最初の目標は、動くことを確認することです。

プラグイン情報は「名札」だと考える

WordPressでは、プラグインの名前や説明が分かる情報を書いておく必要があります。

これはプラグインの名札のようなものです。

ここで意識したいポイントは次の通りです。

• 名前が分かりやすいこと
• 役割が短く伝わること
• 自分で見返しても区別しやすいこと

初心者のうちは、ファイル名やフォルダ名を何となく付けてしまいがちです。

ですが、あとから複数のプラグインを触るようになると、名前が整理されているだけでかなり助かります。

最初の機能は「小さくて結果が見えるもの」にする

最初に作る機能は、目に見えて変化が分かるものがおすすめです。

たとえば次のような内容です。

最初の題材	分かりやすさ	難しさ
管理画面にメッセージを表示	高い	低い
記事の末尾に定型文を追加	高い	低い
ショートコードで文字を表示	高い	低い
設定ページを作る	中くらい	中くらい

私は入門記事を書くとき、最初の題材として記事末尾への一文追加をよくおすすめします。理由は、投稿画面でも確認しやすく、フックの考え方もつかみやすいからです。

変化が見えると、プラグイン開発への苦手意識がぐっと下がります。

ここが分かると一気に楽になる｜開発の基本ルール

フックは「途中に差し込む仕組み」

大きく分けると2種類あります。

• アクション
• フィルター

アクションは、何かのタイミングで処理を実行したいときに使います。

フィルターは、もとの内容を少し変えて返したいときに使います。

この違いが分かるだけで、コードの見え方がかなり変わります。

アクションとフィルターの違い

違いをざっくり整理すると、次の表のようになります。

種類	向いていること	例
アクション	何かを実行する	管理画面にメニューを追加する
フィルター	もとの内容を変える	記事本文の末尾に文を足す

初心者の方は、まずこの2つを厳密に覚えようとしなくても大丈夫です。

動きを見ながら、追加する系はアクション、書き換える系はフィルターと考えると入りやすいです。

有効化と停止の考え方も知っておく

プラグインは、使い始めるときと、止めるときに特別な処理をしたい場面があります。

たとえば次のようなケースです。

• 有効化したタイミングで初期設定を作る
• 停止したタイミングで一時データを整理する

ここで大切なのは、何でも自動で消せばよいわけではないことです。

ユーザーが保存した大事なデータまで消してしまうと困ります。

そのため、何を残して何を片づけるかは、最初に考えておきたいところです。

ここまでできると実用的｜よく使う機能を足していく

管理画面に設定ページを追加する

設定ページでよくある項目は次の通りです。

• 表示する文章
• 表示する場所
• オンオフの切り替え
• 色や見出しの簡単な設定

たとえば、記事の末尾に定型文を表示するプラグインなら、表示文を管理画面で変えられるだけでもかなり実用的になります。

自作プラグインが、ただの練習ではなく、ふだん使える道具に変わる瞬間です。

保存機能は「入れる前に整える」が大事

設定ページを作ると、次は保存機能が必要になります。ここで大切なのは、入力された内容をそのまま使わないことです。なぜなら、入力欄には思わぬ文字や不要な内容が入ることがあるからです。安全に扱うためには、保存前に内容を整える考え方が必要です。

意識したい流れは次の通りです。

流れ	何をするか	目的
入力	ユーザーが値を入れる	情報を受け取る
整理	不要なものを取り除く	安全性を高める
保存	必要な形で記録する	再利用できるようにする
表示	画面に出す	ユーザーに見せる

この流れを理解しておくと、あとで不具合やトラブルが減ります。

初心者のうちから、保存前に整える、表示前にも注意するという意識を持っておくと強いです。

ショートコードで使いやすくする

入門で人気が高いのが、ショートコードです。

ショートコードを使うと、記事や固定ページの中に、決まった機能を簡単に呼び出せます。

ショートコードが向いている例は次の通りです。

• お知らせボックスを表示する
• 定型文を差し込む
• プロフィールを呼び出す
• 注意書きを目立つ形で出す

記事ごとに使い分けたい機能は、ショートコードと相性が良いです。

管理画面設定だけでは足りない場面でも、呼び出す場所を柔軟に選べます。

安心して育てるために｜安全に作る基本ルール

直接アクセスを防ぐ意識を持つ

WordPressの流れの中で呼ばれているのか、それとも外から急に開かれているのかを見分けるということです。こうした基本の守りを入れておくと、安心してプラグインを育てやすくなります。

権限チェックと確認の仕組みを忘れない

設定の保存や管理画面の操作では、その人が本当に変更してよいかを確かめる必要があります。

ここを省くと、見えないところで危険が増えます。

最低限意識したいことは次の通りです。

• 管理者など、操作してよい人だけに制限する
• 正しい画面から送られた操作かを確認する
• 不自然なデータは受け取らない

私はこの部分を、家の鍵とインターホンにたとえることがあります。

権限チェックは鍵で、確認の仕組みはインターホンです。

どちらか片方だけでは不安が残るので、セットで考えるのが大切です。

表示するときも安全を意識する

保存するときだけでなく、画面に表示するときも注意が必要です。

たとえば、入力された内容をそのまま表示すると、思わぬ表示崩れやトラブルの原因になることがあります。

安全に作るために意識したいのは次の3点です。

• 入力時に整える
• 保存時に必要な形へそろえる
• 表示時に見せ方を安全にする

この3つは最初はややこしく感じるかもしれません。

ですが、慣れてくると自然に考えられるようになります。

本格的に身につけたいなら、早い段階で癖にしておくのがおすすめです。

あとで困らないために｜設計と整理のコツ

最初は1ファイル その後で分ければ大丈夫

ファイル分けの目安は次の通りです。

状態	おすすめの構成
学習用の最初の1本	1ファイル中心
設定画面を追加した	管理画面用を分ける
CSSやJavaScriptが増えた	assets系を分ける
翻訳や部品が増えた	languagesやincludesを分ける

最初から細かく分けると、どこに何があるのか分からなくなりやすいです。

一方で、長くなってきたら少しずつ整理するのがよい流れです。

名前の付け方で将来の読みやすさが変わる

意外と大事なのが、名前の付け方です。

フォルダ名、ファイル名、設定名がばらばらだと、あとから見返したときに混乱しやすくなります。

意識したいポイントは次の通りです。

たとえば、testやsampleのような名前のまま育ててしまうと、後で何のための機能か分からなくなります。

最初は小さくても、道具として使う前提で名前を付けておくと整理しやすいです。

メモを残すだけでも開発はかなり楽になる

入門では、コードの技術だけでなく、考えを整理する習慣も役立ちます。

おすすめは、作る前に次のようなメモを残すことです。

• このプラグインの目的
• 必要な画面
• 必要な入力項目
• 動作確認したいこと
• 後で追加したい機能

このメモがあるだけで、途中で迷ったときに戻る場所ができます。

実は、初心者のつまずきの多くは技術不足だけでなく、頭の中が散らかることから起きます。

だからこそ、設計メモは想像以上に効果があります。

つまずいても大丈夫｜初心者が困りやすい場面と対処法

有効化できないときは基本から順に見る

チェックしたいポイントは次の通りです。

こうした基本の見直しだけで解決することは少なくありません。

私もエラーを見ると焦りがちですが、落ち着いて順番に見るだけで解決することがよくあります。

画面が真っ白になったときの考え方

画面が真っ白になると驚きますが、まずは深呼吸して大丈夫です。

多くの場合は、コードのどこかに小さな書き間違いがあります。

対処の考え方は次の通りです。

• 直前に変更した部分を思い出す
• 一気に直そうとせず、変更を少し戻す
• 小さく動作確認しながら進める

最初から何十行もまとめて足すと、どこが原因か分かりにくくなります。

少し書いたら確認、また少し書いたら確認という流れが、結果的にはいちばん早いです。

動くけれど使いにくい状態にも注意する

エラーが出ていなくても、使いにくいプラグインになっていることはあります。

たとえば、設定場所が分かりにくい、説明が足りない、何が保存されたのか見えにくいといった状態です。

見直したいポイントは次の通りです。

よくある状態	起こりやすい困りごと	改善の考え方
設定名が分かりにくい	操作を迷う	名前を具体的にする
説明がない	使い方が伝わらない	一言の補足を入れる
表示結果が見えにくい	成功か失敗か分からない	確認しやすい場所で試す
機能が多すぎる	初心者が混乱する	最小機能から始める

プラグイン作りでは、動くことだけでなく、使いやすいことも大切です。

特に自分以外が使う可能性があるなら、説明の分かりやすさは大きな価値になります。

一歩先まで見据える｜自作プラグインを育てるコツ

翻訳しやすい作りを意識する

意識したいことは次の通りです。

• 画面に出す文言をばらばらにしない
• 表示文をまとめて管理しやすくする
• あとで変更しやすい構造にする

最初から完璧でなくても、言葉の置き方に少し気を配るだけで、あとがかなり楽になります。

読みやすい説明文を用意する

プラグインは、機能だけでなく説明も大切です。

自分では分かっていても、少し時間がたつと何のための設定か忘れてしまうことがあります。

入れておきたい説明は次の通りです。

• このプラグインで何ができるか
• どこに表示されるか
• 設定を変えると何が起こるか
• 使うときの注意点

文章は短く、やさしく、具体的にすると伝わりやすいです。

ここはブログ記事を書く感覚にも近く、読み手目線がそのまま活きる部分です。

配布や再利用を見据えるなら整理が武器になる

入門の段階でも、少しだけ先を意識しておくと役立ちます。

たとえば次の点です。

• 不要な機能を増やしすぎない
• 名前や説明をそろえる
• 設定の意味がすぐ分かるようにする
• ほかのサイトでも使えるか考える

小さなプラグインでも、整理されているだけで価値が上がります。

私は、上手な開発はすごい機能をたくさん入れることではなく、必要な機能を分かりやすく置くことだと感じています。

よくある質問

Q. WordPressプラグインの作り方は初心者でも本当に覚えられますか

A. はい、覚えられます。WordPressプラグインの作り方は、最初から大きなものを作ろうとしなければ十分取り組めます。まずは小さな機能を1つだけ追加する練習から始めると、流れがつかみやすいです。開発入門では、完璧さよりも小さく動かす経験が何より大切です。

Q. WordPressプラグイン開発の入門では どこまで学べば実用レベルですか

A. 目安としては、次のことができればかなり実用的です。

• 管理画面で有効化できる
• フックを使って機能追加できる
• 設定を保存できる
• 安全面を意識して入力と表示を扱える

ここまでできれば、自分のサイトで役立つ小さなプラグインは十分作れるようになります。

Q. WordPressプラグインの作り方を学ぶなら functions.phpより先にプラグイン化を意識したほうがいいですか

A. はい、長く使いたい機能なら、その意識を持っておくのがおすすめです。プラグインとして分けておくと、テーマ変更の影響を受けにくくなり、機能の再利用もしやすくなります。一時的な表示調整はfunctions.phpでもよいですが、育てる機能はプラグイン化しておくと整理しやすいです。

まとめ｜最初の一歩は小さくて大丈夫

今日から読者が取るべき最初の一歩は、テスト用のWordPress環境を用意し、自作プラグイン用のフォルダとメインファイルを1つ作ってみることです。

いきなり立派な機能を目指さなくても大丈夫です。まずは管理画面で認識される小さな一歩から始めてみてください。