wordpressでの一番簡単なプラグイン

wplugin wordpressでは、プラグインを使って、新しい機能をblog機能に追加していくことができます。たとえば、ちょっとした共通項目を管理画面から変更できるようにしたり、同じサーバーにあがっているショッピングカートから商品データを持ってきたり、web apiなどを使って関連情報を表示したりもできます！

プラグインはすでにたくさん公開されています。基本的にはそれらのプラグインで事足りるのですが、ちょっとしたカスタマイズや要求に応えるのにも便利です。今回は、nettuts+でのコンテンツを参考に、作成する際のメモ。

プラグインファイルを作成する

プラグインファイルは、最低１枚のphpファイルで成り立っています。プラグインとなる wp-content/plugins/ フォルダ内に入れるようにしましょう。

プラグインファイル位置：wp-content/plugins/test_plugin
プラグインファイル名：test_plugin.php

というように、サブフォルダの中に入れておいても読み込んでくれますので、あとで管理がしやすいよう、サブフォルダに入れることをおすすめします。
現時点では、ファイルの中身は空っぽです。

※命名規則について：ファイルに対しての命名規則はないようですが、他のスクリプトファイルと競合しない、ユニークな名前であることが必要です。（これは、この後利用する関数や、変数についても同じにようです。）

※作業環境について：直接にウェブ上でおこなうよりは、ＭＡＭＰやＸＡＭＰＰなどを利用してローカル環境で開発することをおすすめします。

管理画面にログイン

ひとまず、「プラグイン」を表示します。

先ほど作成した「test_plugin.php」に下記の内容を追加します。

<?php 
	/*
	Plugin Name: プラグイン名
	Plugin URI: プラグインが掲載されているアドレス
	Description: プラグインの説明
	Author: 制作者
	Version: 1.0
	Author URI: 制作者のアドレス
	*/
?>

plugin-1

プラグイン一覧にあなたの設定したプラグインがあれば、成功です。
「使用する」を押して、プラグインをアクティブにします。
ここから、phpファイルを拡張していきます。

今回は、単純に外部ＤＢを使わず、一番簡単な管理画面作成→表示の方法で案内します。

テンプレートの関数はどうやって作る？

テンプレート関数は、有効になっているプラグインファイルのなかで、functionを書くだけです。

<?php 
function test_view(){

	$data = "表示させたいコンテンツ";
	return $data;
}
?>

と、書き出したら、テンプレートのファイルには下記のように書くだけです。
引数ももちろんかけます。

<?php echo test_view(); ?>

管理フォームで管理するデータはどうやって扱う？

update_option(’your_data_name’, “内容”);
get_option(’your_data_name’);

your_data_nameのところは自由に変更可能ですが、ここでもユニークであることが求められます。

どんなメニューにもhookが必要(from:本家)

管理メニューを作るには、次の三つを行う必要があります:

1. メニューを作成するコードを含んだ関数を作る
2. “admin_menu”フックに上で作った関数を登録する
3. メニューがクリックされたときに表示されるページのHTML出力を作る

この３つをきちんと押さえておけばおｋ。

<?php

//*************** Admin function ***************//
function test_admin() {
	include('test_import_admin.php');
}

function test_admin_actions() {
    add_options_page("テストプラグイン", "テストプラグイン", 1, "Test", "test_admin");
}

add_action('admin_menu', 'test_admin_actions');

?>