K_KOMAI'S HOUSEのバナー トップのイメージ 矢のイメージ Ranking 矢のイメージ メール
Soly japanese only.
PCの部屋のイメージ 自作ソフト/CGIを掲載しています、ご利用下さい。

ソフトアイコン アクセスランキング 解説書 ランキング

 この度は、当アクセスランキングをご利用いただきありがとうございます。
 このhtmlは、「アクセスランキング Ver.1.1.1」の解説書です。
 ご利用に際しての、説明、注意事項などを記述してあります。
概略
 管理人様のサイト内にある、コンテンツ毎にカウンターを設置し延べ人数(ページビュー数)集計を行う。
 また、その集計を利用して、ランキング表を出力する。
ディレクトリー rank_std 本体を含む当CGIのルートフォルダ
ファイル rank_std.cgi アクセスランキング 本体
ファイル htmlform.dat CGIで出力するページの記述部
ファイル counter.dat コンテンツ毎のカウンターを管理するデータファイル
ファイル general.pl 汎用的なルーチン。木眞井啓明作成のCGIパッケージ
ファイル lockfile.pl ファイルの排他制御を行うルーチン。木眞井啓明作成のCGIパッケージ
ファイル sort.pl レコードデータのソートを行うルーチン。木眞井啓明作成のCGIパッケージ
ディレクトリー cgiImage CGI実行中に使用するイメージのフォルダ
ファイル 0.gif カウンター出力で使用する「0」の画像
ファイル 1.gif カウンター出力で使用する「1」の画像
ファイル 2.gif カウンター出力で使用する「2」の画像
ファイル 3.gif カウンター出力で使用する「3」の画像
ファイル 4.gif カウンター出力で使用する「4」の画像
ファイル 5.gif カウンター出力で使用する「5」の画像
ファイル 6.gif カウンター出力で使用する「6」の画像
ファイル 7.gif カウンター出力で使用する「7」の画像
ファイル 8.gif カウンター出力で使用する「8」の画像
ファイル 9.gif カウンター出力で使用する「9」の画像
ファイル busy01.gif カウンター出力の際、カウンターファイルが使用中の場合に使う画像
ファイル dummy03.gif カウンター出力の際、非表示の場合に使う画像
ファイル error02.gif カウンター出力の際、何らかしらエラーが発生した場合に使う画像
ファイル nodata01.gif カウンター出力の際、対象が未登録の場合に使う画像
ディレクトリー htmlImage 出力ページを表示する際に使用するイメージなどのフォルダ
ディレクトリー design 出力ページのCSSファイルのフォルダ
ファイル main.css 出力ページで使用するCSSファイル
ファイル bar03.gif グラフのバー画像
ファイル kkh07_200_40_lnk.gif 木眞井啓明サイトのバナー
ファイル up_a05.gif 初期値では、12時間以内のアクセスで使用する画像
ファイル up_a06.gif 初期値では、24時間以内のアクセスで使用する画像
ファイル up_a07.gif 初期値では、6時間以内のアクセスで使用する画像
 ※上記ファイルの再配布・利用は、原則禁止させていただきます。
   再配布・利用の場合は、お問い合わせをお願いします。
cgi-lib.pl 右記サイトから、DLさせていただきました。http://cgi-lib.berkeley.edu/ Ver.2.18
jcode.pl Kazumasa Utashiro氏のパッケージ。Ver2.13
gifcat.pl 杜甫々氏のパッケージ。http://www.tohoho-web.com/www.htm Ver.1.61
 ※上記の各作成者様のファイルを含んでおります。
   再配布は、各作成者様のサイトで御確認の上お願いします。
   rank_stdフォルダ直下に配置しています。


2.1 機能
 以下のモード、または機能があります。
     
  • カウントアップと表示(以下、アクセスモード)
  •  
  • カウンタ表示(以下、表示モード)
  •  
  • ランキング表示(以下、ランキングモード)
  •  
  • コンテンツ管理(以下、管理モード)
  •  
  • コンテンツ更新(以下、更新モード)
  •  
  • ローカル実行時のカウンタ表示
  •  
  • ランキングページのカスタマイズ
 それでは、各モード、または機能について説明します。
2.1.1 アクセスモード
 CGIをアクセスモードで呼び出した場合の機能。
 管理モードからではない登録方法でもあります。
 ランキング対象コンテンツのカウントアップを行い、その数値を画像に置き換えて出力する機能です。
 アクセスモードで呼び出される度、対象のコンテンツをカウントアップします。
 尚、カウンタが非表示の場合は、ブランク画像(透過gif)を出力します。

 ランキング対象にしたいコンテンツページ(htmlファイル)に以下の記述を追加します。

