シンプル着メロサイトメーカー４ex

scm4ex_p.cgi取扱説明書

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

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

このバージョンではパスワードによる会員制のページも作成できます。

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

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

scm4.cgi

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

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

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

[scm4ex_p]
    │ scm4ex_p.cgi           CGI本体
    │ Folda_MIME_dev.txt     フォルダ定義用テキストファイル
    │ scm4_count.cgi         集計用CGI
    │ scm4_ranking2.cgi      ランキング表示用CGI
    │
    ├[html]
    │      time_up.html         パスワード通過以前のデフォルトページサンプル
    │      infomation.html      パスワード通過しないページサンプル１
    │      other_function.html パスワード通過しないページサンプル２
    │      p_top.html           パスワード通過後のトップページサンプル
    │      p_dl1.html           パスワード通過後のダウンロードページサンプル
    │      (会員用画面のhtmlはファイル名の頭にpを、それ以外はpを付けない)
    │
    ├[fig]
    │      graph.gif            ランキング表示用画像
    │      logo.gif             Web用サンプルロゴマーク
    │      logo.png             Web用サンプルロゴマーク
    │
    └[DLdata]
        ├[Imelo]
        │      Beyer60.mld      サンプル着メロ１(i-mode用)
        │      PsonataK545.mld サンプル着メロ２(i-mode用)
        │
        ├[Jmelo]
        │      Beyer60.mmf      サンプル着メロ１(16和音)
        │      PsonataK545.mmf サンプル着メロ２(16和音)
        │
        ├[MA3]
        │      Beyer60.mmf      サンプル着メロ１(40和音)
        │      PsonataK545.mmf サンプル着メロ２(40和音)
        │
        ├[Pmelo]
        │      Beyer60.mid      サンプル試聴用MIDI１(MIDI)
        │      PsonataK545.mid サンプル試聴用MIDI２(MIDI)
        │
        ├[gif]
        │      face.gif         サンプル画像１
        │
        └[png]
                face.png         サンプル画像２

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

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

ファイル名	パーミッション
scm4ex_p.cgi	755
scm4_count.cgi	755
scm4_ranking2.cgi	755
scm4ex_p.cgiのあるディレクトリ	777
その他のファイル	644

(3)　起動

Folda_MIME_dev.txt

# フォルダ名と、そこに書き込むデータの照合用のテキストファイルです。
#
# 左端に'#'が有る行はコメント行として無視しますので、メモ用にご利用下さい。
# データ区切りは半角スペースを利用して下さい。複数のスペースも一区切りとして
# 考えます。(なので携帯用表示用文字などは半角スペースを含めないで下さい。)
#
# フォルダ名は、scms4.cgiからの相対パスで指定してください。ただし、セキュリティ上フォルダ名を隠したい場合は、
# 各フォルダ名に共通の文字列を追加することによって、見つけにくい状態にしていただけます。
#
# PCでの試聴用のデータを置くフォルダは、拡張子欄にForEMBEDと入れて起き、
# MIDIもしくはMP3ファイルなどを置いてください。
#
# また、EzWebに直接ダウンロードする予定の無いものは、dispositionを、-にして下さい。
#
# 表示対象は半角小文字で隙間無しで、i:i-mode、v:Vodafone、w:EzWeb(WAP2.0)、h:EzWeb(HDML)の記号をご利用下さい。
# '-'とすればPC、'pi'とすればPCとi-modeのみの表示、'vw'とすればPCとVodafoneとEzWeb(WAP2.0)、'ivwh'とすれば全機種に
# リンクが表示されます。(ここにも半角ペースは入らないようにご注意下さい。)
#
# フォルダ名拡張子   携帯用表示用文字 MIMEタイプ          disposition 表示対象   PC用表示用文字
#------------*--------*-----------------*-------------------*------------*-------- *---------------
   Imelo     mld      [i-mode16和音]    application/x-mld   -            i         [i-mode16和音]
# m_02      mmf      [4和音メロ]       application/x-smaf dev4anm      vwh       [4和音メロ]
   Jmelo     mmf      [16和音メロ]      application/x-smaf devmfan      vwh       [16和音メロ]
