準備作業と環境設定
実際のコーディングを行う前に、安定して効率的なローカル開発環境を構築することが非常に重要です。この環境は、プラグインの開発、テスト、デバッグを行うための「サンドボックス」となり、オンラインで稼働している本番サイトに影響を与えないようにするためのものです。
最も簡単な方法は、XAMPP、MAMP（Mac向け）、またはLocal by Flywheelのようなローカルサーバー統合ソフトウェアを使用することです。これらのツールは、Apache（またはNginx）やMySQLデータベース、PHPをワンクリックでインストールしてくれ、WordPressの動作に必要な環境を完璧に整えてくれます。ローカルサーバーのインストールが完了したら、最新バージョンのWordPressコアファイルをダウンロードし、サーバーのウェブページのルートディレクトリ（例：htdocsやwww）に解凍します。その後、有名な「5分でインストール」の手順に従ってWordPressサイトの初期設定を行います。
次に、優れたコードエディタが必要になります。どのテキストエディタでも使用は可能ですが、プログラマー向けに特化して設計されたエディタ（Visual Studio Code、PhpStorm、Sublime Textなど）を使用すると効率が大幅に向上します。これらのエディタには、構文のハイライト表示、コードの自動補完、エラーの警告、統合されたターミナルなどの機能が備わっています。特に、使用するエディタにWordPress関連のコードスニペットやインテリセンスプラグインをインストールすることを強くお勧めします。
推薦図書 WordPressプラグイン開発入門ガイド：ゼロから最初のカスタムプラグインを作成する方法。
最後に、コードのバージョン管理とチームワークを円滑に進めるために、バージョン管理システムに精通しておく必要があります。Git これが現在の主流の選択肢です。あなたのプロジェクトディレクトリでこれを初期化してください。 Git リポジトリを作成し、GitHub、GitLab、Bitbucketなどのリモートリポジトリと関連付けることで、作業内容をバックアップするだけでなく、コードの変更履歴を明確に追跡することができます。
自分の最初のWordPressプラグインを作成しましょう。
まずは、最もシンプルでありながらも構造が整ったプラグインの作成から始めましょう。これにより、プラグインの基本的な構成を理解するのに役立ちます。WordPressのプラグインとは、本質的には1つまたは複数のPHPファイルで構成されており、それらはWordPressのディレクトリ内に配置されます。 /wp-content/plugins/ ディレクトリ内にあり、特定の形式のヘッダーコメントを含むことでWordPressにその存在を知らせます。
まず、ログインしてください。 /wp-content/plugins/ ディレクトリ内に新しいフォルダを作成し、そのフォルダの名前をあなたのプラグインの名前にします。例えば： my-first-pluginこのフォルダ内に、メインプラグインファイルを作成してください。そのファイルの名前は通常、フォルダ名に「.plugin」と拡張子を付けて名付けられます。 .php サフィックス、例えば… my-first-plugin.phpこのファイルをあなたのコードエディタで開いてください。
プラグインのメインファイルのヘッダー情報を作成する
プラグインファイルの冒頭には、標準的な形式のPHPドキュメントコメントブロックを含める必要があります。このヘッダー情報は、WordPressの管理画面内でプラグインが認識され、表示されるための鍵となります。以下のコードを入力してください：
<?php
/**
* Plugin Name: 我的第一个插件
* Plugin URI: https://yourwebsite.com/my-first-plugin
* Description: 这是一个用于演示 WordPress 插件开发基础的简单插件。
* Version: 1.0.0
* Author: 你的名字
* Author URI: https://yourwebsite.com
* License: GPL v2 or later
* Text Domain: my-first-plugin
*/ファイルを保存した後、WordPressの管理画面にログインし、「プラグイン」メニューに移動してください。そこでは「My First Plugin」というプラグインがプラグインリストに表示されているはずです。このプラグインを有効にしたり無効にしたりすることができます。現時点ではこのプラグインは何も機能しませんが、WordPressが認めるプラグインを自分で作成することに成功しました。
推薦図書 ゼロからワンへ：WordPressプラグイン開発の権威ガイドと実践トレーニング。
プラグインに最初の機能を追加します。
では、このプラグインに簡単な機能を追加しましょう。ウェブサイトのフッターにカスタムテキストを表示する機能です。WordPressを使用してこれを実現します。 wp_footer フックを使用して実現します。メインプラグインファイルのヘッダー情報の下に以下のコードを追加してください：
/**
* 在网站页脚输出自定义文本
*/
function myfp_add_footer_text() {
echo '<p style="text-align: center; color: #666;">私の最初のプラグインをご利用いただき、ありがとうございます！</p>';
}
add_action( 'wp_footer', 'myfp_add_footer_text' );ファイルを保存した後、ウェブサイトのフロントエンドを更新し、ページの最下部までスクロールしてください。そうすると、追加したテキストが表示されるはずです。この例を通じて、WordPress開発の2つの核心概念を実践しました：1つの機能を持つ関数を作成し、それを使って… add_action() この関数は、WordPressのライフサイクル内の特定のポイントにフック（Hook）されます。wp_footer）。
核心を掘り下げる：フックとフィルター
フック（Hooks）はWordPressプラグイン開発の中核をなす要素です。これにより、WordPressのコアコードやテーマ、または他のプラグインが実行される特定のタイミングで、元のファイルを変更することなくカスタムコードを挿入することができます。フックには主に2種類あります：アクション（Action）とフィルター（Filter）です。
アクションフックを理解し、活用する
アクションフックを使用すると、特定のイベントが発生した際にカスタム関数を実行することができます。例えば、記事が公開されたときなどです。publish_post）ユーザーがログインするときwp_login）または、以前に行ったように、フッターで出力する際にも同様です。wp_footer）を使用する add_action() この関数を使って、あなたのコールバック関数を追加してください。
以下はより実用的な例です：新しいユーザーが登録された際に、管理者にメールで通知を送ります。
/**
* 新用户注册时通知管理员
* @param int $user_id 新注册用户的ID
*/
function myfp_notify_admin_on_registration( $user_id ) {
$user = get_userdata( $user_id );
$admin_email = get_option( 'admin_email' );
$subject = '有新用户注册！';
$message = sprintf( '新用户 %s (邮箱：%s) 刚刚完成了注册。', $user->user_login, $user->user_email );
wp_mail( $admin_email, $subject, $message );
}
add_action( 'user_register', 'myfp_notify_admin_on_registration' );フィルターの強力な機能をマスターしましょう。
フィルターフックスを使用すると、プロセス内で伝達されるデータを変更することができます。テキスト内容、オプション値、クエリパラメータなど、ほぼすべての要素を変更することが可能です。 apply_filters() 関数でデータポイントを定義し、使用する add_filter() 関数を使用して、あなたの修正内容を元の関数に追加してください。
推薦図書 WordPressプラグイン開発の完全ガイド：ゼロから実際に公開するまでの実践トレーニング。
例えば、すべての記事の内容の末尾に自動的に著作権表示を追加したいと思っている場合です。
/**
* 在所有文章内容末尾添加版权声明
* @param string $content 原始文章内容
* @return string 修改后的文章内容
*/
function myfp_add_copyright_to_content( $content ) {
if ( is_single() ) { // 仅在单篇文章页面生效
$copyright_text = '<div class="my-copyright">© 著作権所有。転載を禁じます。</div>';
$content .= $copyright_text;
}
return $content;
}
add_filter( 'the_content', 'myfp_add_copyright_to_content' );タスクを実行するための「アクション（Actions）」とデータを変更するための「フィルター（Filters）」の違いと使い方を理解することは、上級のWordPress開発者になるための鍵です。
高度な開発：プラグインアーキテクチャとセキュリティ
プラグインの機能が増えるにつれて、すべてのコードをメインファイルにまとめてしまうとメンテナンスが困難になります。適切なプロジェクト構造は非常に重要です。また、セキュリティは開発のあらゆる段階に組み込まれなければなりません。
保守性の高いプラグインアーキテクチャの構築
典型的で構造が明確なプラグインディレクトリの例は、以下のようになります：
my-advanced-plugin/
├── my-advanced-plugin.php // 主插件文件，负责引导和核心设置
├── includes/ // 核心功能类或函数文件
│ ├── class-core.php // 主功能类
│ ├── class-admin.php // 后台管理逻辑
│ └── class-public.php // 前端逻辑
├── admin/ // 后台相关资源
│ ├── css/
│ ├── js/
│ └── partials/ // 管理页面模板
├── public/ // 前端相关资源
│ ├── css/
│ ├── js/
│ └── partials/
├── assets/ // 共享资源，如图标、图片
├── languages/ // 国际化语言文件
└── uninstall.php // 插件卸载时执行的清理代码メインプラグインファイル内で使用してください。 require_once 必要に応じて、他のディレクトリにあるファイルをインポートすることができます。このモジュール化された構造により、コードの役割が明確に分かれ、チームワークの促進や機能の拡張が容易になります。
非常に重要なセキュリティ対策を実施する
WordPressエコシステムにおいて、セキュリティは決して軽視してはなりません。以下は守るべきいくつかの原則です：
1. 数据验证 (Validation)： 对所有来自用户或外部的不受信任的输入（如 $_GET, $_POST, $_COOKIE検証を行い、予想される形式に合致していることを確認してください。以下のような関数を使用してください： sanitize_text_field(), intval(), filter_var()。
2. 数据转义 (Escaping)： 在将任何数据输出到浏览器（HTML、JavaScript、URLs）之前，必须进行转义，以防止跨站脚本（XSS）攻击。使用函数如 esc_html(), esc_js(), esc_url()。
3. 能力检查 (Capability Checks)： 在执行管理操作或访问敏感数据前，始终检查当前用户是否有足够的权限。使用 current_user_can() 関数。
4. 非ce验证 (Nonce Verification)： 对于所有涉及数据更改的请求（如表单提交、AJAX 操作），必须使用一次性随机数（Nonce）来验证请求的意图和来源，防止跨站请求伪造（CSRF）。
以下は、セキュリティ対策を組み込んだ例です。安全な設定オプションの保存機能を作成する方法を示します：
// 在表单提交处理中
function myfp_save_settings() {
// 1. 检查权限
if ( ! current_user_can( 'manage_options' ) ) {
wp_die( '权限不足。' );
}
// 2. 验证 Nonce
if ( ! isset( $_POST['myfp_settings_nonce'] ) || ! wp_verify_nonce( $_POST['myfp_settings_nonce'], 'myfp_save_action' ) ) {
wp_die( '安全校验失败，请重试。' );
}
// 3. 验证和清理输入数据
$option_value = sanitize_text_field( $_POST['my_option'] );
// 4. 保存到数据库 (update_option 有自己的数据清理机制，但我们已经做了)
update_option( 'myfp_custom_option', $option_value );
// 5. 重定向并添加成功消息
wp_redirect( add_query_arg( 'message', 'saved', admin_url( 'admin.php?page=myfp-settings' ) ) );
exit;
}
add_action( 'admin_post_myfp_save_settings', 'myfp_save_settings' );概要
WordPressプラグインの開発とは、基本構造を理解することから始まり、徐々にコアのフックメカニズムに深く入り込み、最終的には安全でメンテナンスしやすいアプリケーションを構築する技術を習得するプロセスです。シンプルなプラグインを作成することで、WordPressが自分のコードをどのように認識するかを学びます。アクションフックやフィルターフックを使うことで、WordPressのコアとのやり取りの方法をマスターし、機能の拡張やデータのカスタマイズを実現します。そして、プロジェクトのアーキテクチャを計画し、セキュリティ対策を徹底することで、プラグインの安定性、拡張性、リスクに対する抵抗力を確保します。継続的に練習し、コアコードを読み、WordPress開発者コミュニティに参加することで、初心者から熟練者へと成長し、プロレベルのWordPressプラグインを作り上げることができるでしょう。
FAQ よくある質問
WordPressプラグインを開発するには、どのような基礎知識が必要ですか？
このプラグインは主にPHPで書かれているため、PHPプログラミング言語の基礎知識が必要です。また、HTML、CSS、JavaScriptについても基本的な理解を持っていると、フロントエンドのインタラクションを伴うプラグインの開発に役立ちます。MySQLデータベースの基本概念（クエリの実行、データの追加・削除・変更・検索など）を理解していると、複雑なデータの処理もスムーズに行えます。もちろん、最も重要なのはWordPressのコア概念に精通していることです。これには、記事（Posts）、ページ（Pages）、ユーザーロール（User Roles）、そして前述のフックシステムなどが含まれます。
私のプラグインに独立した管理メニューページを追加するにはどうすればよいですか？
WordPressが提供するバックエンドメニューAPI関数を使用します。通常、これらの関数は1つの関数内で複数使われます。 add_menu_page() または add_submenu_page() この関数は、メニューアイテムとそれに対応するコールバック関数を登録するためのものです。この処理を実行するには、特定のポイント（ハックポイント）に関連付ける必要があります。 admin_menu フックの上にあります。コールバック関数の中で、HTML を出力して設定ページを構築し、フォームの送信を処理することができます。
プラグインはどのようにしてWordPressのデータベースとやり取りをすべきでしょうか？
WordPressではグローバルオブジェクトが提供されています。 $wpdbこれは強力なデータベース抽象クラスであり、カスタムのSQLクエリを実行するために使用されます。より構造化されたデータの保存には、WordPressのオプションAPIの使用をお勧めします。get_option(), update_option(), add_option()）を使用してシンプルなキー値ペアを保存したり、記事メタデータAPIを利用したりすることができます。add_post_meta(), get_post_meta()特定の記事、ページ、またはカスタム記事タイプに関連するデータを保存するために使用されます。可能な限り、原始的なSQLを直接記述することは避けてください。
私のプラグインを多言語対応にするにはどうすればよいですか？
WordPress は GNU gettext テクノロジースタックを使用して国際化（i18n）を実現しています。以下の手順を完了する必要があります：まず、プラグインのコード内で、翻訳が必要なすべての文字列を特定し、適切な形式に変換してください。 (), esc_html() または _e() まず、関連する翻訳関数をラップ（カプセル化）する必要があります。次に、プラグインのヘッダー部分でこれらの関数を使用します。 load_plugin_textdomain() 関数を使用して翻訳ファイルを読み込みます。最後に、Poeditのようなツールを使って翻訳結果を生成します。 .pot テンプレートファイルは、翻訳者が特定の言語用のコンテンツを作成するために使用されます。 .po と .mo ファイル。
ウェブサイトを破壊することなく、自分のプラグインをテストするにはどうすればよいでしょうか？
強くお勧めしますが、すべての開発作業および初期テストは、ローカル開発環境（XAMPP、Local by Flywheelなど）または独立した非公開のテストサーバー（Staging Server）で行ってください。完全に検証されていない新しいプラグインを、オンラインの本番サイトで直接開発・テストしては絶対にいけません。ローカル環境やテストサーバーでは、エラーを安心して発生させたりコードをデバッグしたりでき、本当のユーザーやサイトデータに影響を与える心配がありません。
次はどうする？
拡大読書と実践的知識
以下は、この記事のトピックに関連しており、さらに深く読むのに適している。あなたの現在の問題に最も近い記事から優先順位をつけ、徐々に周辺のトピックに広げていく方が良い場合が多い。
日本語