通常のアクセス解析CGIでは、ファイルダウンロード数を解析することができませんが、このCGIは、ダウンロードファイルごとにダウンロード数を解析し、ランキング表示します。ランキング表示には、「全期間のランキング」「今週のランキング」「今月のランキング」「今日のランキング」「昨日のランキング」の5モードがあります。
通常のアクセス解析CGIでは、ファイルダウンロード数を解析することができませんが、このCGIは、ダウンロードファイルごとにダウンロード数を解析し、ランキング表示します。ランキング表示には、「全期間のランキング」「今週のランキング」「今月のランキング」「今日のランキング」「昨日のランキング」の5モードがあります。
CGI利用規定をご覧になり、同意した上で、ダウンロードしてください。
CGI は、「download」ボタンを押して、入手してください。Windows をご利用の方は zip 版を、Macintosh をお使いの方は sit 版をダウンロードしてください。
|
|
CGIをダウンロードし、解凍してください。それぞれのファイルについて解説します。
|
| ※1 | CGIを設置が、「cgi-bin」などの専用のディレクトリを指定しているプロバイダーをお使いの方の場合、ディレクトリ「images」は、通常のホームページファイルを設置する場所にアップロードしてください。CGI用のディレクトリにアップロードしても、画像が表示されませんので、ご注意ください。 |
■ 転送先
CGI ファイルと、HTMLファイルを何処に設置してもよいサーバの場合には、本 CGI を解凍したディレクトリ構成のまま、サーバへアップロードしてください。CGI ファイルは、専用のディレクトリ(cgi-bin等)に設置しなければいけないサーバ(WebARENA等)の場合には、images ディレクトリを除いたすべてのファイルを CGI 専用のディレクトリへアップロードしてください。images ディレクトリは、通常の HTML ファイル等ををアップロードする場所へアップロードしてください。
■ パーミッション
これらパーミッションは、あくまでも例です。お使いのプロバイダー、レンタルサーバ業者の指示に従ってください。
上表には、パーミッションの指定が 2 種類指定されております。CGI がオーナー権限で実行されるサーバをお使いの場合には、パーミッション1の設定を使ってください。CGI が ohter 権限で実行されるサーバをお使いの場合には、パーミッション2の設定を使ってください。
CGI がオーナー権限で実行されるか、other 権限で実行されるかは、お使いのプロバイダーもしくはレンタルサーバ業者に確認してください。おおむね、CGI ファイルのパーミッションが、704 でも動作する場合には、オーナー権限で実行されると考えても結構です。CGI ファイルのパーミッションが、705 もしくは 707 でないと動作しない場合には、other 権限で実行されているとお考えください。
「変更不要」と指定しているファイルは、サーバにアップロードするだけで OK です。あえてパーミッションを変更しないでください。
プロバイダーによって、Perlパスが異なります。デフォルトでは「#!/usr/local/bin/perl」と設定しております。プロバイダーの指示に従い、以下のファイルのPerlパスを書き換えてください。
お使いになる環境に合わせて、またお好みに合わせて、設定を変更してください。設定の変更は、すべて「dlconfig.cgi」を編集することにより実現します。
#--------------------------------------------------------------------
#■ランキング表示件数
#ダウンロードランキングの表示件数を指定してください。
#--------------------------------------------------------------------
my $ROW = 20;
#--------------------------------------------------------------------
#■ログファイルサイズ表示設定
#ダウンロードランキングに、ログファイルサイズを表示する機能があります。
#もし不要な場合には、「0」を指定してください。
# 0:表示しない
# 1:表示する
#--------------------------------------------------------------------
my $DSP_SIZE = 1;
#--------------------------------------------------------------------
#■ダウンロード総数表示設定
#ダウンロードランキングに、ダウンロード総数を表示する機能があります。
#もし不要な場合には、「0」を指定してください。
# 0:表示しない
# 1:表示する
#--------------------------------------------------------------------
my $DSP_CNT = 1;
#--------------------------------------------------------------------
#■ランキング表の奇数行目のBGCOLOR指定
#ランキング表は、偶数行目と奇数行目それぞれのバックカラーを設定できま
#す。ここでは奇数行目の色を16進数で指定してください。
#先頭には「#」を加えてください。(例:$BGCOLODD = '#E6EAF3';)
#--------------------------------------------------------------------
my $BGCOLODD = '#E6EAF3';
#--------------------------------------------------------------------
#■ランキング表の偶数行目のBGCOLOR指定
#ランキング表は、偶数行目と奇数行目それぞれのバックカラーを設定できま
#す。ここでは偶数行目の色を16進数で指定してください。
#先頭には「#」を加えてください。(例:$BGCOLEVEN = '#EBE1E2';)
#--------------------------------------------------------------------
my $BGCOLEVEN = '#EBE1E2';
#--------------------------------------------------------------------
#■ランキング表のFONT COLOR 指定
#ランキング表の文字の色を16進数表記で指定してください。先頭には「#」
#を加えてください。(例:$FONTCOL = '#000000';)
#--------------------------------------------------------------------
my $FONTCOL = '#000000';
#--------------------------------------------------------------------
#■グラフイメージファイルのURL
#棒グラフに使用するgifファイルをURLで指定して下さい。
#または、各CGIファイルからの相対パスで指定して下さい。
#--------------------------------------------------------------------
my $GRAPHIMAGEURL = './images/dlgraphbar.gif';
#--------------------------------------------------------------------
#■グラフの最大幅指定(ピクセル)
#棒グラフの最大長をピクセルで指定して下さい。
#--------------------------------------------------------------------
my $GRAPHMAXLENGTH = 300;
#--------------------------------------------------------------------
#■サーバの時差の調整
#海外のサーバを利用されている場合、解析結果の時間が日本時間とは、ずれ
#てしまいます。日本時間に調整するために、その時差を設定します。単位は、
#時間(hour)です。国内のサーバを利用の場合には、「0」のままにして下
#さい。
# 例:9時間進める場合には、$DLTIMEDIFF = 9;
# 9時間遅らす場合には、$DLTIMEDIFF = -9;
#--------------------------------------------------------------------
my $DLTIMEDIFF = 0;
#--------------------------------------------------------------------
#■二重カウント防止
#一定時間内に2度以上ダウンロードした場合には、カウントしないようにす
#ることができます。
#ここでは秒数で指定し、指定した秒数を経過するまで同じIPアドレスからの
#リクエストはカウントしません。
#設定を「0」にすると、二重カウント防止機能はOFFになります。しかし、
#MACのIEでダウンロードすると、一度のダウンロードで2度リクエストされ
#ますので、2度ダウンロードしたとカウントされてしまいます。したがって、
#基本的にはこの機能をOFFにしないことをお勧めします。
#--------------------------------------------------------------------
my $DOUBLE_SEC = 30;
#--------------------------------------------------------------------
#■target属性
#ダウンロードランキング表示の際に表示されるリンクのターゲットを指定
#することができます。例えば、もし別ウィンドウで開きたいのであれば、
# my $LINK_TARGET = '_blank';
#として下さい。
#--------------------------------------------------------------------
my $LINK_TARGET = '';
#####################################################################
#これ以降の設定は、通常変更しなくても動作するはずです。理由がない限り
#変更しないでください。
#####################################################################
#--------------------------------------------------------------------
#■ログファイルの指定
#--------------------------------------------------------------------
my $DLLOG = './dllog.cgi';
#--------------------------------------------------------------------
#■リストファイルの指定
#--------------------------------------------------------------------
my $LIST = './dllist.dat';
ランキング表示のページに関しては、「header.temp」と「footer.temp」ファイルを編集することによって、お好みのページにすることができます。ただし、スタイルシートが定義されておりますので、画面構成が崩れる可能性がありますのでご注意ください。また、著作権表示部分は削除禁止です。
dllist.dat に、各ダウンロードファイルのURLごとにタイトルと紹介ページを定義します。ここで定義したものが、ダウンロードランキングの結果表示に反映されます。下記説明に従って、dllist.dat をテキストエディタで編集してください。
################################################################################ # ダウンロードランキングCGI(ダウンロードページ説明データ) ############################################################################### acc http://www.futomi.com/dl/acc1_4.zip アクセス解析 /library/acc.html dlrank ../../library/download/dlrank1_00.zip DLランキング http://www.futomi.com/ |
1行にひとつのダウンロードファイルを定義します。全部で4つの項目がありますが、それぞれをタブで区切ります。4つの項目の意味は次のとおりです。
| 項目 | 説明 |
| ファイル 識別コード |
ひとつのダウンロードにひとつのファイル識別コードを割り振ってください。識別コードは半角英数で指定してください。 |
| ダウンロードファイル のURL |
該当のダウンロードファイルのURLを指定してください。http:// から記述すれば、ダウンロードするときにダウンロードファイルへリダイレクトします。 「dlranklog.cgi」からの相対パスで指定すると、ダウンロードするときに、「dlranklog.cgi」がそのファイルを読み込み、出力します。 MACの Internet Explorerの場合、リダイレクト方式だとダウンロードする際に、CGIのファイル名でダウンロードしようとします。MACを考慮する場合には、この指定は相対パスで記述して下さい。 |
| 説明文 | ランキング表示する際の説明分です。改行を入れずに1行で記載してください。 |
| リンク先URL | ランキング表示の説明文に張られるリンク先のURLです。ダウンロードファイルの説明ページなどを指定するといいでしょう。 |
行の先頭に「#」をつけると、その行は無視されます。(コメントアウト)
今まで、ダウンロードファイルへのリンク元ページには、直接、ファイルのリンクを指定しているはずですが、そこを修正する必要があります。以下に例を挙げて説明します。
ダウンロードランキングCGIの「dlranklog.cgi」のURLが
http://www.hoge.com/foo/dlrank/dlranklog.cgi
だとします。そして、ダウンロードするファイルの識別コードが「acc」だとします。
ダウンロードファイルへのリンク元ページには、以下のとおりに記載してください。
<a href="http://www.hoge.com/foo/dlrank/dlranklog.cgi?dl=acc">ダウンロード</a>
このページのダウンロードでも本CGIが組み込まれていますので、ご参考ください。
ダウンロード説明ページデータファイルの編集の際、ダウンロードファイルを相対パスで指定した場合、そのファイル名の拡張子に応じて、CGIが MIME Type をブラウザーに返します。MIME Typeのデータは、「mime.types」に記述されておりますので、このファイルを編集することにより、新たなMIME Typeを追加することができます。
「mime.types」は、WWWサーバとして使われている「apache」の設定ファイル mime.typesと同じ物です。一行に、「MIME type」と「拡張子」をタブ区切りで記述して下さい。
application/zip zip |
また一つのMIME Typeに複数の拡張子を指定したい場合には、拡張子をそれぞれスペース区切りで記述して下さい。
application/zip zip ZIP |
なお、拡張子の指定は、大文字、小文字を区別しております。添付の「mime.types」ファイルはすべて小文字で指定されております。もし大文字のファイルを扱いたい場合には、上記のように、大文字の拡張子を追加して下さい。
| ※ | ダウンロード説明ページデータファイルの編集の際、ダウンロードファイルを http:// から記述した場合には、リダイレクト方式となりますので、この MIME Typesの設定は無効になります。この場合、サーバに設定されたMIME Typeに応じてブラウザーに送られます。 |
以下のファイルを上書きして下さい。
dlrank.cgi, dlranklog.cgi に関しては、1 行目の Perl のパスをチェックして下さい。また、サーバにアップロードする際には、ASCII モードで転送して下さい。
お手数ですが、すべてのファイルを設置し直してください。
【Ver 2.2 → Ver 2.3】 2004/06/03
【Ver 2.1 → Ver 2.2】 2004/05/12
【Ver 2.0 → Ver 2.1】
【Ver 1.0 → Ver 2.0】 2001/05/06