AmigoDatabaseカスタマイズノート

1. 利用にあたって

1) 著作権の表示

2) 本スクリプトについて

• このスクリプトは、AmigoDatabaseで新規・変更登録されたユーザー又はデータの一つの項目をヘッドライン情報としてAmigoDAtabase外のHTMLページに表示させるスクリプトです。
• 2010/06/16のアップデートにより、表示するデータはAmigoDatabaseの検索結果一覧のように自由に配置出来るようになりました。
• 表示文字を任意の長さにカットすることが可能です。と同時に改行タグを取り除きます。

2. スクリプト利用環境

• 作動環境： Perl-5以上
• CGIモジュール
• SSI利用可能で「include virtual」コマンドが利用出来ること

3. ダウンロード

• ダウンロードページ
• サンプル

4. headline.cgiの設定

• 1行目のPerlパスを設定 [#!/usr/bin/perl] 又は [#!/usr/local/bin/perl] の何れかで可能かと思います。分からない場合はサーバー管理者にご確認下さい。

5. headline-setup.cgiの設定

1) fold.plまでのパス

## fold.plまでのパス ##
$FoldPath='./lib/fold.pl';

2) 日付表示設定

## 日付表示設定 ##
$DateType = '[yyyy]/[mm]/[dd]([ww]) [hh]:[aa]:[ss]';

3) データ表示設定セット

## データ表示設定セット #######################################
%SET=(
'set1'=>{ # セット名(表示設定のサブルーチン名) ※必ず英字で始める
    'type'    => 'Data',  # 'Data' 又は 'User' (データタイプ)
    'view'    => 10,      # 表示数
    'date'    => 'Rtime', # 'Rtime'(登録日) 又は 'UpTime'(更新日)
    'reverse' => 1,       # dateの表示順(0=昇順/1=降順)
    'rand'    => 1,       # ランダム表示(0=OFF/1=ON)
    'randmax' => 10,      # ランダムにするデータ数
    'cutname' => '',      # 表示文字数にカットするデータ種類名
    'cutmax'  => 0,       # 上記の表示する文字数
    'html'    => 'sample.shtml', # headline.cgiをSSI起動するHTML(SHTML)
    'sname'   => '',      # 抽出するデータ種類名
    'sword'   => '',      # その一致する検索キーワード(完全一致のみ抽出)
},
);

• [type] : [Data]又は[User]の何れかで指定します。[Data]の場合はデータファイルベース、[User]の場合はユーザーファイルベースをターゲットにします。
• [view] : 表示数を指定します。
• [date] : [Rtime]又は[UpTime]の何れかで指定します。ソートの基準データとなります。[Rtime]は登録日、[UpTime]は最終更新日となります。
• [reverse] : [date]で指定したソートの並び変え方法です。[1]は降順、[0]は昇順の指定です。
• [rand] : ランダム表示をON/OFFします。[1]はON、[0]はOFFです。
• [randmax] : ランダムに並び変えるデータ数を指定します。[rand]を1(ON)にした場合、[date]と[reverse]にてソートされたデータ(全てのデータ)の上位から[randmax]の数をランダムに並び変え、上位から[view]の数だけ表示します。
  例えば登録データが50あるとして、[date]と[reverse]にて一旦ソートします。ソート後の上位データのうち[randmax]の数(例えば30)をランダムに並び変えます。並び変え後、[view]の数(例えば10)をヘッドライン表示します。このように通常なら表示されないデータをランダムに並び変えることで20-30位置のデータにも紹介の機会を与える事が出来ます。
• [cutname] : 表示が長文など、表示する文字数をカットするデータ種類名を指定します。一つのデータ種類しか指定出来ません。
• [cutmax] : [cutname]で指定したデータ種類の表示する文字長さを指定します。長さは半角での長さとなります。
• [html] : セキュリティ設定です。headline.cgiを起動するHTMLのファイル名を指定します。指定した場合、そのHTMLファイルからSSI起動されないと起動エラーとなります。外部からheadline.cgiを起動させないためのセキュリティです。
• [sname] : データ抽出する場合は、対象データ種類名を指定します。
• [sword] : 前項[sname]を設定した場合、その抽出対象のキーワードを指定します。キーワードと完全一致のデータを抽出します。

4) 表示設定

sub set1 {
    my$line=<<EOM;
<li><a href="$BaseDir/$MainCGI?cmd=dp&num=$VD[$REC{Data}{DataNum}]">$VD[$REC{Data}{HPName}]</a> <span class="date">- $RDate</span></li>
EOM
}

• データファイルベース： $VD[$REC{Data}{データ種類名}]
• ユーザーファイルベース： $VU[$REC{User}{データ種類名}]
• 登録日と最終更新日： $RDate $NDate (データ、ユーザーファイルベース共通です)

6. アップロードとパーミッション

• headline.cgi : [755]又は[705]
• headline-setup.cgi : [644]又は[604]
• headline.css : [644]又は[604] (CSS参考ファイル)
• sample.shtml : [644]又は[604] (SHTML参考ファイル)

7. ヘッドライン情報表示方法

1) SSI記述の追加

<!--#include virtual="[HTMLからheadline.cgiまでの相対パス]?set=set1"-->

rootディレクトリ ┬ index.html(このファイルにSSI記述する場合)
                 └ databaseディレクトリ ─ headline.cgi

<!--#include virtual="./database/headline.cgi?set=set1"-->

○ ./headline.cgi
○ ./database/headline.cgi
× ../headline.cgi
× ../database/headline.cgi

2) headline.cgiパラメータの設定

3) HTMLファイル拡張子の変更

4) サンプルHTML(sample.shtml)

<link rel="stylesheet" href="./headline.css" type="text/css" media="all">

8. サポート