シンプル着メロサイトメーカー４取り扱い説明書

scm4.cgi取扱説明書

１．シンプル着メロサイトメーカー４（scm4.cgi）の特徴

携帯用着メロサイトを作る際、アクセスしてきた携帯端末の種類(i-mode,Vodafon,EzWeb(WAP2.0),EzWeb(HDML))に応じた表示を行うためのツールです。
そんなに高度な機能は持たせず、テキストデータのみのページと着メロがダウンロードできるページのみを作成すればよい場合に手軽にご利用いただけると思います。
データを変えたい場合は元ページデータファイルのみを変更すればどの端末についても繁栄されますので、メンテナンスが楽になります。

最低限のタグが使えればいいという発想で作っておりますので、タグは5種類しか使用できません。詳しくは、

元ページデータファイルの作成方法

scm4.cgi

２．設置の方法＜設定とアップロード＞

(1)　圧縮ファイルのダウンロードと解凍
　圧縮ファイルをダウンロードして解凍していただくと11個のファイルが入っています。

ダウンロードファイル一覧

…[scm4]-+-scm4.cgi　CGI本体
         |
         +-scm4_count.cgi           　集計用CGI
         |
         +-.haccess　アクセスコントロールファイル(haccess.txt→UPしてから改名)
         |
         +-[html]-+-k_top.html      　トップページのサンプル
         |        |
         |        +-k_melo1.html    　着メロダウンロードページのサンプル
         |
         +-[Jmelo]-+-Beyer60.mmf　    着メロサンプル１―VODAFON用 EzWeb用
         |         |
         |         +-PsonataK545.mmf　着メロサンプル２―VODAFON用 EzWeb用
         |
         +-[Imelo]-+-Beyer60.mld　    着メロサンプル１―i-mode用
         |         |
         |         +-PsonataK545.mld　着メロサンプル２―i-mode用
         |
         +-[fig] -+-logo.png       　画像サンプル(VODAFON、EzWeb(HDML)用)
                   |
                   +-logo.gif       　画像サンプル(PC、i-mode、EzWeb(WAP2.0)用)

(2)　アップロードとパーミッションの変更

アップロード前に、scm4.cgiをテキストエディタ(メモ帳など)で開いて、$me="http://…"の部分をアップロード予定の絶対アドレスに書き直して上書き保存してください。

ファイル名	パーミッション
scm4.cgi	755
scm4_count.cgi	755
access.txt(カウンタを0から始めない場合)	666
scm4.cgiのあるディレクトリ	777
その他のファイル	644

(3)　起動

テキスト情報のページについては、タグの制限、タイトル・ボディタグの中身の指定方法、カウンタ数値の表示位置指定(トップページのみ)
着メロダウンロードページに関しては着メロリストの表示方法のローカルルールをお守り下さい。
相対アドレスでLINKされているページ(http:を使わないリンク)は全てscm4.cgiを通じての表示になるように作って有りますので、その辺を意識してscm4.cgiを通して表示したいLINKは相対アドレスで、scm4.cgiを抜けてのLINKは絶対アドレスで指定します。

元ページデータファイルに使えるタグ(タグは全て小文字でお書き下さい！)

<a>～</a>
同一サイト内の元ページデータファイルにリンクする場合は、そのHTMLからの相対アドレスで指定してします。元ページデータファイル同士はブラウザでCGIを通すことなくLINKのテストを行うことが出来ます。
改行タグ
<center>～</center>
センタリングタグ
～ 文字色指定用のタグ(HDML機では無視されます。白黒でも見やすいデザインを考慮下さい。)
<img src="ファイル名.png" alt="画像が表示できないときの文字列"> 画像指定タグ
(画像はi-modeではgif、VODAFON・EzWebでpngファイルに切り替えます。ファイルの拡張子は必ず小文字にして下さい。白黒画面についてはサポートしてません…)

この決まりを守っていただければ、もちろん着メロ無しのページも作れます。

scm4.cgiでのローカルなタグ(の様なもの)

<!-title'着メロのページ'-->：ページタイトルを指定する。
<!-body'bgcolor="#ffffcc" text="#0000cc" link="#cc0000"'-->：背景色、文字色、LINK文字の色指定。(HDML機では無視されます)。
$access：アクセスカウンタの数値に置き換えられる(トップページのみ)。
<m>曲名,ファイル名(除:ファイルタイプ),mmf和音数(4,16,40),作曲家やMIDI作者</m>：着メロファイルの情報の記述一ページ内に4和音、16和音、40和音のmmfを混在させることが出来ます。
<!-comcolor='#00ffff'-->作曲者/作者欄の色をページ毎に指定できるローカルルール(タグもどき)。

着メロページの元ページデータファイル　例)

