この度は、当アクセスランキングをご利用いただきありがとうございます。
この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時間以内のアクセスで使用する画像 |
|
|
※上記ファイルの再配布・利用は、原則禁止させていただきます。
再配布・利用の場合は、お問い合わせをお願いします。
|
|
| 右記サイトから、DLさせていただきました。http://cgi-lib.berkeley.edu/ Ver.2.18 |
| Kazumasa Utashiro氏のパッケージ。Ver2.13 |
| 杜甫々氏のパッケージ。http://www.tohoho-web.com/www.htm Ver.1.61 |
※上記の各作成者様のファイルを含んでおります。
再配布は、各作成者様のサイトで御確認の上お願いします。
rank_stdフォルダ直下に配置しています。
|
|
| ■ |
２．１ 機能 |
以下のモード、または機能があります。
- カウントアップと表示(以下、アクセスモード）
- カウンタ表示（以下、表示モード）
- ランキング表示（以下、ランキングモード）
- コンテンツ管理（以下、管理モード）
- コンテンツ更新（以下、更新モード）
- ローカル実行時のカウンタ表示
- ランキングページのカスタマイズ
それでは、各モード、または機能について説明します。
|
|
| ■ |
２．１．１ アクセスモード |
CGIをアクセスモードで呼び出した場合の機能。
管理モードからではない登録方法でもあります。
ランキング対象コンテンツのカウントアップを行い、その数値を画像に置き換えて出力する機能です。
アクセスモードで呼び出される度、対象のコンテンツをカウントアップします。
尚、カウンタが非表示の場合は、ブランク画像(透過gif)を出力します。
ランキング対象にしたいコンテンツページ（htmlファイル）に以下の記述を追加します。
記述方法）
<img src="http://localhost/cgi/rank_std/rank_std.cgi?mode=access&id=z0001&name=ランキング対象の名称">
「id=z0001」は、管理のしやすい英数字がお勧めです。
「name=ランキング対象の名称」は、コンテンツの名称です。
この記述を追加するだけで、コンテンツページが表示されれば自動的にデータが作成されます。
尚、URLは実行時に取得して格納します。
非表示をご希望の場合は、データが作成された後に管理モードから変更するか、事前に管理モードから登録してください。
|
|
| ■ |
２．１．２ 表示モード |
CGIを表示モードで呼び出した場合の機能。
ランキング対象のコンテンツのカウンタを、画像に置き換えて出力する機能です。
カウントアップはしません。
何度表示モードで呼び出されても、カウントアップは行いません。
尚、カウンタが非表示の場合でも呼び出しは可能ですが、ブランク画像を出力します。
あまり意味はないです。
記述方法）
<img src="http://localhost/cgi/rank_std/rank_std.cgi?mode=view&id=z0001">
|
|
| ■ |
２．１．３ ランキングモード |
CGIをランキングモードで呼び出した場合の機能。
ページの構成は、以下のようになっています（htmlform.datは未編集）。
※ランキングでは、カウンタで降順ソートをしています。
対象コンテンツをカウンタの多い順番（降順）に、名称、カウンタ、棒グラフを表形式で表示します。
また、最終アクセス日時を使用して、概ねいつ頃にアクセスされたか画像を使って明示します。
デフォルトは、6時間以内、12時間以内、24時間以内としています。
尚、棒グラフは、最大表示幅がありますので、それを超えた場合は折り返して２段以上で表示されます。
記述方法）
<a href="http://localhost/cgi/rank_std/rank_std.cgi?mode=rank">
|
|
| ■ |
２．１．４ 管理モード |
CGIを管理モードで呼び出した場合の機能。
コンテンツページからの登録ではなく、手動で登録する方法であり、登録済みのデータを編集します。
管理モードでは、詳細なモードを加えてコンテンツデータの管理をしておりますが、全てformタグのボタンにて行われます。
ページの構成は、以下のようになっています。
※管理モードでは、IDで昇順ソートをしています。
デフォルトの編集フォームは、コンテンツの追加をします。
管理リストは、管理しているコンテンツの全管理データを表示しています。
これが管理モードの基本画面となります。
尚、ランキングで右上に表示していた「管理：」は、不要ですので表示させていません。
|
以下は、管理リストの項目説明です。
| 説明 |
| コンテンツを管理するためのID |
| コンテンツが表示された延べ回数 |
| コンテンツページにカウンタ値を表示するか指定 |
| ランキングで表示するコンテンツ名とジャンプ先のURL |
既存データを編集する際に使用します。
ボタンをクリックすると、データの更新モードに移行します。 |
| 最後にアクセスされた日時を表示 |
既存のデータを削除します。
復活は出来ません。 |
|
基本は、ランキングページからの遷移としておりますが、以下の内容でURLのショートカットを作成すれば実行可能です。
記述方法）
http://localhost/cgi/rank_std/rank_std.cgi?mode=direct&pwd=9999
※「localhost/cgi」は、管理人様が利用しているCGIのURLです。
基本のモード移行方法は、ランキングの「管理：」にパスワードを入力して Enter キーを押下して下さい。
「図：管理モード」のページが表示されます。
図：ランキング）
図：管理モード）
|
|
| ■ |
２．１．５ 更新モード |
ページの構成は、以下のようになっています。
管理リストのレイアウトは同じですが、編集ボタンと削除ボタンを出力していません。
理由は、編集中だと言うことを示すためで、取りやめる場合は、編集フォームの取消ボタンをクリックして下さい。
元の管理モードに戻ります。
編集フォームには、更新対象データが表示されます。
追加なのか、更新なのか分かるレイアウトにしてあります。
|
|
| ■ |
２．１．６ ローカル実行時のカウンタ表示 |
CGIをアクセスモードで呼び出した場合で、Web上の実行ではない場合に、強制的に表示モードにする機能。
サイトの編集中にカウントアップしてしまうのも変であるという観点から、表示モードにしました。
|
|
| ■ |
２．１．７ ランキングページのカスタマイズ |
当ランキングでは、ランキングページをカスタマイズ可能としています。
htmlを記述できる方であれば、仕組みを理解した上でいかようにもカスタマイズしていただけます。
|
|
| ■ |
２．２ 編集フォーム |
編集フォームでは、以下のことを行います。
図2.2-1）管理コンテンツの追加。
図2.2-2）管理コンテンツの編集（各データの変更・修正）。
各項目、ボタンの説明です。
|
| 項目 |
入力 |
制限 |
初期値 |
説明 |
| ID |
英数字を推奨 |
なし |
なし |
日本語ですと、管理リストでのIDによる並び替えで、読みでソートされないようですので、お勧めしません。
IDについても変更が可能ですので、管理方法を変えたい場合に有効です。
しかし、稼働中にIDを変更することになりますので、タイミングによってはカウントアップされない場合もありますので変更には注意が必要です。
|
| カウンタ |
数値 |
なし |
なし |
初期値は"0"を入力してください。 |
| 表示有無 |
コンボボックスによる選択 |
- |
表示 |
非表示にしたい場合は変更してください。
尚、非表示にしてもブランクの画像が出力されますので、桁数分のスペースは必要です。 |
| コンテンツ名／URL |
英数字、日本語など |
なし |
なし |
上段に名称、下段にURLを入力してください。 |
| 追加ボタン |
- |
- |
- |
デフォルトで表示されているボタン。
入力したデータを登録するためのボタンです。 |
| 更新ボタン |
- |
- |
- |
既存データを編集する際に表示されるボタンです。
各欄に表示されている内容で更新します。
尚、更新有無のチェックは行っておりませんので、クリックすると各欄の内容で更新されます。 |
| 最終アクセス日時 |
- |
- |
- |
既存データを編集する際に表示されます。
編集の必要がないため表示されるだけです（不要ではありますが、あえて表示はさせています）。 |
| 取消ボタン |
- |
- |
- |
既存データを編集する際に表示されるボタンです。
編集を取り消します。
管理モードの初期状態に戻ります。 |
尚、登録の確認は設けておりませんので、間違えた場合は編集を行ってください。
コンテンツページからの登録の方が簡単ですが、カウンターの表示／非表示の設定は、ここからのみとしておりますので、最初から非表示にする場合には、こちらで登録しておくと良いでしょう。
|
|
| ■ |
２．３ データ登録 |
以下の2通りがあります。
上記2点について説明します。
|
|
| ■ |
２．３．１ コンテンツページから登録 |
アクセスモードがこれに当たります。
記述説明はそちらを参照下さい。
コンテンツページに記述さえしてあれば、自動的にデータが作成されます。
但し、カウンタ非表示には出来ませんので管理モードからお願いします。
|
|
| ■ |
２．３．２ 管理モードから登録 |
管理モードの編集フォームから行うのがこれに当たります。
更新モードで、別のIDを入力しますと、元のデータが変更されますのでご注意下さい。
上部にある編集フォームに、対象コンテンツの情報を入力します。
追加ボタンをクリックします。
管理リストに追加されます。
※少々小さいですが、上図と比較すると一件多く表示されています。
以上で、登録ができます。
|
|
|
| ■ |
４．１ カウントアップのタイミング |
コンテンツページが表示される度になります。
制限は設けておりません。
ですので、同一閲覧者でも、再度ページ表示した場合にはカウントアップします。
|
|
| ■ |
４．２ ページ出力のキーワード |
キーワードは、ファイルに記述した物だけとしており、固定となっております。
管理人様独自のキーワードを作成することは出来ません。
|
|
| ■ |
４．３ SSI呼び出し |
SSIには対応しておりません。
ですので、ランキングを管理人様サイトの好きな場所に追加することは出来ません。
|
|
| ■ |
４．４ データの削除 |
管理モードからデータを削除しましても、コンテンツページに記述が残っておりますと、ページが表示された際に再作成されます。
当CGIとしては正常な機能です。
|
|
| ■ |
４．５ フレームを使用したアクセスモード |
フレームを使用している場合、アクセスモードで取得するURLは、当然のことながらフレームのURLではなくCGIを呼び出したページ（htmlファイル）となります。
この場合は、以下のいずれかで対応をお願いします。
- データが登録されてから管理モードで変更する。
- 事前に管理モードでデータを作成する。
|
|
ご質問には、出来る限りお答えしたいと思いますが、少々お時間を頂くこともありますことご理解下さい。
尚、管理人様が被った弊害につきましては、お答えしかねますのでご了承下さい。
下記バナーをクリックして掲示板、もしくはメールにてお願いします。
ご要望、不具合などありましたら、ご連絡をお願いします。
|
