拍手送信プラグイン
このプラグインについて
拍手を送信できます。
広告
ダウンロード
以下のリンクからプラグインをダウンロードできます。(GitHubに遷移します。)
GitHubの緑ボタン「Code」内にある「Download ZIP」からすべてのプラグインをダウンロードできるので、解凍後に作成されるフォルダの中から clap
フォルダを入手してください。
導入方法
準備
あらかじめ管理者ページにログインしておきます。
ファイルのアップロード
clap/
内の configs/
と libs/
と templates/
を、freo設置ディレクトリ内にアスキーモードで上書きアップロードします。
パーミッションの設定
ブラウザソフトで freo/index.php/setup
にアクセスすると、必要なパーミッションが自動設定されます。
ただし、設置時に「ご利用のサーバーは、PHPから直接パーミッションを設定することができない環境のようです。」と表示された環境の場合は自動設定されないので、FTPソフトで以下のファイルのパーミッションを設定してください。
対象 | パーミッション |
---|---|
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}" />
携帯からのアクセス
携帯からアクセスすると、携帯用の表示になります。
削除方法
このプラグインは、以下の手順で削除できます。
ファイルの編集
テンプレートに追加したコードを削除します。
データベースの削除
データベースから plugin_claps
と plugin_clap_thanks
を削除します。(削除しなくてもfreoの動作には問題ありません。)
ファイルの削除
以下のファイルを削除します。
configs/plugins/clap.ini
libs/freo/plugins/config.clap.php
libs/freo/plugins/page.clap.php
templates/mobiles/plugins/clap/
(ディレクトリごと削除)templates/plugins/clap/
(ディレクトリごと削除)
更新履歴
- 最新版との差分ファイルを一覧表示できます。
- 使用している拍手送信プラグインのバージョンを入力してください。
- 更新内容の詳細は、以下の更新履歴を確認してください。
- 2013/04/14 Ver 1.1.3
-
- 指定されたデータが見つからない時、404エラーを返すように変更。
バージョンアップは、以下のファイルを最新版付属のものに差し替えてください。
- 2013/02/22 Ver 1.1.2
-
- お礼画面を順に表示させるとき、正しく動作しない不具合を修正。
バージョンアップは、以下のファイルを最新版付属のものに差し替えてください。
- 2012/11/06 Ver 1.1.1
-
- 拍手の最大送信回数が正しく反映されない不具合を修正。
バージョンアップは、以下のファイルを最新版付属のものに差し替えてください。
- 2011/09/20 Ver 1.1.0
-
- 管理画面でメッセージのみを一覧表示できるように改良。
- 強制的に特定のお礼を表示できるように改良。
バージョンアップは、以下のファイルを最新版付属のものに差し替えてください。
- 2011/02/28 Ver 1.0.4
-
- 拍手送信ボタンをリンクで設置したとき、コンテンツ名(
plugin_clap[title]
)の送信を受け付けるように修正。
バージョンアップは、以下のファイルを最新版付属のものに差し替えてください。
- 拍手送信ボタンをリンクで設置したとき、コンテンツ名(
- 2011/01/06 Ver 1.0.3
-
- 「お礼画面の表示順」を「順に表示」にすると、拍手の送信完了画面が表示されないことがある不具合を修正。
バージョンアップは、以下のファイルを最新版付属のものに差し替えてください。
- 2011/01/04 Ver 1.0.2
-
- お礼登録画面で、メディア管理が正しく表示されない不具合を修正。
バージョンアップは、以下のファイルを最新版付属のものに差し替えてください。
- 2010/10/13 Ver 1.0.1
-
- エラー処理が正しく機能しない不具合を修正。
バージョンアップは、以下のファイルを最新版付属のものに差し替えてください。
- 2010/09/01 Ver 1.0.0
-
正式版を公開しました。最終ベータ版から大きな変更はありませんが、プログラム内部のバージョン情報と更新日はすべて変更しています。ですので今後混乱の無いように、拡張子が
php
のファイルはすべて正式版付属のものに変更することをお勧めします。