プラグインを作成するための基礎知識（必要な知識の種類や、基本的な手順など）

言語

PHP
WordPressのウェブサイトのほとんどはバックエンドサーバー側のプログラミング言語のPHPで構成されている。ユーザーがPHPコードを含むWebページを作成したい時、サーバー上でインストールしたPHPモジュールによって処理されます。もしさらに修正が求められる場合は、HTML・CSSも必要になるでしょう。

ソフトウェア

プラグインを作成するためにWordPress、もちろんセットアップの環境、ドメイン、ホスト、アカウントにアクセスするための管理権限が必要となる。

手順

新しいプラグインを作成するときは、以下の手順に従ってください。

• wordpress配下にあるwp-contentに進む
• pluginフォルダを開く
• 新しくディレクトリを作成し、プラグインの後に名前をつける。(例:name-plugin)
• 新しく作成したpluginフォルダを開く。
• 新しくPHPファイルを開く。(例:name-plugin.php)
• ちょうど作成したPHPファイルを編集します。プラグインのヘッダーコメントを追加することが必須です。あなたのプラグインの名前や著者などのメタデータが含まれる特別なPHPコメントを形成する。最低限、プラグインヘッダーのコメントにはプラグインの名前が含まれていなければならない。pluginフォルダの一つのファイルにのみ、ヘッダーコメントを記述し、どんなに多くのファイルがpluginディレクトリに存在しても、ヘッダーコメントを持つファイルは一つだけにする。
• ファイルを保存し、WordPressの管理画面、プラグインのリストの中に確認することができる。確認するために、WordPressにログインし、左サイドバーの「プラグイン」を選択。そのページはプラグインがそのWordPressにインストールされる全てのプラグインが表示される。あなたの作成した新しいプラグインがリストの中から確認できるでしょう。

ヘッダーコメントについて

たとえ簡単なプラグインであれ、WordPressのプラグインはWordPressプラグインヘッダーコメントをもつPHPファイルです。ヘッダーコメントは一つのディレクトリ内の同じ機能をもつプラグインに置くことを高く定義され、これは簡単に管理、運用ができる。上記の述べたように、ヘッダーコメントはどのようなプラグインかWordPressに示している。したがって、ヘッダーコメントは最低でも、プラグインの名前を含めなければならないが、いくつかの他のコメントを含むことが望まれる。

• Plugin Name(必須):プラグインの名前。WordPressの管理画面内プラグインリストページに表示されます。
• Plugin URL:ホームページのプラグイン。独自のURLを望まれる。あなた自身のウェブサイトがよく、WordPress.orgのURLはここでは使用できない。
• Description:プラグインの短い説明文。管理画面のプラグインの箇所に表示され、140文字以下で記述しなければならない。
• Version:現在のプラグインのバージョン。1.0や1.0.3などと表示される。
• Authour:プラグインの開発者の名前。複数名の場合はカンマで分けて使う。
• Authour URL:開発者の他のウェブサイトやプロフィール。
• License:短い名前のプラグインのライセンス
• License URL:ライセンスのURL(例:https://www.gnu.org/licenses/gpl-2.0.html)
• Text Domain:gettextで記述されるプラグインのテキストドメイン(例:posts-to-posts)
• Domain Path:WordPresにどこにあるかフォルダがあるかと教えるためのパス。

フック：アクションとフィルター

WordPressフックは中心となるファイルを編集することなく、WordPressがどのように動くかを特定の箇所を修正することができます。WordPressの中には「アクションフック」と「フィルターフック」の2種類のフックが存在します。

基本的なフック

プラグインを作るときに基本的な3つのフックが必要になります。

カスタムフックを追加する

フックの機能を通すことによって開発者が独自のプラグインを拡張する「do_action」を使用してカスタムフックを追加することができます。

カスタムフックを削除する

早くて定義された機能を削除するために「remove_action()」で呼び出すことができる。例えばもしあなたのプラグインがもう一つのプラグインに拡張するときに、前のプラグインの「add_action()」により追加された機能を呼び戻すことができる。「remove_action()」は最初の「add_action()」の後に処理する必要があり、その中の状況においてアクションの優先度は重要である。これは「add_action()」の反対に似ている。
優先度を変更するときと同様に、フックからアクションを削除するときは常に注意しなければならない。なぜならその作業によりどのような変更が、同じフックに他の影響を与えるか判断するのが難しいからです。よくテストを行ってから実行することを進める。

WordPressのプラグインのAPIを使う

WordPressの中心の「Application Programming interface(API)」はそれぞれ機能形成し利用することに関連しているファイルを圧縮されたいくつかの独自 APIである。それらは共に働くことによってWordPressのプラグインやテーマに相互影響を及ぼし、変化、拡張することを許可するプロジェクト・インターフェイスを構築することができる。WordPressを開発するときのAPIのコアを使うことを好ましい。

どのようにWordPressはプラグインを読み込むのか

WordPressが管理画面のプラグインページにおいて、インストールされたプラグインを読み込むとき、WordPressのヘッダーコメントに記載されたPHPファイルを探すためにプラグインのディレクトリにあるフォルダを通して探します。もしPHPファイルが一つであるのなら、そのファイルはプラグインフォルダの中にあるだろう。しかし、より一般的にプラグインファイルはそれらの個別のフォルダーに存在し、プラグインの後ろに名前をつけられる。

ショートコード

ショートコードは、コンテンツをきれいに保ち、プログラムの機能を維持し、エンドユーザーがコンテンツの表示をプログラムで変更できるようにする貴重な方法です。エンドユーザがショートコードを使用してポストにフォトギャラリーを追加すると、ギャラリーの提示方法を示すためにできるだけデータを使用していません。