# m_04      mmf      [32和音メロ]      application/x-smaf devm39z      vw        [32和音メロ]
# m_05      3g2      [着歌3GPP2]       audio/3gpp2         devmpzz      w         [着歌3GPP2]
# m_06      amc      [着歌MP3]         application/x-mpeg devdl1m      -         [着歌MP3]
# m_07      amc      [着歌QCELP]       application/x-mpeg devdl1q      vwh       [着歌QCELP]
   Pmelo     ForEMBED -                 -                   -            -         [試聴]
   png       png      [PNG画像]         image/x-png         dev8aww      vwh       [PNG画像]
   gif       gif      [GIF画像]         image/gif           devgi0z      iwh       [GIF画像]
# ani       gif      [アニメGIF]       image/gif           devga2z      iwh       [アニメGIF]
#------------*--------*-----------------*-------------------*------------*-------- *---------------
# http://www.au.kddi.com/ezfactory/tec/spec/ezmovie01.html
# http://www.au.kddi.com/ezfactory/tec/dlcgi/download_1.html
# http://www.au.kddi.com/ezfactory/tec/spec/4_2.html
# 等を参考にしておりますが、携帯実機で確認してみたのは
# i-mode用着メロ、16和音のみです。

いろいろごちゃごちゃ書いてありますが、プログラムで読み込んでいるのは桃色の5行のみで、後は全部コメント行です(消しちゃっても大丈夫)。要はダウンロードさせたいファイルの種類(disposition…dev値)の数だけフォルダを作って、必要な定義をして下さいということです。

PC用表示文字は押しボタン用の画像を使って、<IMG SRC="fig/pb02.gif" BORDER="0">などと置き換えると、幅が揃ってきれいな表示なると思います。宜しければダウンロードサイトのデモ等を参考になさってください。

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

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

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

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

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

<m>曲名,ファイル名(除:ファイルタイプ),作曲家やMIDI作者</m> ：ダウンロードさせたいファイルの情報

$access：アクセスカウンタの数値に置き換えられる(トップページのみ)。

$actime：前回アクセスタイムに置き換えられる(トップページのみ)。

<!-comcolor='#00ffff'-->作曲者/作者欄の色をページ毎に指定できるローカルルール(タグもどき)。

<!-title'着メロのページ'-->：ページタイトルを指定する。

<!-body'bgcolor="#ffffcc" text="#0000cc" link="#cc0000"'-->：背景色、文字色、LINK文字の色指定。(HDML機では無視されます)。

<a href="pass">会員画面へ</a>パスワード画面をCGI内から呼び出す。

<a href="http://www3.kcn.ne.jp/~tomate/scm4ex_p/scm4ex_p.cgi?page=pass">会員画面へ</a>

着メロページの元ページデータファイル　例) 普通のHTML形式に近い書き方も出来るようになりました。

<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,バイエル/とまて</m> 
明るくて軽快な曲です。 
<m>♪ピアノソナタK545,PsonataK545,モーツアルト/とまて</m> 
**************** 
<a href="k_top.html">[TOP]</a>
</body></html>

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

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

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

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

<html><head>
<title>着メロサイトDEMO</title>
</head>
<body bgcolor="#ffffcc" text="#0000aa" link="#880088">
<a href="k_top.html">[TOP]</a>
 
<center>************</center>
<center>携帯着メロサイトメイカー DEMO</center>
<center>************</center>
<center><img src="../fig/logo.png" alt="LOGO"></center>
LINKとテキストと画像のページはこんな感じで表示されます。 
<a href="k_melo1.html">◆着メロページへのLINK</a> 
<blink>BLINK</blink>タグは機種によって表示が異なります。 
<center>★★★★★★</center>
PC版サイト『とまての実験室』にてフリーウエアとして本CGI(scm4ex_p.cgi)配布中です 
http://www3.kcn.ne.jp/~tomate/ 
アクセスカウンタも付けられます。 
<center>♪$access♪</center>
$actime
</body></html>

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

scm4ex_p.cgiの調整項目

#############################################################
# ファイル名関連
$me='http://(ここはアップロード先のURL)/scm4ex_p.cgi'; # このCGIのファイル名(ファイル名を変えたときはここも書き換える必要有り)
$html ='html/'; # htmlの親ディレクトリ
$time_out ='time_up.html';# サイトTOPもしくはタイムアップ画面のファイル名
$top_page ='p_top.html'; # パスワード通過後画面のファイル名

