拍手送信プラグイン
このプラグインについて
拍手を送信できます。

導入方法
準備
あらかじめ管理者ページにログインしておきます。
ファイルのアップロード
config.clap.php と page.clap.php を libs/freo/plugins/ ディレクトリ内にアスキーモードでアップロードします。
clap.ini を configs/plugins/ ディレクトリ内にアスキーモードでアップロードします。
clap/ を templates/plugins/ ディレクトリ内にアスキーモードでアップロードします。
mobile/ 内にある clap/ を templates/mobiles/plugins/ ディレクトリ内にアスキーモードでアップロードします。
パーミッションの設定
configs/plugins/clap.ini のパーミッションを 606 に設定します。
セットアップ
ブラウザソフトで freo/index.php/clap/setup にアクセスします。セットアップ画面が表示されるのでセットアップを実行します。
テンプレートの編集
拍手送信ボタンを表示したいページのテンプレートに、以下の記述を追加します。表示項目やHTMLは、必要に応じて適当に変更してください。
(拍手送信ボタンをエントリーのサイドバーに表示させる場合、templates/utility.html に <div class="utility"> ~ </div> のブロックを記述し、その中に追加します。)
<h3>拍手送信</h3>
<div class="content">
<form action="{$freo.core.http_file}/clap" method="post">
<fieldset>
<legend>拍手送信フォーム</legend>
<input type="hidden" name="freo[token]" value="{$token}" />
<p><input type="submit" value="拍手を送る" /></p>
</fieldset>
</form>
</div>
もしくは、以下のようなテキストリンクからでも拍手を送信することができます。
<p><a href="{$freo.core.http_file}/clap">拍手を送る</a></p>
完了
管理者ページにログイン後、管理メニューから「プラグイン」→「拍手送信」を選択すると、カウント数の確認ができます。
機能解説
メッセージ入力欄の追加
送信完了画面に表示されるメッセージの入力項目は、templates/plugins/clap/default.html を編集する事で自由に追加することができます。
入力項目はformタグ内に記述し、name属性には plugin_clap[option][任意の半角英数字] を指定します。具体的には、plugin_clap[option][option1] や plugin_clap[option][message] のような値を指定します。入力項目はいくつでも追加することができますが、name属性の値が重複しないようにしてください。
以下に、実際の追加例を記載します。
一行入力を追加するには、一例ですが以下のように記述します。
お名前:
<input type="text" name="plugin_clap[option][example1]" size="50" value="" />
複数行入力を追加するには、一例ですが以下のように記述します。
一言:
<textarea name="plugin_clap[option][example2]" cols="50" rows="2"></textarea>
セレクトボックスを追加するには、一例ですが以下のように記述します。
好きなコンテンツ:
<select name="plugin_clap[option][example3]">
<option value="">選択してください</option>
<option value="ギャラリー">ギャラリー</option>
<option value="小説">小説</option>
<option value="ブログ">ブログ</option>
</select>
ラジオボタンを追加するには、一例ですが以下のように記述します。
年齢:
<input type="radio" name="plugin_clap[option][example4]" value="" checked="checked" /> 無回答 /
<input type="radio" name="plugin_clap[option][example4]" value="10代" /> 10代 /
<input type="radio" name="plugin_clap[option][example4]" value="20代" /> 20代 /
<input type="radio" name="plugin_clap[option][example4]" value="30代" /> 30代 /
<input type="radio" name="plugin_clap[option][example4]" value="その他" /> その他
チェックボックスを追加するには、一例ですが以下のように記述します。
返信:
<input type="checkbox" name="plugin_clap[option][example5]" value="返信OK!" /> 返信OK!
また、以下のように記述すると、各入力欄のラベルを追加できます。
<input type="hidden" name="plugin_clap[label][example1]" value="お名前:" />
通常、管理画面では 設定した任意の半角英数字=送信されたテキスト という形式で表示されますが、上のように設定しておくと お名前:山田太郎 のように表示させることができます。
拍手送信ボタンの複数設置
拍手送信ボタンを設置する際、
<form action="{$freo.core.http_file}/clap" method="post">
<fieldset>
<legend>拍手送信フォーム</legend>
<input type="hidden" name="freo[token]" value="{$token}" />
<input type="hidden" name="plugin_clap[title]" value="コンテンツ名" />
<p><input type="submit" value="拍手を送る" /></p>
</fieldset>
</form>
このように plugin_clap[title] を設定すると、「どこから拍手が送信されたか」を管理ページで判別できるようになります。value属性には、任意のコンテンツ名を設定できます。
もしくは、以下のようなテキストリンクからでも任意のコンテンツ名を送信することができます。
<p><a href="{$freo.core.http_file}/clap?plugin_clap%5Btitle%5D=コンテンツ名">拍手を送る</a></p>
特定のお礼画面を強制表示
拍手送信ボタンを設置する際、
<form action="{$freo.core.http_file}/clap" method="post">
<fieldset>
<legend>拍手送信フォーム</legend>
<input type="hidden" name="freo[token]" value="{$token}" />
<input type="hidden" name="plugin_clap[id]" value="お礼画面のID" />
<p><input type="submit" value="拍手を送る" /></p>
</fieldset>
</form>
このように plugin_clap[id] でお礼画面のIDを設定すると、このボタンを押されたときに表示されるお礼画面を指定することができます。
もしくは、以下のようなテキストリンクからでも任意のIDを送信することができます。
<p><a href="{$freo.core.http_file}/clap?plugin_clap%5Bid%5D=お礼画面のID">拍手を送る</a></p>
お礼画面が表示されてから連続で拍手すると他のお礼画面が表示される可能性がありますが、templates/plugins/clap/default.html の20行目あたりにある
<input type="hidden" name="freo[token]" value="{$token}" />
<input type="hidden" name="plugin_clap[title]" value="{$smarty.post.plugin_clap.title}" />
この直後に以下のコードを追加すると、お礼画面のIDが設定されている場合はずっと同じお礼画面が表示されるようになります。
<input type="hidden" name="plugin_clap[id]" value="{$smarty.post.plugin_clap.id}" />
携帯からのアクセス
携帯からアクセスすると、携帯用の表示になります。
更新履歴
- 2011/09/20 Ver 1.1.0
-
- 管理画面でメッセージのみを一覧表示できるように改良。
- 強制的に特定のお礼を表示できるように改良。
バージョンアップは、以下のファイルを最新版付属のものに差し替えてください。
clap/admin.htmlclap/admin_text.htmlclap/admin_thank.htmlmobile/clap/admin.htmlmobile/clap/admin_text.htmlmobile/clap/admin_thank.htmlclap.iniconfig.clap.phppage.clap.php
- 2011/02/28 Ver 1.0.4
-
- 拍手送信ボタンをリンクで設置したとき、コンテンツ名(
plugin_clap[title])の送信を受け付けるように修正。
バージョンアップは、以下のファイルを最新版付属のものに差し替えてください。
config.clap.phppage.clap.php
- 拍手送信ボタンをリンクで設置したとき、コンテンツ名(
- 2011/01/06 Ver 1.0.3
-
- 「お礼画面の表示順」を「順に表示」にすると、拍手の送信完了画面が表示されないことがある不具合を修正。
バージョンアップは、以下のファイルを最新版付属のものに差し替えてください。
config.clap.phppage.clap.php
- 2011/01/04 Ver 1.0.2
-
- お礼登録画面で、メディア管理が正しく表示されない不具合を修正。
バージョンアップは、以下のファイルを最新版付属のものに差し替えてください。
config.clap.phpclap/admin_thank_form.html
- 2010/10/13 Ver 1.0.1
-
- エラー処理が正しく機能しない不具合を修正。
バージョンアップは、以下のファイルを最新版付属のものに差し替えてください。
config.clap.phppage.clap.phpclap/error.htmlmobile/clap/error.html
- 2010/09/01 Ver 1.0.0
-
正式版を公開しました。最終ベータ版から大きな変更はありませんが、プログラム内部のバージョン情報と更新日はすべて変更しています。ですので今後混乱の無いように、拡張子が
phpのファイルはすべて正式版付属のものに変更することをお勧めします。