WordPressプラグイン開発入門ガイド：ゼロから公開までの全プロセス

準備作業と開発環境の構築

どんなコードの作成を始める前にも、科学的な開発環境を整えることが成功への第一歩です。まず、ローカルに独立したWordPress環境をインストールする必要があります。XAMPP、MAMP、Local by Flywheel、Laragonなどの統合開発環境の使用を強くお勧めします。これらの環境では、PHP、MySQL、ウェブサーバー（通常はApacheまたはNginx）をワンクリックで設定することができます。開発環境で使用しているPHPのバージョンが対象とするWordPressのバージョンと互換性があることを確認してください。一般的にはPHP 7.4以降のバージョンの使用が推奨されています。

次に、コードエディタまたは統合開発環境（IDE）が必要になります。PHPStorm、Visual Studio Code、Sublime Textなどが優れた選択肢であり、これらには構文ハイライト、コードデバッグ、バージョン管理の統合などの機能が備わっています。WordPressのプラグインファイルの構造を明確に表示できるエディタを使用することは、プラグインの仕組みを理解する上で非常に重要です。

コーディングを始める前に、WordPressプラグインのコアファイルについて理解しておく必要があります。すべてのプラグインは、少なくとも1つのメインPHPファイルで構成されており、そのファイルの名前は例えば「main.php」といった具合になります。 my-first-plugin.phpこのファイルには特別なプラグインヘッダー情報を含める必要があります。これはプラグインの「身分証明書」のようなもので、WordPressにそのプラグインの基本情報を伝えるためのものです。また、プラグインのディレクトリ構造もしっかりと計画してください。シンプルなプラグインは1つのファイルだけで構成されることもありますが、複雑なプラグインの場合は通常、複数のディレクトリが含まれます。 /assets/ CSSおよびJavaScriptファイルを保存する場所です。/includes/ 機能関連のファイルを保存するための場所です。/languages/ 国際化ファイルを保管する際には、明確な構造を確立することが大切です。これにより、ファイルの管理が容易になり、チーム内での協力もスムーズに進むでしょう。

推薦図書 ゼロからWordPressプラグイン開発をマスターする：完全ガイドと実践トレーニング。

コアプラグイン開発プロセス

プラグインを作成する際の核心的なプロセスは、メインファイルの作成から始まります。すべてのプラグインは、特定のヘッダーコメントで始めなければなりません。このコメントには、WordPressプラグインの名前、説明、バージョン、作者などの情報が記載されます。

UltaHostのWordPressホスティングサービス

30日間の返金保証、無制限の帯域幅とデータベースサービス、無料のDDoS防御機能が付きます。3年契約をすると、501TPから4Tまでのプランで割引が適用されます。

アクセスページ

以下は、最も基本的なプラグインのメインファイルの例です。このファイルは、直接以下の場所に配置する必要があります： /wp-content/plugins/ ディレクトリ内には、例えば… example-plugin/example-plugin.php。

<?php
/**
 * 插件名称: 我的第一个插件
 * 插件 URI: https://example.com/my-first-plugin
 * 描述: 这是一个用于演示的基础WordPress插件。
 * 版本: 1.0.0
 * 作者: 张三
 * 作者 URI: https://example.com
 * 许可证: GPL v2 or later
 * 文本域: my-first-plugin
 */

// 防止直接访问文件
if ( ! defined( 'ABSPATH' ) ) {
    exit; // 如果ABSPATH未定义，则退出脚本
}

このファイルを保存すると、WordPressの管理画面にある「プラグイン」ページでそのプラグインを確認し、有効にすることができます。現時点では何も動作しませんが、これによりプラグインの基本枠組みが完成したということになります。次に、プラグインに必要な核心的な機能ロジックを導入する必要があります。

典型的な機能の一つとして、WordPressのページや記事の内容を変更することが挙げられます。簡単な関数を作成し、WordPressのフィルターフック（Filter Hook）を利用してその関数をコンテンツに適用することができます。例えば、以下のコードはすべての記事の末尾に自動的にカスタムテキストを追加します。まず、関数を定義しましょう。 myplugin_add_footer_textその後、使用します。 add_filter この関数は、それを特定の場所にマウント（つまり、利用可能な状態にする）します。 the_content フィルターの上にあります。

// 在文章内容末尾添加自定义文本的函数
function myplugin_add_footer_text( $content ) {
    // 仅对主循环中的文章单页生效
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $custom_text = '<p><em>この記事は、「My First Plugin」によって内容が強化されています。</em></p>';
        $content .= $custom_text;
    }
    return $content;
}
// 将函数挂载到 `the_content` 过滤器
add_filter( 'the_content', 'myplugin_add_footer_text' );