記述方法)
<img src="http://localhost/cgi/rank_std/rank_std.cgi?mode=access&id=z0001&name=ランキング対象の名称">
   ※「localhost/cgi」は、管理人様が利用しているCGIのURLです。
     「id=z0001」は、管理のしやすい英数字がお勧めです。
     「name=ランキング対象の名称」は、コンテンツの名称です。

 この記述を追加するだけで、コンテンツページが表示されれば自動的にデータが作成されます。
 尚、URLは実行時に取得して格納します。
 非表示をご希望の場合は、データが作成された後に管理モードから変更するか、事前に管理モードから登録してください。
2.1.2 表示モード
 CGIを表示モードで呼び出した場合の機能。
 ランキング対象のコンテンツのカウンタを、画像に置き換えて出力する機能です。
 カウントアップはしません。
 何度表示モードで呼び出されても、カウントアップは行いません。

 尚、カウンタが非表示の場合でも呼び出しは可能ですが、ブランク画像を出力します。
 あまり意味はないです。

記述方法)
<img src="http://localhost/cgi/rank_std/rank_std.cgi?mode=view&id=z0001">
   ※「localhost/cgi」は、管理人様が利用しているCGIのURLです。
2.1.3 ランキングモード
 CGIをランキングモードで呼び出した場合の機能。

 ページの構成は、以下のようになっています(htmlform.datは未編集)。
 ランキングの表示イメージ
 ※ランキングでは、カウンタで降順ソートをしています。

 対象コンテンツをカウンタの多い順番(降順)に、名称、カウンタ、棒グラフを表形式で表示します。
 また、最終アクセス日時を使用して、概ねいつ頃にアクセスされたか画像を使って明示します。
 デフォルトは、6時間以内、12時間以内、24時間以内としています。

 尚、棒グラフは、最大表示幅がありますので、それを超えた場合は折り返して2段以上で表示されます。

記述方法)
<a href="http://localhost/cgi/rank_std/rank_std.cgi?mode=rank">
   ※「localhost/cgi」は、管理人様が利用しているCGIのURLです。
2.1.4 管理モード
 CGIを管理モードで呼び出した場合の機能。
 コンテンツページからの登録ではなく、手動で登録する方法であり、登録済みのデータを編集します。
 管理モードでは、詳細なモードを加えてコンテンツデータの管理をしておりますが、全てformタグのボタンにて行われます。

 ページの構成は、以下のようになっています。
 管理モードサンプル
 ※管理モードでは、IDで昇順ソートをしています。

 デフォルトの編集フォームは、コンテンツの追加をします。
 管理リストは、管理しているコンテンツの全管理データを表示しています。
 これが管理モードの基本画面となります。
 尚、ランキングで右上に表示していた「管理:」は、不要ですので表示させていません。

 以下は、管理リストの項目説明です。

項目 説明
ID コンテンツを管理するためのID
カウンタ コンテンツが表示された延べ回数
表示有無 コンテンツページにカウンタ値を表示するか指定
コンテンツ名/URL ランキングで表示するコンテンツ名とジャンプ先のURL
編集 既存データを編集する際に使用します。
ボタンをクリックすると、データの更新モードに移行します。
最終アクセス日時 最後にアクセスされた日時を表示
削除 既存のデータを削除します。
復活は出来ません。
 基本は、ランキングページからの遷移としておりますが、以下の内容でURLのショートカットを作成すれば実行可能です。

記述方法)
http://localhost/cgi/rank_std/rank_std.cgi?mode=direct&pwd=9999
   ※「localhost/cgi」は、管理人様が利用しているCGIのURLです。

 基本のモード移行方法は、ランキングの「管理:」にパスワードを入力して Enter キーを押下して下さい。
 「図:管理モード」のページが表示されます。

図:ランキング)
 ランキング画像

図:管理モード)
 管理モード画像
2.1.5 更新モード
 ページの構成は、以下のようになっています。
 更新モードサンプル

 管理リストのレイアウトは同じですが、編集ボタンと削除ボタンを出力していません。
 理由は、編集中だと言うことを示すためで、取りやめる場合は、編集フォームの取消ボタンをクリックして下さい。
 元の管理モードに戻ります。
 編集フォームには、更新対象データが表示されます。
 追加なのか、更新なのか分かるレイアウトにしてあります。
2.1.6 ローカル実行時のカウンタ表示
 CGIをアクセスモードで呼び出した場合で、Web上の実行ではない場合に、強制的に表示モードにする機能。
 サイトの編集中にカウントアップしてしまうのも変であるという観点から、表示モードにしました。
2.1.7 ランキングページのカスタマイズ
 当ランキングでは、ランキングページをカスタマイズ可能としています。
 htmlを記述できる方であれば、仕組みを理解した上でいかようにもカスタマイズしていただけます。
2.2 編集フォーム
 編集フォームでは、以下のことを行います。

 図2.2-1)管理コンテンツの追加。
 編集フォームの追加


 図2.2-2)管理コンテンツの編集(各データの変更・修正)。
 編集フォームの更新

 各項目、ボタンの説明です。