# データディレクトリの親ディレクトリ
$datatop='DLdata/';

# ダウンロードファイルのフォルダ定義ファイル名
$Folda_MIME_dev="Folda_MIME_dev.txt";

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

# 閲覧者パスワード等管理
$a_pass_set=1234; # 閲覧者用パスワード
$pass_in_code='pass'; # パスワード画面の呼び出しコード
$idling=3600; # 前回アクセスから何秒たったらTOPに戻ってほしいか（タイムスタンプ有効期限）
$p_html_top='p'; # パスワードが必要な画面のhtmlファイル名の頭一文字(htmlのファイル名の最初一文字を揃えて、他のページと区別する。)

# ページタイトルのデフォルト
$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=3; # ダウンロードカウンタファイルの保存数(何か月分か？)
$pc_dnload=1; # PCへのダウンロードを許可する(1:許可，0:不許可)
$embed_log=0; # PCでのEMBED試聴もダウンロード回数に含める(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=パス付き着メロサイトのURLはこちら&body=$me?">
【携帯にこのサイトのURLを送信する】</A> 
<FORM ACTION="$me" METHOD="POST">
<DIV ALIGN="right">
<INPUT TYPE="hidden" NAME="page" VALUE="hyoujipage">
<INPUT TYPE="hidden" NAME="t" VALUE="hyoujit">
<INPUT TYPE="hidden" NAME="apass" VALUE="hyoujiapass">
管理人PASS <INPUT TYPE="password" NAME="pass" SIZE="10" MAXLENGTH="10"><INPUT TYPE="submit" NAME="send" VALUE="送信"> 
</DIV>
</FORM>
HIA

# EMBED演奏するファイルの拡張子からMIMEタイプを選択。EMBEDで試聴させたい全ての拡張子を登録する必要が有ります。
 %CTYPE =('mid', 'audio/midi' ,
 'mp3', 'audio/mpeg' );
#############################################################

scm4_count.cgiの調整項目

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

scm4_ranking2.cgiの調整項目

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

上記はscm4ex_p.cgi、scm4_count.cgi、scm4_ranking2.cgiのプログラムソース上部の数行です。
水色の部分はアップロード先のURLを書き込みます。
桃色の部分は動作チェック後、セキュリティ上変更を推奨します。
ここで出来ることは、

ファイル名関連
$meはscm4ex_p.cgiからscm4ex_p.cgiを呼び出すための物で、アップロード先の絶対アドレスで指定を推奨します。
$htmlは、scm4ex_p.cgiから呼び出すHTMLファイルを格納しているフォルダへの相対パスです。
$time_outは、パスワードやタイムスタンプ無しでアクセスするデフォルトのページです。サイトのトップページをCGI経由で表示させる場合はこのページをサイトトップに指定します。
CGIを経由しない普通のhtmlをサイトトップにしている場合は、タイムアップの場合のインフォメーションページを指定します。
$top_pageは、パスワード画面通過後一番最初に表示されるページの元ページデータファイル名です。通常TOPページ(INDEXページ)のファイルになるでしょう。上記$htmlからの相対パスで指定します。
$datatopダウンロードデータの親ディレクトリ名を指定
$Folda_MIME_devダウンロードデータのディレクトリ(フォルダ)情報を指定
管理人用のパスワード
$passset管理人用のパスワード(サイト内のLINK切れをヴィジュアルに表示しますので、着メロやページを増やした時に速やかに問題を解決します。)
閲覧者用パスワード関連
$a_pass_set閲覧者用のパスワード
$idling前回アクセスからのパスワード有効時間を秒単位で指定(1時間は3600)
$pass_in_codeパスワードを呼び出すときのページ名
アクセスログ関連
$access_logは、アクセスログを採るか採らないかの指定です。アクセスログを保存したい場合は1、不要な場合は0を指定します。
$access_maxは、アクセスログを何回分保存するかを指定します。多すぎるとアクセスが遅くなりますので、20以上200以下くらいが良いと思います。
$access_log_fileは、アクセスログを保存するファイル名です。パスやファイル名をサンプルと変更する場合はここを書き換えてください。CGIからの相対パスで指定します。

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