ウェブサイトに特定の機能を追加したい場合でも、自分のアイデアを共有可能な製品にしたい場合でも、WordPressプラグインの開発を学ぶことは非常に価値のあるスキルです。プラグインを自分で開発することで、ウェブサイトの機能を完全にコントロールでき、テーマの制限を超え、広大なWordPressエコシステムに貢献することができます。このガイドでは、開発環境の構築から高度なプラグインの公開までの全過程を丁寧に説明し、強力で安全かつメンテナンスしやすいプラグインを作成するために必要なすべての知識を身に付けることができます。
開発環境の構築とプロジェクトの初期化
最初のコード行を書く前に、効率的な開発環境を構築することは非常に重要な第一歩です。適切に設定された環境は、開発効率とデバッグの体験を大幅に向上させることができます。
ローカル開発環境の設定
ローカルサーバー環境用のソフトウェアパッケージ、例えばLocal by Flywheel、XAMPP、Laragonの使用をお勧めします。これらのツールを使えば、PHP、MySQL、ウェブサーバー（通常はApacheまたはNginx）をワンクリックでインストールできます。また、使用しているPHPのバージョンが公式で推奨されているものであることを確認してください。WordPressのコアチームは、安定したPHPバージョンの使用を推奨しています。
推薦図書 WordPressプラグイン開発の究極ガイド：ゼロからカスタム機能の構築まで。
次に、コードエディタが必要になります。Visual Studio CodeやPhpStormは開発者に人気のある選択肢です。VS Codeは軽量で拡張性が高く、PHP IntelephenseやWordPressのコードスニペットなどの拡張をインストールすることで、ほぼIDEと同等の環境を実現できます。一方、PhpStormはより強力なコード分析、デバッグ、リファクタリング機能を提供しています。
最初のプラグインの基本構造を作成する
WordPressのプラグインとは、本質的にはWordPressサイト内にインストールされる追加機能やコンポーネントのことです。 wp-content/plugins/ ディレクトリ内には、少なくとも1つのPHPのメインファイルが含まれているフォルダがあります。まずは、最もシンプルなプラグインを作成することから始めましょう。
まず、ローカルのWordPressにインストールされているプラグインのディレクトリ内に新しいフォルダを作成してください。例えば、`new-plugins`といった名前でフォルダを作成してください。 my-first-pluginそのフォルダ内に、メインのPHPファイルを作成してください。ファイル名は通常、フォルダ名と同じになります。my-first-plugin.php。
すべてのプラグインは、標準のプラグインヘッダー情報（Plugin Header）で始まる必要があります。これはWordPressがプラグインの基本情報を認識するための方法です。開いてください。 my-first-plugin.php そして、以下のコードを記述してください：
<?php
/**
* Plugin Name: 我的第一个插件
* Plugin URI: https://yourwebsite.com/my-first-plugin
* Description: 这是一个用于学习的简单示例插件。
* Version: 1.0.0
* Author: 你的名字
* License: GPL v2 or later
* Text Domain: my-first-plugin
* Domain Path: /languages
*/ファイルを保存した後、WordPressの管理画面にログインし、「プラグイン」メニューにアクセスしてください。そこでは「My First Plugin」というプラグインがプラグインリストに表示されているはずです。このプラグインには現時点では何の機能もありませんが、あなたは無事に有効なWordPressプラグインを作成することに成功しました。
推薦図書 WordPressプラグイン開発の究極ガイド：ゼロからビジネスレベルのプラグインを構築する。
プラグインのコア構造とフックメカニズム
WordPressの「フック（Hook）」システムを理解することは、プラグイン開発の基盤となります。フックを利用すると、自分のコードをWordPressのコア処理の特定のタイミングで実行させることができ、機能を変更したり追加したりすることができます。
アクションフックとフィルターフック
WordPressでは、主に2種類のフックが提供されています：アクション（Actions）とフィルター（Filters）です。
アクションフックを使用すると、記事の投稿、ユーザーのログイン、管理バックエンドの読み込みなど、特定のイベントが発生したときにコードを実行できます。アクションフックは返り値を期待しません。その目的は「何かを実行する」ことにあります。 add_action() この関数を使用すると、自分の関数をアクションフックにマウントできます。
フィルターフックはデータを変更するために使用されます。これにより、データが使用される前（例えばデータベースに保存されたり、ページ上に表示されたりする前）に、そのデータを修正することができます。フィルター関数は修正後の値を返す必要があります。 add_filter() この関数を使用すると、自分の関数をフィルターホックにマウントできます。
シンプルな機能を実装する
では、プラグインに最初の実用的な機能を追加しましょう：記事の内容の最後に自動的にカスタムテキストを追加する機能です。そのために、以下の手順を実行します… the_content このフィルターホックです。
あなたの my-first-plugin.php ファイルヘッダのコメントブロックの後に、以下のコードを追加してください：
推薦図書 WordPressプラグイン開発をゼロから学ぶ：あなたの最初のカスタム機能を作成しましょう。
// 在文章内容后添加自定义文本
function myfp_add_text_to_content( $content ) {
if ( is_single() && in_the_loop() && is_main_query() ) {
$custom_text = '<p><em>お読みいただきありがとうございます！この記事は【私の最初のプラグイン】のサポートによって作成されました。</em></p>';
$content .= $custom_text;
}
return $content;
}
add_filter( 'the_content', 'myfp_add_text_to_content' );このコードは、ある関数を定義しています。 myfp_add_text_to_contentそれは記事の内容を受け取ります。 $content これをパラメータとして使用します。関数内の条件判断により、このテキストがフロントエンドの単一記事ページのメインループ内でのみ表示されるようになります。その後、カスタムテキストを元のコンテンツに追加し、修正されたコンテンツを返します。最後の行では… add_filter この関数を以下の場所にマウントしてください： the_content フィルターの上にあります。
ファイルを保存し、ブログ記事のページを更新すると、記事の下部に追加したテキストが表示されます。
管理メニューと設定ページの作成
完璧なプラグインには、通常、ユーザーが設定を行えるオプションが提供される必要があります。これには、WordPressの管理画面（ダッシュボード）内にメニューや設定ページを作成する必要があります。
ページを管理メニューに追加します。
WordPressでは、管理画面のサイドバーにトップメニューやサブメニューを追加するための関数が用意されています。ここでは、シンプルな設定ページを作成していきます。まず、以下の手順を使用します： add_action() フックは… admin_menu このアクションには関数をマウントし、メニューの登録に使用します。
プラグインのメインファイルに以下のコードを追加してください：
// 创建管理菜单
function myfp_create_admin_menu() {
add_menu_page(
'我的插件设置', // 页面标题
'我的插件', // 菜单标题
'manage_options', // 所需权限
'myfp-settings', // 菜单 Slug
'myfp_settings_page_html', // 显示页面内容的回调函数
'dashicons-admin-generic', // 菜单图标（Dashicon）
80 // 菜单位置
);
}
add_action( 'admin_menu', 'myfp_create_admin_menu' );構築設定ページのコンテンツを作成する
では、先ほどのコールバック関数を定義する必要があります。 myfp_settings_page_html レンダリング設定ページのHTMLコンテンツを生成するために。
// 设置页面的 HTML 结构
function myfp_settings_page_html() {
// 检查用户权限
if ( ! current_user_can( 'manage_options' ) ) {
return;
}
?>
<div class="wrap">
<h1></h1>
<form action="/ja/options.php/" method="post" data-trp-original-action="options.php">
<?php
// 输出安全字段（如 nonce）、设置节和字段
settings_fields( 'myfp_options' );
do_settings_sections( 'myfp-settings' );
submit_button( '保存设置' );
?>
<input type="hidden" name="trp-form-language" value="ja"/></form>
</div>
あなたのアカウントは有効です。あなたはログインしています。設定の保存および検証のためには、WordPressのSettings APIを使用する必要があります。これには、設定の登録、設定セクション（section）やフィールド（field）の追加が含まれます。これらの設定を別の関数で初期化し、それをWordPressにマウント（mount）しましょう。 admin_init 行動面で。
// 初始化设置
function myfp_settings_init() {
// 注册一个设置项
register_setting( 'myfp_options', 'myfp_options', 'myfp_options_validate' );
// 添加一个设置区域
add_settings_section(
'myfp_section_general',
'常规设置',
'myfp_section_general_html',
'myfp-settings'
);
// 向该区域添加一个字段
add_settings_field(
'myfp_field_custom_text',
'自定义显示文本',
'myfp_field_custom_text_html',
'myfp-settings',
'myfp_section_general',
[ 'label_for' => 'myfp_field_custom_text' ]
);
}
add_action( 'admin_init', 'myfp_settings_init' );
// 设置区域的描述文本
function myfp_section_general_html() {
echo '<p>プラグインの基本的な動作を設定する。</p>';
}
// 文本字段的 HTML 输出
function myfp_field_custom_text_html() {
$options = get_option( 'myfp_options' );
$value = $options['custom_text'] ?? ''; // 使用空值合并运算符
?>
<input type="text" id="myfp_field_custom_text" name="myfp_options[custom_text]" value="<?php echo esc_attr( $value ); ?>" class="regular-text">
<p class="description">ここに入力されたテキストは、記事の最後に表示されます。</p>
<?php
}
// 简单的设置验证
function myfp_options_validate( $input ) {
$new_input = [];
if ( isset( $input['custom_text'] ) ) {
$new_input['custom_text'] = sanitize_text_field( $input['custom_text'] );
}
return $new_input;
}最後に、以前に作成したものを修正するのを忘れないでください。 myfp_add_text_to_content この関数に、新しい設定項目を使用させてください。
function myfp_add_text_to_content( $content ) {
if ( is_single() && in_the_loop() && is_main_query() ) {
$options = get_option( 'myfp_options' );
$custom_text = $options['custom_text'] ?? '感谢阅读！';
// 确保有内容才添加
if ( ! empty( $custom_text ) ) {
$content .= '<p><em>'`. esc_html($custom_text)`.'</em></p>';
}
}
return $content;
}現在、プラグインの設定ページで、記事の末尾に表示されるテキストを自由に変更することができます。
アドバンスド開発とベストプラクティス
プラグインの機能が徐々に複雑になるにつれて、良い開発習慣に従うことでコードの保守性、安全性、およびパフォーマンスを確保することができます。
オブジェクト指向プログラミングとセキュリティ
複雑なプラグインについては、オブジェクト指向（OOP）のクラス構造を採用することがより良い選択です。これによりコードの整理が容易になり、関数名の衝突を避けることができ、再利用性も向上します。
以下は、シンプルなクラス構造の例です：
class MyFirstPlugin {
public function __construct() {
add_action( 'init', [ $this, 'load_textdomain' ] );
add_action( 'admin_menu', [ $this, 'create_admin_menu' ] );
add_filter( 'the_content', [ $this, 'add_text_to_content' ] );
}
public function load_textdomain() {
load_plugin_textdomain( 'my-first-plugin', false, dirname( plugin_basename( __FILE__ ) ) . '/languages' );
}
// ... 其他方法（如前面定义的函数可以移到这里成为类的方法）...
}
// 安全地初始化插件类
if ( class_exists( 'MyFirstPlugin' ) ) {
$myFirstPlugin = new MyFirstPlugin();
}セキュリティはWordPress開発において最も重要な要素です。ユーザーが入力するデータには常に検証（Validation）と消毒（Sanitization）を行い、出力されるデータにはエスケープ処理（Escaping）を施す必要があります。このような処理を行うために、以下のようなツールや手法を使用するとよいでしょう： sanitize_text_field(), esc_html(), wp_kses_post() と wp_nonce_field() このようなWordPressの組み込み関数です。
国際化（Internationalization）とパフォーマンス最適化（Performance Optimization）
あなたのプラグインを世界中のユーザーが利用できるようにするためには、国際化（i18n）が不可欠です。つまり、言語設定に対応する処理を行う必要があるのです。 __() と _e() `etc.`関数を使用して、ユーザーに表示されるすべての文字列をラップします。これらの処理はすでにクラスのコンストラクタメソッド内で実施されています。 load_textdomain この関数は、以下のように動作します： init アクション中に翻訳ファイルを読み込んでいます。Poeditのようなツールを使用して翻訳データを作成する必要があります。 .pot テンプレートファイルを用意し、翻訳者にそのファイルの翻訳を依頼してください。 .mo 翻訳ファイル。
パフォーマンスの観点から、プラグインのリソース（CSSやJSファイルなど）は必要なときにのみ読み込むようにしてください。 wp_enqueue_script() と wp_enqueue_style() 関数を使用し、正しいフック（例えば…）と組み合わせてください。 wp_enqueue_scripts フロントエンド用です。admin_enqueue_scripts （バックエンドで使用されます）。データベースのクエリについては、できるだけWordPressのキャッシュAPI（例えば）を利用してください。 wp_cache_get() と wp_cache_set()）を使用して、時間のかかる処理の結果をキャッシュします。
概要
WordPressプラグイン開発の旅は、シンプルなPHPファイルから始まります。フック（ActionsおよびFilters）の仕組みをマスターすることで、WordPressのコア機能を変更したり拡張したりする能力を得ることができます。管理インターフェースの作成、Settings APIを利用したユーザー設定の処理、オブジェクト指向プログラミングの採用、厳格なセキュリティ対策など、一歩一歩がプラグインの専門性と信頼性を高めていきます。優れたプラグインには、強力な機能だけでなく、国際化、パフォーマンス最適化、コードの整理といったベストプラクティスの遵守も求められます。継続的に実践を積むことで、複雑なニーズに応え、世界中のWordPressコミュニティで利用される高品質なプラグインを構築することができるでしょう。
FAQ よくある質問
WordPressプラグインを開発するには、どのような基礎知識が必要ですか？
PHPプログラミング言語の基本文法をマスターし、HTML、CSS、JavaScriptがフロントエンドでどのように相互作用するかを理解する必要があります。WordPressの基本概念（記事、ページ、ユーザーロール、データベース構造など）に精通していると、プラグインがシステムとどのように連携するかを理解するのに役立ちます。HTTPリクエストとレスポンスについての基本的な知識も、フォームの処理やAPIの呼び出しに役立ちます。
フック（Hooks）内のアクションとフィルターの違いは何ですか？
アクションフックは、特定のイベントが発生したときにコードを実行するためのもので、何の値も返しません。その目的は単に「何かを行う」ことです。例えば、メールを送信したり、ログを記録したりするような処理です。一方、フィルターフックは渡されたデータを変更するためのもので、関数は変更後の値を返す必要があります。変更されるのは内容、テキスト、またはその他の変数です。例えば、記事のタイトルやツールバーの内容を変更するような処理です。
開発したプラグインが他のプラグインと衝突するのを防ぐには、どうすればよいでしょうか？
すべての関数、クラス、変数、定数に一意の接頭辞を付けることは、名前の衝突を防ぐ最も効果的な方法です。一般的な名前の使用は避け、プラグインや会社を表す略語を接頭辞として使用してください。オブジェクト指向プログラミングを採用し、コードをクラス内に封じ込めることで、作用域を効果的に分離することもできます。さらに、マウントハンドラーを設定する際には条件判断を正確に行い、不要なページでコードが実行されないように注意してください。
私のWordPressプラグインをどのようにデバッグすればいいのでしょうか？
まず、確認してください。 wp-config.php ファイルを開く WP_DEBUG と WP_DEBUG_LOGこれにより、PHPのエラー、通知、警告が記録されます。 wp-content/debug.log ファイル内にあります。使用してください。 error_log() 関数が出力する変数の値を確認することでデバッグを行います。ブラウザの開発者ツールにあるコンソールやネットワークパネルは、JavaScriptやAJAXリクエストのデバッグに非常に重要です。複雑な問題に対しては、Xdebugのような専門的なデバッグツールを使用することで効率を大幅に向上させることができます。
開発が完了したら、どのようにして自分のプラグインを公式のディレクトリにアップロードするのでしょうか？
WordPressの公式な開発者プラットフォームにアクセスし、アカウントを作成する必要があります。『プラグイン開発者ガイド』をよく読んで、自分のプラグインがコードの標準、セキュリティ、ライセンス（GPL互換でなければならない）など、すべての要件を満たしていることを確認してください。プラグインの説明書類、スクリーンショット、READMEファイルも用意しておいてください。その後、Subversion（SVN）を使用して自分のコードを公式に割り当てられたコードリポジトリにコミットすると、そのコードがリポジトリ内で確認できるようになります。
次はどうする？
拡大読書と実践的知識
以下は、この記事のトピックに関連しており、さらに深く読むのに適している。あなたの現在の問題に最も近い記事から優先順位をつけ、徐々に周辺のトピックに広げていく方が良い場合が多い。
日本語