フィルターに加えて、アクションフック（Action Hook）もWordPressの機能を拡張するための重要な手段です。フィルターとは異なり、アクションは特定のタイミングでタスクを実行するために使用されます。例えば、管理画面でメニューページを追加する際などです。これを活用することで、WordPressの動作をより柔軟にカスタマイズすることができます。 add_action 関数をマウントするための処理が必要です。例えば、バックグラウンドで設定メニュー項目を追加する場合、そのメニュー項目は通常、特定の場所にマウントされます。 admin_menu このアクションフック。

推薦図書 ゼロからWordPressプラグイン開発をマスターする：カスタム機能の構築とベストプラクティス。

高度な機能と統合

プラグインの機能が増えていくにつれて、すべてのコードをメインファイルにまとめてしまうと管理が困難になります。高度なプラグイン開発では、オブジェクト指向プログラミング（OOP）を用いてコードを整理することが推奨されます。プラグインの核心機能を表すクラスを作成することで、データや機能をより効果的にカプセル化でき、名前の衝突を減らすことができます。

以下は、クラスメソッドを使用して簡単なコード機能を実現する例です。ここでは、あるクラスを作成します。 My_Shortcode_Plugin ショートコードを登録するには、まずクラスのコンストラクターを定義し、その中でショートコードを登録する必要があります。

class My_Shortcode_Plugin {
    public function __construct() {
        // 在构造函数中注册短代码
        add_shortcode( 'greeting', array( $this, 'render_greeting_shortcode' ) );
    }

// 短代码渲染函数
    public function render_greeting_shortcode( $atts, $content = null ) {
        // 处理短代码属性
        $atts = shortcode_atts( array(
            'name' => '访客',
        ), $atts, 'greeting' );

// 返回渲染的输出
        return '<div class="greeting">こんにちは、' . esc_html($atts['name']) . '！' . $content . '</div>';
    }
}
// 实例化插件类
new My_Shortcode_Plugin();

機能自体に加えて、優れたプラグインであればフロントエンドのスタイルやインタラクションも考慮する必要があります。つまり、CSSやJavaScriptファイルを安全に読み込む必要があるのです。WordPressには、スクリプトやスタイルシートを登録したり追加したりするための完璧なAPIが用意されています。

hosting.com 共有ホスティング

AMD EPYC CPU、NVMe SSDストレージ、LiteSpeedによる高いパフォーマンス、24時間365日の専門家による社内サポート、SSL、ブルートフォース、マルウェア、DDoS保護などの高度なセキュリティ対策、最大73%のコスト削減

アクセスページ

あなたは以下の方法で… wp_register_script、wp_register_style そして、それに対応する追加（加入）関数もあります。 wp_enqueue_script と wp_enqueue_style これを完了するためには、例えば以下のコードのように、フロントエンドでプラグインのスタイルシートを登録し、それに追加する方法を示しています。通常、私たちは… wp_enqueue_scripts フックはフロントエンドで使用されますが、 admin_enqueue_scripts フックはバックエンドで使用されます。

// 注册并加入插件前端样式和脚本的函数
function myplugin_enqueue_assets() {
    // 注册一个CSS文件
    wp_register_style(
        'myplugin-frontend-style',
        plugins_url( 'assets/css/frontend.css', __FILE__ ),
        array(),
        '1.0.0'
    );
    // 将CSS文件加入队列
    wp_enqueue_style( 'myplugin-frontend-style' );
}
// 挂载到 `wp_enqueue_scripts` 钩子（前端）
add_action( 'wp_enqueue_scripts', 'myplugin_enqueue_assets' );

さらに、バックエンドのオプションページを作成することは、現代のプラグインにとってよくある要求です。これにはWordPressのSettings APIを使用する必要があります。Settings APIは、設定オプションを作成、検証、保存するための安全で標準化された方法を提供しています。あなたはそれを使用する必要があります。 add_options_page この関数を使用してサブメニューページを追加します。 register_setting、add_settings_section と add_settings_field などの関数を使用して設定フォームを構築し、データを処理します。

プラグインのテスト、パッケージング、およびリリース

