【WordPress】０からわかる!自作プラグインの作り方

WordPressで自作のプラグインが作れるって聞いたんだけどどうやって作るのかな。プラグインを自作するってなんだか難しそう。分かりやすく教えてほしいな。

本記事は上記のような疑問に役立つ記事となっております。

WordPressを使ってWEBサイトを運営している方で有れば便利なプラグイン。

実は自作する事が出来ます。

ただ自作するとなると「エンジニアじゃないと無理なんでしょ」と思われるかもしれませんがそんな事はありません。

作り方さえ分かればエンジニアじゃない方でも簡単にプラグインを作成する事が可能です。

というわけで今回ばWordPressで使えるプラグインの作り方について見ていきたいと思います。

プラグインの作り方

それではプラグインの作り方を順を追って見てみましょう。

まず、プラグインを作る場所ですが、 WordPressをインストールしている自分のパソコンの以下の階層に作成しましょう。

app→public→wp-content→plugins

今回作るプラグインは、指定したHTMLのコードを記述してくれるショートコードを実装したいと思います。

プラグイン用のファイルの作成

では、上記の階層のpluginsの中に、X(旧Twitter)ShortCodeというフォルダを作ります。

これがプラグインの名前となります。

そしてその中にPHPのファイルを作成しましょう。

わかりやすくフォルダと同じ名前にしてもよいですし、自分だけがプラグインであれば自分でわかればなんでも良いと思います。

では、このファイルをエディタで編集していきましょう。

プラグイン用のコメントを書く

エディタでPHPファイルを開いたら、以下のようにコメントを記述しましょう。

<?php
/*
/* Plugin Name: X(旧Twitter) Short Code→プラグインの名前を書く
/* Version:1.0など→特に決まりはないですが、更新した場合は数字を加算していくと良いでしょう
/* Author:自分の名前→作成者、もしくは自分の名前を記載しましょう。

このように記述してWordPressの管理画面で見てみると以下のようにプラグインが表示され、バージョンや作成者の名前が入っています。

この中で必ず書かなくてはいけないものは、

<?php
/*
/* Plugin Name:

上記の「Plugin Name」となります。

他の記述は書かなくても問題なく管理画面に表示されますが、Plugin Nameは書かないとプラグインとして認識されず管理画面にも表示されないため注意が必要です。

ちなみにプラグインの情報として書くものには以下のものがあります。

<?php
/*
Plugin Name: (プラグインの名前)
Plugin URI: (プラグインの説明と更新を示すページの URI)
Description: (プラグインの短い説明)
Version: (プラグインのバージョン番号。例: 1.0)
Author: (プラグイン作者の名前)
Author URI: (プラグイン作者の URI)
License: (ライセンス名の「スラッグ」 例: GPL2)
*/
?>

原則は上記の項目は英語で書く必要がありますが、配布しない自分専用のプラグインであれば日本語で書いても基本的には問題ありません。

プラグインの機能の実装

ではいよいよプラグインの機能の実装を行なっていきます。

実装といってもそこまで大袈裟なものではなく、例えばfunctions.phpなどに記載している関数などを一つ選んでそれをプラグインとして使うことも出来ます。

例えば以下のような形です。

<?php
/*
/* Plugin Name: X(旧Twitter) Short Code
/* Version:1.0など
/* Author:shino
*/

function shortcode_hello(){
  return '<p>こんにちは、しの(<a href="https://twitter.com/SHINOWEB1" target="_blank">@SHINOWEB1</a>)です。</p>';
}
add_shortcode('hello','shortcode_hello');
?>

上記のコードでは、[hello]というショートコードを投稿画面で入力すると、

と表示される関数ですが、その関数をプラグインとして実装している形です。

実際に上記のようにエディタで入力し、有効化します。