========== 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