完成编码后，严格的测试是确保插件质量的关键。你需要在不同环境下进行测试。确保在你的本地开发环境中进行核心功能测试，然后在模拟线上环境的 Staging 服务器上进行兼容性测试。测试应包括：与当前和上一主要版本的 WordPress 兼容性测试；与你使用的主题和其他流行插件的兼容性测试；对新旧 PHP 版本（如 PHP 7.4 与 8.x）的兼容性测试；以及前端在不同浏览器（如 Chrome, Firefox, Safari）上的表现测试。启用 WordPress 调试模式可以帮助你发现 PHP 错误或警告。在 wp-config.php ファイル内に設定を行います。 WP_DEBUG ために true この機能を有効にすることができます。

推薦図書 WordPressプラグイン開発入門ガイド：ゼロから始めて、あなたの最初の機能拡張を構築する。

プラグインの安定性が確認されたら、パッケージングに先立って準備を行う必要があります。これには少なくとも2つの重要なステップが含まれます：コードの国際化（i18n）とReadmeファイルの準備です。国際化により、プラグインを複数の言語でサポートできるようになり、これはプラグインを世界中に広めるための基本となります。ユーザーに表示されるすべてのテキストについて、WordPressの翻訳機能を使用する必要があります。 ()、_e() と esc_html()。同時に、 /languages/ ディレクトリ内にPOTテンプレートファイルを置いておき、翻訳者が使用できるようにしてください。

もう一つ必要なファイルは、標準的な形式で作成されたものです。 readme.txtこれはWordPress公式のプラグインディレクトリでの表示用に使用され、特定の構文形式で記述する必要があります。プラグインの名前、説明、インストール手順、よくある質問、アップデート履歴などの情報を含めなければなりません。WordPress.orgでは… readme.txt そのフォーマットには厳格な要件がありますので、公式ドキュメントを参照して作成してください。

インターサーバー共有ホスティング

共有ホスティング月$2.50米ドル, 最初の月$0.1米ドルプロモーションコードtryinterserver, 461クラウドアプリケーションスクリプト, 1クリックインストール.

アクセスページ

準備作業が完了したら、パッケージングを開始できます。一時的なフォルダを作成し、開発ツール（GitディレクトリやIDEの設定ファイルなど）や最終的に不要になるファイル（元のPSDファイルなど）を除く、すべてのプラグインファイルをそこにコピーしてください。すべてのファイルのパスと権限が正しいかを確認してください。その後、ZIP圧縮ツールを使用してこれらのファイルをZIPファイルに圧縮してください。 my-first-plugin-v1.0.0.zipこのZIPファイルのルートディレクトリには、あなたのプラグインのフォルダが直接存在するはずです。

最後に、待ち望ましいリリース段階です。WordPress.orgで無料のSVNコードリポジトリを申請することができます。これがプラグインを公式ディレクトリに公開するための唯一の手段です。基本的なSVNコマンドに精通しておく必要があり、整理されたプラグインコードを初めてリポジトリにコミットする必要があります。 /trunk/ 目次。処理が完了しました。 readme.txt メインファイル内の安定版番号が更新された後、新しい SVN ラベルを作成することができます（例：） /tags/1.0.0/バージョンを公開するには、このフォーマットを使用してコードをアップロードします。提出後、WordPress.orgのシステムが自動的に処理を行い、通常数時間後にはあなたのプラグインが公式のディレクトリに掲載されます。そこから世界中のユーザーが検索してインストールすることができるようになります。

概要

ゼロからWordPressプラグインを開発することは、体系的で達成感のあるプロセスです。まずはローカル環境の構築とコアファイルの構造を理解することから始まり、プラグインヘッダー情報の作成やフィルター・アクションフックの利用を通じてコア機能を実現していきます。要件が複雑になるにつれて、オブジェクト指向プログラミングの導入、フロントエンドリソースの安全な組み込み、バックエンド管理インターフェースの構築が必須のスキルとなります。開発サイクルの最後には、包括的な互換性テスト、厳格な国際化対応、ドキュメントの作成、そして規格に準拠したパッケージングとリリースプロセスを行うことで、プラグインを個人の作品からコミュニティで利用できる信頼性の高い製品へと昇華させます。この全プロセスをマスターすることで、特定のウェブサイトのニーズを解決するだけでなく、WordPressエコシステムの構築にも深く貢献することができるようになります。

FAQ よくある質問

