無料(フリー)掲示板CGIプログラムとwebツール

HitBBS 初めに お約束 設置の基本 見本 DL&更新情報

※「お約束」に同意できない場合は使用する事が出来ません。

K1.1-詳細

無料のアクセスカウンタープログラムです。ホームページにカウント用iframeを設置すると、訪問者の数を数えて数字画像を表示します。

実行が、アイフレームの為、通常カウントされない検索用のボット(Bot)等のアクセスもカウントできます。

ロック機構が特殊で、カウンターのロック不具合でページが表示されなくなる事がありません。

プログラムの動作の流れ。
訪問者がアクセス→プログラム実行→表示

クッキーを使用して、カウントの制限をしています。

必須条件
  • 特になし(Perl用)
主な機能
  • カウントアップに三つのモードを搭載しています
    1.アクセス全てをカウントするフルカウントモード
    2.セッションごとにカウントするセッションモード
    3.日付が変わるまで再度カウントしない日付モード
  • 管理人のカウントを制限
  • 検索ボットのカウントを含めたり外したり、又は検索ボットだけのカウント
  • 好きなカウンター画像に変更可能
  • アクセスカウンターの桁数の自由な変更
  • 簡易セットアップ

ファイル構成 - (転送モード)

ZIP ┐
    ├ k1 ┐
    │    ├ image ┐
    │    │       └ {カウンター画像} - (バイナリー)
    │    │
    │    ├ a-stata.pl -- (アスキー)
    │    ├ counter.cgi - (アスキー)
    │    ├ html-out.pl - (アスキー)
    │    └ k1-data.pl -- (アスキー)
    │
    ├ details.html - (転送不要)
    ├ index.html --- (転送不要)
    └ readme.html -- (転送不要)

K1.1-ファイル概要

counter.cgi
実行ファイル(本体)です。ホームページに、このファイルにアクセスするiframeタグを設置します。エディタで編集する必要があります。
html-out.pl
iframeタグで表示されるページのスキンがあります。
k1-data.pl
このカウンターの各種設定データです。
その他のファイル
実行に必要なブログラム等です。

K1.1-マニュアル


アップロード

設定が出来たら、設置の基本にある様にサーバにアップロードします。

通常は、カウンターを設置したいwebページのあるディレクトリに新しいディレクトリを作成して、そこにアップロードします。

サーバによってCGIを設置する場所が決まっている場合は、そこに新しいディレクトリを作成してアップロードします。

プログラム実行に必要な権限

拡張子.cgiはCGIファイルです。実行・読み取り・書き込み、の権限が必要です。
拡張子.pl はPLファイルです。読み取り・書き込み、の権限が必要です。

CGIプログラムが獲得できる権限に合わせて下さい、サーバによって変わります。
例えば、ユーザー権限で動作する場合、PLファイルはその他グループで読み書き出来る権限は不要になります。

パーミッションについて

大抵はサーバの方で指定していると思うので、その値を使用して下さい。 もし指定が無いようでしたら次の値でお試し下さい。

CGIファイル 705又は755又は775
PLファイル 604又は644又は664
ログファイル 600又は660
ディレクトリ 755又は775
ログ専用ディレクトリ 700又は770
CSS、HTMLファイル等 604又は644又は664又は666

※問題が出なければ、数字の小さい方を採用して下さい。


インストール・アンインストール

インストールは、アップロードして「counter.cgi?setup=パスワード」で、ブラウザでアクセスすると実行されます。
その際、ブラウザの設定で、クッキーを受け入れるようにしておいて下さい。 カウンターの初期の数字が表示されたら完了です。
設置したホームページを開いてカウンターが表示されるか確認します。

アンインストールは不要なディレクトリやファイルを削除するだけです。

設置

カウンターを設置したいwebページにインラインフレームタグを書き込みます。

テキストエディタでカウンターを表示したい場所へ次のタグを書き込みます。

<iframe sandbox="allow-scripts allow-same-origin allow-forms" frameborder="1" scrolling="no" src="○○/counter.cgi" style="width: 120px; height: 15px; margin: 0px 0px; vertical-align: -3px;"></iframe>

タグ内容
frameborder="1"
ボーダーサイズです、不要な場合は"0"を指定。
width: 120px; height: 15px;
iframeのサイズです、カウンターに合わせて下さい。
src="○○"/counter.cgi
カウンターへアクセスするアドレスを入れて下さい。
margin: 0px 0px;
表示位置の調整用です。必要に応じて変更または削除して下さい。
vertical-align: -3px;
同じく表示位置の調整用です。

