efCount取扱説明書

fcount.cgi の一行目のperl へのパスををお使いのプロバイダに合わせて書き換えます。
もし、perl のパスが /usr/bin/perl だったら、

#!/usr/bin/perl

と書き換えて下さい。　頭の #! は消してはいけません。

SSI として動作させるなら 1， CGI として動作させるなら 0(数字のゼロ) を指定します。
大概の方は 0 を指定することになると思います。

ログファイルを格納したディレクトリの名前を入力します。　(デフォルトは log )
(※仕様変更しました。　今までパスを指定していた方はご注意下さい！)

他人にブラウザからログを直接読まれたくないという人はここを変更します。
(ただし、ログ用ディレクトリは efStat をインストールしたディレクトリの中(配下)になければなりません)
特別な事情がなければ変更せずにお使い下さい。

readme.html の通りにインストールしたのなら変更しないで下さい。

！	無理な値を指定すると過負荷でサーバを停止させてしまう危険性があります。 注意して設定して下さい。

アクセスログを何件分保存するか指定します。
この数を超えた分のログは古い順からところてん式に押し出され、消えてゆきます。

理論上の制限はありませんが、でかい数にしてサーバが壊れると怒られてしまいますし、ログの表示にとてつもなく時間が掛かるようになってしまいますので、程良い数にしましょう(^_^；

デフォルトは300です。　これはうちのページの場合の設定値なんですが、来客数が一日100件くらいの規模のページならこれでも余裕でしょう。
おすすめは300〜500程度です。

どんなに多くても3000程度にして下さい。　それ以上は安定動作を保証できません。
これ以上増やすとログの取りこぼしやログの破損の危険があります。
最悪の場合サーバをクラッシュさせてしまうかも知れません。

詳しくはtips / ログ最大保存数の限界値を参照下さい。

再読み込み防止機構とは、訪問者のIPアドレスと、ログに記録された前回の訪問者のIPアドレスを比較し、

• 一致すれば「同じ訪問者」　→　カウントしない
• 一致しなければ「違う訪問者」　→　カウントする

という仕組みで無駄なカウントアップを防ぐ機能です。

しかしながら、常にカウントアップしたい、という方もおられることでしょう。
そのような場合、このオプションの数値を 0 に指定してください。

自分自身など、カウントに含めたくないホスト名又はIPアドレスを指定して下さい。
但し、完全に一致させなければ効果がありません。

この欄を空欄にすると正常に動作しません。
不要な方も、必ず適当な値を入力しておいて下さい。　

ロボットなど、カウントに含めたくないブラウザ名を記述します。
SSI モードで動かしていて、WWWC 等のロボットが頻繁に来るようなページでは特に有効です。

ここで指定された文字列は前方一致比較の対象になります。
つまり、WWWC としておけば

• WWWC/0.93
• WWWC/1.23
• WWWCabcdefg

などを名前に持つブラウザの場合に無視します。

この欄を空欄にすると正常に動作しません。
不要な方も、必ず適当な値を入力しておいて下さい。

画像ファイルを格納したディレクトリの名前を入力します。　(デフォルトは image )

都合上、他のディレクトリにカウンタ用イメージを入れた場合はここを変更します。
ただし、カウンタ画像用ディレクトリは efStat をインストールしたディレクトリの中(配下)になければなりません。
特別な事情がなければ変更せずにお使い下さい。

readme.html の通りにインストールしたのなら変更しないで下さい。

カウンタ用画像配布サイトからカウンタのイメージファイルをダウンロードしてきて解凍すると、フォント名の付いたディレクトリが出来るはずです。
そのディレクトリをそのまま、イメージ格納用ディレクトリ(何も変更していないなら image )の中にコピーして下さい。
そうしないと上手く動作しません。

＜例＞

カウンタ画像ファイルをefStatで使うには、命名規則に合わせる必要があります。　tips / カウンタ用画像の命名規則も併せてご覧ください。

カウンタの名前を指定して下さい。
上の例では fuksan ですね。

ここで指定する名前はデフォルトの指定となり、呼び出し時にフォント指定をしなかった場合、ここで指定されたフォントが使用されます。

efStat 一式をインストールしたディレクトリを指定します。

呼び出すHTMLから見た相対パスでも良いですが、ルートディレクトリからのフルパスが望ましいです。
相対パスで指定した場合、呼び出すHTMLが他のディレクトリにあったりすると動作しないからです。

フルパスは telnet や ftp 等を使い、各自でお調べ下さい。
プロバイダの説明ページに載っている場合があります。

fcount.cgi の(約)398行目から(約)421行目までが変更箇所です。
(おすすめ：　エディタの検索機能で "sub Macro_Output" を検索してみて下さい)

@mes = (
　　"<FONT FACE=\"Arial\"><B>[Counter]</B> Total:<B>${all}}</B>
　　/ Today:<B>${today}</B> / Yesterday:<B>${yesterday}</B></FONT>",
);

こんな部分があると思います。
メッセージを変更したいときはここを変更します。　変数などの詳しい意味はプログラム中に説明がありますので、そちらをご覧下さい。

上記の例では総ヒット数が5600、今日のヒット数が23、昨日のヒット数が56の場合、

[Counter] Total:5600 / Today:23 / Yesterday:56

と表示されます。

メッセージを複数指定しておくことでランダムに表示させることが出来ます。

@mes = (
　　"メッセージ A",
　　"メッセージ B",
　　"メッセージ C",
);

例えばこの様に書いた場合、3つのメッセージをランダムに表示させます。

また、

@mes = (
　　"メッセージ A",
);

または

@mes = (
　　"メッセージ A",
　　#"メッセージ B",
　　#"メッセージ C",
);

このようにすると常に一つのメッセージだけを出力するようになります。

ちょっと戸惑うかも知れませんけど、呼び出しの書式を示しておきます。
本当は呼び出しタグ自動生成ツールがありますが、これに甘えすぎるとトラブった時に自分で解決できないので、必ずこちらを熟読してから使って下さい。

【書式】 fcount.cgi?LOG=[ログファイル名]&MODE=[表示モード]&DIGIT=[表示桁数]&FONT=[フォント指定]&REF=[参照元URL]&SCR=[画面情報] ※すべてのオプションに順番は関係ありません。
[ログファイル名] ※時計機能の場合のみ省略可	カウントさせるログファイルの名前を指定します。 拡張子は指定する必要がありません。 (というか、指定するとエラーになります)
[表示モード] ※省略可	どういうカウンタを表示させるかを指定します。 a , t , y , w が使用できます。 省略すると強制的に総カウント数が表示されます。 それぞれの英文字に頭に - (ハイフン)を付加すると、カウントアップを行いません。 つまり、それぞれの項目のカウント値を表示させるだけという動き方をします。 詳しくは 何故カウントアップしない指定があるのか を参照下さい。
	それぞれの意味
	a (-a)	総カウント数を表示 (All)
	t (-t)	本日カウント数を表示 (Today)
	y (-y)	昨日カウント数を表示 (Yesterday)
	w	[おまけ機能]：24時間表記の時計を表示させる (Watch) (→時計機能を使うときの注意)
[表示桁数] ※省略可	カウンターの数字を何桁で表示させるか指定します。 0 から 9 までの値が指定できます。 (0 は実質的にオプションを省略したことと同じ意味になります) 9桁以上を指定するとエラーになります。 省略すると、実際の桁数に合わせて表示します。
[フォント指定] ※省略可	デフォルトで指定したフォント(カウンタ用画像の名前)を任意に変更させるにはこの項目を追加します。 省略すると、プログラムの設定項目で指定した画像が使用されます。
[参照元URL] ※省略可	参照元URLを記録します。 実際には、 JavaScript の力を借りてココを埋めます。 (よって、訪問者が JavaScript をオフにしている場合、参照元を取得できないという制限があります)
[画面横幅],[縦幅],[色数] ※省略可	画面の縦幅・横幅・色数を記録します。 実際には、 JavaScript の力を借りてココを埋めます。 (よって、訪問者が JavaScript をオフにしている場合、画面情報を取得できないという制限があります)

いきなりHTMLに組み込んだりせずに、動作するのを確認してからHTMLに組み込むのが賢いやり方です。
ブラウザのURL入力欄に

http://???/~username/cgi-bin/fstat/fcount.cgi?LOG=index
（ページのあるサーバが ??? で、あなたのユーザ名が username、cgi-bin というディレクトリの中に fstat を置いている場合）

と打ち込んでみましょう。　（もちろん index は同梱の index.log の事ですネ）
あなたが既に他にログファイルを作っているのなら、その名前に置き換えて下さい。

上のように試して、数字が表示されましたか？　上手く行かなければtips / トラブルシューティングをお読み下さい。
上手く行ったなら、もう怖い物はありません。　ジャンジャン応用してみましょう。　例えば、

など、オプションを色々と組み合わせて反応を見てみましょう。
（ちなみに、この時にカウント数が増えないのは正常な動作です）
なお、書式の欄でも書きましたが、全てのオプションの順番はバラバラでも構いません。
ここまで来れば、fcount.cgi を使いこなせたも同然です(^^)
さらに応用として、JavaScript を組み合わせて参照元を記録できる状態まで持って行きましょう。　そのまま読み進めて下さい。

sample.html　を読むと更に分かり易いでしょう。
と、いうか、sample.html のサンプルをそのままパチると簡単です。
（下の例は純粋なテキストではないのでお奨めできません）

他にも有用なテクニックが載っていると思いますので、是非参考にして下さい。

なお、手動でタグを準備する自信がない方は 呼び出しタグ自動生成ツール をお使い下さい。
これでタグを作り、呼び出したいHTMLファイルにカット＆ペーストすれば楽勝でしょう。
ただ、こればかりに頼っているとハマったときに原因が分からなくなりますので、退屈かとは思いますが下の説明もちゃんと読んで下さいね。

カウンターを表示させたい部分に、

というタグを埋め込みます。　太字で色の付いた下線部分が変更箇所です。
カットアンドペーストして使うと良いでしょう。

./cgi-bin/fstat/fcount.cgi の部分は、呼び出すHTMLから見た fcount.cgi への相対パスを指定します。
また、 http://www.hoge.ne.jp/~fuka/cgi-bin/fstat/fcount.cgi のようなURLでの指定でも構いません。
HTMLの置かれたサーバとは別の場所にefStatを設置した時に有効でしょう。
(BIGLOBEのwww5aサーバやTikiTikiの様にCGIサーバが外部にあるプロバイダ、人にefStatをレンタルする場合など)

index の部分はログファイル名を指定します。

a は表示オプションを指定します。　a , t , y , w の４種類があります。
省略すると a を指定したことになります。

5 は表示桁数です。　ここでは「5桁表示する」という意味です。
省略できます。

fuksan は表示フォントを fuksan に指定する、という意味です。

ALT="総アクセス数" WIDTH="60" HEIGHT="16" BORDER="0"
ですが、これはまさしく IMG タグの指定そのままです。
お好きなように変更して下さい。
他のブラウザではどうか知りませんが、少なくともNetscape NavigatorではIMGタグで画像サイズを指定しておかないと、その画像を読み込み終わるまで他の部分を読み込んでくれないという仕様があります。
ですから、出来るだけ画像サイズは指定しておくようにして下さい。
表示桁数を指定して桁数を固定すると、画像サイズの指定がしやすくなってイイカンジです。

また、カウンタの存在を知られたくない、つまり隠しカウンタとして使いたい方は、ここで WIDTH と HEIGHT を 1 に指定します。
要するに、1ドットしかないカウンタ画像を表示するよう指定します。　これならまず見つからないでしょう。　…ソースを見れば…なんてツッコミはなし(^^;

【書式】 fcount.cgi?LOG=[ログファイル名]&MODE=[表示オプション] ※　<!--#include virtual=""--> による呼び出しにのみ対応しています。 ※　オプション指定の順番は変えてはいけません。 ※　区切りには半角スペースを用います。
[ログファイル名]	カウントさせるログファイルの名前を指定します。 拡張子は指定する必要がありません。 (というか、指定するとエラーになります)
[表示オプション] ※省略可	省略	通常動作します。　つまり、カウントした後にメッセージを表示します。 "-" , "h" 以外の文字を入力したときも強制的に通常動作します。
	-	カウント値の表示は行いますが、カウントはしません。　つまり、表示のみを行います。 フレームを使ったページで有効でしょう。　例えば、 index.html　(h オプションで記録を取る) 　　　|----- menu.html 　　　+----- main.html　(- オプションで表示だけさせる) といった使い方が考えられます。 これだと参照元を正確に記録できるだけでなく、フレーム内で表示もできて美味しいとこ取りです。
	h	カウント値を表示せずにカウントします。　(Hidden) つまり、隠しカウンターとして動作します。

カウントしたいページのHTMLのどこか(出来れば<BODY>タグの直後など、ファイルの先頭の方が良いです)に、

<!--#include virtual="./cgi-bin/fcount/fcount.cgi?LOG=index"-->
(カウント値を表示させる場合)

<!--#include virtual="./cgi-bin/fcount/fcount.cgi?LOG=index&MODE=-"-->
(カウント値を表示させるだけの場合)

<!--#include virtual="./cgi-bin/fcount/fcount.cgi?LOG=index&MODE=h"-->
(カウント値を表示させない場合)

このようなタグを埋め込んで下さい。　カットアンドペーストして使うと良いでしょう。
太字で色の付いた下線部分が変更箇所です。

./cgi-bin/fstat/fcount.cgi の部分は、呼び出すHTMLから見た fcount.cgi への相対パスを指定します。
/~fuka/cgi-bin/fstat/fcount.cgi のようなドキュメントルートからの絶対パス指定でも構いません。