項目 入力 制限 初期値 説明
ID 英数字を推奨 なし なし 日本語ですと、管理リストでのIDによる並び替えで、読みでソートされないようですので、お勧めしません。
IDについても変更が可能ですので、管理方法を変えたい場合に有効です。
しかし、稼働中にIDを変更することになりますので、タイミングによってはカウントアップされない場合もありますので変更には注意が必要です。
カウンタ 数値 なし なし 初期値は"0"を入力してください。
表示有無 コンボボックスによる選択 - 表示 非表示にしたい場合は変更してください。
尚、非表示にしてもブランクの画像が出力されますので、桁数分のスペースは必要です。
コンテンツ名/URL 英数字、日本語など なし なし 上段に名称、下段にURLを入力してください。
追加ボタン - - - デフォルトで表示されているボタン。
入力したデータを登録するためのボタンです。
更新ボタン - - - 既存データを編集する際に表示されるボタンです。
各欄に表示されている内容で更新します。
尚、更新有無のチェックは行っておりませんので、クリックすると各欄の内容で更新されます。
最終アクセス日時 - - - 既存データを編集する際に表示されます。
編集の必要がないため表示されるだけです(不要ではありますが、あえて表示はさせています)。
取消ボタン - - - 既存データを編集する際に表示されるボタンです。
編集を取り消します。
管理モードの初期状態に戻ります。

 尚、登録の確認は設けておりませんので、間違えた場合は編集を行ってください。

 コンテンツページからの登録の方が簡単ですが、カウンターの表示/非表示の設定は、ここからのみとしておりますので、最初から非表示にする場合には、こちらで登録しておくと良いでしょう。
2.3 データ登録
 以下の2通りがあります。
      
  • コンテンツページから行う
  •   
  • 管理モードから行う
 上記2点について説明します。
2.3.1 コンテンツページから登録
 アクセスモードがこれに当たります。
 記述説明はそちらを参照下さい。
 コンテンツページに記述さえしてあれば、自動的にデータが作成されます。
 但し、カウンタ非表示には出来ませんので管理モードからお願いします。
2.3.2 管理モードから登録
 管理モードの編集フォームから行うのがこれに当たります。
 更新モードで、別のIDを入力しますと、元のデータが変更されますのでご注意下さい。

 上部にある編集フォームに、対象コンテンツの情報を入力します。
 編集フォーム画像(サンプル入力済み)

 追加ボタンをクリックします。
 管理リストに追加されます。
 追加後の管理リスト画像
   ※少々小さいですが、上図と比較すると一件多く表示されています。

 以上で、登録ができます。


3.1 解凍
 zipファイルを解凍して下さい。
 「1. 梱包内容」の通りに展開されます。
3.2 rank_std.cgiの変更
 実行する上で、変更が必要な箇所の説明をします。
 また、変更が必要な箇所は、
#-----------------------------------------
# 変更可能な値
 と記述してありますので、それ以外は、書き換えないようにお願いします。
項目 説明
管理人名  「管理人名」をご利用の方の名前に変えて下さい。
 ランキングを表示する際、下部に表示されます。
管理人のパスワード  「9999」を英数字でお好きなものに変えて下さい。
 管理モードを表示する際に使用します。
管理人のホームページURL  「http://perl-dev/」を管理人様ホームページのURLに変えて下さい。
管理人のメール  「aaa@bbb.com」をメールアドレスに変えて下さい。
 あるいは、CGIを使ったメールフォームのURLに「mailto:aaa@bbb.com」を変えて下さい。
管理人のイメージURL  「http://perl-dev/image」を管理人様ホームページで使用しているイメージのURLに変えて下さい。
ランキング用タイトル  「コンテンツ別アクセスランキング」をお好きな名称に変えて下さい。
 変更されない場合は、このまま表示されます。
当CGIのURL  「http://perl-dev/CGI/rank_std/」を管理人様ホームページで使用しているCGIのURLに変えて下さい。
 また、当ランキングのフォルダも変更される場合は、「rank_std/」も変えて下さい。
当CGIのhtml用イメージURL  「http://perl-dev/image/htmlImage」を管理人様ホームページで使用しているイメージのURLに変えて下さい。
 また、当ランキングで使用するフォルダ「htmlImage」も変更される場合は、こちらも変えて下さい。
カウンターの桁数  初期値で4桁としてあります。
 桁数に満たない場合は、先頭に0を追加しますので、お好きな桁数に変えて下さい。
グラフの表示可能幅  表示する際のグラフ最大値になります。
 初期値は300としてありますが、お好きな数値に変更して下さい。
 尚、単位はピクセルです。
 また、グラフは最大値を超えると折り返しますので、あまり大きくしなくても正しく表示されます。
