BlognPlus 用記事評価モジュール

閲覧者がブログの記事に対して５段階で評価を与える事が出来るモジュールです。

「記事評価モジュール」の機能

主な機能

閲覧者は5段階で記事を評価できる
頂いた評価を元に平均評価を算出し、ブログに表示できる（個別記事）
ブログに平均評価の高い順一覧を表示できる
管理者は管理画面で平均評価の一覧を見る事ができる
直近の IP アドレスを記録し、同一者は同じ記事に対して連続で評価できない（別記事への評価は可能）

動作例

モジュールを導入する前に、どんな風に動作しているかご覧になりたい場合は、以下のサイトを参考にして下さい。

※ トラックバックをいただいたサイト様に無断でリンクさせていただいています。

動作環境

BlognPlus v2.6.2
BlognPlus v2.6.0
BlognPlus v2.5.6

ダウンロード

利用規約

このモジュールの所有権は「nJOY」管理人 CJ にあります。
モジュールを使用して損害が生じても、「nJOY」管理人 CJ は一切の責任を負いかねます。
モジュールの再配布・販売等は一切禁じます。
利用者個人の責任において改造は自由に行えます。
スクリプト内にあるプログラム名・バージョン名・著作権表示を削除・変更する事は認めません。
当規約に同意された方のみ、このモジュールを無料で使う事が出来ます。
もしよければ、あなたのブログに「nJOY BLOG」へのリンクをはってやってください。管理人が大変喜び、モジュール作成の励みになります。

「記事評価モジュール」(rateit.zip, 17kb)

インストール方法（主な手順）

ダウンロードした圧縮ファイル（rateit.zip）を解凍する。
「rateit」フォルダを BlognPlus ディレクトリ下の /module/ にアップロードする。
「config.cgi」「lock」「log.cgi」ファイルのパーミッションを「666」等に変更する。
/log/ ディレクトリのパーミッションを「777」等に変更する。
スキンファイルに記事評価ボタン/平均評価表示用のソースを記述する。

モジュール構成ファイル

blognplus
module
rateit
bar_b.gif
blank.php
config.cgi
control.php
function.php
index.html
info.php
lock
log.cgi
rateit.php
starf.gif
starh.gif
starn.gif
update.php
log
YYYYmmdd.log (*)

赤文字のファイルのパーミッションは「666」「606」等にする必要があります。
/log/ のパーミッションは「777」「707」等にする必要があります。

* /log/ 内の「YYYYmmdd.log」は自動的に作成されます。

インストール作業（BlognPlus v2.6.x 以降）

BlognPlus v2.6.x 以降では上記の手順に加え、次のインストール作業が必要になります。

インストール

「rateit」フォルダを /module/ ディレクトリ下にアップロード後、未登録一覧に入っている「記事評価モジュール」の [インストール] ボタンを押してください。

動作設定

PC: PC 用スキンに独自タグを記述した場合、「PC」欄を「ON」にしてください。
携帯: 携帯用スキンに独自タグを記述した場合、「携帯」欄を「ON」にしてください。

優先順位

特に制限はありません。

スキンへの記述方法（記事評価ボタン）

ソースの青文字部分は評価ボタンが動作するために必要な記述ですので、絶対に変更しないでください。
ソースはそのままスキンにコピー＆ペーストして使えます。必要に応じて細部を調整してください。

スキン内のどこに記述するか特に制限はありませんが、{LOG}～{/LOG} 内の {LOGMORE} 直後あたりに記述する事を推奨します。

例：セレクトボックス型

記事を評価してください（★１つ＝悪い、★５つ＝良い）

この記事の平均評価：

(15人）

上記のソース

{RATEIT}
記事を評価してください（★１つ＝悪い、★５つ＝良い）
<form action="./index.php?mode=rateit" method="post" name="rateit">
<select name="rating">
<option value="5">★★★★★</option>
<option value="4">★★★★☆</option>
<option value="3" selected="selected">★★★☆☆</option>
<option value="2">★★☆☆☆</option>
<option value="1">★☆☆☆☆</option>
</select>
<input type="hidden" name="id" value="{RATEIT_ID}" />
<input type="hidden" name="cd" value="{RATEIT_CD}" />
<input type="submit" name="submit" value="評価">
</form>
この記事の平均評価： {RATEIT_ST} ({RATEIT_NO}人）
{/RATEIT}

例：ラジオボタン型

この記事は役に立ちましたか？

この記事の平均評価：

(15人）

上記のソース

{RATEIT}
この記事は役に立ちましたか？
<form action="./index.php?mode=rateit" method="post" name="rateit">
<input type="radio" name="rating" value="1">全然役に立たなかった
<input type="radio" name="rating" value="2">役に立たなかった
<input type="radio" name="rating" value="3" checked="checked">どちらでもない
<input type="radio" name="rating" value="4">役に立った
<input type="radio" name="rating" value="5">とても役に立った
<input type="hidden" name="id" value="{RATEIT_ID}" />
<input type="hidden" name="cd" value="{RATEIT_CD}" />
<input type="submit" name="submit" value="評価">
</form>
この記事の平均評価： {RATEIT_ST} ({RATEIT_NO}人）
{/RATEIT}

独自タグについて

独自タグ	出力内容
{RATEIT}	出力処理開始
{RATEIT_ID}	記事ID（投稿フォーム内で使用）
{RATEIT_CD}	認証コード（投稿フォーム内で使用）
{RATEIT_ST}	平均評価の画像
{RATEIT_NO}	評価数
{/RATEIT}	出力処理終了

{RATEIT}～{/RATEIT}

この独自タグ内に書かれた文字列は個別記事表示時のみ表示されます。
それ以外の場合は、表示されません。

{RATEIT_ST}

５点満点中の平均評価を画像で表示します（1～5点まで 1/2 点刻み）。必ず {RATEIT}～{/RATEIT}の中に記述してください。
平均評価をブログ上に表示したくない場合は、記述を省略してもかまいません。

{RATEIT_NO}

評価数を表示します。必ず {RATEIT}～{/RATEIT}の中に記述してください。
評価数をブログ上に表示したくない場合は、記述を省略してもかまいません。

星画像

平均評価表示用の画像はモジュールに同梱していますが、自分の好きな画像に差し替えることができます（同梱画像は白背景用）。
モジュールのディレクトリにある３つの GIF 画像を同名の別ファイルで上書きしてください。画像の縦横サイズに制限はありません。

ファイル名	説明
starf.gif	1点用画像
starh.gif	1/2点用画像
starn.gif	0点用画像

差し換え用画像

以下のサイト様でこのモジュールで使える星画像を配布されています。

A DAY IN THE LiFE - ゴールド/イエロー/グリーン