Textcounter - 解説＆ダウンロードページ

Textcounter 解説＆ダウンロードページ

● 主な機能と特徴

TextcounterはSSIを使用した、テキスト表示型のカウンタです。
今日/昨日のカウント数を、テキストで表示することも出来ます。
3桁区切り機能、桁数調整機能で見やすさにも配慮。
重複カウントを防止する、IPアドレスチェック機能付き。
管理モードでカウント数をいつでも変更可能。
もちろんロック機能付き。
このスクリプトはSSIが使えるプロバイダでなければ動作しません。

サンプル
以下は累計/今日/昨日のカウント数を表示させた例です。
サンプルではカウント数を太字にしてあります。

累計値：	41,879 カウント
今日：	0005 カウント
昨日：	0009 カウント

● ダウンロード

以下のZIP圧縮ファイルをダウンロードしてください。

Textcounter v2.00
（text_c.zip）
続いて解凍します。解凍ソフト をお持ちで無い方はまず入手しましょう。
解凍すると以下のファイルが展開します（拡張子が無いものはフォルダです）。

t_counter.cgi
data
count.log
today.cnt
yesterday.cnt

すべてのファイルが揃っていることを確認して、次へ進みましょう。

● プログラムの設置

まずは t_counter.cgi をメモ帳などのテキストエディタで開きます。

最初の1行目

を自分のプロバイダの環境に合わせて書き直します。
大抵プロバイダのホームページに書いてあるので、探してみましょう。

以下は初期設定部分の引用です。
初心者の方は説明にしたがって赤字の重要設定項目を変更しましょう。

### 初期設定ここから ###
### ↓↓↓↓↓↓↓↓ ###

#--このスクリプトに関する設定--#

## このCGIファイルの名前
$cgifile = 't_counter.cgi';
## データファイルまでのパス
$datafile = 'data/count.log';
## 今日のカウント数の保存ファイルまでのパス
$todayfile = 'data/today.cnt';
## 昨日のカウント数の保存ファイルまでのパス
$yesterdayfile = 'data/yesterday.cnt';

#--処理に関する設定--#

## 文字コード
$moji_code = 'Shift_JIS';

## IPアドレスをチェックする (Yes=1 No=0)
### 1 にすると重複カウントを防止します
$ip_check = '0';

## 今日/昨日のカウント数を保存する（Yes=1 No=0）
### 累計カウントのみで使用する場合は 0 とする
$ty_flag = '1';

## 桁区切り処理を行う（Yes=1 No=0）
### 桁区切り処理は累計カウント数にのみ有効
### 1 にした場合は下の $width は無視されます
$d_total = '0';

## カウンタ桁数
### 0を挿入したくない場合は 0 としてください
### 桁区切り処理を行う場合 $width は無視されます
$width    = '6'; # 累計カウント数
$ty_width = '4'; # 今日/昨日のカウント数

## ロック処理を行う (Yes=1 No=0)
### 通常はこのままの状態で使用してください
$lockkey = '1';
## ロックディレクトリ名
### 通常はこのままの状態で使用してください
$lockdir = 'data/lock';

## マスターキー
### 管理モードを使わない場合は 0000 とする
$master_key = '0000';

続いてカウント数を表示させたいHTMLファイルの任意の場所に、
カウンタを呼び出すためのタグを書きます。

以下は[cgi-bin]ディレクトリ（フォルダ）の中へプログラムを置いた場合の例。

累計カウント数　　　 今日のカウント数　　 昨日のカウント数

● ファイルの転送

初期設定が済んだらいよいよファイルを転送します。
FTPソフト をお持ちで無い方は こちら を参考にしてください。

以下は[cgi-bin]ディレクトリ（フォルダ）に転送した場合の例です。
ファイルやディレクトリの横に<755>などとありますが、これはパーミッション（アクセス権）です。
間違えないよう正しく設定してください。

[www]┐
     ├ ･･(略)･･.html （このファイルに呼び出すためのタグを書く）
     ｜
     └ [cgi-bin] ┐
                  ├ t_counter.cgi <755> メインCGI
                  ｜
                  └ [data]┐               <777> データ格納ディレクトリ
                           ├ count.log     <666> カウントデータを保存
                           ├ today.cnt     <666> 今日のカウント数を保存
                           └ yesterday.cnt <666> 昨日のカウント数を保存

転送とパーミッションの設定がうまくいったら、SSIを動作させてみましょう。
カウントが表示されれば、とりあえず成功です。

以下の補足事項もご覧になってください。

● 補足事項

SSIが動作しない（カウンタが表示されない）

この場合は様々なことが考えられますが第一に浮かぶのが、
SSIを動作させるHTMLファイルの拡張子が、プロバイダ側で決められていないかということです。
普通HTMLファイルは拡張子が.htmlや.htmですが、SSIを使うファイルの場合、
.shtmlでなければならないとあらかじめ決められている場合があります。
管理モードの使い方

このプログラムは前にも述べたように管理モードがあります。
管理モードからはカウント数が変更できます。
管理モードの呼び出しは、URL欄に、以下のように入力してください。

http://･･（略）･･/cgi-bin/t_counter.cgi?edit

このように t_counter.cgi のあとに引数をつけて呼び出します。
これでブラウザ上に管理モード画面が表示されるはずです。
あとは画面の指示に従ってください。

管理モードはマスターキーを0000にした場合は使用できません。
動作しない、またはバグを発見した場合

まずは サポートBBS にて症状を詳しく載せてみましょう。
どう考えてもバグと思わしき症状を発見した場合は コンタクトフォーム からご連絡ください。
更新履歴

2002/11/26 v2.00を公開。
1.ロック処理をmkdir関数に統一しました。
2.IPアドレスチェック機能を追加し、重複カウントに対処。
3.海外サーバでの時差対策として、タイムゾーンを日本時間に定義。
4. その他、細かな修正点多数。

2002/05/11 v1.62を公開。
1.引数を付けてアクセスした場合はカウントアップしないようにしました。
2.ソースを若干簡略化（動作内容に変更はありません）。

2002/05/09 v1.60を公開。
1.エラーメッセージが正しく出力されない不具合に対処。
2.管理モードで不正なカウント数を入力した場合、エラー表示するようにしました。
3.管理モードの引数による呼び出し方法を簡略化しました。

2002/05/03 v1.50を公開。
1.桁区切り機能を追加しました。
2.エラーメッセージの表示を変更しました。
3.処理方法を若干変更し、管理モードでのデザインも変更しました。

2002/03/13 v1.30を公開。
1.ロック処理にsymlink関数を使用できるようにしました。

2001/04/26 v1.20を公開。
1.ロック機構を改良。これにより一部サーバで不具合が生じていたのに対処。
2.管理モードでの文字化け対策に文字コードを設定できるようにしました。
3.管理モードでのエラー発生時の表示方法を変更しました

旧バージョンをお使いの方は t_counter.cgi のみを上書きしてください。
今までのカウントログはそのまま使用可能です。