MyTools.NET - リンク集管理CGI T-Bookmark 1 説明書

インストール方法

インストール

ソースから全てのファイルをダウンロードする。
※ ダウンロード方法はソースをダウンロードするを参照。
３つの ～.cgi の最上部のPerlのパスを正しく設定する。
※ 詳しくはPerlのパスを設定するを参照。
tblib.plの上部にある「変数設定部」の以下の変数を編集する。
- $basedir ..... データファイルを格納するディレクトリのパス（※注１）
- $method ..... フォーム内容の送信方法（※注２）
- $admin_email ..... 管理者メールアドレス（※注３）
- $code ..... 日本語文字コード（※注４）
※注１データファイルをプログラムと同じ場所に置く場合は $basedir=".";のままで。
※注２ "post" が使えないところでは "get" に変えてください
※注３ @ の前に必ず \ をつけて下さい。(例, t-nishida\@mvh.biglobe.ne.jp)
※注４ sjis以外に変更する場合は、全てのファイルを秀丸などでそのコードに変換すること。
tbadmin.cgiの上部にある「変数設定部」の以下の変数を編集する。
- $password ..... 管理用パスワード
～.cgi、～.pl、～.gifをＦＴＰのアスキーモードで転送する。パーミッションは、.cgi を 705、.plと.gif を 604にする。
※ FTPについてはプログラムをFTPで送るを参照。
※ パーミッションについてはパーミッションを設定するを参照。
(telnetの場合)
% chmod 705 tbookmark.cgi
% chmod 705 tbregist.cgi
% chmod 705 tbadmin.cgi
% chmod 604 tblib.pl
% chmod 604 jcode.pl
% chmod 604 new.gif
% chmod 604 up.gif
$basedirで指定したディレクトリ（$basedir=".";の場合は～.cgi と同じディレクトリ。以下同様。）に、～.html、ファイルをＦＴＰのアスキーモードで転送する。パーミッションを604に設定する。
(telnetの場合)
% chmod 604 tb_main.html
% chmod 604 tb_regist.html
% chmod 604 tb_admin.html
tbgenre.txt、tbdata.txt、tbnew.txt という３つの空ファイルを作る。それを$basedirで指定したディレクトリにFTPする。パーミッションを 606 に設定する。
※ 空ファイルの作り方は、空ファイルの作り方を参照。
(telnetの場合)
% chmod 606 tbgenre.txt
% chmod 606 tbdata.txt
% chmod 606 tbnew.txt
$basedirで指定したディレクトリにディレクトリ lockdir を作る。パーミッションは707にする。
(telnetの場合)
% mkdir lockdir
% chmod 707 lockdir
各 .cgi にブラウザからアクセスして動作チェック。
　・tbookmark.cgi → 「ヒットしませんでした。条件を変更して再検索してください。」と表示されればＯＫ。
　・tbregist.cgi → 「ページ登録、修正、削除依頼」のフォームが表示されればＯＫ。
　・tbadmin.cgi → 「T-Bookmark 管理ページ」が表示されればＯＫ。
　　　※ 上のように表示されない場合、ブラウザでアクセスするを参照して問題を解決してください。

　分野が一つもない状態だとＵＲＬを登録できません。以下の「分野を作成する」へお進みください。

[目次へ]

分野を作成する

　管理ページ（tbadmin.cgi）にアクセスし、「分野リスト編集」を選んで分野の作成を行います。

※ 管理ページへは、検索ページ（tbookmark.cgi）の右下にある「管理用」のリンクからも移動できます。
※ パスワードはインストールの４で設定した管理用パスワードです。

分野登録の手順は以下の通り：

分野コードを決める。使用できる文字は半角大文字英語２文字です。
例えば、「国語」は「JP」、「算数」は「MT」、理科は「SC」など。分野が想像できるような組み合わせがよいでしょう。
「分野リスト編集」で「新規登録」ボタンを押す。
「新規作成」のフォームに、分野コード、分野名、説明を入力する。
※ 「説明」は、ユーザ登録申請画面で、分野の説明として表示されます。
[例] 分野コード「JP」、分野名「国語」、説明「現代文、古文、詩歌、漢字など」
「作業実行」ボタンを押す。
　→ 画面下部に新しく登録した分野が表示される。
３～４を何度か繰り返して、いくつか分野を作成します。
左上の「検索ページへ戻る」のリンクから検索ページ（tbookmark.cgi）に戻り、右の「分野一覧」の欄に、新しく登録した分野の分野名が表示されているかを確かめる。

※ 「分野リストの編集」の詳しい説明は後述。

　試しにページを登録してみましょう。下の「管理ページからページを登録してみる」へお進み下さい。

