The Blue and Violet Storys

ダウンロード＆解説ページ
Webはくしゅ本体
Webはくしゅモジュール

　主な機能面での変化は以下のとおりです。

　（１）拍手があったときにメールで通知
　（２）ひとことメッセージが投稿されたときにメールで通知
　（３）拍手画像にこれまでの拍手数を表示させる
　（４）拍手元ページでの任意の文字コード（UTF-8以外）に対応

　（１）（２）については、これまでレポートページを開かなければ拍手があったどうか分らなかったものを、掲示板での新規（レス）やブログのコメント時ど同様にメール（携帯）でその通知を受け取れるようにしたものです。単に、その方が嬉しいからですけどね。

　（３）は、同じように拍手ボタンを設置されているHPやブログで、拍手のカウント数が表示されているのを見て羨ましかったのをようやく実現しました。

　（４）は、いわゆる汎用性の強化で、文字コードの異なるどんなHPからでも拍手を受け取れるようになります。逆に、本体側であるWeb拍手の方の文字コードはUTF-8に固定となります。（変更することも可能ですが）

　ただし、Web拍手モジュールの方はいささかの注意が必要で、（３）を実現するために、これまでCJさん作の「タグ拡張モジュール」を前提にしていた部分をはずし、独自にindex.phpの改造が必要になりました。
　拍手ボタン画像をphpによって作成する際に、引数となる「ページタイトル」にURLエンコードが必須となったことで、「拡張モジュール」だけでは対応できなくなったことが主な理由です。
（これまでも、Aタグで拍手ボタンを設置する場合にはURLエンコードが必要でしたが、BlognPlusのモジュール的にはフォームタグを使用することで実質的には問題ありませんでした）

　よって、独自のindex.phpの改造が必要となった次第です。（これまでもその機能自体はありましたけどね）
　ただし、（３）の機能を使わないのであれば、モジュール側のみ旧バージョン（ver1.3）を使用しても影響はないものと思われます。

「補足」

　拍手ボタン設置専用のスクリプト（sx_webclap_button.php）は同軸してありますが、おおもとで拍手元ページがphpで作られていない（使えない？）場合のため、拍手ボタンを手作業で記述するためのhtmlのサンプルを以下に示します。

※フォームボタンの場合

　事実上、トークンにかかる記述はなくても大丈夫です。（sx_claptokenの行）


※Aタグの場合


※拍手のボタン画像にsx_wbc_imgbutton.phpを用いていますが、手作業ではタイトルのURLエンコードに手間取るかと思います。そこは手を抜いてIMGタグのSRCを普通にボタン画像を用いてしまうのも手です。（拍手カウントが表示されませんが……）
※文字コードは明示的に指定することで誤動作を避けるためのものです。面倒であれば無くても動作すると思われます。（本体内ではautoで変換します）

≪ 続きを隠す

DownLoad ＆解説ページ

　機能面での変更は基本的にありません。（暫定対応であったため）

　ただし、index.phpへの改造を不要としたコメントスパム対策モジュールの仕様変更により、このコメントアイコン＆絵文字モジュールにおいても同様の手続きによりindex.phpへの記述のうち、コメント投稿受付部分について不要となりました。

　しかしながら、双方のモジュールの動作の要件を満たすために、若干の調整が必要となります。

　要件とは、「コメント受付時においてかならず対策モジュールよりも先に実行されなければならない」というもので、前バージョンまではindex.phpへの改造段階において明示的に先に記述することでその要件を満たしていました。
　しかしながら、対策モジュールの方でindex.phpへの改造を不要となったことで、スクリプト側にて当該要件を満たす動作を実現してあげる必要があります。

　BlognPlus ver2.6.0以降においては、管理画面にてモジュール動作の優先順位を変更することが可能になりましたが、ver2.5.6以前においてはどちらのモジュールが先に実行されるか定まっていませんし、2.6.0であっても、優先順位の変更を忘れてしまうことが考えられます。

　そこで、両方のモジュールを使用される場合、下記の手続き（改造）をコメントスパム対策モジュールのasm4cmt.phpに施してください。

(asm4cmt.php の先頭)
{IFVCODE}
// asm4cmt.php
//
//---------------------------------------------------------------
≪ 続きを隠す

DownLoad ＆解説ページ

　BlognPlus2.6.0の仕様に合わせて、設定画面を用意し、これまでスクリプトの中で設定していたエントリー毎表示コメント件数などを管理画面にて設定することができるようにしました。（BlognPlusの初期設定から「新着コメント表示件数」自体が無くなっています）

