プラグイン Post6WidgetArea 作成ステップ3

今回は、自作プラグインのクラス化に挑戦してみました
プラグインは、クラスを使用せずに記述することも出来ますが、変数や関数名の名前が衝突する可能性を低くして、安全で保守しやすいプラグインとするためには、クラスを使用して記述することがお勧めです

クラスというと難しく聞こえますが、プログラムをメンテしやすいようにするのが目的ですので、自分のスキルに合わせた範囲で対応しておくだけでOKです。

より高機能な使い方等への対応は、スキルアップに合わせて書き換えることで完成度が上げていこうと思っています

クラス化のポイント

クラスの実装は、Class定義の中に変数(プロパティ)や関数(メソッド)を記述していきます

プロパティやメソッドには、アクセス修飾子でアクセスを制限出来ます
アクセス修飾子には、public, private, protected の3種類があります

public どこからでもアクセス可能
protected クラス内部と、派生クラスの内部からのみアクセス可能
private クラス内部からのみアクセス可能

クラスを利用するためには、インスタンスを作成します
newキーワードでインスタンスを作成し、用意した変数に格納します
インスタンス変数 = new クラス名();

newでインスタンスを作成せずに static 宣言で静的変数、静的メソッドとすれば、インスタンス変数を用いずにアクセスすることも出来ます
クラス名::メソッド名()

コンストラクタ
インスタンスが作成されると、定義したコンストラクタメンバ関数 __construct() が自動的に実行されます

インスタンスが破棄される時には、デストラクタが呼び出されると思うが、いくつかのプラグインのコードを見た限りでは、特に記述していないので、システム任せで問題ないと思われます(もう少し調べる必要があり)

継承
また、クラス化すると継承を用いたプログラミングが可能になるので、本格的なオブジェクト指向のプログラムを記述することも出来ます
もう少しPHPをマスターしたら、いづれは、継承を使用したプログラムにも挑戦してみようと思っています (^_^;)

これだけで、クラスです

最低限の作業でクラス化してみます

クラス定義

初めに下記のようなクラス定義を記述します
クラス名の1文字目は大文字にしてクラスとわかりやすくしておきます

class Post6widgetarea {

    public function __construct()
    {

    }

$post6widgetarea = new Post6widgetarea();

クラスを定義するブロックエリアを設け、そのクラスのインスタンスを作成すれば、コンストラクタ部分に記述したコードが実行されます

次に、このクラスの中に今まで作成していたコードを移していきます

1.コンストラクタ

初期化処理を記述します
今まで作成したコードの関数以外のプログラム記述部分で add_action, add_filter や get_option によるオプションデータの読み込み処理等が該当します

2.変数(プロパティ)

グローバル定義されていた変数をクラス内 __construct() メソッドの上へ移動して、アクセス修飾子を private とします

3.関数(メソッド)

グローバル定義されていた関数をクラス内 __construct() メソッドの下へ移動して、アクセス修飾子を public とします
クラス内でしか使用しない関数なら private や protected としておいたほうがより良いです

4.変数(プロパティ)、関数(メソッド)へのアクセスの記述を修正

今までグローバルに定義されていた変数や関数をカプセル化してクラス内の定義に修正したので、変数(プロパティ)、関数(メソッド)は、インスタンスからアロー演算子(->)で呼び出すよう修正します。

自クラスの場合は、$this が自分自身のインスタンスを示しており、他クラスのオブジェクトなら、new演算子で作成したインスタンス変数を用いて、アロー演算子で呼び出すことが出来ます

従って、次のように記述していたグローバル変数、関数へのアクセス
$goption = get_option(‘post6widget_option’);
update_exclude_option($goption);

自クラス内のインスタンス変数を用いたアクセスに書き換えます
$this->goption = get_option(‘post6widget_option’);
$this->update_exclude_option($this->goption);

また、クラス内でフック等でコールバック関数を登録している場合は、配列を使用して記述するように修正する必要があります
コールバックは、配列の最初の要素がオブジェクトインスタンスとなるので、クラス内のメソッドを指定する場合は、$this を指定します

従って、次のように記述していたコールバック関数
add_action(‘admin_menu’, ‘my_menu’)

どのオブジェクトインスタンスの関数なのかを配列を用いて記述します
add_action(‘admin_menu’, array(&$this, ‘my_menu’));

以上で終了です

最低限のクラス化対応が出来ました
一部静的関数のクラス等も作り、こんな感じのクラスに書き換えました

今回は、機能的な追加は何もありませんが、参考までにここにソースコードを貼り付けます