※デモページ(index.html)が付属していますので、参考にして下さい。

数字の画像の変更
  1. imageディレクトリの画像のファイル名に差し替えたい画像のファイル名を合わせます。
  2. 画像を写して上書きします。
  3. html-out.pl ファイルのスキンのimgタグの画像サイズを合わせます。
    スマートフォンで画像がぼやける時は、ここで設定する値の縦横より二倍の画像を用意するとぼやけにくくなります。 大きな画像でも、この設定で表示は小さくなります。
  4. iframeのサイズや位置も合わせます。
  5. GIF以外の画像を使用する時は、k1-data.plの$_->{gif_counter}の設定で拡張子部分を合わせて下さい。

使い方

設定のカウントの制限
カウントするより制限の方が優先されます。
例えば、フルカウントモードの時でも、管理人や検索ボットのカウントは制限できます。
または、管理人をカウントするように設定しても、日付モードで設定した場合は日付が変わるまでは再度カウントしません。

カウンターを元に戻すには
アップロードしたディレクトリにあるk1_tmpディレクトリをFTPアップロードソフトで開きます。
その中にある、countディレクトリを更に開くと、名前が数字のディレクトリがあります、それを全て削除するとカウンターがリセットされます。


ディレクトリ構造(デフォルト値)

─┐
  ├ image ┐
  │       └ {カウンター画像ファイル}
  │
  ├ k1_tmp ┐ <----------------------- (セットアップで作られる)
  │        └ count ┐ <-------------- (セットアップで作られる)
  │                 └ {カウント数} <- (カウントすると作られる)
  │
  ├ a-stata.pl
  ├ counter.cgi
  ├ html-out.pl
  └ k1-data.pl

注意

iframe未対応のブラウザのアクセスはカウントできません。


K1.1-設定値

初期の設定は見本と同じになっています、環境に合わせて変更して下さい。

文字コードはUTF-8ボム無しになっています。


counter.cgi

CGI実行ファイルです。

#!/usr/bin/perl
アップロードするサーバで指定されているものに変更して下さい。
$setup_pas
セットアップパスワードを設定して下さい。初期値で「xyz」が設定されています、必ず変更して下さい。

html-out.pl

PLファイルです。iframeに表示するHTMLページのスキンがあります。

$prout = <<HTMLOUT;
この行より下から、「HTMLOUT」が出現するまでの間が、ページスキンとなります。

◎使われている変数の内容
$counts[数字] 画像のURLです。数字の部分は、カウンターの桁の数より1引いたものに当たります。 例えば、$counts[0] はカウンターの1の位で、$counts[9] は10の位になります。


k1-data.pl

PLファイルです。設定データがあります。

$_->{default_counter}
カウンターの最初の数字です。 通常0ですが、別のカウンターから引き継ぐ場合は、そのカウンターの数字を入れると、そこからカウントし始めます。
$_->{digits_number}
カウンターの桁数です。 10で10桁のカウンターが出来ます。
$_->{count_mode}
カウントモードを設定します。
「0」は全てのアクセスをカウントする「フルカウントモード」
ページ移動後の再アクセスや、ブラウザのリロードなども全てカウントします。
「1」はセッションが途切れるまで再カウントしない「セッションモード」
セッションクッキーを使って制限しています。
「2」は日付が変わらないと再度カウントしない「日付モード」
数年有効なクッキーに日付を書き込んで制限しています。
$_->{admin_remove}
管理人のアクセスをカウントするかどうか設定します。
「0」でカウントします、「1」でカウントしません。
これは、セットアップ時に管理人専用クッキーをセットしで制限します。 クッキーが消えてしまった時は、再度セットアップを実行するとまたクッキーがセットされます。
$_->{bot_go}
検索ボットのカウントの仕方を設定します。
「0」で、通常のアクセスと共に検索ボットのアクセスも含めてカウントします。
「1」で検索ボットのアクセスはカウントしません。
「3」は、検査ボットのみをカウントします、通常のアクセスはカウントされません。
※ユーザーエージェントで判断している為、すべての検索ボットの仕分けが出来る分けではありません。
$_->{gif_counter}
カウンター画像のファイル名が設定されています。

HitBBS 初めに お約束 設置の基本 見本 DL&更新情報


HitBBS (c)
 管理人:ひとちゃん