なぜプラグインがWordPressエコシステムの核心なのでしょうか？
WordPressの強力な拡張性は、そのプラグインシステムに大きく依存しています。プラグインを使用することで、開発者はWordPressのコアコードを変更することなく、シンプルな連絡フォームから高度な電子商取引システムまで、ウェブサイトに任意の機能を追加することができます。プラグイン開発を理解することは、あらゆるニーズに応じてWordPressをカスタマイズするための鍵を握ることを意味します。プラグインは「設定よりもルールを優先する」という原則に従い、一連の明確なライフサイクルフック（Hooks）を通じてコアと連携して動作します。
一个标准的插件本质上是一个或多个位于/wp-content/plugins/ディレクトリ内のPHPファイルには、特定のプラグインヘッダーコメントを含める必要があります。このコメントはWordPressにプラグインの情報を提供するためのものです。このようなモジュール化された設計により、機能の分離とシステムの安定性が保たれ、プラグインの有効化、無効化、削除が安全かつコントロール可能になります。
自分の最初のプラグインを作成しましょう：基本構造から始めましょう。
プラグインを作成するには、まずその基本ファイルと構造を構築する必要があります。これは単にコードを書くだけではなく、プラグインの将来のメンテナンスや拡張のための基盤を築くことでもあります。
推薦図書 ゼロからWordPressプラグイン開発をマスターしよう：オリジナル機能の作成と効率的な収益化。
まず、あなたのローカルのWordPress開発環境で…/wp-content/plugins/ディレクトリ内に新しいフォルダを作成してください。フォルダの名前は、プラグインの機能を表す英語の小文字で構成された一意な文字列でなければなりません。例えば：my-first-greeting-pluginこのフォルダ内に、メインのPHPファイルを作成してください。ファイル名は通常、フォルダ名と同じになります。例えば：my-first-greeting-plugin.php。
プラグイン情報のヘッダー声明
プラグインのメインファイルは、特定のコメントブロックで始まる必要があります。これがWordPressがプラグインを認識するための鍵となります。以下のコードをメインのPHPファイルに追加してください：
<?php
/**
* Plugin Name: 我的第一个问候插件
* Plugin URI: https://example.com/my-greeting-plugin
* Description: 这是一个演示插件，用于在网站页脚添加一句自定义问候语。
* Version: 1.0.0
* Author: 你的名字
* Author URI: https://example.com
* License: GPL v2 or later
* Text Domain: my-first-greeting-plugin
* Domain Path: /languages
*/このコメントでは、WordPressの管理画面（バックエンド）にある「プラグイン」ページに表示されるプラグインに関するすべての情報が定義されています。Plugin Nameこれは必須項目で、その他はすべてオプションです。ファイルを保存すると、WordPressの管理画面のプラグイン一覧でこの新しいプラグインを確認でき、他のプラグインと同様に「有効」にすることができます。
アクションフックを使用して機能を追加する
プラグインを有効にしても、現時点では何も動作しません。プラグインを実際に機能させるためには、WordPressの「フック（Hook）」を使用する必要があります。フックには「アクション（Action）」と「フィルター（Filter）」の2種類があります。アクションを使用すると、特定のタイミング（例えばページが読み込まれたときや記事が投稿されたとき）にカスタムコードを実行することができます。
ページのフッターに挨拶文を追加してください。
よくある要求の一つに、ウェブサイトのフッター部分にコンテンツを追加することがあります。WordPressではこれを実現するための機能が用意されています。wp_footerこのアクションフックです。カスタムの関数をこのフックに「マウント」することができます。
推薦図書 WordPressプラグイン開発の究極ガイド：ゼロから最初のカスタムプラグインを作成する。
メインのPHPファイルのヘッダーコメントの下に、以下のコードを追加してください：
// 声明一个自定义函数，用于输出问候语
function my_greeting_display() {
echo '<p style="text-align: center; color: #666; padding: 10px;">こんにちは、世界！私の最初のWordPressプラグインをお使いいただき、ありがとうございます。</p>';
}
// 使用 add_action 函数将我们的自定义函数挂载到 wp_footer 钩子上
add_action( 'wp_footer', 'my_greeting_display' );add_action関数は、カスタムコードとWordPressのコアをつなぐ橋渡しの役割を果たします。最初のパラメータはフックの名前です。‘wp_footer’2番目のパラメータは、私たちが定義した関数名です。‘my_greeting_display’ファイルを保存してウェブサイトのフロントエンドを更新すると、ページのフッターにこの挨拶文が表示されるはずです。
フィルターを導入することで柔軟性が向上します。
アクションフックによって私たちは「何かを実行」することができ、フィルターフックによっては「データを変更」することができます。これらにより、データがブラウザに使用されたり出力されたりする前に、そのデータを修正することが可能になります。この仕組みにより、プラグインの機能はより柔軟でカスタマイズしやすくなります。
修改文章标题的示例
仮に、すべての記事のタイトルの前に自動的に「【推薦】」という文字を付けたいとします。そのためには、以下のような方法を使用することができます：the_titleフィルター。
プラグインのメインファイルに、以下の新しい関数とフィルターを追加してください：
// 声明一个函数，用于修改文章标题
function my_prefix_post_title( $title, $post_id = null ) {
// 确保只在主循环且是文章页面添加前缀
if ( is_single() && in_the_loop() ) {
$title = '【推荐】' . $title;
}
// 必须返回修改后的值
return $title;
}
// 使用 add_filter 函数，挂载到 the_title 过滤器
add_filter( 'the_title', 'my_prefix_post_title', 10, 2 );add_filter「の第三のパラメータ」10これは優先順位を示しており、数字が小さいほど先に実行されます。4番目のパラメータです。2これは、関数に渡される値を表しています。my_prefix_post_titleフィルター関数は、パラメータの数を返す必要があります。フィルター関数は、単に値を出力するだけでなく、修正された値を返さなければなりません。これにより、あなたのコードは他のプラグインやテーマのフィルターと連携して動作することができます。
推薦図書 WordPressプラグイン開発を完全にマスターする：ゼロからカスタム機能の構築まで。
プラグイン管理ページを作成します。
プラグインにユーザーが設定できるオプションが必要な場合、そのためのバックエンド管理ページを作成する必要があります。これは、WordPressの管理メニューAPIを使用して実現されます。
管理画面に設定ページを追加する
WordPressの管理画面（バックエンド）の左側ナビゲーションバーに、シンプルなトップメニューを追加します。
あなたのプラグインのメインファイルに、以下のコードを続けて追加してください：
// 注册管理菜单
function my_greeting_add_admin_menu() {
add_menu_page(
'问候插件设置', // 页面标题
'问候插件', // 菜单标题
'manage_options', // 权限（管理员）
'my-greeting-plugin', // 菜单slug
'my_greeting_admin_page', // 回调函数，用于显示页面内容
'dashicons-admin-generic', // 菜单图标（WordPress Dashicons）
80 // 菜单位置
);
}
add_action( 'admin_menu', 'my_greeting_add_admin_menu' );
// 定义设置页面的HTML内容
function my_greeting_admin_page() {
// 安全检查
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
// 输出设置字段（后续可扩展）
settings_fields( 'my_greeting_options' );
do_settings_sections( 'my-greeting-plugin' );
submit_button( '保存设置' );
?>
<input type="hidden" name="trp-form-language" value="ja"/></form>
<p>私の最初のプラグインの設定ページにようこそ。今後、ここにさらに多くのオプションを追加することができます。</p>
</div>
あなたのアカウントは有効です。あなたはログインしています。add_menu_page関数はトップレベルのメニューを作成するための核心です。保存した後、管理者としてWordPressの管理画面にログインすると、左側に「Greeting Plugin」という新しいメニューアイテムが表示されます。それをクリックすると、私たちが定義した基本設定ページに移動します。これはより複雑なプラグインの設定機能を構築するための第一歩であり、将来的にはこのページで設定フィールドやフォームの保存などのロジックを統合することができます。
概要
シンプルな挨拶プラグインを作成することで、WordPressプラグイン開発の核心的な流れを体験しました。まずは基本ファイルとヘッダー情報の作成から始め、その後それらを活用して…add_actionフックは特定の位置でコードを実行し、その後それを使用します。add_filter出力内容の修正：最後に、管理メニューのAPIを使用してプラグインにバックエンド設定インターフェースを追加します。これら4つの基本要素——ファイル構造、アクションフック、フィルターフック、管理インターフェース——は、ほぼすべてのWordPressプラグインの基盤を構成しています。これらの概念を理解し、熟知することで、初級者から上級者へとステップアップし、より複雑で機能豊富なカスタムツールを構築することができるようになり、WordPressの潜在能力を最大限に引き出すことができるでしょう。
FAQ よくある質問
###：プラグインの最小構造とは何ですか？
プラグインは、1つの独立したPHPファイルのみを持つことができます。そのファイルに有効なWordPressプラグイン用のヘッダーコメントが含まれていればよいのです。Plugin Nameそれを取り出し、適切な場所に置いてください。/wp-content/plugins/ディレクトリやそのサブディレクトリ内にあれば、WordPressはそれを認識して一覧表示します。もちろん、複雑なプラグインの場合はメンテナビリティを高めるために、コードを複数のファイルやサブディレクトリに分けて構成することが一般的です。
アクションフックとフィルターフックの根本的な違いとは？
アクションフックは特定のタイミングで「操作を実行する」ためのもので、関数からの戻り値は必要ありません。その主な目的はコードを実行することです。フィルターフックは「データを変更する」ためのもので、関数からは必ず値を返す必要があります（通常は変更後の入力値です）。これにより、データがフィルターチェーン内で渡されることができます。簡単に言えば、アクションは何かを行うことであり、フィルターは何かを変えることです。
どうすれば、自分のプラグインコードが他のプラグインと衝突しないようにできるでしょうか？
関数名、クラス名、定数名の衝突を避けるためのベストプラクティスとしては、名前空間を使用するか（推奨されます）、すべての識別子に一意の接頭辞を付けることです。例えば、この記事の例では、すべての関数に一意の接頭辞が付けられています。my_またはmy_greeting_PHP 5.3以降では、名前空間（namespace）の使用がより現代的で包括的な方法となっています。
プラグインを開発する際には、どのようにデバッグを行うのでしょうか？
まず、ご自身の環境で以下のことを確認してください：wp-config.phpファイルを開くWP_DEBUG：define( ‘WP_DEBUG’, true );使用方法：error_log()この関数は、デバッグ情報をサーバーのエラーログに書き込みます。変数のチェックには、以下の方法を使用できます：print_r()またはvar_dump()組み合わせるwp_die()ページ上で安全に出力する必要があります。さらに、Query Monitorなどの開発者向けプラグインを使用すると、デバッグの効率が大幅に向上します。
次はどうする？
拡大読書と実践的知識
以下は、この記事のトピックに関連しており、さらに深く読むのに適している。あなたの現在の問題に最も近い記事から優先順位をつけ、徐々に周辺のトピックに広げていく方が良い場合が多い。
日本語