[目次へ]

管理ページからページを登録してみる

　管理ページ（tbadmin.cgi）にアクセスし「ブックマーク追加・修正・削除」を選んでページの登録を行います。試しに自分のページを登録してみてください。

フォームの以下の項目を埋める。
登録者名、E-Mail、タイトル、URL、分野（一つ以上）、キーワード（半角スペース区切り）、紹介文
すべて入力しおえたら「作業実行」を押す。
　→ 「作業状況：新しいページ（No.xxxxxxxxxxxxx）を登録しました。」と表示される。
検索ページ（tbookmark.cgi）に戻って、登録したものが表示されているかどうか確認する。

※ 「ブックマークの追加・修正・削除」の詳しい説明は後述。

[目次へ]

ユーザ側から登録依頼を出してみる

　登録依頼ページ（tbregist.cgi）から、ページ登録依頼を出してみます。
※ 登録依頼ページへは、検索ページ（tbookmark.cgi）の右下の「登録・修正・削除依頼」をクリックしても移動できます。

「作業を選択してください」で「新規登録」が選択されていることを確認。
フォームの以下の項目を入力する。
E-Mail、登録者名、タイトル、URL、分野（一つ以上）、キーワード（半角スペース区切り）、紹介文
「申請内容確認画面へ」を押す。
　→ 【登録確認】 のメッセージと、入力内容が出てくる。
「仮登録実行」を押す。
　→ 【登録完了】 のメッセージと、入力内容が出てくる。
ユーザ側の作業はこれで完了です。
管理ページ（tbadmin.cgi）に移動する。
　→ 「登録依頼の処理」のところに、（登録待ち：1件）と表示されている。
「登録依頼の処理」を選び、パスワードを入力して「作業実行」を押す。
　→ 「登録待ち一覧」が表示される。先ほど依頼を出したものがあるのを確認。
「許可」を選んで「チェックOK」を押す。
　→ 「作業状況：1 件を許可、0 件を却下しました。」と表示される。
検索ページ（tbookmark.cgi）に戻って、登録したものが表示されているかどうか確認する。
※ ここで登録したものに「NEW」の画像が表示されない場合「"NEW" "UP" の画像が表示されない原因とその対処方法」をごらん下さい。

　ここまで確認できれば、インストールは完了です。

※ テストで登録したものを削除する方法は、登録済みページを修正／削除するを参照。
※ デザインの変更方法はデザインを変更するを参照。

[目次へ]

"NEW" "UP" の画像が表示されない原因とその対処方法

　お使いのプロバイダによっては、新規登録した項目のところに "NEW" "UP" の画像が表示されない場合があります。その原因は「CGIを置くディレクトリに他のファイルを置くことを許可していない設定になっている」ことです。（www5a.biglobe.ne.jp など。）

　「インストール」では省略のために .cgi と .gif を同じ場所に置くように説明されていますが、上記のような設定になっているプロバイダでは、設置方法を少し変更する必要があります。

　ユーザ側から登録依頼を出してみるのチェックがすべて正常に終わったところまで行ったら、以下のように改造して下さい。

new.gif, up.gif を、通常のHTMLを置く場所（貴方のページのトップページがあるのと同じ場所）にFTPでアップロードする。
ブラウザからURLを打ち込んでその画像を表示させてみて、そのURLをメモしておく。
（例えば、http://www.your.prvider/~hoge/new.gif など。）
tbookmark.cgi の 40,42行目（「"NEW" の画像」「"UP" の画像」の下）を以下のように書き換える。

[改造前]
$image_new = "<IMG SRC=\"./new.gif\" WIDTH=\"35\" HEIGHT=\"11\" BORDER=\"0\">";
$image_up = "<IMG SRC=\"./up.gif\" WIDTH=\"35\" HEIGHT=\"11\" BORDER=\"0\">";

[改造後]
$image_new = "<IMG SRC=\"[new.gifのURL]\" WIDTH=\"35\" HEIGHT=\"11\" BORDER=\"0\">";
$image_up = "<IMG SRC=\"[up.gifのURL]\" WIDTH=\"35\" HEIGHT=\"11\" BORDER=\"0\">";

例えば、「$image_new = "<IMG SRC=\"http://www5a.biglobe.ne.jp/~hoge/new.gif"\" WIDTH=\"35\" HEIGHT=\"11\" BORDER=\"0\">」のように書きます。
tbookmark.cgi を元の場所にFTPでアップロードする。

　これでもう一度ブラウザから tbookmark.cgi を呼び出してみてください。NEW の画像が表示されていれば成功です。

[目次へ]

使い方