<!-title'着メロサイトDEMO'-->
<!-body'bgcolor="#ffffcc" text="#0000aa" link="#880088"'-->
<a href="k_top.html">[TOP]</a> 
**************** 
着メロダウンロードのページ 
**************** 
ご存知、ピアノ教本ですが、この曲は何となく好きなんです。 
<m>♪バイエル60番,Beyer60,16,バイエル/とまて</m> 
明るくて軽快な曲です。 
<m>♪ピアノソナタK545,PsonataK545,16,モーツアルト/とまて</m> 
**************** 
曲名リストの下にもコメントが付けられるようになりました。リンクもOKです。 
<a href="k_top.html">[TOP]</a>

上記の例でダウンロードする曲のデータは、次の2曲(×2種類=4ファイル)を想定しています。

曲名	i-mode用ファイル名	J-skyとEzWeb(WAP2.0)用ファイル名
バイエル60番	Beyel60.mld	Beyel60.mmf(16和音)
ピアノソナタK545(モーツァルト)	PsonataK545.mld	PsonataK545.mmf(16和音)

テキストデータとサイト内リンクのみの場合の元ページデータファイル　例)

<!-title'着メロサイトDEMO'-->
<!-body'bgcolor="#ffffcc" text="#0000aa" link="#880088"'-->
<center>************</center>
<center>携帯着メロサイトメイカー DEMO</center>
<center>************</center>
<center><img src="../fig/logo.png" alt="LOGO"></center>
LINKとテキストと画像のページはこんな感じで表示されます。 
<a href="k_melo1.html">◆着メロページへのLINK</a> 
<center>★★★★★★</center>
PC版サイト『とまての実験室』にてフリーウエアとして本CGI(scm4.cgi)配布中です 
http://www3.kcn.ne.jp/~tomate/ 
管理人メールアドレス 
tomate1@anet.ne.jp 
アクセスカウンタも付けられます。 
<center>♪$access♪</center>

普通のHTML形式に近い書き方も出来るようになりました。

<!DOCTYPE HTML PUBLIC "-//W3C/DTD HTML 4.0 Frameset//EN">
<html>

<head>
<title>着メロサイトDEMO</title>
</head>
<body bgcolor="#000088" text="#ffaaaa" link="#ffff77">
<!-comcolor='#00ffff'-->
<a href="k_top.html">[TOP]</a>
 
**************** 

元データファイルがHTMLに更に近づきました。
 
**************** 
ご存知、ピアノ教本ですが、この曲は何となく好きなんです。 
<m>♪バイエル60番,Beyer60,16,バイエル/とまて</m> 
明るくて軽快な曲です。 
<m>♪ピアノソナタK545,PsonataK545,16,モーツアルト/とまて</m> 
**************** 
<a href="k_top.html">[TOP]</a>
</body></html>

桃色の部分はパラメータとして使用。水色の部分は削除。白い部分のみを本文として使用します。
背景やテキストカラーなどを元データの時点でチェックできるので便利です。

４．scm4.cgiのソースを一部書き換えることによる調整

scm4.cgiの調整項目

#############################################################
# ファイル名関連
$me="http://(絶対パス指定)/scm4.cgi"; # このCGIのファイル名をフルパスで指定します。
$top_page="html/k_top.html"; # ページを指定していない場合のデフォルトのファイル名(通常サイトのトップページをこのCGIからの相対パスで)
$I_path="Imelo"; # i-mode着メロ(*.mld)を格納するフォルダへのパス(このCGIからの相対パス)
$J_path="Jmelo"; # Vodafone/EzWeb用着メロ(*.mmf)を格納するフォルダへのパス(このCGIからの相対パス)

# 管理人パスワード
$passset='kanri';

# ページタイトルのデフォルト
$title="NonTitle";

# アクセスログ関連
$access_log=1; # アクセスログを採るか採らないか　1:採る 0:採らない
$access_max=100; # アクセスログ保存数
$access_log_file='access.txt'; # アクセスログファイルの指定(このCGIからの相対パスで)

# ダウンロードカウンタ関連
$dlcnt_file_head="DL_"; # ダウンロードカウンタファイル名の頭(scm4_count.cgiと整合性を取る必要が有ります)
$lockfile="lockfile.txt"; # ロックファイルの名前
$dllogmax=12; # ダウンロードカウンタファイルの保存数(何か月分か？)

$pc_dnload=1; # PCへのダウンロードを許可する(1:許可，0:不許可)

# 曲のコメント(作曲者名、作者名など)の色
$comcolor="#00aaff";

# エラーメッセージの文言
 # ロックファイルが有る。２人以上のリクエストが同時に入った場合。
 $message1='只今混み合っております。恐れ入りますがもう一度お願いします。';
 # ログファイルが開けない場合(管理人はログファイルの属性などをチェックする必要有り。
 $message2='申訳ありません。只今、ダウンロードできません。';

# PCからのダウンロードを許可しない場合のメッセージ(PCに対して)
$for_pc=<<'HIA';
<div style="border-style:ridge;border-width:3px;border-color:yellow;padding:10px;font-size:80%">
着メロはリスト表示のみになっております。
PCからのアクセスと認識されました。
携帯電話実機でのアクセスをお待ちしております！ 
携帯電話実機でアクセスしているにもかかわらずこのメッセージが出ている場合は、
ご連絡頂けたら幸いです。</div> 
HIA

