なぜWordPressプラグインの開発を選ぶのでしょうか？
WordPressは世界で最も人気のあるコンテンツ管理システム（CMS）であり、その強力な拡張性は主にプラグインのおかげです。カスタムプラグインを開発することで、開発者はコアコードを変更することなくウェブサイトに必要な機能を追加することができます。これにより、ウェブサイトのアップグレードの安全性と機能の独立性が保たれます。特定のビジネスニーズに応えたり、ワークフローを最適化したり、広大なWordPressエコシステムの中で新しい製品を創造したりするためにも、プラグイン開発は非常に価値のあるスキルです。
直接修改テーマとは対照的に…functions.phpプラグインでは、機能のロジックが独立したモジュール内に封じ込められています。そのため、テーマを変更してもプラグインが提供する機能は正常に動作し続けます。さらに、構造がしっかりしているプラグインは異なるサイト間で簡単に移行や再利用が可能であり、開発効率が大幅に向上します。
自分の最初のプラグインを作ってみましょう。
プラグイン開発を始める第一歩は、プラグインの最も基本的な構造を理解することです。すべてのWordPressプラグインは、特定の場所に保存されています。/wp-content/plugins/ディレクトリ内には、各プラグインがそれぞれ独立したフォルダを持っています。
推薦図書 WordPressプラグイン開発入門ガイド：ゼロからあなたの最初のプラグインを作ろう。
プラグインのメインファイルを作成します。
プラグインの核心はPHPのメインファイルです。新しいフォルダを作成する必要があります。例えば、my-first-pluginそして、そのフォルダと同じ名前のPHPファイルを作成してください：my-first-plugin.phpこのファイルのヘッダーにあるコメントは非常に重要で、WordPressにプラグインのメタ情報を提供しています。
<?php
/**
* Plugin Name: 我的第一个插件
* Plugin URI: https://example.com/my-first-plugin
* Description: 这是一个用于学习插件开发的示例插件。
* Version: 1.0.0
* Author: 你的名字
* Author URI: https://example.com
* License: GPL v2 or later
* Text Domain: my-first-plugin
* Domain Path: /languages
*/このファイルを保存すると、WordPressの管理画面（バックエンド）の「プラグイン」ページでそれを確認し、有効にすることができます。現時点ではまだ何の機能もありませんが、合法的なプラグインフレームワークを作成することに成功しました。
プラグインに基本機能を追加する
プラグインを有効にした後、簡単な機能を追加していくことができます。よくある初心者向けの例としては、ウェブサイトのフッターにカスタムテキストを表示するというものがあります。これは以下の方法で実現できます：wp_footerこのアクションフック（Action Hook）を使って実現します。
プラグインのメインファイルに、以下のコードを追加してください：
// 在网站页脚输出自定义信息
function my_first_plugin_footer_text() {
echo '<p style="text-align: center;">私の最初のプラグインをご利用いただき、ありがとうございます！</p>';
}
add_action( 'wp_footer', 'my_first_plugin_footer_text' );ここでは、ある関数を定義しました。my_first_plugin_footer_text()その後、使用します。add_action()この関数は、それを特定の場所にマウント（つまり、利用可能な状態にする）します。wp_footerフックの上です。WordPressがページのフッター部分を処理する際に、自動的に私たちの関数が呼び出され、事前に設定されたHTMLコンテンツが出力されます。これはWordPressの「フックとコールバック」メカニズムの基本的な使い方を示しています。
推薦図書 WordPressプラグイン開発入門ガイド：ゼロから始めて、あなたの最初の機能付きプラグインを作成する。
核心を掘り下げる：フックとフィルター
WordPressプラグイン開発の核心的な考え方は、「フック（Hooks）」に基づいています。フックには2種類あります：アクションフック（Action Hooks）とフィルターフック（Filter Hooks）です。これらを理解することは、初心者から上級者へと成長するための鍵となります。
アクションフックを理解する
アクションフックを使用すると、WordPressが実行される特定のタイミングで自分のコードを挿入することができます。上記の例でもそのようにです。wp_footerそれはページフッターのHTMLが生成される際にトリガーされます。もう一つよく使われるアクションフックは…initWordPressが基本的な読み込みを終え、リクエストを処理する前に実行されます。主にプラグインの設定を初期化したり、カスタムの記事タイプを登録したりするために使用されます。
// 在初始化时执行一些操作
function my_plugin_init_action() {
// 例如，在这里可以注册一个自定义文章类型
// if ( ! post_type_exists( 'book' ) ) { ... }
}
add_action( 'init', '_plugin_init_action' );フィルターフックをマスターする
アクションフックとは異なり、フィルターフックはデータを変更するために使用されます。フィルターフックは値を受け取り、その値を変更した後で処理された値を返します。典型的な例としては…the_contentフィルターを使用すると、記事やページのメインコンテンツを変更することができます。
// 在文章内容末尾自动添加一段提示文字
function my_plugin_content_filter( $content ) {
if ( is_single() ) {
$extra_text = '<div class="my-plugin-note">この記事の内容は、私のプラグインによってフィルタリングされて生成されたものです。</div>';
$content .= $extra_text;
}
return $content;
}
add_filter( 'the_content', 'my_plugin_content_filter' );この例では、関数my_plugin_content_filter()元のデータを受け取ります。$contentまず、ページが単一の記事ページであるかを確認し、その後にHTMLコードを追加します。最後に、修正された内容を返します。WordPressはこの返された値を元の内容の代わりに使用して表示します。
構築可能なプラグイン
プロフェッショナルなプラグインには通常、ユーザーが設定を行える管理インターフェースが必要です。これには、WordPressのバックエンドで設定ページを作成し、フォームデータを処理し、安全に保存することが含まれます。
管理メニューとページを作成します。
利用するadd_menu_page()またはadd_options_page()この機能を使うと、プラグインのためにバックグラウンドでメニューアイテムや設定ページを追加することができます。これは通常、admin_menuアクションフック内で処理が完了しました。
推薦図書 WordPressプラグイン開発入門ガイド：ゼロから上級者まで、カスタム機能の作成方法。
// 添加插件管理菜单
function my_plugin_add_admin_menu() {
add_options_page(
'我的插件设置', // 页面标题
'我的插件', // 菜单标题
'manage_options', // 所需权限
'my-plugin-settings', // 菜单slug
'my_plugin_settings_page' // 显示页面的回调函数
);
}
add_action( 'admin_menu', 'my_plugin_add_admin_menu' );
// 设置页面的HTML内容
function my_plugin_settings_page() {
?>
<div class="wrap">
<h1>私のプラグイン設定</h1>
<form method="post" action="/ja/options.php/" data-trp-original-action="options.php">
<?php
settings_fields( 'my_plugin_settings_group' );
do_settings_sections( 'my-plugin-settings' );
submit_button();
?>
<input type="hidden" name="trp-form-language" value="ja"/></form>
</div>
あなたのアカウントは有効です。あなたはログインしています。登録設定、フィールド、およびセキュリティ処理
次に、WordPressのSettings APIを使用して設定やフィールドを登録し、データの保存を処理する必要があります。これにより、データの検証、権限チェック、およびセリアライズされた保存の安全性が保証されます。
// 初始化插件设置
function my_plugin_settings_init() {
// 注册一个新的设置项到“my_plugin_settings_group”
register_setting( 'my_plugin_settings_group', 'my_plugin_options' );
// 在设置页面添加一个区域
add_settings_section(
'my_plugin_section_id',
'基础配置',
null,
'my-plugin-settings'
);
// 向该区域添加一个字段
add_settings_field(
'my_plugin_text_field',
'提示文本',
'my_plugin_text_field_render',
'my-plugin-settings',
'my_plugin_section_id'
);
}
add_action( 'admin_init', 'my_plugin_settings_init' );
// 渲染文本框字段
function my_plugin_text_field_render() {
$options = get_option( 'my_plugin_options' );
?>
<input type='text' name='my_plugin_options[text_field]' value='<?php echo esc_attr( $options['text_field'] ?? '' ); ?>'>
<p class="description">ここに入力されたテキストは、ウェブサイトのフロントエンドに表示されます。</p>
あなたのアカウントは有効です。あなたはログインしています。この方法により、ユーザーがフロントエンドで入力したデータはWordPressに組み込まれている非CEScape処理や検証などのセキュリティ対策を経てから、配列の形で保存されます。wp_options表の中にあります。あなたのプラグインコードはそこから利用できます。get_option( ‘my_plugin_options’ )これらの値を安全に取得するには…
ベストプラクティスに従い、リリースの準備を整えましょう。
高品質でメンテナンス性が高く、安全なプラグインを開発するには、一連のベストプラクティスに従う必要があります。
コードの組織化とセキュリティ
ユーザーが入力したデータを絶対に信じてはいけません。すべての入力内容に対して疑いの目を向け、慎重に処理する必要があります。$_GET、$_POST取得したデータ、またはデータベースから読み取って出力用に準備したデータについては、WordPressが提供する関数を使用してエスケープ処理や検証を行います。esc_html()、esc_attr()、sanitize_text_field()、wp_kses()など。使用方法：wp_enqueue_script()とwp_enqueue_style()スクリプトやスタイルを正しく読み込み、依存関係やバージョン管理も適切に処理する必要があります。複雑なプラグインについては、オブジェクト指向プログラミング（OOP）を活用してコードを整理し、機能をクラスに封じ込めることで、コードのモジュール性と再利用性を高めることを検討してください。
国際化（Internationalization）とローカライゼーション（Localization）
あなたのプラグインを世界中のユーザーが利用できるようにするためには、国際化（i18n）が不可欠です。つまり、異なる言語に対応するための処理を行う必要があるということです。__()または_e()これらの関数は、ユーザーに表示されるすべての文字列を処理します。プラグインのヘッダー部分にあるコメント内で定義されています。Text Domain（例えば）my-first-plugin）ここで使用されているテキストフィールドと一致していなければなりません。
// 错误示例
echo “Settings Saved”;
// 正确示例
echo esc_html__( 'Settings Saved', 'my-first-plugin' );その後、Poeditのようなツールを使用して、これらの文字列を抽出して生成することができます。.potテンプレートファイルを使用することで、翻訳者は異なる言語（例えば……）のコンテンツを作成することができます。zh_CN.po）の翻訳ファイルです。これらを….moコンパイルされたファイルはプラグインディレクトリに置かれています。/languages/フォルダ内にあるWordPressは、サイトの言語設定に応じて自動的に対応する翻訳データを読み込みます。
公式カタログに公開する準備ができました。
もしプラグインをWordPress.orgの公式プラグインディレクトリに提出する予定であれば、コードが規格に準拠していることを確認する必要があります。これには、詳細なドキュメントの作成も含まれます。readme.txtプラグインについては、特定の形式で説明文を作成し、スクリーンショットやインストール手順、FAQ、更新履歴も含めます。コードはGPLライセンスに従っており、公式のSubversion（SVN）リポジトリを通じてコードの提出を行います。リリースする前に、プラグインが異なるバージョンのWordPressやPHP、人気のあるテーマ、その他のプラグインと互換性があるかを入念にテストしてください。
概要
WordPressプラグインの開発は、単純な機能の封装から複雑なアプリケーションの構築へと進化する段階的なプロセスです。その始まりは、正しいヘッダーコメントを含んだPHPファイルからです。核心となるのは、アクションフック（action hooks）とフィルターフック（filter hooks）を熟知し、WordPressのコアと効果的に連携することです。Settings APIを利用してバックエンド管理インターフェースを構築することで、プラグインをユーザーフレンドリーにすることができます。セキュリティのベストプラクティスを守り、国際化を実現し、コードを整理することは、プロフェッショナルレベルのプラグインを開発するための基盤となります。個人プロジェクトのニーズを満たすためであれ、オープンソースコミュニティに貢献したいと思っている場合であれ、この開発プロセスをマスターすることで、強力なカスタマイズ機能を実現するための道が開かれます。
FAQ よくある質問
プラグインを開発するには、どのような前提知識が必要ですか？
PHPの基本的なプログラミング知識が必要であり、HTMLやCSSにも精通している必要があります。また、WordPressの基本的な操作や概念（記事、ページ、ウィジェットなど）についても理解していることが求められます。MySQLデータベースの基本概念にも精通しているとよいですが、必須ではありません。なぜならWordPressにはデータベース操作を簡単に行うための便利な関数が用意されているからです。WP_Query、wpdb（クラス）
プラグインとテーマの `functions.php` ファイルにはどのような違いがありますか？
コードをトピック内に配置してください。functions.phpこのファイルには、機能を迅速に追加するための方法が記載されていますが、これらの機能はテーマに依存しています。テーマを切り替えると、それらの機能も失われてしまいます。一方、プラグインはテーマとは独立したモジュールであり、どのテーマを使用しても、プラグインが有効になっていればその機能は常に利用可能です。長期にわたって使用する予定がある機能や、複数のサイトで再利用する必要がある機能については、プラグインとして開発する方がより適切な選択です。
プラグインのコードをどのようにデバッグするか？
WordPressにはさまざまなデバッグツールが用意されています。まず、以下の方法でデバッグを行うことができます：wp-config.phpファイルを開くWP_DEBUG「パターン、それを使用する。」define( 'WP_DEBUG', true );これにより、すべてのPHPエラー、警告、および通知が画面上に表示されます。より安全な方法としては、これらを同時に設定することです。WP_DEBUG_LOGためにtrueエラーを以下の場所に記録してください：/wp-content/debug.logファイルの中にあります。さらに、使用するには…error_log()Query Monitorなどの専門的なデバッグプラグインを使用すると、変数やデータベースクエリの追跡をより効率的に行うことができます。
私のプラグインは、高バージョンのPHPとどのように互換性を持たせることができるのでしょうか？
プラグインが将来のPHPバージョンでも正常に動作するようにするためには、廃止されたり削除されたりした関数や構文の使用を避ける必要があります。ローカル開発環境では、将来の目標バージョン（例えばPHP 8.x）に対応した環境を使用してテストを行うべきです。WordPressやPHPの公式なアップデート情報に常に注意を払い、プラグインのアップデートログに対応しているPHPバージョンの範囲を明記することで、ユーザーが適切な開発環境を選択できるようにするとよいでしょう。
次はどうする？
拡大読書と実践的知識
以下は、この記事のトピックに関連しており、さらに深く読むのに適している。あなたの現在の問題に最も近い記事から優先順位をつけ、徐々に周辺のトピックに広げていく方が良い場合が多い。
日本語