[MyTools.NET / CGI / TcounT Lite 2]

◆ TcounT Lite Ver.2.01 説明書

(c) Takahiro Nishida 1999/8/1

■ about...

■ index

■ 機能

　TcounTから昨日、今日のアクセス数表示機能と管理機能を取り除いた簡易版です。設置のしやすさを追求しました。下の特徴があります。 (★は Ver.2 からの新機能。)

[index]

■ 謝辞

　TcounT Ver.4.XX 以降で使用している、GIF画像をつなげるためのライブラリ gifcat.pl は、とほほ氏 (s-hasei@mtg.biglobe.ne.jp) によるものです。素晴らしいライブラリを無償で公開して下さっている氏に感謝致します。詳細は下記リンクをご覧下さい。

(→とほほのWWW入門へ)

[index]

■ ソース

(ダウンロード後、ファイル名が"-cgi.txt"、"-pl.txt"となってるものを".cgi"、".pl"に変更してください)

【 全ファイルをまとめてダウンロード 〜 countlite200.lzh】

[index]

インストール方法

■ インストール

  1. プログラム一覧からtclite.cgi、gifcat.plの二つのファイルをダウンロードする。
    ※ ダウンロード方法はソースをダウンロードするを参照。

  2. .cgi ファイルの最上部のPerlのパスを正しく設定する。
    ※ 詳しくはPerlのパスを設定するを参照。

  3. tclite.cgiの以下の変数を編集してください。

    ※注 データファイルを .cgiと同じ場所に置く場合は $basedir="."; として下さい。

  4. tclite.cgi、gifcat.plファイルをＦＴＰのアスキーモードで転送する。パーミッションを705、604に設定する。
    ※ FTPについてはプログラムをFTPで送るを参照。
    ※ パーミッションについてはパーミッションを設定するを参照

    (telnetの場合)
    % chmod 705 tclite.cgi
    % chmod 604 gifcat.pl

  5. 上と同じディレクトリに、ディレクトリdata、img、lockdirを作る。パーミッションは全て707に設定する。

    (telnetの場合)
    % mkdir data
    % mkdir img
    % mkdir lockdir
    % chmod 707 data
    % chmod 707 img
    % chmod 707 lockdir

  6. ディレクトリimg中に、数字の画像ファイルをFTPでバイナリ転送する。数字のファイル名は、0.gif, 1.gif, 〜, 9.gifとする。パーミッションを 604 にする。

    (telnetの場合)
    % cd img
    % chmod 604 *.gif

    　数字画像はhttp://www.digitmania.holowww.com/に山ほどあります。気に入ったのがなければ自分で作成してもよいでしょう。

    ※ GIFのタイプによっては正常に表示されない場合があります。詳しくは画像が崩れる原因を参照。自分で作成する場合こちらの注意を良く読んでください。

  7. ブラウザからtclite.cgiにアクセスしてみる。
    　→ 「パラメータが不正です」と表示されればＯＫ。
    　　　※ 上のように表示されない場合、ブラウザでアクセスするを参照して問題を解決してください。

以上でインストール完了です。

[index]

