＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝ 広告管理:設置マニュアル 作成: hige MAIL: hige@deneb.freemail.ne.jp HOME: CGIのかんづめ http://www.dab.hi-ho.ne.jp/appletea/cgikan/ ＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝ ────────────────────────────────────── ■ 目次 ────────────────────────────────────── ・はじめに ・配布物一覧 ・設置方法 ・使用方法 ・変更履歴 ────────────────────────────────────── ■ はじめに ────────────────────────────────────── 登録しておいた広告をランダムに選んで表示します。「広告」といってもただのHTML なので、お友達のサイトを登録しておいてランダムに表示･紹介する、といった使い 方もできます。 広告の登録･修正作業はWeb上でできます。表示にはSSIが必要ですが、掲示板などの CGIで広告を出す場合にはadmgr.plの関数を直接呼ぶことも可能です。 ────────────────────────────────────── ■ 配布物一覧 ────────────────────────────────────── 広告管理は「CGIのかんづめ」でダウンロードできます。ダウンロードしたadmgr.lzh を解凍すると以下のファイルが展開されます。 install.txt : 設置マニュアル(このファイル) admgr.cgi : CGIスクリプト本体 jcode.pl : 漢字コード変換ライブラリ admgr.pl : ランダムに広告をとりだすライブラリ admgr/pages.txt : 広告を表示する頁の定義ファイル ────────────────────────────────────── ■ 設置方法 ────────────────────────────────────── 広告管理を設置する方法を説明します。大まかな手順は以下の通りです。 1. CGIスクリプト本体を修正する 2. サーバーにアップロードする 3. 動作を確認する ---------------------------------------- 【１】CGIスクリプト本体を修正する ---------------------------------------- テキストエディタで admgr.cgi を開き、3箇所修正してください。 □ 1行目 #!/usr/local/bin/perl プロバイダが指定するPerlへのパスを指定します。 □ 31行目 $home = "http://www.dab.hi-ho.ne.jp/appletea/cgikan/"; [HOME]をクリックしたときに戻るページを指定します。 □ 34行目 $pwd = 'guest'; 管理機能を使うためのパスワードを指定します。セキュリティの関係上、必ず変更し てください。 ---------------------------------------- 【２】サーバーにアップロードする ---------------------------------------- CGIの設置ディレクトリを xxx と仮定します。下図のようなファイル配置でサーバに アップロードして下さい。[]内の数字はパーミッションです。 xxx / ｜ ＋-- admgr.cgi [755] ＋-- jcode.pl [644] ＋-- admgr.pl [644] ｜ ＋-- admgr / [755] ｜ ＋-- pages.txt [666] FTP でアップロードするときは、以下の点に注意してください。 ・全てのファイルを Ascii モードで転送する ・全てのファイルの漢字コードを EUC に変換する 広告管理はUNIXサーバーを前提にしています。Windowsサーバーの場合はそのままで は設置できないのでご了承ください。 ---------------------------------------- 【３】動作を確認する ---------------------------------------- アップロードが終わったらブラウザで表示してみましょう。URL は以下のようになり ます。お使いのサーバによって URL は異なります。 http://(CGIを設置したサーバ)/(CGIを設置したディレクトリ)/admgr.cgi きちんと表示されましたか？ ・はい。表示されました。 >> 設置完了です。お疲れ様でした。 ・いいえ。エラーになります。 >> 手順をチェックしてやりなおして下さい。 動かない場合、文字コードを変換していないというミスが多いです。「動かない」と いう報告のほとんどがコレです。 文字コード変換機能のある FFFTP のような FTP ソフトを使うと失敗が少ないと思い ます。 ────────────────────────────────────── ■ 使用方法 ────────────────────────────────────── 広告管理は、2種類の機能があります。 ・管理画面を表示 ・広告を表示 実際にホームページに広告を表示するときには、以下の２種類の方法のうちどちらか を使います。 (1) 通常のページ -> SSI (2) 掲示板などのCGI -> 広告管理ライブラリの関数を呼ぶ どちらの場合も、頁と場所を指定すると、その領域に登録されている広告の中からラ ンダムに1つを選んで返してくれます。 ---------------------------------------- ■ 管理画面の表示 ---------------------------------------- ■ URL URL は以下のようになります。 管理画面：http://(パス)/admgr.cgi ■ 操作方法 パスワード入力を求める画面が表示されます。そこで正しいパスワードを入れると管 理画面が表示されます。 ■ 広告の登録 頁、場所、広告、の3段階で情報を登録します。 例えば、次のように操作してみてください。 1. 「頁を追加」をクリック 2. 日本語名を「標準」、英数字名を「default」と入力して「登録する」をクリック ## ここまでで、「標準」という頁設定が追加されました。 ## 3. 「標準」頁の「場所を追加」をクリック 4. 日本語名を「上」、英数字名を「top」と入力して「登録する」をクリック ## 「標準」頁に「上」という広告領域があることを定義できました。 ## 5. 「標準」「上」の「広告の編集」をクリック 6. 「広告を追加」をクリック 7. 以下のように入力して「登録する」をクリック 　　名前　テスト 　　HTML　CGIのかんづめ 有効 チェックする ## 「標準」頁の「上」領域に表示する広告が1つ登録されました。 ## 頁は実際のホームページと1対1に対応する必要はありません。「標準」のような頁設 定を作って、全てのページで使いまわすほうが管理が楽です。 頁設定を増やす理由としては、広告を表示する領域の数が違う、ページ毎に訪れる人 の層が違う、といったことがあるでしょう。 例えば、プレゼント情報のページを持っている場合、「標準」の他に「懸賞」という 設定を追加し、懸賞がらみの広告だけを厳選して載せると効果があるかもしれません ね。 ---------------------------------------- ■ 広告の表示(SSI編) ---------------------------------------- ■ URL カレンダーを表示したい箇所に以下のようなコードを埋め込みます。 URL は以下のようになります。 (パス)/admgr.cgi?mode=get_ad&page=default&type=top&code=sjis CGIのパラメータは以下の通りです。 ・mode "get_ad" 固定です。 ・page 頁の名前(半角英数字)を指定します。 ・type 場所の名前(半角英数字)を指定します。 ・code 文字コードを指定します。'sjis' か 'euc' にして下さい。 ■ 注意事項 プロバイダによってSSI機能に制約があります。プロバイダの対応状況を必ず確認し てください。 よくある制約１：「SSIを埋め込むページの拡張子は .shtml でなければならない」 よくある制約２：「パスはvirtualで指定する / 指定できない」 ---------------------------------------- ■ 広告の表示(掲示板などのCGIで使う) ---------------------------------------- 掲示板などのCGIでは、SSIのコードを埋め込んでも処理されないのが普通です。 この場合、CGI の中で以下のようなコードを書くと広告表示用の HTML を取得できま す。 #ライブラリの組み込み require './admgr.pl'; ... #広告を取得 $ad_html = &admgr'get_ad('default', 'top'); 取得したコードは print 文などでそのまま表示できます。文字コードは取得後に適 宜変換してください。 get_ad 関数のパラメータは以下の通りです。 ・第1引数 頁の名前(半角英数字)を指定します。 ・第2引数 場所の名前(半角英数字)を指定します。 ────────────────────────────────────── ■ 変更履歴 ────────────────────────────────────── ---------------------------------------- ■ 1.1 -> 1.2 (2003.7.7) ---------------------------------------- ・サイト移転のため著作権表示を修正。 ---------------------------------------- ■ 1.0 -> 1.1 (2001.1.26) ---------------------------------------- ・トップページで広告名の表示をON/OFFできるようにしました。1.0はOFF状態と同 等です。 ・同じ名前(半角英数字)で頁、場所を登録できないようにしました。 ・一度設定した頁、場所の名前(半角英数字)を確認する画面が無かったので、トッ プ頁で表示するようにしました。 以上