開発前の準備作業
コーディングを始める前に、十分な準備作業を行うことはプロジェクトの成功にとって重要な基盤です。効率的で安全な開発環境を構築する必要があります。
ローカルの開発テスト環境を構築する
プラグインの開発は、本番サーバー上では行わないことを強くお勧めします。ローカル開発環境を使用すれば、ウェブサイトがダウンする心配なく、自由に試行錯誤を行うことができます。XAMPP、MAMP、Local by Flywheel、Dockerなどのツールを使えば、ローカルコンピュータ上にApache/Nginx、MySQL、PHPを備えたWordPressの運用環境を簡単に構築できます。これにより、コードの修正やデバッグが非常に迅速に行えるようになります。
WordPressプラグインの基本構造を理解する
最もシンプルなWordPressプラグインは、メインファイルを1つだけ持つことができます。このメインファイルには、WordPressにプラグインの基本情報を伝えるための特定のヘッダーコメントが必要です。例えば、名前が「my-simple-plugin.php」のプラグインの場合、そのファイルの冒頭には次のようなコメントが含まれます：my-first-plugin.phpそのファイルの内容は以下のようになります：
推薦図書 WordPressプラグイン開発の完全ガイド：ゼロから始めて、あなたの最初の機能プラグインを構築する。
<?php
/**
* Plugin Name: 我的第一个插件
* Plugin URI: https://example.com/my-first-plugin/
* Description: 这是一个用于演示的简单插件。
* Version: 1.0.0
* Author: 你的名字
* License: GPL v2 or later
* Text Domain: my-first-plugin
*/このファイルを次の場所に置いてください：/wp-content/plugins/ディレクトリ内にあれば、WordPressの管理画面（バックエンド）の「プラグイン」ページでそのプラグインを確認し、有効にすることができます。これがプラグインの最も基本的な形態ですが、現時点ではまだ何の機能もありません。
あなたの最初の機能プラグインを構築しましょう。
実際の例から始めましょう。記事の末尾に自動的に著作権情報を追加するプラグインを作成します。この例は、このプラグインのいくつかの核心的な概念を説明するためのものです。
プラグインのメイン関数を定義する
私たちは、著作権情報を生成して出力するための関数を作成する必要があります。その関数の名前を「generateCopyrightInfo」とします。myplugin_add_copyright_textこの関数の内部では、現在の記事の情報を取得し、それを組み合わせて著作権表示用のテキストを生成します。
function myplugin_add_copyright_text( $content ) {
if ( is_single() ) {
$current_year = date( 'Y' );
$copyright_text = '<p class="myplugin-copyright">© ' . $current_year . ' すべての権利を保有します。この記事は私のウェブサイトで初めて公開されました。</p>';
$content .= $copyright_text;
}
return $content;
}フックを使用してWordPressに機能を統合する
単独の関数は自動的に実行されません。WordPressの「フィルターフック（Filter Hook）」を使用して、記事の内容が出力される前に自分たちの関数を適用する必要があります。ここではその方法を説明します。the_contentこのフィルター。
add_filter( 'the_content', 'myplugin_add_copyright_text' );上記のファイルヘッダーとこれら2つのコードを同じファイルに統合してください。phpこのファイルには、基本的な機能を持つプラグインが含まれています。このプラグインは、個々の記事の本文の後に、現在の年号を含む著作権情報を追加します。
推薦図書 ゼロからワンへ：WordPressプラグイン開発入門とベストプラクティスガイド。
出力内容に基本的なスタイルを追加します。
著作権情報をより見栄えの良いものにするために、いくつかのシンプルなCSSスタイルを加えることができます。ベストプラクティスとしては、wp_enqueue_style関数を使ってスタイルシートの読み込みを順番に行い、必要な時だけ読み込むようにします。スタイルシート用のファイルを作成する必要があります。style.cssそして、それをメインプラグインファイルに登録してください。
メインプラグインファイルに以下の内容を追加してください：
function myplugin_enqueue_styles() {
wp_enqueue_style( 'myplugin-style', plugins_url( 'css/style.css', __FILE__ ) );
}
add_action( 'wp_enqueue_scripts', 'myplugin_enqueue_styles' );その後、プラグインのディレクトリ内に新しいファイルを作成してください。css/style.cssファイルを開き、スタイルを追加してください：
.myplugin-copyright {
font-size: 0.9em;
color: #666;
border-top: 1px solid #eee;
padding-top: 10px;
margin-top: 20px;
}プラグインの設定オプションを実装する
成熟なプラグインでは、通常ユーザーがいくつかのカスタム設定を行うことができます。著作権プラグインにはバックエンド設定ページを追加し、ユーザーが著作権表示テキストを変更できるようにします。
「バックエンド設定メニューページを作成する」
まず、WordPressの管理画面（ダッシュボード）の「設定」メニューにサブメニュー項目を追加する必要があります。これには以下の手順を踏む必要があります：add_options_page関数。
function myplugin_add_settings_page() {
add_options_page(
'版权插件设置', // 页面标题
'版权设置', // 菜单标题
'manage_options', // 权限
'myplugin-settings', // 菜单slug
'myplugin_render_settings_page' // 用于输出页面内容的回调函数
);
}
add_action( 'admin_menu', 'myplugin_add_settings_page' );登録設定、ブロック、フィールド
WordPressは、設定項目を安全かつ簡単に処理するためのSettings APIを提供しています。私たちは、設定グループ1つ、実際の設定項目1つ（データベースに保存される）、そしてフィールド1つ（フォームの入力欄）を登録する必要があります。
function myplugin_register_settings() {
register_setting( 'myplugin_settings_group', 'myplugin_copyright_text' );
add_settings_section( 'myplugin_main_section', '主要设置', null, 'myplugin-settings' );
add_settings_field( 'myplugin_text_field', '版权文本', 'myplugin_render_text_field', 'myplugin-settings', 'myplugin_main_section' );
}
add_action( 'admin_init', 'myplugin_register_settings' );
// 渲染文本字段的函数
function myplugin_render_text_field() {
$option_value = get_option( 'myplugin_copyright_text', '© [year] 版权所有。本文首发于我的网站。' );
echo '<input type="text" name="myplugin_copyright_text" value="' . esc_attr( $option_value ) . '" class="regular-text" />';
echo '<p class="description">プレースホルダーを使用することができます。 <code data-no-auto-translation="">[year]</code> `%Y`は現在の年を表します。</p>';
}その中で、myplugin_render_settings_pageこの関数は、設定ページ全体のHTMLフォーム構造を出力する役割を果たします。
推薦図書 WordPressプラグイン開発完全ガイド：ゼロからカスタム機能の構築まで。
メイン関数を修正して、動的なテキストをサポートできるようにしましょう。
現在、最初のメイン関数を修正する必要があります。myplugin_add_copyright_textデータベースからユーザーが設定したテキストを読み取り、そこに含まれる置換子を置き換えてください。
function myplugin_add_copyright_text( $content ) {
if ( is_single() ) {
$text = get_option( 'myplugin_copyright_text', '© [year] 版权所有。本文首发于我的网站。' );
$text = str_replace( '[year]', date( 'Y' ), $text );
$copyright_text = '<p class="myplugin-copyright">'. $text .'</p>';
$content .= $copyright_text;
}
return $content;
}プラグインのリリースとメンテナンス
開発が完了し、テストも終わったら、自分の作品をより多くの人に共有したいと思うでしょう。これには、作品をパッケージ化し、公開する作業、そしてその後のアップデートが必要になります。
標準に従ってパッケージを作成し、公開します。
はい。wp-content/plugins/ディレクトリ内では、プラグインは独立したフォルダ内に配置する必要があります。例えば：my-first-plugin/このフォルダには、通常少なくともメインプラグインのファイルが含まれています。my-first-plugin.php、一つREADME.txt（プラグインの説明とインストール方法）および考えられる問題点についてassets（画像）includes（追加のPHPファイル）js、cssサブディレクトリも含めて、ファイル構造が明確であることを確認してください。
もしプラグインをWordPressの公式プラグインディレクトリに提出する予定であれば、そのガイドラインを厳守する必要があります。開発者ガイドコードの標準化、セキュリティ性、互換性、そしてSubversion（SVN）を用いたバージョン管理も含まれます。
プラグインの安全性を確保する
セキュリティは非常に重要です。ユーザーが入力したデータや動的なデータについては、常に検証、クリーニング、およびエスケープ処理を行ってください。
1. 验证（Validation）：检查数据是否符合预期的格式（如是否为邮箱、数字）。
2. 清理（Sanitization）：在将数据存入数据库或用于其他操作前，移除其中的不安全字符。对于表单输入，使用sanitize_text_fieldまたはsanitize_textarea_field。
3. 转义（Escaping）：在将数据从数据库输出到HTML页面时，确保其中的特殊字符被正确转换，防止XSS攻击。使用esc_html、esc_attrまたはwp_kses_post。
例えば、設定項目をフォームに出力する際には、私たちは以下の方法を使用しました：esc_attr：
echo '<input ... value="' . esc_attr( $option_value ) . '" ... />';将来のアップデートの方向性を計画する
プラグインには明確なバージョン番号（例：1.0.0）を設定し、セマンティックなバージョン管理に従ってください。また、更新するたびにプラグインのメインファイルの冒頭にコメントを追加してバージョン番号を更新してください。Version情報。
プラグインのアップデート時にデータベースの構造を更新したりデータを移行したりする必要がある場合は、WordPressのアップグレードメカニズムを利用することができます。比較することもできます。get_option( ‘myplugin_version’ )保存されている古いバージョン番号と現在のバージョン番号を比較し、バージョンの変更が検出された場合にアップグレードタスクを実行します。
プラグインを最新バージョンのWordPressおよびPHPと互換性のある状態に保ち、定期的にテストを行い、ユーザーのフィードバックに基づいて継続的に改善していく必要があります。
概要
WordPressプラグインの開発とは、アイデアを具体的な機能に変換し、それによってウェブサイトの機能性を高めるプロセスです。まずはシンプルなプラグインから始めて…phpファイルの開始部分では、アクションフックやフィルターフックを使用して機能を統合し、Settings APIを活用してユーザーフレンドリーな設定インターフェースを構築します。最後にはセキュリティ規格とバージョン管理に従ってリリースおよびメンテナンスを行います。これらの各ステップは、モジュール化および標準化された開発思想を体現しています。重要なのは、WordPressのフックシステムとAPIを深く理解し、常にセキュリティとユーザー体験を最優先にすることです。これらの基礎をマスターすれば、特定のニーズに応じた強力なツールを構築する能力が身につき、「ゼロから一」を実現することができるのです。
FAQ よくある質問
WordPressプラグインを開発するには、どのような基礎知識が必要ですか？
PHPプログラミング言語の基礎知識が必要です。なぜなら、これがWordPressの主要な開発言語だからです。また、HTML、CSS、JavaScriptについても基本的な理解が求められます。これらはフロントエンドの表示やインタラクションを処理するために使用されます。MySQLデータベースの基本概念（例えばクエリ）や、WordPress自体のコア関数、フック（ActionsやFilters）、そしてよく使われるAPI（例えばOptions API）についても理解しておくことが不可欠です。
私が開発したプラグインのデバッグ方法はどのようにすればいいのでしょうか？
WordPressのプラグイン開発にはいくつか効果的なデバッグ方法があります。まず、以下のことを確認してください：wp-config.phpファイルを開くWP_DEBUGとWP_DEBUG_LOGこのようにすると、エラーや情報が記録されます。/wp-content/debug.logファイルの内容は、ユーザーに直接表示しないようにしてください。次に、広範囲にわたってこの方法を活用することができます。error_log()この関数は、変数の情報をログに出力します。さらに、ブラウザの開発者ツール（コンソールやネットワークタブ）を使用してフロントエンドのJavaScriptエラーやAPIリクエストを確認したり、PHPStormやVS Codeのような専門的なIDEを使ってデバッグを行うことも、非常に効率的な方法です。
プラグインは第三者のAPIを呼び出すことができますか？
もちろん可能です。WordPressのプラグインでは、天気予報サービス、ソーシャルメディア、決済ゲートウェイなどの第三者APIを呼び出すことができます。APIを呼び出す際には、WordPressが提供するHTTP API関数を使用する必要があります。wp_remote_get()、wp_remote_post()それらは、ネイティブのPHP cURLよりも優れています。file_get_contentsより安全であり、タイムアウトや再試行などのメカニズムが組み込まれています。API呼び出しが失敗する可能性（例：ネットワークのタイムアウト、エラーコードの返却など）には必ず対処し、返されたデータについて厳格な検証とクリーニングを行い、その安全性を確保してください。
私のプラグインでは、どのようにして多言語対応（国際化）を実現するのでしょうか？
WordPressはGNU gettextテクノロジースタックを使用して国際化（i18n）とローカライゼーションを実現しています。プラグイン内で翻訳が必要なすべてのテキストは、特定の関数を使用して処理する必要があります。例えば：__('文本', 'my-plugin-textdomain')翻訳後の文字列を返すために使用されます。_e('文本', 'my-plugin-textdomain')直接出力用です。プラグインのファイルヘッダー内で定義する必要があります。Text Domainそして、これを使用してください。load_plugin_textdomain()関数は適切なタイミングで実行されるべきです（例えば、データが準備されたときや処理が完了したときなど）。init（アクション）翻訳ファイルを読み込みます。その後、Poeditのようなツールを使用して翻訳を作成します。.potテンプレートファイルは、翻訳者が異なる言語のテキストを生成するために使用されます。.poと.moファイル。
ビジネス向けプラグインを開発する際には、以下の点に注意する必要があります：
商用プラグインの開発には、より高い専門性が求められます。コードの品質、アーキテクチャ設計、セキュリティ、パフォーマンスのすべてがより高い基準に達していなければなりません。明確で競合しないライセンス認証システムを設計する必要があります（これは通常、自社のサーバーまたは第三者サービスを通じて実現されます）。専門的な技術ドキュメント、ユーザーマニュアル、そしてタイムリーなテクニカルサポートチャネルの提供が非常に重要です。プラグインに自動更新機能を組み込むことで（WordPress.orgではなく、自社のサーバーを使用して）、ユーザーは新しいバージョンやパッチをより簡単に入手できるようになります。また、ユーザー契約やプライバシーポリシーを明確にし、GDPRのようなデータ保護法規を遵守することも必須です。
次はどうする？
拡大読書と実践的知識
以下は、この記事のトピックに関連しており、さらに深く読むのに適している。あなたの現在の問題に最も近い記事から優先順位をつけ、徐々に周辺のトピックに広げていく方が良い場合が多い。
日本語