  1. <?php

  2. /*

  3. Plugin Name: Post 6 WidgetArea

  4. Plugin URI: https://celtislab.net/wp_plugin_post6widgetarea

  5. Description: 投稿記事前後等に6箇所のウイジェットエリアを追加します。1.ページエリアスタート部、2.投稿記事タイトル後、3.記事中のショートコード位置、4.投稿記事コンテンツ後、5.ページエリアエンド部、6.head 要素内

  6. Author: enomoto celtislab

  7. Version: 0.3.0

  8. Author URI: https://celtislab.net/

  9. */

  10. class CeltisLib {

  11. //固定ページが除外指定ポストIDであるか判定する

  12. public static function isnot_exclude_page($exclude_id)

  13. {

  14. $exclude = (count($exclude_id) > 0 ) && is_page($exclude_id);

  15. return( ! $exclude );

  16. }

  17. //投稿記事がが除外カテゴリーまたは除外指定ポストIDであるか判定する

  18. public static function isnot_exclude_single($exclude_cat, $exclude_id)

  19. {

  20. $exclude1 = in_category($exclude_cat);

  21. $exclude2 = (count($exclude_id) > 0 ) && is_single($exclude_id);

  22. return( (! $exclude1) && (! $exclude2) );

  23. }

  24. //dyndamic_sidebar の文字列化

  25. public static function get_mydynamic_sidebar($index = 1)

  26. {

  27. ob_start();

  28. dynamic_sidebar($index);

  29. $sidebar_contents = ob_get_clean();

  30. return $sidebar_contents;

  31. }

  32. }

