DSCounter
Ver.1.13
Copyright 2001 DELTA SOFT
はじめに
DSCounterはページカウンター、テキストカウンター、ダウンロードカウンターに使用できる万能カウンターです。
自由に改良して使用して構いません。(許諾条件参照)
ただし、私自身CGIについて詳しくないので、サポートはしませんし、技術的な質問にもお答えできません。
CGIについては「とほほのWWW入門」を参照してください。
dsctmgr.cgiはdscount.cgiに統合されました。
旧版をインストール済みの方はサーバーからdsctmgr.cgiを削除してください。
その他セットアップを再度確認してください。
特徴
・これ一つでページカウンタ、テキストカウンタ(SSI)、ダウンロードカウンタになります。
・複数ページ、複数ダウンロードに対応しています。
・なるべく簡単に使用できるように設計してあります。
・表示に累計、本日、昨日のカウント数が指定できます。
・個別にグラフィックス(GIF)を指定できます。
・加算値の指定ができます。(表示のみで加算しない事も可)
・月別、曜日別、時間別のアクセス解析ができます。
・管理ページが付いています。
・CGIの先頭行の #!/usr/bin/perl をサーバーに合わせて変更してください。
・ログファイルなどのファイル名を変えてください。
ログファイル($LogFile、$LogBakFile)にはパスワードも記録されています。
他人に見られないようにファイル名を変えましょう。
・その他CGIの先頭部分の定義を必要に応じて変更してください。
・下記のファイルをサーバーにアップロードしてください。
ファイル名 |
パーミッション |
説明 |
dscount.cgi |
755 |
カウンタ本体 |
gifcat.pl |
755 |
画像連結ライブラリ |
jcode.pl |
755 |
日本語処理ライブラリ |
bar.gif |
644 |
グラフ用画像 |
dscount.htm |
644 |
ドキュメント |
データファイル(dscount.cnt、dscount.log)は自動作成されます。
・必要に応じてカウンターグラフィックスをアップロードしてください。
グラフィックスは同サイズ、同パレットで0.gif〜9.gifの10個を用意します。
コロンやスラッシュなどの記号を使う場合はそれも用意します。
透過GIF可、ディレクトリは同サーバー内で任意です。
gifディレクトリにサンプルグラフィックス(下図)、transparentディレクトリに1x1の透明GIFを同梱してあります。
注
left.gifとright.gifは他とサイズが異なりますのでviewオプションでの連結はできません。
オンラインでドキュメントを表示する場合はこのグラフィックスもアップロードしてください。
・パーミッションをサーバに合わせて設定してください。
.cgi/.plは755、.gifは644など
・パスワードを設定してください。
ブラウザ―からサーバー上のdscount.cgiを実行して、パスワードを設定してください。
例:ブラウザ―でURLに"http://www.〜/cgi-bin/dscount.cgi"を入力
・カウンターの登録作業はいりません。
注:$AutoRegist=0なら管理ページで登録してください。
使い方
書式:dscount.cgi?オプション&...
<オプション>
name=カウンタ名(省略した場合には管理ページを表示)
url=アドレス (相対パスでも絶対パスでも可)
image=GIFディレクトリ名 (cgiの場所から相対指定)
image=textの時はテキスト出力(SSI)
image指定がない時はダウンロードカウンタ
digit=最小桁数 (省略時は1)
add=加算値 (省略時は累計表示時には1、他は0)
view=表示項目リスト (省略時はtotal)
表示項目リスト
項目名 |
値 |
グラフィックス |
例 |
total |
累計 |
0.gif〜9.gif |
|
today |
本日のアクセス数 |
0.gif〜9.gif |
|
yesterday |
昨日のアクセス数 |
0.gif〜9.gif |
|
year |
今日の年 |
0.gif〜9.gif |
|
mon |
今日の月 |
0.gif〜9.gif |
|
day |
今日の日 |
0.gif〜9.gif |
|
(スペース) |
|
space.gif |
|
. |
|
dot.gif |
|
: |
|
colon.gif |
|
- |
|
hyphen.gif |
|
/ |
|
slash.gif |
|
( |
|
left.gif |
|
) |
|
right.gif |
|
その他の文字 |
一文字毎 |
文字.gif |
|
各オプションは省略可能です。(順不同)
デフォルトではカウンタの登録作業は必要ありません。(自動登録)
自動登録をしないようにする場合は"dscount.cgi"内の"$AutoRegist=1"を"$AutoRegist=0"にしてください。
例
・ページカウンター
<IMG
SRC="cgi-bin/dscount.cgi?name=Top&image=gif1">
<IMG SRC="cgi-bin/dscount.cgi?name=Top&image=gif2&view=today">
1行目は累計(加算あり)、2行目は今日のアクセス数(加算なし)を表示します。
上記例ではそれぞれ別の画像を使用し、gif1、gif2ディレクトリにGIF画像をおきます。
カウンター表示したくない場合は透明GIFを使用してください。
・テキストカウンター
<!--#exec cgi="cgi-bin/dscount.cgi?name=Top&image=text"-->
SSIでテキスト出力したい場合には"image=text"にします。
・ダウンロードカウンター
<a href="cgi-bin/dscount.cgi?name=DSCounter&url=http://www1.odn.ne.jp/deltasoft/dscount.lzh">
ダウンロードカウンタの場合はimageオプションは指定してはいけません。
urlオプション省略時には登録されているurlを返します。
安全上の問題から自動登録がONの場合はurlを指定するようにしてください。
いくつかのグループに分けたい場合
ダウンロードカウンタとページカウンタを分けるなど、いくつかのグループに分けて集計したい場合にはディレクトリを変えてDSCounterをそれぞれインストールしてください。
例:
cgi-bin--+--pagecount------+--dscount.cgi
|
+--downloadcount--+--dscount.cgi
管理ページ
nameオプションを指定しないでdscount.cgiを実行すると管理ページが表示されます。
ブラウザから直接"http://www.〜/dscount.cgi"を指定するか下記のようにリンクを張ってください。
<a href="cgi-bin/dscount.cgi">ダウンロードランキング</a>
管理ページには以下の3つがあります。
なお、パスワードが設定されていないと編集ページが表示されますので、パスワードの設定を行ってください。
タイトル部分(DSCounter)をクリックするとオンラインヘルプ(このドキュメント)が表示されます。
・アクセス解析なし一覧表示
アクセス数のみ表示し、月別、曜日別、時間帯別のアクセス解析は表示しません。
・アクセス解析あり一覧表示
アクセス数とアクセス解析表示を行います。
・編集ページ
カウンタの登録、修正、削除やアクセス解析するカウンタの設定ができます。
編集ページに入るには一覧表示の右上の入力ボックスにパスワードを入力して"Edit"ボタンを押してください。
パスワードはこのページで設定/変更できます。
パスワードが設定されていないと編集ページが表示されます。
カウンタの登録
カウンタ名を入力して"Edit"ボタンを押してください。
なお、デフォルトでは自動登録ができますので、わざわざ登録する必要はありません。
カウンタの修正
カウンタ名と修正する部分の値を入力して"Edit"ボタンを押してください。
空欄は修正されません。
カウンタのクリア
カウンタ名を入力して"Clear"ボタンを押してください。
カウンタの削除
カウンタ名を入力して"Delete"ボタンを押してください。
アクセス解析カウンタの設定
アクセス解析できるカウンタは1つのみです。
カウンタ名を入力して"Change"ボタンを押してください。
カウンタ名を設定しない場合は全てのアクセスの解析を行います。
値のリセットだけしたい場合は同じ名前にして"Change"ボタンを押します。
パスワードの設定
新パスワードと確認用の入力をして"Change"ボタンを押してください。
自動登録の注意
dscount.cgiの$AutoRegistが1の場合にはカウンタの自動登録を行いますが、安全上の問題がありますので注意してください。
心配な場合は自動登録をOFFにしてください。($AutoRegist=0)
・urlオプションを明示する
自動登録がONだとurlが変更された場合には自動的に登録されているurlも変更します。
これは外部からurlの変更が可能な事になるので、ダウンロードカウンタの場合にはなるべくurlオプションでURLを明示的に指定してください。
そうすれば、例え書き換えられても明示されているURLを返します。(ついでに登録URLも修正される)
なお、ページカウンターの場合にはURLを返さないので特に問題にはならないでしょう。
<a href="cgi-bin/dscount.cgi?name=DSCounter> |
DSCounterに登録されているURLを返すが、外部から書き換える事が可能 |
<a href="cgi-bin/dscount.cgi?name=DSCounter&url=../lib/dscount.lzh> |
例え書きかえられても明示されているurlを返す。 |
・勝手にカウンタを作れる
自動登録がONの場合には外部の人間が勝手にカウンタを作れてしまう事になります。
ただ、これは管理ページを見ればすぐ分かるし、発見次第削除すればいいでしょう。
まぁ、こんな事する人もいないと思いますが…
その他の注意
ログファイルのあるディレクトリ(cgi-binディレクトリなど)にはindex.htmなどを置いておきましょう。
これらのデフォルトドキュメントがないとそのディレクトリにあるファイルが見れてしまう事があります。
index.htmの内容はなんでも構いません。
履歴
2001/7/17 Ver.1.13
・カウンター一覧表示のURL表示を最後にした
2000/3/22 Ver.1.12
・カウンターファイルがない時の処理を変更
・カウンタークリアの処理を変更
2000/2/10 Ver.1.11
・管理ページのカウンターの"Clear"の不具合を修正
2000/2/4 Ver.1.10
・カウンタ本体(dscount.cgi)と管理ページ(dsctmgr.cgi)を1つにした
・viewオプションで累計、本日、昨日のアクセスなどを一度に指定できるようにした
・管理ページからデータファイルのダウンロードができるようにした
・管理ページのタイトルをクリックしたらドキュメント(このファイル)を表示するようにした
2000/2/1 Ver.1.00
・初公開
・著作権を侵害しない
・違法、不正な使用をしない
・このソフトを使用して発生したいかなる事態にも、作者、著作権者にその責任、賠償等を請求しない
・使用者の責任において使用する
上記に同意できる場合に限り、自由に使用してください。
転載配布条件
使用許諾条件と同じ条件に同意し、無償の場合に限り自由に行って構いません。
商用利用条件
書籍等の付録メディア等に収録する場合は、転載配布条件に準じますが、下記連絡先までご一報ください。
その他のケースについては個別に対応しますので、下記連絡先までお問い合わせ下さい。
連絡先
デルタソフト
ホームページ:http://www1.odn.ne.jp/deltasoft/
電子メール:deltasoft@pop07.odn.ne.jp