ユーザ側：検索する

　ユーザがメインで使う画面は検索ページ（tbookmark.cgi）です。「検索フォーム」に文字を入れて「検索」を押すと、その単語にマッチする項目を検索できます。検索対象となるのは以下の４つです。

タイトル、コメント、キーワード、URL （登録者名、メールアドレスは含まれません。）

※ 英語の大文字小文字は区別されません。

※ あまりOR検索を使う人はいないだろうと思い、このようなAND中心の仕様になっています。

[目次へ]

ユーザ側：検索オプション（キーワード表示、ＩＤ表示）

　通常の検索では、キーワード、登録ＩＤは表示されません。これらを表示させたい場合、検索ページ（tbookmark.cgi）の右下にある「キーワード表示」「ＩＤ表示」をクリックします。一度検索オプションを変えると、以後の検索はずっとそのモードに固定されます。

　検索オプションを元に戻したいときは右下の「通常表示」をクリックするか、検索フォーム右の「通常表示」をクリックします。

[目次へ]

ユーザ側：登録依頼を出す

　ユーザはページの登録依頼を出すことができます。検索ページ（tbookmark.cgi）の右下の「登録・修正・削除依頼」をクリックして、登録依頼ページ（tbregist.cgi）に移動し、以下の項目をフォームに書きこみます。

メールアドレス、登録者名、タイトル、URL、分野、キーワード、紹介文

※ 紹介文にHTMLタグは使えません。
※ キーワードは「１０個まで」と書いてありますが、実際には何個でも入ります。

[目次へ]

ユーザ側：修正、削除依頼を出す

　一度登録した内容の修正をする場合も、「登録・修正・削除依頼」から行います。修正依頼を出すには、以下の二つが必要です。

ＩＤ ..... 登録時に出るＩＤ番号。
（※ 忘れてしまった場合、ＩＤ検索オプションで調べることができます。）
メールアドレス ..... 登録時に入力したメールアドレス。
（※ 忘れてしまった場合、管理者に直接メールで問い合わせるしかありません。）

「作業を選択」で「修正」を選び、上の二つと、修正したい項目を入力します。入力しなかった部分については、以前と同じままになります。

※ 更新日 ..... 「元のまま」→ 前回登録時のまま、「最新にする」→現在の日付になる。
　　「最新にする」を選ぶと「日付順」の先頭に表示されるようになります。

[目次へ]

管理者側：ユーザからの登録依頼を処理する

　管理者はユーザからの登録内容をチェックし、採用、不採用を決定します。現在登録待ちが何件あるかは、管理ページ（tbadmin.cgi）のトップに赤字で表示されています。

　依頼が1件以上あった場合は、「登録依頼の処理」を選択し、パスワードを入力して「作業実行」を押してください。「登録依頼の処理」ページに移動します。

　「登録依頼の処理」には現在修正の依頼をしているページの情報が表示されます。以下の３種類の依頼があります。

新規登録 ..... 新規に登録依頼をしてきたもの。
修正 ..... 既に登録してあるものについて修正を依頼してきたもの。
削除 ..... 登録の削除を依頼してきたもの。

　依頼内容を確認し、それぞれ「許可」か「却下」を選んで、「チェックＯＫ」を押します。すると、「許可」を選んだものはデータに追加され、「却下」を選んだものは破棄されます。

　登録された人にメールで連絡が行くようにはなっていません。ユーザは実際に検索ページを訪れて、自分のものが登録されているかどうかを確かめます。

※ 一度却下したものは二度と復活しません。
※ どっちも選択しなかったものは保留されて、そのまま依頼リストに残されます。
※ 「却下しなくてもいいけど、ちょっとだけ修正したい」という場合は、ＩＤをメモしておいて、ここでは「許可」にし、後ほど登録済みページを修正／削除するから修正します。

[目次へ]

管理者側：自分でページを登録する

　登録依頼を経ずに直接ページを登録したい場合は、管理ページ（tbadmin.cgi）のブックマークの追加・修正・削除から行います。以下の項目を入力してください。

登録者名、E-Mail、タイトル、URL、分野（一つ以上）、キーワード（半角スペース区切り）、紹介文

[目次へ]

管理者側：登録済みページを修正／削除する

　一旦登録したページを修正、削除する場合は、管理ページ（tbadmin.cgi）のブックマークの追加・修正・削除から行います。手順は以下の通り。

修正したいページのＩＤを入力し、「読み込む」ボタンを押す。
※ 分からない場合はＩＤ検索オプションで調べてください。
下のフォームにそのＩＤの登録内容が表示される。
　　[修正] それを修正して「作業実行」を押す。
　　[削除] 「このページを削除」をチェックして「作業実行」を押す