###の開発プラグインを作成するには、どのような前提知識が必要ですか？
WordPressプラグインを開発するには、まずPHPプログラミングのしっかりとした基礎が必要です。なぜなら、プラグインのコードは主にPHPで書かれているからです。また、フロントエンドの表示やインタラクションを処理するために、HTML、CSS、JavaScriptについても基本的な知識が必要です。WordPressの基本概念（テーマ、フック（Hooks）、ショートコード（Shortcode）、クエリ（Query）、各種API（Options API、REST APIなど）に精通していることが、効率的な開発の鍵となります。すべての分野の専門家である必要はありませんが、これらの知識を持っていると開発の過程で無駄な手間を省くことができます。

如何有效调试自定义插件中的错误？

最も効果的なデバッグ方法は、WordPressのデバッグモードを有効にすることです。ウェブサイトの wp-config.php ファイル内で該当する内容を見つけ出し、設定を行ってください。 define( 'WP_DEBUG', true );これにより、PHPのエラー、警告、および通知がページ上に直接表示されます。

変数や配列の内容をより明確に確認するためには、複数の方法を組み合わせて使用するとよいでしょう。 error_log() この関数は、情報をサーバーのエラーログに記録するか、または補助関数を使用して処理します。 print_r() または var_dump()そして、その出力をHTML形式で表示します。 <pre> タグを適切にラップすることで、フォーマットされた表示が可能になります。さらに、ブラウザの開発者ツール（F12）を使用してネットワークリクエストやJavaScriptコンソールのエラーを確認することも非常に重要なステップです。複雑なロジックについては、Xdebugなどの専門的なデバッグツールを使用することを検討してください。

なぜ私のプラグインをバックグラウンドで有効にした後も、ウェブサイトに何の変化も見られないのでしょうか？

これは通常、いくつかの一般的な原因によって引き起こされます。まず、機能コードが正しく実行されているかを確認してください。関数がすでにテストを通過していることを確認してください。 add_action または add_filter 正しいフックにマウントされており、これらのフックは期待しているページ（フロントエンドやバックエンドなど）で正しくトリガーされています。

次に、文法エラーや致命的なエラーによってプラグインが自動的に無効になっていないかを確認してください。WordPressの管理画面にある「インストール済みプラグイン」ページを確認してください。もしプラグインの名前が「破損したプラグイン」と表示されている場合、通常はプラグインのヘッダー情報が不完全であるか、メインファイルに文法エラーがあることを意味します。最後に、コードのロジックに条件分岐などが含まれていないかを確認してください。 is_single(), is_admin()これらの条件は現在のページでは満たされていない可能性があり、そのため機能が実行されないことがあります。

プラグインにユーザーが設定できる項目を追加するには、どのようにすればよいですか？

WordPressの組み込みされたSettings APIを使用して設定項目を作成することをお勧めします。これが最も安全で標準的な方法です。基本的な手順は以下の通りです：まず、 add_menu_page() または add_options_page() この関数はバックグラウンドでメニューページを追加します。その後、それを使用します。 register_setting() 関数は設定グループを登録します（セキュリティ検証および保存のために）。その後、それを使用します。 add_settings_section() あなたの設定ページに地域グループを追加してください。最後に、それを使用してください。 add_settings_field() グループ内に具体的なフォームフィールド（入力ボックス、ドロップダウンメニューなど）を追加するには、各フィールドのHTMLをレンダリングするためのコールバック関数を作成し、それをメニューページのコールバック関数内で使用する必要があります。 settings_fields() と do_settings_sections() 以下は、そのフォームの全内容です。ユーザーがフォームを送信すると、WordPressが自動的にデータの保存と検証を行います。

プラグインをWordPressの公式プラグインディレクトリにどのように提出するか？

プラグインを公式ディレクトリに提出するには、まずWordPress.orgでアカウントを登録する必要があります。その後、プラグインの提出ページにアクセスして新しいプラグイン用のSVNリポジトリを申請します。申請が承認されると、SVNリポジトリのアドレスが提供されます。次に、公式の規格に従ってプラグインのファイルを準備する必要があります。特に、要件を満たすように注意してください。 readme.txt ファイルと、標準的なヘッダーコメントを含むPHPファイルです。

SVNクライアント（コマンドラインツールやTortoiseSVNなど）を使用して、プラグインのコードを初めてリポジトリにコミットします。 /trunk/ 目次。安定版がリリースされる際には、 /trunk/ コンテンツをコピーしてください。 /tags/ ディレクトリ内に新しいタグ（例えば「new_tag」など）を作成します。 /tags/1.0.0/）、そして readme.txt 「Stable tag」フィールドの値をこのバージョン番号に更新してください。提出すると、WordPress.orgが自動的に解析して処理を行い、しばらくするとあなたのプラグインが公式ディレクトリに掲載されます。