# PC表示の時にページ下部に載せる情報(サイトアドレス送信用LINK、管理人パスワード入力欄が有りますが、調整・削除・お好みの情報を追加して下さい)
$pcfooter=<<"HIA";
<A href="mailto:PleaseInputYourAddress?subject=scm4.cgiデモページのURL&body=http://wwwここにサイトのURLを！/scm4.cgi?">
【携帯にこのサイトのURLを送信する】</A>
<FORM ACTION="$me" METHOD="POST">
<DIV ALIGN="right">
<INPUT TYPE="hidden" NAME="page" VALUE="$page">
管理人PASS <INPUT TYPE="password" NAME="pass" SIZE="10" MAXLENGTH="10"><INPUT TYPE="submit" NAME="send" VALUE="送信"></DIV>
</FORM>
HIA
#############################################################

scm4_count.cgiの調整項目

#############################################################
# ファイル名関連
$me="scm4_count.cgi"; # このCGIのファイル名(ファイル名を変えたときはここも書き換えます)
$dlcnt_file_head="DL_"; # ダウンロードカウンタファイル名の頭(scm4.cgiと整合性を取る必要が有ります)
#############################################################

上記はscm4.cgi、scm4_count.cgiのプログラムソース上部の数行です。ここで出来ることは、

ファイル名関連
$meはscm4.cgiを設置した絶対パス指定に書き換えてご利用下さい(相対パス指定だとi-modeシミュレータで誤動作します)。
$top_pageは、引数無しでscm4.cgiを呼び出した時に一番最初に表示されるページの元ページデータファイル名です。通常TOPページ(INDEXページ)のファイルになるでしょう。このCGIからの相対パスで指定します。
$I_path i-mode着メロ(*.mld)を格納するフォルダへのパス(このCGIからのPATH)
$J_path Jmelo着メロ(*.mmf)を格納するフォルダへのパス(このCGIからのPATH)
$passset 管理人用のパスワード(サイト内のLINK切れをヴィジュアルに表示しますので、着メロやページを増やした時に速やかに問題を解決します。)
アクセスログ関連
$access_logは、アクセスログを採るか採らないかの指定です。アクセスログを保存したい場合は1、不要な場合は0を指定します。
$access_maxは、アクセスログを何回分保存するかを指定します。多すぎるとアクセスが遅くなりますので、20以上200以下くらいが良いと思います。
$access_log_fileは、アクセスログを保存するファイル名です。パスやファイル名をサンプルと変更する場合はここを書き換えてください。CGIからの相対パスで指定します。

アクセスログファイルaccess.txtは自動的に作成されますが、スタートするカウント数を1以外にしたい場合は、access.txtという名前のファイルをテキストエディタ (メモ帳などで作成の上、始めたいカウント値を入力して保存し、scm4.cgiと同じディレクトリにUPして、パーミションを666に指定してください)
ダウンロードログ関連
$dllogmaxは、ダウンロードログファイルをいくつ(何か月分)まで保存するかの指定です。0でダウンロードログを採りません。
$dlcnt_file_headは、ダウンロードカウンタファイル名の頭の部分
$lockfileはロックファイルの名前
$pc_dnload PCへのダウンロードを許可する(1:許可，0:不許可)
$comcolor 曲のコメント(作曲者名、作者名など)の色
メッセージ関連
$message1 エラーメッセージの文言(ロックファイルが有る。２人以上のリクエストが同時に入った場合)
$message2 エラーメッセージの文言(ログファイルが開けない場合)
$for_pc PCからのダウンロードを許可しない場合のメッセージ(PCに対して)ヒアドキュメントですので、タグなども自由にお使いになれます。(HIAまでの間を書き換えて下さい)
$pcfooter PCでの表示のとき、ページ下部に載せたい情報を記述します。ヒアドキュメントですので、タグなども自由にお使いになれます。携帯へURLを転送したい場合は、『お使いの環境により変わります』の部分を書き換えて使用してください。
　パスワード入力欄が不要な場合は、の部分を削除してください。パスワード入力欄を削除した場合にチェッカーモードは使用するときは、 (http://wwwお使いの環境によって変わります/scm4.cgi?pass=kanri)などとタイプすることによって切り替えられます。

着メロを格納するフォルダ名$I_path、$J_pathはセキュリティ上変更してお使いになることをお勧めします。
尚、$dlcnt_file_headは、ダウンロードカウンタファイル名の頭の部分を変更した場合は、scm4_count.cgiのソースも書き換えて整合性をとる必要があります。

本ツールに関しまして、ご意見ご感想、是非追加したい機能などがございましたら、BBS及びメールでご連絡下さいませ。ありがたく考慮させていただきます。本ページトップに作者のサイトへのLINKがあります。