インターネットの広大な世界の中で、WordPressはその強力な拡張性によりコンテンツ管理システムの市場の半分以上を占めています。その無限の拡張性を可能にしているのが、プラグインです。WordPressのプラグイン開発を通じて、あなたは想像しうるあらゆる機能をウェブサイトに追加することができます。この記事では、ゼロから始めて、あなたの最初のWordPressプラグインを構築する方法を丁寧に説明し、その核心的な構造と開発プロセスを深く理解していきます。
WordPressプラグインの基礎と開発環境の構築
コーディングを始める前に、WordPressプラグインの本質を理解し、適切な開発環境を構築することが非常に重要です。プラグインとは、基本的に1つまたは複数のPHPファイルで構成され、WordPressの規格に従って作成されたものであり、特定の機能をWordPressサイトに追加するためのものです。钩子（フック）コアシステムとのやり取りを行います。
プラグインの基本定義
すべてのプラグインには、一意のメインファイルが必要であり、そのファイルのヘッダー部分には特定の形式でプラグインに関する情報を記述したコメントが含まれていなければなりません。このコメントは、WordPressがプラグイン管理ページでプラグインの名前、説明、バージョンなどのメタデータを認識し、表示するための根拠となります。
推薦図書 プラグイン開発入門：初めての拡張機能をゼロから作る。
ローカル開発環境の設定
効率的かつ安全に開発を行うためには、ローカルサーバー環境の使用を強くお勧めします。XAMPP、MAMP、Local by Flywheel、Dockerなどのツールを選択することができます。基本的な要件としては、PHP（対象サーバーと互換性のあるバージョン）、MySQL/MariaDB、Apache/Nginxをインストールすることです。その後、最新のWordPressコアファイルをダウンロードしてインストールを完了してください。
自分の最初のプラグインを作成しましょう：「挨拶文ツール」です。
では、実際に簡単なプラグインを作成してみましょう。このプラグインの機能は、ウェブサイトの記事内容の最後に、カスタマイズした挨拶文を自動的に追加することです。
まず、WordPressの中で… wp-content/plugins ディレクトリ内に新しいフォルダを作成し、その名前を「new_folder」とします。 my-first-greeting-pluginその後、そのフォルダ内にメインのPHPファイルを作成します。ファイル名は自由に決めることができます。 my-first-greeting-plugin.php。
プラグインヘッダー情報の宣言
メインファイルを開き、以下のコードを入力してプラグインを定義してください：
<?php
/**
* Plugin Name: 我的第一个问候语插件
* Plugin URI: https://yourwebsite.com/my-first-greeting-plugin
* Description: 这是一个练习用的插件，用于在文章末尾添加问候语。
* Version: 1.0.0
* Author: 你的名字
* Author URI: https://yourwebsite.com
* License: GPL v2 or later
* Text Domain: my-first-greeting-plugin
*/ファイルを保存した後、WordPressの管理画面にある「プラグイン」ページにアクセスすると、新しく追加されたプラグインがプラグインリストに表示され、有効にすることができます。もちろん、現時点ではまだ何の機能もありません。
推薦図書 WooCommerceを使用したeコマースサイトのパフォーマンスを最適化するための10の重要なコツと実践ガイド。
フックを使用してコア機能を追加する
WordPressの動作は「フック」（hook）メカニズムに大きく依存しており、これには以下のような種類があります：动作钩子（アクションフック）および过滤器钩子（フィルターフック）記事の内容の後にテキストを追加するには、これを使用する必要があります。 the_content このフィルターホックです。
メインファイルのヘッダーコメントの下に、以下の関数とフックを追加してください：
// 定义向文章内容添加问候语的函数
function mfgp_add_greeting_to_content( $content ) {
// 确保只在主循环的单篇文章页面显示
if ( is_single() && in_the_loop() && is_main_query() ) {
$greeting = '<p style="color:#666; font-style:italic;">この記事をお読みいただき、ありがとうございます！素晴らしい一日をお過ごしください！</p>';
$content .= $greeting;
}
return $content;
}
// 将函数挂载到 ‘the_content’ 过滤器钩子上
add_filter( 'the_content', 'mfgp_add_greeting_to_content' );ファイルを保存し、プラグインを有効にした後、ウェブサイト上の任意の記事を開いて最後までスクロールすると、追加された挨拶文が表示されるはずです。この簡単な例を通じて、プラグイン開発における最も基本的な概念を実践しました：プラグインを宣言する方法、機能を実現するための関数を記述する方法、そしてそれらをウェブサイトに組み込む方法です。add_filterまたはadd_action関数を正しいフックにマウントしてください。
プラグイン機能の強化：管理設定ページが追加されました。
成熟したプラグインでは、通常ユーザーがバックエンドで設定を行うことができます。次に、挨拶文プラグインに簡単な設定ページを追加し、管理者が表示されるテキストをカスタマイズできるようにします。
管理メニューアイテムを作成する
まずadd_actionフックが関数を呼び出し、その関数が使用されます。 add_options_page この関数は、WordPressの管理画面（バックエンド）の「設定」メニューにサブページを追加します。
メインファイルに以下のコードを続けて追加してください：
推薦図書 ゼロから始める：WordPressプラグイン開発の完全なガイドと実践的なチュートリアル。
// 添加设置菜单
function mfgp_add_admin_menu() {
add_options_page(
'问候语插件设置', // 页面标题
'自定义问候语', // 菜单标题
'manage_options', // 权限要求（管理员）
'my-greeting-plugin', // 菜单 Slug
'mfgp_settings_page_html' // 用于输出页面内容的回调函数
);
}
add_action( 'admin_menu', 'mfgp_add_admin_menu' );構築設定ページおよび保存ロジックの作成
では、先ほどのコールバック関数を定義する必要があります。 mfgp_settings_page_html 設定ページのHTMLフォームをレンダリングし、フォームデータの保存を処理します。WordPressでは設定用のAPIが提供されており、このプロセスを簡素化できますが、流れを明確に理解するために、まずは基本的な方法を使用します。
// 定义设置页面的 HTML 结构
function mfgp_settings_page_html() {
// 检查用户权限
if ( !current_user_can( 'manage_options' ) ) {
return;
}
// 处理表单提交（非设置API方式）
if ( isset( $_POST['mfgp_greeting_text'] ) ) {
// 验证 Nonce 确保请求来源安全
check_admin_referer( 'mfgp_save_settings' );
// 清理并保存输入的数据
$greeting_text = sanitize_textarea_field( $_POST['mfgp_greeting_text'] );
update_option( 'mfgp_custom_greeting', $greeting_text );
echo '<div class="notice notice-success is-dismissible"><p>設定が保存されました！</p></div>';
}
// 获取已保存的问候语
$saved_greeting = get_option( 'mfgp_custom_greeting', '感谢您阅读本文！祝你拥有美好的一天！' );
?>
<div class="wrap">
<h1></h1>
<form method="post" action="">
<?php wp_nonce_field( 'mfgp_save_settings' ); ?>
<table class="form-table">
<tr>
<th scope="row"><label for="mfgp_greeting_text">カスタムの挨拶文</label></th>
<td>
<textarea name="mfgp_greeting_text" id="mfgp_greeting_text" rows="5" cols="50" class="large-text"><?php echo esc_textarea( $saved_greeting ); ?></textarea>
<p class="description">このテキストは、すべての記事の末尾に表示されます。</p>
</td>
</tr>
</table>
<?php submit_button( '保存更改' ); ?>
<input type="hidden" name="trp-form-language" value="ja"/></form>
</div>
あなたのアカウントは有効です。あなたはログインしています。フロントエンドの出力関数を更新します。
最後に、以前のフロントエンド出力関数を修正する必要があります。それにより、データベースから取得したオプションを使用して出力を行うようになります。get_option挨拶文はファイルから読み取られ、ハードコードされたテキストが使用されるのではありません。
function mfgp_add_greeting_to_content( $content ) {
if ( is_single() && in_the_loop() && is_main_query() ) {
// 从数据库选项中获取问候语，如果没有则使用默认值
$greeting_text = get_option( 'mfgp_custom_greeting', '感谢您阅读本文！祝你拥有美好的一天！' );
if ( ! empty( $greeting_text ) ) {
$greeting = '<p style="color:#666; font-style:italic;">'`. esc_html($greeting_text).`'</p>';
$content .= $greeting;
}
}
return $content;
}現在、管理者は「設定」 → 「カスタム挨拶文」のページで表示されるテキストを自由に変更でき、フロントエンドの表示も即座に更新されます。
プラグインのリリース準備：国際化とセキュリティ強化
プラグインを他人と共有したり、公式ディレクトリに提出する前に、いくつかの重要な最終処理が必要です。主に、国際化（多言語対応）とセキュリティ強化のための作業です。
テキストの国際化を実現する
国際化（i18n）により、あなたのプラグインを他の言語に翻訳することが可能になります。ユーザーに表示されるすべての文字列を、指定された関数で囲む必要があります。私たちのプラグイン内の文字列を修正してください：
1. プラグインのヘッダー部分にあるコメント内で、私たちは既に必要な設定を定義しています。 Text Domain。
2. コード内で使用するには、以下のように記述します： () または esc_html() 関数が文字列をラップします。例えば：
// 在设置页面函数中
$greeting_text = get_option( 'mfgp_custom_greeting', __( ‘感谢您阅读本文！祝你拥有美好的一天！’， ‘my-first-greeting-plugin’ ) );
echo ‘<h1>’ . esc_html__( ‘问候语插件设置’， ‘my-first-greeting-plugin’ ) . ‘</h1>’// フロントエンドの出力関数内で（注意：フロントエンドの出力は通常翻訳する必要はありませんが、テーマやユーザーの要求によっては必要になる場合もあります）
// ただし、挨拶文自体が複数言語に対応する必要がある場合は、より複雑なロジックが必要になるでしょう。3. Poeditのようなツールを使用して作成します。 .pot 翻訳者がこれを基に作成できるテンプレートファイル .po と .mo ファイル。
セキュリティ対策を強化する
セキュリティは非常に重要です。私たちはすでにいくつかのセキュリティ関連の機能を使用しています。sanitize_textarea_field、esc_html、esc_textareaとwp_nonce_field。さらに、以下の点にも注意が必要です：
* 权限检查：在管理页面函数开始处使用 current_user_can 検査を行います。
* 数据验证与清理：对所有用户输入（如 $_POST, $_GET）进行验证（是否符合预期格式）和清理（移除非法字符）。
* 非竞态条件更新：对于重要的选项，考虑使用 wp_options テーブルを操作する際には、Settings APIを使用する方がより安全です。このAPIには、ノンコンカレント性（nonce）の確保機能や権限チェック機能が組み込まれています。
概要
このガイドを通じて、機能が完全なWordPressプラグインの作成から公開に至るまでの全プロセスを完了しました。まずはプラグインの基礎を理解し、標準的なヘッダー情報を含むメインファイルを作成しました。次に、シンプルな挨拶文機能を通じてWordPressの中核となるフックシステムを実践しました。その後、プラグインに管理画面を追加してユーザーによる設定を可能にしました。最後に、公開に先立つ重要なステップである国際化とセキュリティ強化についても検討しました。各ステップでは、WordPressの核心的な関数やベストプラクティスが紹介されています。これらの基礎知識を身につければ、より複雑で創造的なプラグインの開発に挑戦し、世界中のWordPressエコシステムに貢献することができるでしょう。
FAQ よくある質問
WordPressプラグインを開発するには、どのような前提知識が必要ですか？
PHPの基本的なプログラミング知識が必要であり、HTMLやCSSにも精通している必要があります。また、WordPressの基本的な操作（記事の作成、ページの編集、メニューの設定など）にも慣れていることが求められます。オブジェクト指向プログラミング（OOP）に精通している必要はありませんが、大規模なプラグインを開発する際には非常に役立ちます。
なぜ私のプラグインが有効になった後も、バックグラウンドメニューに表示されないのでしょうか？
最も一般的な原因は権限の問題です。呼び出しを行う際に、自分の権限を確認してください。add_options_pageまたは類似の関数を使用する際に、2番目のパラメータ（capability）が正しく設定されているかどうか、例えば… ‘manage_options’。また、ご確認ください：ご使用の関数が正しく実装されているかどうかを確認してください。add_action( ‘admin_menu’， ...)フックが正しくマウントされており、文法エラーによって関数が実行されなかったわけではありません。コードの冒頭に以下のような記述を追加することができます：error_logこの関数を使ってデバッグを行います。
WordPressのプラグインをどのようにデバッグするか？
まず、ご自身の環境で以下のことを確認してください： wp-config.php このファイルではWordPressのデバッグモードが有効になっています。 define( ‘WP_DEBUG’， true ); と define( ‘WP_DEBUG_LOG’， true );このようにすると、エラーメッセージが記録されます。 /wp-content/debug.log ファイルの中にあります。次に、ブラウザの開発者ツールにある「コンソール」や「ネットワーク」タブを使用してフロントエンドのデバッグを行うことができます。複雑なロジックについては、error_log( print_r( $variable， true ) );変数の値をログに出力することは、よく使われる方法です。
私のプラグインは、他のプラグインやテーマとどのように互換性を持たせることができるのでしょうか？
互換性を最大限に保証するために、あなたのプラグインでは以下のことを行うべきです：1）すべての関数、クラス、変数、オプションに一意の接頭辞を付けて命名する（私たちが使用しているように）。mfgp_），避免命名冲突。2）在添加修改前端或后端样式时，尽量使用独特的选择器类名。3）在可能的情况下，提供过滤器钩子（apply_filters）他の開発者があなたのプラグインの動作を変更できるようにする。4）WordPressのコアデータベースのテーブルやファイルを直接変更することは避けてください。
次はどうする？
拡大読書と実践的知識
以下は、この記事のトピックに関連しており、さらに深く読むのに適している。あなたの現在の問題に最も近い記事から優先順位をつけ、徐々に周辺のトピックに広げていく方が良い場合が多い。
日本語