[目次へ]

管理者側：分野リストを編集する

　ページを分類するための分野リストの編集は、管理ページ（tbadmin.cgi）の「分野リストの編集」から行います。

新規登録 ..... 上部フォームの「新規登録」を押して、新分野のコード、名前、説明を加える。
修正 ..... 修正したい分野の分野コードを入力し「読み込み」を押し、表示された内容を修正して「作業実行」を押す。
削除 ..... 修正したい分野の分野コードを入力し「読み込み」を押し、表示されたら「この分野を削除」をチェックして「作業実行」を押す。

※ 分野コードに使用できる文字は半角大文字英語２文字です。
　　　　　　○ MD, CH, G_
　　　　　　× MIDI, CHILD, GAME

[目次へ]

デザインを変更する

　デザインを変更するには、以下のファイルを編集します。

tb_main.html ..... タイトル、背景色、標準のフォント色など。
tbookmark.cgi ..... 検索結果の配色。表示方法など。

　初期デザインではタイトルが「タイトル」という文字になっていたりして使えません。最低限でも「tb_main.html」だけは編集してください。

[目次へ]

タイトル、背景色など～ tb_main.html

　タイトル、背景色などは tb_main.html を編集して変更します。どこを変更すればよいかは tb_main.html内に書いてあります。とりあえず以下の２つだけは最低限編集してください。

TITLEタグ （7行目）..... <TITLE> ～ </TITLE> の間に入る文字列。
タイトル部 （36行目）..... 一番上のタイトル文字列。

上の他にも色々編集できます。詳細はファイル内部のコメントをご覧下さい。

※ 「以下は絶対に変更しないで下さい」～「ここまで」の間は絶対に書き換えないで下さい。

[目次へ]

検索結果の配色～ tbookmark.cgi

　検索結果の配色は、tbookmark.cgi の上部にある変数設定部（下記）を編集することによって変更できます。

### 以下は配色の設定 ###

$col_anm = "#FF0000"; # No.xx ～ No.xx [←A]
$col_num = "#000000"; # No. [←B]
$col_ttl = "#FF0000"; # タイトル [←C]
$col_gnr = "#000099"; # 分野 [←D]
$col_day = "#9999FF"; # 日付 [←E]
$col_url = "#888888"; # ＵＲＬ [←F]
$col_key = "#9933CC"; # キーワード [←G]
$col_pid = "#FF6600"; # ＩＤ [←H]

変数と部分の対応は以下の通り。（ＩＤ、キーワードは表示オプションをつけたときのみ表示されます）

◆ No.1 [←B] MyTools.NET [←C] [雑学・流行] [趣味] [コンピュータ] [←D]
(1999/08/14) [←E] http://www.mytools.net/ [←F]
[ID] No.1999081416071011 [←G]
[Keys] CGI JavaScript カウンタチャット掲示板クイズ投票 MIDI [←H]
........ 掲示板、チャット、クイズ、投票など、様々なCGIプログラムを無料公開。MIDIもあります。[←BODYタグのTEXT]

[目次へ]

"NEW", "UP" を表示する基準日数を変える

　NEW, UP の画像は、初期設定では「登録（更新）してから７日以内のもの」につくようになっています。この日数を変えるには、以下の部分を変更してください。

[tbookmark.cgi 38行目]
# 更新日から何日以内なら「New」「Up」を付けるか
$new_date = 7;

これを「$new_date = 3;」とすると、基準日数が３日に変わります。

※ 「$new_date = 0;」とすると、NEW, UP の表示がされなくなります。

[目次へ]

"NEW", "UP" の画像を変える

　新規登録の

、更新の

の画像は、自分で作成したものや素材集などの他のものに変更することもできます。
(1) 現在の new.gif と up.gif を新しい画像ファイルで上書きする
(2) tbookmark.cgi の $image_new, $image_up （40,42行目）を新しい画像のURLにする
のいずれかの方法で変更して下さい。

※ (1)の方法をとった場合でも、必ず $image_new と $image_up の画像サイズ（WIDTH, HEIGHT）を書き換えて下さい。

$image_new ... NEW 画像へのパス（※ WIDTH, HEIGHTは必ず指定して下さい。下も同様。）
$image_up ... UP 画像へのパス

.....
　ちなみにここをタグではなく単なる文字にすることも可能です。

（例）
$image_new = "【NEW!】";
$image_up = "【UP!】";

　　　→ 新規は 【NEW!】 、更新は 【UP!】 という表示になります。

[目次へ]

[高度] 配色だけでなく表示そのものを変える