　もちろん、管理画面を含め、このモジュールはBlognPlus　ver2.5.6 および ver2.6.0の両方に対応しています。


≪ 続きを隠す

　導入準備の（１）で、管理画面でのインストールは正常に終了したものの、「動作 ON/OFF」で実際に適用させた途端に画面が真っ白になった原因は、BlognPlus2.6.0での以下の仕様変更によるものでした。

- conf.php
・[変更]アドレス指定を絶対アドレスに変更

これは、公式の更新内容での記述ですが、BlognPlusのシステムの中で使用される定数定義の中で、フォルダの位置を指し表すものの値が、これまでindex.phpからの相対アドレスだったものが、サーバーでの絶対アドレスに変更されたということを意味しています。
　具体的には、モジュールフォルダの位置を示していた"BLOGN_MODDIR"の値が、当初'module/'だったのが'/home/****************/public_html/****/blog/'のような長ったらしい値になってしまいました。

　私の単純なミスなのか、単なる習慣だったのか、表示モード別分岐タグモジュールの先頭で、使用する関数群であるfunction.phpの読み込み時に

include("./".BLOGN_MODDIR."ifview/function.php");

　というものがあって、先ほどの絶対アドレスになったことでfunction.phpを見つけられなくなったことによるPHPエラーでした。

　これに関しては先頭の"./"を無くしてやることで大丈夫になるのですが、この際このinclude文を削除し、代わりにモジュールのinfo.phpで定義する「index.phpで事前に読み込むfunctionデータ」のところにこのfunction.phpをセットすることで、正常に動作するようになったわけです。

（実際は、導入の最後に、やっぱり今後不都合が発生しそうだったので、戻しました）

　ここで、従来通りのやり方でindex.phpへの２か所の改造を施します。

　結果から申しますと、正常に動作いたしました。

　とはいうものの、これで解決したわけではなく「表示モード別分岐タグ」モジュールの前回（ver1.3）のときに「次回のバージョンUPでは～」と発言していたことを思い出し、この機会に機能面でのバージョンUPを図ろうと思いついてしまったのが運のつきでした。（愚かな…）

　「表示モード別分岐タグ」モジュールのver1.4はすでに発表してありますので、変更点はそちらを参照いただくとして、そういったことでスクリプトのほぼ全部を描き直し、そのデバッグ作業で手間取っていたわけです。

　さらに、後半になって気づいたことにモジュールの「動作ON/OFF」への対応というものがあります。管理画面にて個別にON/OFFを変えれるようになったことで、私のモジュールのいくつかのようにindex.phpの改造を伴うモジュールの仕様には注意が必要になると思われます。
　なぜなら、何らかの事情（デバッグとか他モジュールとの整合性のチェックとか？）で動作OFFにしたとき、BlognPlusはモジュールのinfo.phpで設定したスクリプトを読み込まなくなるのはいいのですが、その中で定義された関数なども定義されないことになってしまいます。

　しかし、index.phpに直接施した改造は、そんなON/OFFのことなんか知らずに記述されたとおりに未定義の関数を実行しようとします。
　エラーが出て当たり前ですね。（あはは、画面が白いわぁ）

　なので、これまで

とかやっていたindex.phpへの記述を



　と変更し、

そのifviewadd1.phpの中で



　という具合に変更しました。つまり、モジュールが読み込まれ、関数if_view()が定義されていた場合に限り、上記の動作を行うようにしたわけです。

　これにより、不意に動作OFFにしたり、アンインストールした場合でも、同時にindex.phpの記述を削除する必要はなくなります。


　最後に、先ほどのfunction.phpで、「今後不都合が発生しそうだったので、戻しました」の件ですが、これは次の「コメントアイコン＆絵文字」モジュールに手をつけ始めて気づいた事柄が動機になっていますので、説明は次回にさせていただきますね。（眠いです）


≪ 続きを隠す

　機能面での変更は一切ありませんが、BlognPlus2.6.0のモジュールのインストール／アンインストールに対処するため、前回の「表示モード別分岐タグ」モジュールと同様に、２か所のindex.phpへの記述方法を関数呼び出しからincludeによるものに変更いたしましたのでご注意をお願いいたします。

（前バージョンにて１か所はすでにincludeになっていましたが）

DownLoad ＆ 解説ページ


≪ 続きを隠す