最終アクセス  最終アクセスが、いつ頃だったのかを明示的に表します。単位は時間です
 初期値では、6時間以内、12時間以内、24時間以内としておりますので、お好きな時間幅に変更して下さい。
 近い順に、以下のイメージを使用します。

6時間以内 up_a07.gif
12時間以内 up_a05.gif
24時間以内 up_a06.gif
3.3 htmlform.datの変更
 ランキングページを表示する際のフォーマットになっております。
 いくつか約束事がありますが、それさえ守っていただければ、いかようにも変更していただいてかまわないファイルです。
 ファイル自体にも注意書きがありますが、こちらでも説明します。
 尚、フッターについては、CGI実行時に追加されます。
項目 説明
コメント  先頭のコメント以外は、ページを作る際の分類としておりますので、邪魔だと言って削除なさらないようにお願いします。
キーワード  ランキング出力時に、数値や文字に置き換えるために用意した文言です。
 全てが大文字英字となっておりますので、このキーワードを使用すれば、どのようなフォーマットでも値は同じになります。
 ですので、使用しないと対象の値が出力されません。
 また、分かりやすくするため、キーワード以外の記述は全て小文字にしてあります。

 有効なキーワードは、ファイルをご覧下さい。
ヘッダー部  ランキングだけではなく、管理モードでも使用する部分です。
 [ホーム][ランキング]の部分は、戻りと再表示のために用意したもので、記述しなくても問題はありませんが、少なくともホームへ戻るためのリンクは用意すべきかと思います。

 次に、管理表示開始?管理表示終了部分についてです。
 こちらも、必須事項ではありませんが、記述しない場合は、管理人様のPCにURLを持っておく必要があります。
ランキング部  ランキングに使用する部分で、表形式にしてあります。
 カウンタの表示有無にかかわらず、全てのコンテンツがランキング表示されます。
 項目を減らすと、表示されなくなるだけですので変更されても問題ありません。
フォーマット確認  Windwosサーバー上を想定しておりませんので、拡張子は「*.dat」にしてあります。
 ここを「*.html」に書き換えれば、変更した内容の確認もそのままできるような記述にしてあります。
 変更の際には、この方法にてお願いします。
 また、アップロードする際、「*.dat」への再変更をお忘れなく。
3.4 アップロード
 rank_stdフォルダ配下のcgiImageフォルダまでを、CGIで使用している場所にアップロードしてください。
 また、htmlImageフォルダ配下については、html(サイト)で使用している場所にアップロードしてください。
 その際ご利用の転送ツールで、以下のパーミッション設定を行ってください。
ファイル分類 パーミッション値 転送方式
*.cgi 755 アスキー
*.pl 644 アスキー
*.dat なくても可(666) バイナリー
*.gif 644 バイナリー
*.css 644 バイナリー


4.1 カウントアップのタイミング
 コンテンツページが表示される度になります。
 制限は設けておりません。
 ですので、同一閲覧者でも、再度ページ表示した場合にはカウントアップします。
4.2 ページ出力のキーワード
 キーワードは、ファイルに記述した物だけとしており、固定となっております。
 管理人様独自のキーワードを作成することは出来ません。
4.3 SSI呼び出し
 SSIには対応しておりません。
 ですので、ランキングを管理人様サイトの好きな場所に追加することは出来ません。
4.4 データの削除
 管理モードからデータを削除しましても、コンテンツページに記述が残っておりますと、ページが表示された際に再作成されます。
 当CGIとしては正常な機能です。
4.5 フレームを使用したアクセスモード
 フレームを使用している場合、アクセスモードで取得するURLは、当然のことながらフレームのURLではなくCGIを呼び出したページ(htmlファイル)となります。
 この場合は、以下のいずれかで対応をお願いします。
      
  • データが登録されてから管理モードで変更する。
  •   
  • 事前に管理モードでデータを作成する。


 ご質問には、出来る限りお答えしたいと思いますが、少々お時間を頂くこともありますことご理解下さい。
 尚、管理人様が被った弊害につきましては、お答えしかねますのでご了承下さい。
 下記バナーをクリックして掲示板、もしくはメールにてお願いします。

 ご要望、不具合などありましたら、ご連絡をお願いします。
 下記目次の「2.ランキングCGI説明」〜「4.注意事項」まで、クリックすると展開します。
 これ以外は、直接リンクになっております。
まえがき
1.梱包内容
2.ランキングCGI説明
3.利用手順
4.注意事項
5.サポート


バージョン 位置づけ
1.1.1.0 FREE
更新日付 著作権
2014/03/08 木眞井啓明
その他
 フリーで提供させていただきます代わりに、当CGIを利用したいかなる弊害も作者は責任を負いません。
 尚、当方でも十分な確認を行っておりますが、不具合などありましたらご連絡をお願いします。


ページトップ