　配色だけでなく表示方法そのものを変更したい場合は、tbookmark.cgi の268行目付近、「検索結果表示部」の変数 $htmlbuf を変更して下さい。見た目は普通のHTMLですが、文字が入るところに変数が入ります。変数と文字の対応はファイル内に書いてあります。

※ 表示に " を出したいときは前に必ず \ をつけて下さい。[例] ×COLOR="#FFFF00"、○COLOR=\"#FFFF00\"

[目次へ]

表示単位、初期表示件数を変える

　表示件数に関する項目は、tbookmark.cgi の上部「以下は表示に関するカスタマイズ」内の変数を編集します。

$show_scale ..... 検索結果が多数あったとき、いくつずつ表示させるか。
$default_pages ..... 「登録順」が選択された際に何ページ分表示させるか。
$show_max ..... 「全表示」オプション（後述）が指定されたときに、最大何件まで同時に表示するか。

[目次へ]

ユーザの検索記録ログを取る

　ユーザがどんな文字で検索して、何件ヒットしたかをログとして記録することができます。（ユーザがどんなキーワードのコンテンツを欲しがっているかが分かるわけです。）ログを取るようにする方法は以下の通り。

tbookmark.cgi の上部の「以下は表示に関するカスタマイズ」の下にある変数「$user_trace」の値を 1 に変更する。

[元] $user_trace = 0; → [変更後] $user_trace = 1;
$basedir で指定したディレクトリに userlog.txt という空ファイルをFTPする。パーミッションを606にする。
試しに検索してみて、userlog.txt にブラウザからアクセスして、書き込まれているかどうか確認する。

　ユーザログの例はこちら。

　ログを取りつづけると、userlog.txt のサイズがどんどん大きくなっていきます。適度に空ファイルを上書きFTPしてやりましょう。

　ログを取るのをやめる場合は、$user_trace の値を 0 に戻してください。

[目次へ]

リンク集管理CGI T-Bookmark Ver.1.10 説明書

about...

目次

機能

設置に関する注意～文字コードは自由になりました

ソース

インストール方法

インストール

分野を作成する

管理ページからページを登録してみる

ユーザ側から登録依頼を出してみる

"NEW" "UP" の画像が表示されない原因とその対処方法

使い方

ユーザ側：検索する

ユーザ側：検索オプション（キーワード表示、ＩＤ表示）

ユーザ側：登録依頼を出す

ユーザ側：修正、削除依頼を出す

管理者側：ユーザからの登録依頼を処理する

管理者側：自分でページを登録する

管理者側：登録済みページを修正／削除する

管理者側：分野リストを編集する

デザインを変更する

タイトル、背景色など～ tb_main.html

検索結果の配色～ tbookmark.cgi

"NEW", "UP" を表示する基準日数を変える

"NEW", "UP" の画像を変える

[高度] 配色だけでなく表示そのものを変える

表示単位、初期表示件数を変える

ユーザの検索記録ログを取る

Note...

偽の登録依頼にご用心

登録時のメールアドレスを忘れてしまったユーザがいたら

検索オプションの同時使用、隠しオプション（全表示）

バージョン情報

バージョン履歴

1.0x → 1.1x へのバージョンアップ方法

リンク集管理CGI T-Bookmark Ver.1.10 説明書

about...

目次

機能

設置に関する注意 ～ 文字コードは自由になりました

ソース

インストール方法

インストール

分野を作成する

管理ページからページを登録してみる

ユーザ側から登録依頼を出してみる

"NEW" "UP" の画像が表示されない原因とその対処方法

使い方

ユーザ側：検索する

ユーザ側：検索オプション（キーワード表示、ＩＤ表示）

ユーザ側：登録依頼を出す

ユーザ側：修正、削除依頼を出す

管理者側：ユーザからの登録依頼を処理する

管理者側：自分でページを登録する

管理者側：登録済みページを修正／削除する

管理者側：分野リストを編集する

デザインを変更する

タイトル、背景色など ～ tb_main.html

検索結果の配色 ～ tbookmark.cgi

"NEW", "UP" を表示する基準日数を変える

"NEW", "UP" の画像を変える

[高度] 配色だけでなく表示そのものを変える

表示単位、初期表示件数を変える

ユーザの検索記録ログを取る

Note...

偽の登録依頼にご用心

登録時のメールアドレスを忘れてしまったユーザがいたら

検索オプションの同時使用、隠しオプション（全表示）

バージョン情報

バージョン履歴

1.0x → 1.1x へのバージョンアップ方法

設置に関する注意～文字コードは自由になりました

タイトル、背景色など～ tb_main.html

検索結果の配色～ tbookmark.cgi