＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝懸賞生活日記:設置マニュアル作成: hige MAIL: hige@deneb.freemail.ne.jp HOME: CGIのかんづめ http://www.dab.hi-ho.ne.jp/appletea/cgikan/ ＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝ ────────────────────────────────────── ■ 目次 ────────────────────────────────────── ・はじめに・配布物一覧・設置方法・カスタマイズ方法・使用方法・旧バージョン(懸賞当選日記)をお使いの方へ・変更履歴 ────────────────────────────────────── ■ はじめに ────────────────────────────────────── 懸賞生活日記は、懸賞生活向けの機能をプラスした日記CGIです。日記の記事の中から、当選品やサイト収入を抜き出して表にする機能が最大の特徴となっています。このCGIは以下のような方に特にオススメです。・インターネット懸賞が好きで、当選品報告ページを作っている方・インターネットのお小遣い系サイトが好きで、収入報告ページを作っている方懸賞生活日記は他にも以下の特徴があります。・設置が簡単 >> CGIの修正は4箇所だけ。あとはアップロードして終わりです。・テンプレートファイルだけで見た目を変えられる。 >> スタイルシート部分だけで、印象を大幅に変えることが出来ます。 >> タグ内を修正すると、全く別の画面構成に変えられます。・月毎にデータファイルが作られる・目次ファイルが別に作られる >> 何十年もの記事がたまっていっても処理は遅くなりません。・コメントにHTMLを使用可能・最新の日記をSSIで表示可能 >> ブログ風の見た目と使い勝手で日記を編集できます。ご要望があればメールを下さい。次バージョン開発の参考にします。 ────────────────────────────────────── ■ 配布物一覧 ────────────────────────────────────── 懸賞生活日記は「CGIのかんづめ」でダウンロードできます。ダウンロードした prenikki.lzh を解凍すると以下のファイルが展開されます。 install.txt : 設置マニュアル(このファイル) customize.txt : カスタマイズマニュアル prenikki.cgi : CGIスクリプト本体 jcode.pl : 漢字コード変換ライブラリ prenikki/simple.html : テンプレートファイル ────────────────────────────────────── ■ 設置方法 ────────────────────────────────────── 懸賞生活日記を設置する方法を説明します。大まかな手順は以下の通りです。 1. CGIスクリプト本体を修正する 2. サーバーにアップロードする 3. 動作を確認する ---------------------------------------- 【１】CGIスクリプト本体を修正する ---------------------------------------- テキストエディタで prenikki.cgi を開き、4箇所修正してください。 □ 1行目 #!/usr/local/bin/perl プロバイダが指定するPerlへのパスを指定します。 □ 30行目 $pwd = 'guest'; 管理機能を使うためのパスワードを指定します。セキュリティの関係上、必ず変更してください。 □ 33行目 $home = "http://www.dab.hi-ho.ne.jp/appletea/cgikan/"; [HOME]をクリックしたときに戻るページを指定します。 □ 36行目 $imgdir = 'http://xxx.com/yyy'; 画像ファイルを置くディレクトリを指定します。 ---------------------------------------- 【２】サーバーにアップロードする ---------------------------------------- CGIの設置ディレクトリを xxx と仮定します。下図のようなファイル配置でサーバにアップロードして下さい。[]内の数字はパーミッションです。 xxx / ｜＋-- prenikki.cgi [755] ＋-- jcode.pl [644] ｜＋-- prenikki / [755] ｜＋-- simple.html [666] FTP でアップロードするときは、以下の点に注意してください。・全てのファイルを Ascii モードで転送する・全てのファイルの漢字コードを EUC に変換する懸賞生活日記はUNIXサーバーを前提にしています。Windowsサーバーの場合はそのままでは設置できないのでご了承ください。 ---------------------------------------- 【３】動作を確認する ---------------------------------------- アップロードが終わったらブラウザで表示してみましょう。URL は以下のようになります。お使いのサーバによって URL は異なります。 http://(CGIを設置したサーバ)/(CGIを設置したディレクトリ)/prenikki.cgi きちんと表示されましたか？・はい。表示されました。 >> 設置完了です。お疲れ様でした。・いいえ。エラーになります。 >> 手順をチェックしてやりなおして下さい。動かない場合、文字コードを変換していないというミスが多いです。「動かない」という報告のほとんどがコレです。文字コード変換機能のある FFFTP のような FTP ソフトを使うと失敗が少ないと思います。 ────────────────────────────────────── ■ カスタマイズ方法 ────────────────────────────────────── 懸賞生活日記のデザインは自由にカスタマイズできます。長くなるのでこのマニュアルには書いていません。customize.txt をご覧になってください。 ────────────────────────────────────── ■ 使用方法 ────────────────────────────────────── 懸賞生活日記には、大きく分けて「日記モード」と「集計モード」の２つの使い方があります。他にはブログ風の見せ方をするのに便利な「SSIモード」があります。懸賞生活日記｜＋-- 日記モード = 一般的な日記CGIと同じ機能｜｜｜＋-- 頁表示 = 最新からXX件ずつ記事を表示｜＋-- 月毎表示 = 月毎に記事を表示｜＋-- 目次 = 記事がある月の一覧を表示｜＋-- 集計モード = 日記の中から収入や当選品を抜き出して表にする機能｜｜｜＋-- 月毎表示 = 月毎に収入・当選品を表示 / 月間集計を表示｜＋-- 目次 = 収入・当選品のある月の一覧を表示 / 年間集計・総集計を表示｜＋-- SSIモード = 最新からXX件の記事をSSIで表示 ---------------------------------------- ■ 日記モードの使い方 ---------------------------------------- ■ URL URL は以下のようになります。トップページなどからリンクしてください。頁表示：http://(パス)/prenikki.cgi?mode=page [推奨] 月毎表示(最新年月)：http://(パス)/prenikki.cgi 月毎表示(指定年月)：http://(パス)/prenikki.cgi?m=YYYY/MM 目次表示：http://(パス)/prenikki.cgi?mode=contents 月毎表示(指定年月)のときは、YYYY/MMのところを指定したい年月にして下さい。例. http://www.xxx.ne.jp/yyy/prenikki.cgi?mode=sum&m=2003/01 ■ データの追加・変更データの追加・変更は管理画面で行います。頁表示または月毎表示の画面で「管理用」というメニューをクリックすると、パスワードを聞かれるので、prenikki.cgi の $pwd に書いたパスワードを入力して下さい。管理画面で追加、修正のリンクをクリックすると、記事入力画面が表示されます。入力できるのは以下の項目です。 A. 基本情報 = 日付, タイトル, 画像URL, コメント B. 関連サイト/獲得商品 = サイト名, サイトURL, 商品の種類, 商品名, 金額画像のアップロード機能はありません。画像は prenikki.cgi の $imgdir で指定したディレクトリの下に転送しておきます。$imgdir の下に月毎のサブディレクトリを作ると管理が楽です。別ディレクトリの画像を使う場合は、'http://'からの完全なパスを指定してください。 B.に関しては、獲得商品の種類によって入力する項目が違います。・なし >> サイト名, サイトURL(オプション) ・現金 >> サイト名, サイトURL(オプション), 金額・金券 >> サイト名, サイトURL(オプション), 商品名, 金額・商品 >> サイト名, サイトURL(オプション), 商品名獲得商品がある場合、入力した商品名と金額は集計モードで使用されます。サイト名を空白にすると、URLや獲得商品情報も削除されます。収入や当選と関係ないサイトへリンクを貼りたい場合は、2つの方法があります。どちらを使っても構いません。方法1. コメントに URL を書く。 >> (有効なら)自動リンク機能でリンクされる。方法2. 関連サイト/獲得商品に書く。 >> 関連サイト一覧として表示される。 ■ データの削除データの削除も管理画面で行います。古いデータを自動的に削除する機能はないので、不要になった記事と画像は適宜削除してください。なお、記事を削除しても画像は削除されません。(「同じ画像を他から使っているかもしれない」という考えから、この仕様になっています。) ---------------------------------------- ■ 集計モードの使い方 ---------------------------------------- ■ URL URL は以下のようになります。トップページなどからリンクしてください。月毎表示(最新年月)：http://(パス)/prenikki.cgi?mode=sum [推奨] 月毎表示(指定年月)：http://(パス)/prenikki.cgi?mode=sum&m=YYYY/MM 目次表示：http://(パス)/prenikki.cgi?mode=sumContents 月毎表示(指定年月)のときは、YYYY/MMのところを指定したい年月にして下さい。例. http://www.xxx.ne.jp/yyy/prenikki.cgi?mode=sum&m=2003/01 ■ データの追加・変更・削除集計モードでの追加・変更・削除は行えません。日記モードで追加・変更・削除すると、その結果が反映されます。 ---------------------------------------- ■ SSIモードの使い方 ---------------------------------------- ■ SSIモードの目的ブログサイトのように日記の最新xx件をトップページに表示することができます。 ■ URL 日記を表示したい箇所に以下のようなコードを埋め込みます。 ■ データの追加・変更 SSIモードでの追加・変更・削除は行えません。日記モードで追加・変更・削除すると、その結果が反映されます。 ────────────────────────────────────── ■ 旧バージョン(懸賞当選日記)をお使いの方へ ────────────────────────────────────── 懸賞生活日記 ver.2.0 の前バージョンは懸賞当選日記 ver.1.0 です。機能を大幅に強化した結果、想定される利用方法が異なってきたため名称を変更しました。バージョンアップには以下の問題点があります。問題点１. 懸賞当選日記 ver.1.0 のデータファイルは読み込めない。問題点２. 懸賞当選日記 ver.1.0 のテンプレートファイルは使えない。解決法はありますが、名前を変えて新旧両バージョンの CGI をサーバに置き、「過去の日記はこちら」というようなリンクを旧バージョンに貼っておくことをオススメします。解決法は以下のとおり。【問題点１の解決方法】データコンバート用のCGIを作りました。公開はしていないのでメールでお問い合わせください。(私はこれを使いました。) 【問題点２の解決方法】旧バージョンのヘッダ部分に新バージョンのヘッダにあるスタイルシートをコピーして下さい。さらに変更された特殊コメントを新しい名前に置換し、廃止された特殊コメントを削除してください。最後に新バージョンのテンプレートを参考に、追加された特殊コメントを加えればOKです。・変更された特殊コメント : に変更 : に変更 : に変更 : に変更・廃止された特殊コメント : 削除 : 削除 : 削除・追加された特殊コメント : 日記の名前(日記モードと集計モードで別定義できる) : メニュー機能が変わっているので完全に同じ画面にはできません。ご了承ください。 ────────────────────────────────────── ■ 変更履歴 ────────────────────────────────────── ---------------------------------------- ■ 2.2 -> 2.3 (2005.04.04) ---------------------------------------- ・コメントにHTMLを入力可能としました。・日記モード頁表示機能とSSIモードを追加しました。 ---------------------------------------- ■ 2.1 -> 2.2 (2005.02.20) ---------------------------------------- ・マイナスの金額を入力できるようにしました。 ---------------------------------------- ■ 2.0 -> 2.1 (2003.07.07) ---------------------------------------- ・サイト移転のため著作権表示を修正。 ---------------------------------------- ■ 1.0 -> 2.0 (2003.01.24) ---------------------------------------- ・今まで日記モードに該当する画面だけでしたが、日記目次、集計、集計目次の画面　が追加されました。・1件の日記記事に対して複数のサイト名、サイトURL、獲得商品を設定できるように　なりました。また、獲得商品の種類を設定すると金額、件数が集計されるようにな　りました。・スタイルシートで色やサイズの調整を行えるようにしました。その他、書ききれないほど大幅に変更しています。以上