投票所のタイトル

投票所のタイトル

この設定項目では、投票所のタイトルを指定します。

//-- 投票所のタイトル
$poll->attr( "title", "・・・ここに投票所のタイトルを書く・・・" );

以下の例では、普段お使いのサーチエンジンは？を投票所のタイトルとして表示します。

$poll->attr( "title", "普段お使いのサーチエンジンは？" );

投票項目

投票項目

以下のように投票項目を列記します。

$poll->addItem( "・・・投票項目のKey・・・", "・・・投票項目のキャプション・・・" );
$poll->addItem( "・・・投票項目のKey・・・", "・・・投票項目のキャプション・・・" );
$poll->addItem( "・・・投票項目のKey・・・", "・・・投票項目のキャプション・・・" );
.......................
.......................
.......................

投票項目のキャプションは、実際に投票所に表示される投票項目の名前です。投票者に分かりやすい文言を選んでください。

投票項目のKeyはデータファイル内で、投票項目の投票数を記録するのに用いられます。投票所内に表示されることはありません。

投票項目のKeyはどんな文字列でもよいのですが、同じKeyを一回以上使うことはできません。一つ一つのKeyがユニークである必要があります。簡単にユニークなKeyをつくるには、key1、key2、key3...といったように番号を終わりにつけるという方法があります。

下の例では、「ヤフー」、「グーグル」、「ビング」の三つを、投票項目のキャプションとして設定しています。投票項目のKeyはkey1、key2、key3と指定してありますが、ひとつひとつ違うユニークな文字列であれば、どのような文字列でもかまいません。

$poll->addItem( "key1", "ヤフー" );
$poll->addItem( "key2", "グーグル" );
$poll->addItem( "key3", "ビング" );

※ 投票を開始した後、投票項目のキャプションを変更しても投票数は維持されます。一方、投票項目のKeyを変更すると、新しい投票項目とみなされ、投票数は０から始まります。

テンプレート内で使用される文字列

テンプレート内で使用される文字列を指定します。文言を変更したい場合、以下の文字列を変更してください。

$poll->attr( "msg-vote", "投票" );
$poll->attr( "msg-select-one", "投票項目を選択してください" );
$poll->attr( "msg-already-voted", "既に投票済みです" );
$poll->attr( "msg-view-result", "投票結果を見る" );
$poll->attr( "msg-thank-you", "ご投票ありがとうございました" );
$poll->attr( "msg-return", "戻る" );
$poll->attr( "msg-vote-count", "%n%票" );
$poll->attr( "msg-total", "合計%n%票" );
$poll->attr( "msg-reset-block", "「二重投票防止」をリセットする" );
$poll->attr( "msg-not-started", "投票はまだ始まっていません" );
$poll->attr( "msg-ended", "投票期間は終了いたしました" );

二重投票防止のリセット・ボタン

二重投票防止のリセット・ボタン

「二重投票防止のリセット・ボタン」の表示・非表示を設定します。

「二重投票防止のリセット・ボタン」を表示するには、以下のようにtrueを指定します。

$poll->attr( "b-reset-block", true );

「二重投票防止のリセット・ボタン」を非表示にするには、以下のようにfalseを指定します。

$poll->attr( "b-reset-block", false );

項目選択の種類

投票が単一選択のみか複数選択可能かを指定します。

単一選択のみ、 複数選択可能

単一選択のみの場合、以下のようにradioを指定します。

$poll->attr( "vote-input", "radio" );

複数選択可能の場合、以下のようにcheckboxを指定します。

$poll->attr( "vote-input", "checkbox" );

お知らせボックスの表示時間

お知らせボックス

お知らせボックスの表示時間をミリ秒単位で指定します。

下の例では、 お知らせボックスの表示時間を2.5秒に指定しています。

$poll->attr( "tip-box-duration", 2500 );

二重投票をIPアドレスで防止

IPアドレスで二重投票を防止するには、以下のようにtrueを指定します。

$poll->attr( "enable-ip-block", true );

IPアドレスで二重投票を防止しない場合は、以下のようにfalseを指定します。

$poll->attr( "enable-ip-block", false );

二重投票をクッキーで防止

クッキーで二重投票を防止するには、以下のようにtrueを指定します。

$poll->attr( "enable-cookie-block", true );

クッキーで二重投票を防止しない場合は、以下のようにfalseを指定します。

$poll->attr( "enable-cookie-block", false );

投票期間開始の日時を指定

投票期間開始の日時を指定することができます。指定した日時が来る前は以下のようなメッセージが表示されます。

投票期間開始前

以下の例では、投票は2015年3月1日午後３時20分に開始します。

$poll->attr( "dt-start", "2015-03-01 15:20" );

開始を指定しない場合は、以下のように空の文字列 ("") を記入してください。

$poll->attr( "dt-start", "" );

投票期間終了の日時を指定

投票期間終了の日時を指定することができます。指定した日時が来た後は以下のようなメッセージが表示されます。

投票期間終了後

以下の例では、投票は2015年4月2日午前３時10分に終了します。

$poll->attr( "dt-end", "2015-04-02 03:10" );

終了を指定しない場合は、以下のように空の文字列 ("") を記入してください。

$poll->attr( "dt-end", "" );

投票結果の表示順序

投票結果ページで、投票項目が表示される順序を指定します。

投票項目を、投票数の多いものから少ないものの順で表示するには、以下のようにdescを指定します。

$poll->attr( "item-order", "desc" );

降順 (desc)

投票項目を、投票数の少ないものから多いものの順で表示するには、以下のようにascを指定します。

$poll->attr( "item-order", "asc" );

昇順 (asc)

投票項目を、この設定ファイルで書き込んだ順序で表示するには、以下のように空の文字列 ("") を記入します。

$poll->attr( "item-order", "" );

書き込んだままの順序