WordPress Plugin Developer Handbook

WordPress プラグイン開発者ハンドブックへようこそ。 WordPress プラグインの世界に飛び込む準備はできていますか？ プラグイン開発者ハンドブックは、WordPress プラグインに関するすべてのリソースです。 WordPress プラグイン開発の初心者でも、経験豊富なプラグイン開発者でも、ここでプラグイン関連の質問の多くに対する答えを見つけることができます。 プラグイン開発が初めての場合は、はじめにを読んでから基本に進んでください。 セクション3では、プラグインのセキュリティについて紹介します。 フックは、プラグインが WordPress と対話するためのものです。 セクション4でそれらのすべてについて学びます。 プラグインで使用できる WordPress の組み込み機能の詳細については、管理メニュー、ショートコード、設定、メタデータ、カスタム投稿タイプ、分類法、ユーザーのセクション5〜11をご覧ください。 セクション12で HTTP API...

プラグイン開発者ハンドブックへようこそ。 初めてのプラグインを作成する場合も50代目のバージョンを作成する場合も、このリソースが最高のプラグインの作成に役立つことを願っています。 プラグイン開発者ハンドブックは、プラグインヘッダーにあるべきものから、セキュリティのベストプラクティス、プラグインのビルドに使用できるツールまで、さまざまなトピックを扱っています。 また、進行中の作業です。不足しているものや不完全なものを見つけた場合は、編集して改善してください。 WordPressには3つの主要なコンポーネントがあります。 core themes plugins このハンドブックでは、プラグインと、WordPressとの相互作用について説明しています。 それらがどのように機能し、独自のものを作成するかを理解するのに役立ちます。 プラグインを作成する理由 WordPress 開発に基本的なルールが1つあり、それは WordPress のコアに触れないことです。 つまり、WordPress のコアファイルを編集してサイトに機能を追加することはしてはいけません。 これは、WordPress が新しいバージョンに更新されると、すべてのコアファイルが上書きされるためです。 したがって、追加する機能はすべて、承認済みの...

プラグインは、WordPress のコア機能を拡張するコードのパッケージです。 WordPress プラグインは、PHP コードと、画像、CSS、JavaScript などの他のアセットで構成されています。 独自のプラグインを作成することにより、WordPress を拡張します。つまり、WordPress が既に提供しているものの上に追加機能を構築します。 たとえば、サイトの最新の10個の投稿へのリンクを表示するプラグインを作成できます。 または、WordPressのカスタム投稿タイプを使用して、メール通知、カスタムチケットステータス、クライアント向けポータルを備えたフル機能のサポートチケットシステムを作成するプラグインなどを作成できます。 可能性は無限大！ ほとんどの WordPress プラグインは多くのファイルで構成されていますが、プラグインに必要なのは、ヘッダー内に特別にフォーマットされた DocBlock を含むメインファイル1つだけです。 最初のプラグインの1つである Hello Dolly...

入門 最も簡単な例では、WordPress プラグインは、WordPress プラグインのヘッダーコメントを含む PHP ファイルです。 プラグインのすべてのファイルが1か所に整理されるように、プラグインを保持するディレクトリを作成することを強くお勧めします。 新しいプラグインの作成を開始するには、以下の手順に従ってください。 WordPress インストールの wp-content ディレクトリに移動します。 プラグインディレクトリを開きます。 新しいディレクトリを作成し、プラグインにちなんで名前を付けます（例：plugin-name）。 新しいプラグインのディレクトリを開きます。 新しい PHP ファイルを作成します（プラグインにちなんでこのファイルに名前を付けるとよいでしょう（例：plugin-name.php））。 Unix コマンドラインでのプロセスは次のとおりです。...

入門で説明したように、メイン PHP ファイルには、ファイルがプラグインであることを WordPress に伝え、プラグインに関する情報を提供するヘッダーコメントを含める必要があります。 最小フィールド 少なくとも、ヘッダーコメントにはプラグイン名を含める必要があります。 ヘッダーフィールド 利用可能なヘッダーフィールド： Plugin Name：（必須）WordPress Admin のプラグインリストに表示されるプラグインの名前。 Plugin URI：プラグインのホームページ。一意の URL である必要があります（できれば独自の Web サイト上にあります）。これはプラグインに固有でなければなりません。ここでは WordPress.org...

ほとんどの WordPress プラグインは GPL の下でリリースされます。これはWordPress 自体が使用するのと同じライセンスです。 ただし、他のオプションも利用できます。 プラグインが使用するライセンスを明確に示すことが常に最善です。 ヘッダー要件セクションで、プラグインヘッダーコメント内でプラグインのライセンスを指定する方法について簡単に説明しました。 別の一般的で推奨される方法は、メインプラグインファイル（プラグインヘッダーコメントがあるもの）の上部近くにライセンスブロックコメントを配置することです。 通常、このライセンスブロックコメントは次のようになります。 プラグインヘッダーコメントと組み合わせると：

アクティブ化および非アクティブ化フックは、プラグインがアクティブ化または非アクティブ化されたときにアクションを実行する方法を提供します。 アクティベーション時に、プラグインはルーチンを実行して、書き換えルールの追加、カスタムデータベーステーブルの追加、またはデフォルトオプション値の設定を行うことができます。 非アクティブ化すると、プラグインはルーチンを実行して、キャッシュや一時ファイルやディレクトリなどの一時データを削除できます。 非アクティブ化フックはアンインストールフックと混同されることがあります。 アンインストールフックは、プラグインオプションやカスタムテーブルなどの削除など、すべてのデータを完全に削除するのに最適です。 有効化（アクティブ化） アクティブ化フックをセットアップするには、register_activation_hook()関数を使用します。 無効化（非アクティブ化） 非アクティブ化フックをセットアップするには、register_deactivation_hook()関数を使用します。 これらの各関数の最初のパラメーターは、メインプラグインファイルを参照します。メインプラグインファイルは、プラグインヘッダーコメントを配置したファイルです。 通常、これらの2つの関数はメインプラグインファイル内からトリガーされます。 ただし、関数が他のファイルに配置されている場合は、メインプラグインファイルを正しく指すように最初のパラメーターを更新する必要があります。 例 アクティベーションフックの最も一般的な用途の1つは、プラグインがカスタム投稿タイプを登録するときに WordPress パーマリンクを更新することです。 これは厄介な 404 エラーを取り除きます。 これを行う方法の例を見てみましょう:...