WordPressプラグイン開発環境の構築
最初のプラグインの作成を始める前に、安定しており、隔離された環境であり、機能が充実した開発環境を用意することが非常に重要です。これにより、本番サイトを保護するだけでなく、デバッグやテストに必要なすべてのツールも利用できるようになります。
ローカル開発環境の設定
最も推奨される方法は、Local by Flywheel、XAMPP、MAMPなどのローカルサーバー環境を使用することです。これらのツールを使えば、ワンクリックでWordPressをインストールでき、PHP、MySQL、Webサーバーがすべて統合されています。PHPのバージョンは現在のWordPress公式推奨バージョンと一致していることを確認し、エラーレポート機能も有効にしておくと、開発の初期段階で潜在的な問題を発見するのに役立ちます。
WordPress のインストールディレクトリ内の wp-content/plugins フォルダ内で、新しいプラグイン用に別のフォルダを作成してください。例えば、`my_new_plugin`といった名前でフォルダを作成してください。 my-first-pluginすべてのプラグインファイルはここに配置されます。
推薦図書 SEO最適化の総合的な解析：テクニカルアーキテクチャからコンテンツ戦略までの実践ガイド。
コードエディタの選択とデバッグツール
強力なコードエディタを選ぶことで開発効率が大幅に向上します。例えば、Visual Studio Code、PHPStorm、Sublime Textなどがあります。エディタにはWordPress用のコードスニペット、PHP IntelliSense、PHPデバッグ機能などの拡張機能を必ずインストールしてください。
デバッグに関しては、WordPressのデバッグ機能を有効にするだけでなく、他にもいくつかの方法があります。 WP_DEBUG パターン（在） wp-config.php ファイル内に設定を行います。 define('WP_DEBUG', true);また、Query Monitorプラグインのインストールも推奨されます。これは開発者向けのパネルで、データベースクエリ、PHPエラー、フック（Hooks）、スクリプトなどの重要な情報をリアルタイムで表示することができ、プラグイン開発において非常に便利なツールです。まさに「多目的なツール」と言えるでしょう。
自分の最初のWordPressプラグインを作成しましょう。
標準的なWordPressプラグインには、少なくとも1つのメインファイルが必要です。このメインファイルには、WordPressがプラグインを認識し読み込むための特定のヘッダ情報を含める必要があります。
プラグインのメインファイルを作成する
あなたのプラグインフォルダ（例えば…）にある… my-first-pluginその中で、プラグインの名前をファイル名にして、PHPファイルを作成します。例えば： my-first-plugin.phpファイルの冒頭には、プラグインのヘッダーに関するコメントを含めなければなりません。
<?php
/**
* Plugin Name: 我的第一个插件
* Plugin URI: https://example.com/my-first-plugin
* Description: 这是一个用于学习WordPress插件开发的示例插件。
* Version: 1.0.0
* Author: 你的名字
* Author URI: https://example.com
* License: GPL v2 or later
* Text Domain: my-first-plugin
* Domain Path: /languages
*/このコメントはプラグインの「身分証明書」のようなものです。その中には、Plugin Name これらは必須項目であり、その他はすべてオプションです。WordPressはこれらの情報をスキャンすることで、バックエンドのプラグインリストにあなたのプラグインを表示します。
推薦図書 WordPressプラグイン開発の完全ガイド：初心者から上級者までのステップアップ。
基本的な機能を実装する
このプラグインに簡単な機能を追加しましょう：記事の内容の最後に自動的にカスタムテキストを追加する機能です。そのために、以下の方法を使用します… the_content フィルター。
プラグインのヘッダー情報の下に、以下のコードを追加してください：
// 在文章内容末尾添加自定义文本
function myfp_add_footer_text($content) {
// 仅对单篇文章生效
if (is_single()) {
$custom_text = '<p><em>お読みいただきありがとうございます！この記事は「My First Plugin」のサポートによって作成されました。</em></p>';
$content .= $custom_text;
}
return $content;
}
add_filter('the_content', 'myfp_add_footer_text');ファイルを保存した後、WordPressの管理画面にある「プラグイン」ページにアクセスします。そこに「My First Plugin」というプラグインが表示されるはずです。それを有効にしてから、ウェブサイトの記事を閲覧してください。すると、設定したテキストが記事の末尾に追加されているのがわかります。この簡単な例は、「フィルター（Filter）」を使用してWordPressの出力内容を変更する方法を示しています。
プラグインの核心に迫る：フックとAPI
WordPressプラグインの強力な機能の基盤となっているのは、「フック（Hooks）」システムと豊富なAPIです。これらを理解することは、高度な開発を行う上で鍵となります。
アクションとフィルターホックの仕組みを理解する
フックには主に2つのタイプがあります：アクション（Action）とフィルター（Filter）です。
アクションフックを使用すると、WordPressの特定の実行ポイント（例えば記事の投稿時やバックエンドの読み込み時など）にカスタムコードを挿入することができます。 add_action() この関数はマウント処理を行うためのものです。操作を実行するだけであり、返値を期待していません。
フィルターフックを使用すると、WordPressが処理中に生成するデータを変更することができます。 add_filter() 関数を使用してマウントします。入力値を受け取り、それを変更した後に返す必要があります。
例えば、ユーザーがログインする際にメールを送信するというのは一つのアクションです。
推薦図書 WooCommerce独立型ECサイト構築：ゼロから始める実践ガイド。
function myfp_on_user_login($user_login, $user) {
wp_mail($user->user_email, '欢迎回来！', '您刚刚成功登录了网站。');
}
add_action('wp_login', 'myfp_on_user_login', 10, 2);そして、記事のタイトルを変更することはある種の「フィルター」の役割を果たします。
function myfp_prepend_title($title) {
return '精选：' . $title;
}
add_filter('the_title', 'myfp_prepend_title');よく使われるAPIインターフェースの詳細解説
WordPress は多数の安全な API 関数を提供しており、データベースに直接操作する必要をなくしてくれます。
* 选项 API：使用 add_option(), get_option(), update_option() プラグインの設定データを保存および取得するために使用されます。これらのデータは以下の場所に保存されます： wp_options 表の中に。
* 设置 API：用于在后台“设置”或独立页面中创建标准化、安全且可验证的表单字段。它简化了设置页面的创建过程，并自动处理安全校验（Nonce）和数据存储。核心函数包括 register_setting(), add_settings_section() と add_settings_field()。
* 数据库 API：通过 $wpdb グローバルオブジェクトを使用してカスタムデータベース操作を行うことができます。これにより、以下のような機能が提供されます： $wpdb->insert(), $wpdb->update(), $wpdb->get_results() このような方法により、テーブルのプレフィックス処理やSQLインジェクションの防御も既に実施されています。
* HTTP API：使用 wp_remote_get() または wp_remote_post() これはリモートのHTTPリクエストを発行するためのものです。ネイティブのPHP関数よりも… file_get_contents() より安全で互換性が高く、SSLやプロキシのサポートも備えています。
プラグインのバックエンドとユーザーインターフェースを構築する
成熟なプラグインには通常、設定ページが必要であり、ユーザーがその動作をカスタマイズできるようになっています。WordPressでは、この設定ページを管理画面のメニューに追加するためのさまざまな方法が用意されています。
管理メニューとサブメニューを作成する
利用する add_menu_page() この機能を使用すると、バックグラウンドの左側ナビゲーションバーにトップレベルのメニューアイテムを追加することができます。 add_submenu_page() サブページを追加することができます。これらの関数は通常、 admin_menu アクションフック内で呼び出されます。
以下は、トップメニューとその設定ページを作成する例です：
// 添加后台菜单
function myfp_add_admin_menu() {
// 添加顶级菜单
add_menu_page(
'我的插件设置', // 页面标题
'我的插件', // 菜单标题
'manage_options', // 权限要求
'myfp-settings', // 菜单slug
'myfp_settings_page_html', // 用于输出页面内容的回调函数
'dashicons-admin-generic', // 图标
80 // 位置
);
}
add_action('admin_menu', 'myfp_add_admin_menu');
// 设置页面HTML内容
function myfp_settings_page_html() {
// 权限检查
if (!current_user_can('manage_options')) {
return;
}
?>
<div class="wrap">
<h1><?php echo esc_html(get_admin_page_title()); ?></h1>
<form action="/ja/options.php/" method="post" data-trp-original-action="options.php">
<?php
// 输出设置字段、节和安全字段
settings_fields('myfp_options'); // 与 register_setting() 的选项组名匹配
do_settings_sections('myfp-settings'); // 与页面slug匹配
submit_button('保存设置');
?>
<input type="hidden" name="trp-form-language" value="ja"/></form>
</div>
あなたのアカウントは有効です。あなたはログインしています。設定APIを使用してフォームを構築する
上記のフォームを実際に機能させるためには、設定 API を使用してフィールドを登録する必要があります。これは通常、 admin_init フック内で処理が完了しました。
// 初始化设置
function myfp_settings_init() {
// 注册一个设置选项
register_setting('myfp_options', 'myfp_settings');
// 添加一个设置节
add_settings_section(
'myfp_section_basic',
'基础设置',
null, // 节描述回调函数，可为空
'myfp-settings'
);
// 为节添加一个文本字段
add_settings_field(
'myfp_field_footer_text',
'页脚文本',
'myfp_field_footer_text_html', // 渲染字段HTML的回调函数
'myfp-settings',
'myfp_section_basic',
['label_for' => 'myfp_field_footer_text']
);
}
add_action('admin_init', 'myfp_settings_init');
// 字段HTML渲染函数
function myfp_field_footer_text_html() {
$options = get_option('myfp_settings');
$value = $options['footer_text'] ?? '默认文本';
?>
<input type="text"
id="myfp_field_footer_text"
name="myfp_settings[footer_text]"
value="<?php echo esc_attr($value); ?>"
class="regular-text">
<?php
}このような組み合わせにより、検証機能と保存機能を備えた標準化されたバックエンド設定ページが作成されました。ユーザーが設定を保存すると、その値はシステム内に保存されます。 get_option('myfp_settings') 取得され、プラグインの機能に使用されます。
概要
WordPressプラグインの開発とは、基本構造（プラグインヘッダー、ファイルの組織）を理解することから始め、徐々にその核心的なメカニズム（フック、API）を習得していくプロセスです。専門的なローカル環境を構築することで、安全に実験やデバッグを行うことができます。最初のプラグインを作成することで、プラグインがWordPressによってどのように認識され、読み込まれるかを学びます。アクションフックやフィルターフック、オプション、設定、データベースなどのAPIを深く理解することは、機能豊富で安全なプラグインを構築するための基盤となります。最後に、WordPressが提供する管理メニューの機能や設定APIを活用することで、ユーザーにとって使いやすく、設定が簡単なバックエンドインターフェースを作成することができます。これらのステップとベストプラクティスに従えば、ゼロから始めてもさまざまなニーズに応えるWordPressプラグインを構築することができるでしょう。
FAQ よくある質問
WordPressプラグインを開発するには、どのような基礎知識が必要ですか？
PHPプログラミング言語の基礎知識が必要です。なぜなら、このプラグインは主にPHPで作成されているからです。また、HTML、CSS、JavaScriptについても基本的な理解があると、フロントエンドの表示やインタラクティブなインターフェースを作成する際に非常に役立ちます。MySQLデータベースの基本概念（データの追加、削除、変更、検索など）にも精通していると、WordPressのデータ操作をよりよく理解することができます。最後に、WordPress自体の基本構造やよく使われるテンプレートタグについても理解しておくことが不可欠です。
如何确保我开发的插件是安全的？
プラグインのセキュリティを確保するためには、いくつかのベストプラクティスに従う必要があります。まず、すべてのユーザー入力データに対して検証、クリーニング、エスケープ処理を行う必要があります。WordPressが提供する関数を使用するとよいでしょう。 esc_html(), esc_attr(), sanitize_text_field() と wp_kses()次に、データの変更に関わる操作（フォームの送信など）を実行する際には、Nonce（一回限りのトークン）を使用してリクエストの意図と出所を検証する必要があります。最後に、データベースと直接やり取りを行う際には、必ず適切なセキュリティ対策を施すことが重要です。 $wpdb クラスが提供するメソッドを使用するか、より高度なAPIを活用することで、SQL文を手動で記述することを避け、注入攻撃を防ぎましょう。
プラグインのメインファイルの名前は自由に決めることができますか？
はい、ただし一定の規範に従う必要があります。メインのPHPファイルの名前は自由に決めることができますが、通常はプラグインのディレクトリ名やプラグイン名と一致する、全小文字でハイフンで区切られた名前を使用することをお勧めします。例えば： my-awesome-plugin.php重要なのは、そのファイルに正しいプラグインヘッダーのコメントが含まれていなければならないということです。 Plugin Name: なぜなら、WordPressはファイル名ではなく、ファイルの内容内にあるこれらの特定のコメントをスキャンすることでプラグインを認識するからです。
私のプラグインに多言語サポートを追加するにはどうすればよいですか？
プラグインに多言語サポート（国際化およびローカライゼーション）を追加するには、主に3つのステップがあります。第一歩として、プラグインのコード内で、翻訳が必要なすべての文字列を特定し、適切な形式に変換する必要があります。 __() または _e() 関連する関数をラップし、テキストドメイン（Text Domain）を設定します。次に、プラグインのヘッダー内のコメントで正しく宣言を行います。 Text Domain と Domain Path第三段：Poeditのようなツールを使用して、プラグインのコードをスキャンし、生成します。 .pot テンプレートファイルを用意し、それぞれの言語に翻訳を行い、対応するファイルを生成します。 .po と .mo そのファイルを指定された言語ディレクトリに配置してください。WordPressはウェブサイトの言語設定に基づいて、対応する翻訳を自動的に読み込みます。
次はどうする？
拡大読書と実践的知識
以下は、この記事のトピックに関連しており、さらに深く読むのに適している。あなたの現在の問題に最も近い記事から優先順位をつけ、徐々に周辺のトピックに広げていく方が良い場合が多い。
日本語