拍手送信プラグイン

このプラグインについて

拍手を送信できます。

拍手送信プラグイン

ダウンロード

以下のリンクからプラグインをダウンロードできます。（GitHubに遷移します。）

GitHubの緑ボタン「Code」内にある「Download ZIP」からすべてのプラグインをダウンロードできるので、解凍後に作成されるフォルダの中から clap フォルダを入手してください。

GitHubからダウンロード

旧バージョンをダウンロード

導入方法

準備

あらかじめ管理者ページにログインしておきます。

ファイルのアップロード

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/ （ディレクトリごと削除）