■ カウンターをつける

  1. 新しいカウンターの名前を決める。(ここでは例としてファイル名をcountとする。)

    ※カウンターの名前には半角英語と半角数字の組み合わせ(top, link等)を使ってください。ハイフン(-)などの記号は使えません。

  2. ディレクトリ data/ の下に count.txt という名前の空ファイルをFTPで送る。パーミッションを606にする。
    ※ 空ファイルの作り方は、    空ファイルの作り方を参照。

    % chmod 606 data/count.txt

  3. ブラウザからtclite.cgi?countにアクセスしてみる。"00000" という画像が表示されたらＯＫ。

  4. ページの中のカウンターを置きたい場所に次のように書く。

    あなたは
    <img src="(tclite.cgiのURL)?count&1" width="80" height="21">
    人目の訪問者です。

    ※ URLは相対パス(../tclite.cgi等)でも絶対パス(http://〜/tclite.cgi)でも構いません。
    ※ widthには (gifファイルの横幅)×5、height は gifファイルの縦幅を書いて下さい。表示桁数を変える方法は後述。

  5. ページを実際にサーバーにFTPしてみて、表示されるかどうか確かめる。リロードしたら数字が増えるかも確認する。

[index]

■ カウンターを追加する

  1. 新しいカウンターの名前を、前のものとは重複しないように決める。(先ほどが count だったので、ここでは count2 とする。)

  2. あとは上のカウンターをつけると同様。count(.txt) だった部分を count2(.txt)に置き換えて下さい。

    タグは以下のようになります。
    <img src="(tclite.cgiのURL)?count2&1" width="80" height="21">

[index]

■ ディレクトリ構成

ここまで作業した結果の全体のディレクトリ構造は次のようになります。($basedir="."; の場合)
※ カッコ内の数字はパーミッション。<〜>はディレクトリ。 
+ tclite.cgi (705)
+ gifcat.pl (604)
+ <lockdir> (707)
+ <data> (707)
     + count.txt (606)
     + count2.txt (606)
+ <img> (707)
     + 0.gif (604)
     + 1.gif (604)
     + ...
     + 9.gif (604)

[index]

使い方

■ パラメータの意味

　TcounTは、tclite.cgiのURLの後ろにパラメータを付けて、カウンタの動きを操作します。パラメータの指定の仕方は次の通り。

<img src="tclite.cgi?(1)&(2)&(3)&(4)">

途中のパラメータを跳ばしたい場合は、"tclite.cgi?test&&&img2" という具合に、 & を続けて書いて下さい。

[index]

● 表示桁数を変える
　表示桁数を指定するには、パラメータの三番目にその桁数を書いて下さい。

(例) ３桁にしたい場合
<img src="(tclite.cgiのURL)?count&1&3" width="48" height="21">

※ 何も指定しなかった場合は５桁になります。
※ 桁数を変更したら、それに合わせて width を変えるのを忘れないように。
※ 表示しきれない場合、表示しきれるとこまで桁数が増えます。(例えば、パラメータの三番目が3 になっているのに、カウント数が 2234 な場合は、４桁で表示されます。)

[index]

● 数字画像を変える
　数字画像は好きなGIFファイルを使用することができます。手順は以下の通り。

  1. とりあえず使いたいGIF画像を用意する。名前は 0.gif, 1.gif, ... , 9.gifとしておく。

  2. ディレクトリ img があるのと同じ場所に適当な名前のディレクトリをつくる。(例えば img2 等) パーミッションを 707 にする。

    % mkdir img2
    % chmod 707 img2

  3. 新しく作ったディレクトリ (ここではimg2)の下に、0.gif, 1.gif, ... , 9.gifをFTPでバイナリ転送する。パーミッションを 606 にする。

    % cd img2
    % chmod 606 *.gif

  4. パラメータの四番目に、そのディレクトリ名を指定する。

    (例) ディレクトリ img2/ の画像を使いたい場合 (6桁表示)
    <img src="(tclite.cgiのURL)?count&1&6&img2" width="96" height="21">

※ 何も指定しなかった場合は、img の下にある画像ファイルが使用されます。

[index]

■ パラメータ指定例と実際の表示

※ 以下では プログラム（tclite.cgi） の位置を /cgi-bin/count/tcount.cgi と仮定します。別サーバーにある場合は http:// から始まる絶対パスで指定して下さい。
● 例１ (カウンター名：test1)

【HTML】
<IMG SRC="/cgi-bin/cntlite/tclite.cgi?test1&1" WIDTH="80" HEIGHT="21">

　普通の設置方法です。パラメータを何も指定しない場合は、５桁表示、画像は gif/img/ のものを使用します。
※ 画像ファイルのサイズをWIDTH、HEIGHTで指定しておかないと、数字画像が読み込まれるまでそれより下のHTMLが表示されないので、必ず指定するようにしましょう。

● 例２ (カウンター名：test2、８桁表示)

【HTML】
<IMG SRC="/cgi-bin/cntlite/tclite.cgi?test2&1&8" WIDTH="128" HEIGHT="21">

　８桁の場合は、パラメータの三番目を 8 にする。桁数に合わせて WIDTH を変更するのを忘れずに。

● 例３ (カウンター名：test3、４桁表示、ball/ の画像を使用)

【HTML】
<IMG SRC="/cgi-bin/cntlite/tclite.cgi?test3&1&5&ball" WIDTH="120" HEIGHT="24">

　画像を変えるには、パラメータの四番目に画像ファイルの入っているディレクトリ名を指定する。

[index]

■ カウンターを修正する

　例えば、カウンター名 fix を 567 に修正したい場合、
  1. fix.txt というファイルにカウント数を入れる。この場合は「567」と書く。
    ※ ファイルの末尾に改行を入れないで下さい。

  2. fix.txt を data/にFTPでアスキー転送する。

  3. <(tclite.cgiのURL)?fix>にアクセスしてみて、修正後の数値が表示されるかどうか確かめる。

これでカウントが 567 から始まります。

[index]

■ カウンターを削除する

data/ の <カウンター名>.txt を消去して下さい。

[index]

Note...

■ 画像が崩れる原因

　TcounTは各自で作成したGIF画像も使用できますが、ファイルによって表示が崩れることがあるようです。GIF連結部分は汎用ライブラリを使用しています。私がその内容を理解していないため対応することができません。統計的には以下のような画像は上手く行かない場合が多いようです。

　自分で作成する際は、上記のような画像は作らないようにしてください。（http://www.digitmania.holowww.com/の画像はほとんどが正常に表示されます。自作なさりたい方はパレットの使い方などを参考にしてください。）

※ しかし、上の原因がどれも当てはまらなくても表示が崩れる場合もあります。使ってみて崩れたら、諦めて別の画像にした方が早いです。

[index]

バージョンアップ

■ バージョン履歴

[index]

[MyTools.NET / CGI / TcounT Lite 2]