========== Readme.txt for BooHyperCounter ver1.41 ==========
*BooHyperCounterは、Perlで記述されたアクセスカウンターです。
*BooHyperCounterは、ひとつのCGIファイルで複数のページの
カウントができます。
*このプログラムを使用する前に以下のことをご確認下さい。
1.サーバーでCGIを使用できること
2.サーバーでPerlを使用できること
*利用方法
1.まず、bhcnt.plの拡張子を.cgiに変更します。
2.メモ帳などのエディタで、カウント数の入るファイルを
作ります。以下に例と説明を記述します。
まず、エディタなどを開き、以下の例と説明を参考に、
カウンター用のデータを記述します。
<例>
0,./page1.html,./img1/
0,./page2.html,./img2/
[説明]
ひとつのページの設定で1行使用します。従って上の例
では2つのページにカウンターを設置しているわけです。
ちなみに、上の例はレイアウト上、行頭に余白がありま
すが、実際に記述する際は、行頭・行末ともスペースは
入れないでください。なお設定は全て半角で記述してく
ださい。
また、それぞれの設定項目ごとに 「,」で区切ります。
そして設定項目は4項目あります。
[では設定項目ごとの説明です]
1項目目(上の例では「0」の部分)
カウントの初期値です。カウントを開始したい数字を
入れます。
2項目目(上の例では「./page1.html」の部分)
カウンターを取り付けたいページの名前です。カウン
トページを特定するための名前ですので、半角英数で
あれば、お好きな名前でかまいません。上の例のよう
にページへのパスを書くのも良いと思いますし、1,2,
3,... というように番号でも構いません。ただ、同じ
名前を他の行で使用しないでください。
3項目目(上の例では「./img1/」の部分)
カウンター用数字画像のあるディレクトリへのパスで
す。ディレクトリへのパスですので、必ず最後に「/」
を忘れないでつけてください。
カウンターをつけたいページが複数の場合は、同様にし
てページ数分の行を設定してください。最後の行の行末
は、改行してもしなくてもかまいません。
設定が終了しましたら、ファイル名「hcnt.dat」で保
存してください。
3.bhnct.cgiを、エディタで開き、以下の部分を変更してく
ださい。(変更箇所は先頭行と#set data部分です)
*先頭行の#! /usr/local/bin/perl の部分を 自分のサ
ーバーでのPerlへのパスに書き換えてください。分か
らない方は、サーバー管理者へお問い合わせください。
*$count = の''内には、hcnt.datへのパスを指定します。
4.カウンター用の数字画像を用意し、数字画像のファイル
名を、0.gif 〜 9.gifとしてください。(必ずGIF形
式の画像をご使用ください)
5.カウンターを設置したいページに、以下のようなタグを
挿入してください。(この部分にカウンターが表示され
ます)
表示したい桁数ぶんのタグを挿入します。上の場合だと、
4桁のカウンターになります。 5桁だと、「?fm=」の後
ろを 5 とします。つまり、fm= の部分で桁数を指定して
います。そして5桁だと「fig=」の後ろが、5&・・・,4&・・・,
3&・・・,2&・・・,1&・・・となり、5つのタグを書きます。
つまり、fig=の部分では右から数えて何桁目にあたるか
を指定しています。
次に、「&file=」の後ろは、hcnt.datの2項目目で設
定したページの名前です。hcnt.datと、ここでの記述を
照合してカウントページを特定していますので、間違わ
ないようにしてください。
なお、bhcnt.cgi を同じディレクトリに入れない場合
は 「src="」以降の部分をCGIプログラムにパスが通
るように変更する必要があります。
ちなみに
タグの WIDTH="" オプションと
HEIGHT="" は使用可能です。
6.bhcnt.cgiを、サーバーにASCIIモードで転送します。
(CGIプログラムの設置場所をプロバイダ側で指定し
ている場合がありますので、分からない場合はサーバ
ー管理者にお問い合わせください)
7.bhcnt.cgiがあるディレクトリに 「lock」という名前の
ディレクトリを作成します。このディレクトリには、何
も入れなくてかまいません。
8.hcnt.datの 4項目目で設定したディレクトリに 0.gif
〜 9.gif の画像ファイルをbinaryモードで転送します。
9.$countで指定した場所に「hcnt.dat」ファイルをAscii
モードで転送します。
10.以下のようにパーミッションを設定します。
注:ここでは数字画像の入ったディレクトリを、仮にimg
として説明しています
(パーミッションの設定方法についてはFTPソフトの
操作説明をお読みください)
lock