  33. class Post6widgetarea {

  34. private $goption;

  35. //コンストラクタ

  36. public function __construct() {

  37. //管理画面(設定メニュー)

  38. if(is_admin()) {

  39. add_action('admin_menu', array(&$this, 'my_menu')); //オプション表示

  40. add_action('admin_init', array(&$this, 'my_register')); //オプション更新

  41. }

  42. //プラグイン削除時のフック

  43. if ( function_exists('register_uninstall_hook') ) {

  44. register_uninstall_hook(__FILE__, array(&$this, 'my_uninstall_hook'));

  45. }

  46. //ウィジェットエリア定義

  47. add_action('widgets_init', array(&$this, 'my_register_wedgets'));

  48. //ウィジェットをアクション/フィルターフックにセット

  49. add_action('wp_head', array(&$this, 'my_wp_head'));

  50. add_action('loop_start', array(&$this, 'my_loop_start'));

  51. add_filter('the_content', array(&$this, 'my_content'));

  52. add_action('loop_end', array(&$this, 'my_loop_end'));

  53. //delete_option('post6widget_option'); //for debug

  54. $this->goption = get_option('post6widget_option');

  55. $this->update_exclude_option($this->goption); // update post

  56. //未設定時には、デフォルトを仮設定しておく

  57. if(!isset($this->goption['home']))

  58. $this->goption['home'] = 0;

  59. if(!isset($this->goption['page']))

  60. $this->goption['page'] = 0;

  61. if(!isset($this->goption['single']))

  62. $this->goption['single'] = 1;

  63. if(!isset($this->goption['archive']))

  64. $this->goption['archive'] = 1;

  65. if(!isset($this->goption['exclude_id']))

  66. $this->goption["exclude_id"] = array();

  67. if(!isset($this->goption['exclude_cat']))

  68. $this->goption["exclude_cat"] = array();

  69. if(!isset($this->goption['shortcode']))

  70. $this->goption["shortcode"] = 'Post6ins';

  71. add_shortcode($this->goption['shortcode'], array(&$this, 'my_content_shortcode'));

  72. }

  73. //設定オプション表示(メニュー)

  74. public function my_menu()

  75. {

  76. add_options_page('Post 6 WidgetArea Settings', __('Post 6 WidgetArea'), 'manage_options', __FILE__, array(&$this, 'post6widget_area_options'));

  77. }

  78. //設定オプション更新

  79. // 引数1:グループ名(settings_fields関数の引数で使用する)

  80. // 引数2:オプション名(input要素などのname属性で使用する)

  81. public function my_register()

  82. {

  83. register_setting('post6widget_optiongroup', 'post6widget_option');

  84. }

  85. //プラグイン削除時のオプションクリア

  86. public function my_uninstall_hook()

  87. {

  88. delete_option('post6widget_option');

  89. }

  90. //ウイジェットエリア登録

  91. public function my_register_wedgets()

  92. {

  93. register_sidebar( array(

  94. 'name' => __( 'Post6 wp_head widget' ),

  95. 'id' => 'post6_wp_head',

  96. 'description' => __( '<head> 要素内のウィジェットエリアです' ),

  97. 'before_title' => '<div class="widget-title">',

  98. 'after_title' => '</div>',

  99. 'before_widget' => '<div id="%1$s" class="widget-wrapper %2$s">',

  100. 'after_widget' => '</div>'

  101. ) );

  102. register_sidebar( array(

  103. 'name' => __( 'Post6 start area widget' ),

  104. 'id' => 'post6_start_area',

  105. 'description' => __( 'ホーム/固定/投稿記事/アーカイブページエリア上部に表示されるウィジェットエリアです。' ),

  106. 'before_title' => '<div class="widget-title">',

  107. 'after_title' => '</div>',

  108. 'before_widget' => '<div id="%1$s" class="widget-wrapper %2$s">',

  109. 'after_widget' => '</div>'

  110. ) );

  111. register_sidebar( array(

  112. 'name' => __( 'Post6 single start widget' ),

  113. 'id' => 'post6_single_start',

  114. 'description' => __( '投稿記事コンテンツ上部に表示されるウィジェットエリアです。' ),

  115. 'before_title' => '<div class="widget-title">',

  116. 'after_title' => '</div>',

  117. 'before_widget' => '<div id="%1$s" class="widget-wrapper %2$s">',

  118. 'after_widget' => '</div>'

  119. ) );

  120. register_sidebar( array(

  121. 'name' => __( 'Post6 shortcode widget' ),

  122. 'id' => 'post6_shortcode',

  123. 'description' => __( '投稿記事コンテンツ内のシュートコード挿入部に表示されるウィジェットエリアです。' ),

  124. 'before_title' => '<div class="widget-title">',

  125. 'after_title' => '</div>',

  126. 'before_widget' => '<div id="%1$s" class="widget-wrapper %2$s">',

  127. 'after_widget' => '</div>'

  128. ) );

  129. register_sidebar( array(

  130. 'name' => __( 'Post6 single end widget' ),

  131. 'id' => 'post6_single_end',

  132. 'description' => __( '投稿記事コンテンツ下部に表示されるウィジェットエリアです' ),

  133. 'before_title' => '<div class="widget-title">',

  134. 'after_title' => '</div>',

  135. 'before_widget' => '<div id="%1$s" class="widget-wrapper %2$s">',

  136. 'after_widget' => '</div>'

  137. ) );

  138. register_sidebar( array(

  139. 'name' => __( 'Post6 end area widget' ),

  140. 'id' => 'post6_end_area',

  141. 'description' => __( 'ホーム/固定/投稿記事/アーカイブページエリア下部に表示されるウィジェットエリアです' ),

  142. 'before_title' => '<div class="widget-title">',

  143. 'after_title' => '</div>',

  144. 'before_widget' => '<div id="%1$s" class="widget-wrapper %2$s">',

  145. 'after_widget' => '</div>'

  146. ) );

  147. }

  148. public function my_wp_head()

  149. {

  150. dynamic_sidebar('Post6 wp_head widget');

  151. remove_action('wp_head', array(&$this, 'my_wp_head'));

  152. }

  153. public function my_loop_start()

  154. {

  155. $option = $this->goption;

  156. if( (is_home() && $option['home'])

  157. || (is_page() && CeltisLib::isnot_exclude_page($option["exclude_id"]) && $option['page'] )

  158. || (is_single() && CeltisLib::isnot_exclude_single($option["exclude_cat"], $option["exclude_id"]) && $option['single'])

  159. || (is_archive() && $option['archive']) ) {

  160. dynamic_sidebar('Post6 start area widget');

  161. }

  162. remove_action('loop_start', array(&$this, 'my_loop_start'));

  163. }

  164. public function my_loop_end()

  165. {

  166. $option = $this->goption;

  167. if( (is_home() && $option['home'])

  168. || (is_page() && CeltisLib::isnot_exclude_page($option["exclude_id"]) && $option['page'] )

  169. || (is_single() && CeltisLib::isnot_exclude_single($option["exclude_cat"], $option["exclude_id"]) && $option['single'])

  170. || (is_archive() && $option['archive']) ) {

  171. dynamic_sidebar('Post6 end area widget');

  172. }

  173. remove_action('loop_end', array(&$this, 'my_loop_end'));

  174. }

  175. public function my_content_shortcode()

  176. {

  177. $option = $this->goption;

  178. $ins_content = '';

  179. if( is_single() && CeltisLib::isnot_exclude_single($option["exclude_cat"], $option["exclude_id"]) ){

  180. $ins_content .= CeltisLib::get_mydynamic_sidebar('Post6 shortcode widget');

  181. }

  182. return $ins_content;

  183. }

  184. public function my_content($content)

  185. {

  186. $option = $this->goption;

  187. if(! is_single()){

  188. return $content;

  189. }

  190. else {

  191. $new_content = "";

  192. if(CeltisLib::isnot_exclude_single($option["exclude_cat"], $option["exclude_id"]) ){

  193. $new_content .= CeltisLib::get_mydynamic_sidebar('Post6 single start widget');

  194. $new_content .= $content;

  195. $new_content .= CeltisLib::get_mydynamic_sidebar('Post6 single end widget');

  196. }

  197. else

  198. $new_content .= $content;

  199. return $new_content;

  200. }

  201. }

  202. //パラメータ更新データの受信 exclude_id, exclude_cat は表示前に型変換しているので

  203. //options.php に渡す前にデータを検証してから型を戻してセットし直す

  204. //もっとスマートな書き方もあると思うがとりあえず動作することを優先する

  205. //

  206. public function update_exclude_option(&$option)

  207. {

  208. if (!empty($_POST['action'])) { // Update 

  209. if(isset($_POST['post6widget_option']['exclude_id'])){

  210. $idlist = array();

  211. $ids = explode(",", $_POST['post6widget_option']['exclude_id']);

  212. for($x = 0; $x<count($ids); $x++) {

  213. $id = (int)trim($ids[$x]);

  214. if($id>0)

  215. $idlist[] = $id;

  216. }

  217. $option["exclude_id"] = $idlist;

  218. $_POST['post6widget_option']['exclude_id'] = $idlist;

  219. }

  220. if(isset($_POST['post_category'])){

  221. $excat = array();

  222. foreach((array) $_POST['post_category'] AS $val){

  223. if(!empty($val) && is_numeric($val))

  224. $excat[] = (int)$val;

  225. }

  226. $option["exclude_cat"] = $excat;

  227. $_POST['post6widget_option']['exclude_cat'] = $excat;

  228. }

  229. }

  230. }

  231. //-------------------------------------------------------------------------

  232. function post6widget_area_options() { ?>

  233. <div class="wrap">

  234. <div id="icon-options-general" class="icon32"><br /></div>

  235. <h2>Post 6 WidgetArea</h2>

  236. <p>Post 6 WidgetArea プラグインは、ブログ記事前後等に6箇所のウイジェットエリアを追加します</p>

  237. <p>1.ページエリアスタート部、2.投稿記事タイトル後、3.記事中のショートコード位置、4.投稿記事コンテンツ後、5.ページエリアエンド部、6.head 要素内</p>

  238. <p><br /></p>

  239. <p>ウイジェットエリアは、管理画面の外観→ウイジェットへ追加されているので、定型文や広告、ソーシャルボタン設置等のテキストやHTMLコードを「テキストウイジェット」を用いて挿入して下さい</p>

  240. <p>PHPコードを実行させる場合には、別途「Executable PHP widget」プラグインを導入して、「PHP Code ウイジェット」を使用して下さい</p>

  241. <p>また、HTMLのhead要素内へのウイジェットエリアには、メタデータやCSS等のドキュメントについての情報を挿入することが出来ます</p>

  242. <p><br /></p>

  243. <!-- submit ボタンクリックで input 要素の name 属性データを post メソッドで option.php へ送信する -->

  244. <form method="post" action="options.php">

  245. <?php settings_fields('post6widget_optiongroup'); ?>

  246. <?php

  247. $option = $this->goption;

  248. ?>

  249. <h3 style="margin-top: 10px;">記事エリアスタート/エンド部のウイジェット処理を有効とするページ種別</h3>

  250. <p>ウイジェット処理を有効にするページ種別を指定して下さい</p>

  251. <label><input type="checkbox" name="post6widget_option[home]" value="1" <?php checked( $option['home'], 1 ); ?>" /> ホームページ</label><br />

  252. <label><input type="checkbox" name="post6widget_option[page]" value="1" <?php checked( $option['page'], 1 ); ?>" /> 固定ページ</label><br />

  253. <label><input type="checkbox" name="post6widget_option[single]" value="1" <?php checked( $option['single'], 1 ); ?>" /> 個別投稿ページ</label><br />

  254. <label><input type="checkbox" name="post6widget_option[archive]" value="1" <?php checked( $option['archive'], 1 ); ?>" /> アーカイブページ</label><br />

  255. <p><br />※記事タイトル後、ショートコードによる挿入、記事コンテンツ後のウイジェット処理は、個別投稿ページのみが対象となります</p>

  256. <p><br /></p>

  257. <h3 style="margin-top: 10px;">ウイジェット処理を行わない除外条件設定 </h3>

  258. <p>指定カテゴリーの投稿記事を除外</p>

  259. <div style="border-color:#CEE1EF; border-style:solid; border-width:2px; height:10em; margin:5px 100px 5px 20px; overflow:auto; padding:0.5em 0.5em;">

  260. <ul>

  261. <?php wp_category_checklist(0,0,$option['exclude_cat'],FALSE,NULL,FALSE); ?>

  262. </ul>

  263. </div>

  264. <p>指定 post ID の投稿記事、固定ページを除外 (カンマ区切りで指定して下さい)</p>

  265. <p><label>Post ID:<input type="text" style="width:200px;" name="post6widget_option[exclude_id]" value="<?php echo implode(",", $option['exclude_id']); ?>" /></label></p>

  266. <p><br /></p>

  267. <h3 style="margin-top: 10px;">記事中に挿入するウイジェット処理を有効とするショートコードの定義</h3>

  268. <p>定義されている文字列をショートコードとして処理します</p>

  269. <p><label>ショートコード名称:<input type="text" name="post6widget_option[shortcode]" value="<?php echo $option['shortcode']; ?>" /></label></p>

  270. <p class="submit">

  271. <input type="submit" name="Submit" class="button-primary" value="<?php esc_attr_e('Save Changes') ?>" />

  272. </p>

  273. </form>

  274. </div>

  275. <?php }

  276. }

  277. //インスタンス作成

  278. $post6widgetarea = new Post6widgetarea();

  279. ?>

  280.  

とりあえずクラス化が出来ましたが、PHPのオブジェクト指向プログラミングについてはもっと調べてすこしづつ使っていこうと思います

次は、国際化対応について調べます (^^)


まとめ記事紹介

go-to-top