cafemilk @ ウィキ
http://w.atwiki.jp/cafemilk/
cafemilk @ ウィキ
ja
2010-10-23T20:16:17+09:00
1287832577
-
インストール その他
https://w.atwiki.jp/cafemilk/pages/23.html
*その他
-手っ取り早く本運用に進めるための情報です。
**ドメイントップを main.cgi にしたい
-通常ドメインのトップは index.html と相場が決まっていますが、サーバによってはアクセスコントロールファイル (.haccess) を用いるとドメイントップのファイル名を変更することができます。
-.haccess に記述する内容は以下の通りです。
>DirectoryIndex main.cgi
**CGI であることを隠蔽したい 1
-サーバによってはアクセスコントロールファイル (.haccess) を用いると、完全に隠蔽とはいきませんが、拡張子.cgiをなくした状態での運用が可能です。
-.haccess に記述する内容は以下の通りです。
><Files "main">
>ForceType cgi-script
></Files>
-これにあわせて設定を変更します。
-設定ファイルの位置は以下のようになります。
>&tt(){[Apache_server]}
>&tt(){ └ [cgi-bin]}
>&tt(){ └ [config]}
>&tt(){ └ [common]}
>&tt(){ └ config_common.pl}
-以下のように設定します。
> # CGI名
> # [通常]
> # $config->{path}{cgi} = 'main.cgi';
> # [拡張子を省略できる場合]
> # $config->{path}{cgi} = 'main';
> $config->{path}{cgi} = 'main';
-さらに main.cgi のファイル名を変更して拡張子を削除します。
--拡張子のつかないファイルの FTP 転送にはご注意ください。
--たいていの場合、手動にてテキスト転送を行う必要があります。
>&tt(){main}
**CGI であることを隠蔽したい 2
-さらに、PATH_INFO という仕組みを用いると、商品ページなど一部の URL から ? 表記をなくすことができます。
--PATH_INFO を用いた URL は例えば以下のように変化します。
>&tt(){Before : http://www.example.com/main.cgi?execute=item&item=cup_01}
>&tt(){After. : http://www.example.com/main/item/cup_01/}
-設定を変更します。
-設定ファイルの位置は以下のようになります。
>&tt(){[Apache_server]}
>&tt(){ └ [cgi-bin]}
>&tt(){ └ [config]}
>&tt(){ └ [common]}
>&tt(){ └ config_common.pl}
-以下のように設定します。
> # PATH_INFOモード
> # 通常は無効です。
> # [無効]
> # $config->{path_info} = '0';
> # [有効]
> # $config->{path_info} = '1';;
> $config->{path_info} = '1';
**スキンを製作したい
-手っ取り早くスキンを作成したい場合、標準スキンの HTML ソースを見ながら新しいスキンを作成し、差し替えるというやり方がよいでしょう。
--オリジナルの HTML ソースに、標準スキンから独自タグの移植を行うという作業となります。
-オリジナルのタグは <# .. #> で囲まれたタグです。
-オリジナルタグの一例は以下の通りです。
><form action='<##url_root##><#path_cgi#>' method='post' style=''>
-PC 用スキンは以下の 3 つのディレクトリにあります。
>&tt(){[Apache_server]}
>&tt(){ └ [cgi-bin]}
>&tt(){ └ [skin]}
>&tt(){ └ [user]}
>&tt(){ └ [cgi]}
>&tt(){ └ [default]}
>&tt(){ └ [web]}
>&tt(){ ├ [default]}
>&tt(){ │ └ [japanese]}
>&tt(){ │ └ [yen]}
>&tt(){ │ └ [default]}
>&tt(){ ├ [guest]}
>&tt(){ │ └ [japanese]}
>&tt(){ │ └ [yen]}
>&tt(){ │ └ [default]}
>&tt(){ └ [member]}
>&tt(){ └ [japanese]}
>&tt(){ └ [yen]}
>&tt(){ └ [default]}
-PC 用スキン用の画像等ファイルは以下の 3 つのディレクトリに置きます。
--スタイルシートはここにあります。
>&tt(){[Apache_server]}
>&tt(){ └ [public_html]}
>&tt(){ └ [skin]}
>&tt(){ └ [user]}
>&tt(){ └ [cgi]}
>&tt(){ └ [default]}
>&tt(){ └ [web]}
>&tt(){ ├ [default]}
>&tt(){ │ └ [japanese]}
>&tt(){ │ └ [yen]}
>&tt(){ │ └ [default]}
>&tt(){ ├ [guest]}
>&tt(){ │ └ [japanese]}
>&tt(){ │ └ [yen]}
>&tt(){ │ └ [default]}
>&tt(){ └ [member]}
>&tt(){ └ [japanese]}
>&tt(){ └ [yen]}
>&tt(){ └ [default]}
-携帯用スキンは以下の 3 つのディレクトリにあります。
>&tt(){[Apache_server]}
>&tt(){ └ [cgi-bin]}
>&tt(){ └ [skin]}
>&tt(){ └ [user]}
>&tt(){ └ [cgi]}
>&tt(){ └ [default]}
>&tt(){ └ [mobile]}
>&tt(){ ├ [default]}
>&tt(){ │ └ [japanese]}
>&tt(){ │ └ [yen]}
>&tt(){ │ └ [default]}
>&tt(){ ├ [guest]}
>&tt(){ │ └ [japanese]}
>&tt(){ │ └ [yen]}
>&tt(){ │ └ [default]}
>&tt(){ └ [member]}
>&tt(){ └ [japanese]}
>&tt(){ └ [yen]}
>&tt(){ └ [default]}
-携帯用スキン用の画像等ファイルは以下の 3 つのディレクトリに置きます。
>&tt(){[Apache_server]}
>&tt(){ └ [public_html]}
>&tt(){ └ [skin]}
>&tt(){ └ [user]}
>&tt(){ └ [cgi]}
>&tt(){ └ [default]}
>&tt(){ └ [mobile]}
>&tt(){ ├ [default]}
>&tt(){ │ └ [japanese]}
>&tt(){ │ └ [yen]}
>&tt(){ │ └ [default]}
>&tt(){ ├ [guest]}
>&tt(){ │ └ [japanese]}
>&tt(){ │ └ [yen]}
>&tt(){ │ └ [default]}
>&tt(){ └ [member]}
>&tt(){ └ [japanese]}
>&tt(){ └ [yen]}
>&tt(){ └ [default]}
-スキン内部にて画像ファイルを呼び出すタグは以下のようになります。
--画像ファイルのディレクトリ構造はスキンのディレクトリ構造に連動していますので、一致したディレクトリに画像を置く必要があります。
><img src='<##path_material##>hoge.jpg' border='0' width='100' height='100'>
-PC 用スキンのカート画面に表示される iframe による説明と規約の部分については新規に作成する必要があります。
-作成したものの適用が求められるスキンは以下の通りです。
>&tt(){[pin_user_cart_main_submit.html]}
-適用箇所は以下の部分です。
--dummy.html の部分を差し替えてください。
><div class='box_cart_main_menu_5'>
><br>
>購入手続にあたっての同意事項 :<br>
>たいへんお手数とはなりますが、ご購入の手続にあたっては、以下の規約と説明を閲覧し、その内容に同意ください。<br>
><iframe src='dummy.html' style='width:682px;height:400px;border:1px #DDDDDD solid;'></iframe>
></div>
><div style='clear:both;'>
></div>
//├└─│┌┐┘└├┬┤┴┼━┃┏┓┛┗┣┳┫┻╋
2010-10-23T20:16:17+09:00
1287832577
-
インストール ケース 2
https://w.atwiki.jp/cafemilk/pages/21.html
*ケース 2
-サーバ内構造が public_html と cgi-bin とに分かれておらず、CGI の設置ディレクトリと商品画像などの素材ディレクトリを別にする必要がない場合のインストール
1) 統合作業
-注意点
--バージョンアップの際に統合作業を行うと設定やデータベースといったものが消失することになります。
--設定ファイルのバージョンアップ更新が必要となった場合は差分を適用するようにしましょう。
-ダウンロードしたファイルの構造は(一部)こうなっています。
>&tt(){[Apache_server]}
>&tt(){ ├ [cgi-bin]}
>&tt(){ │ ├ [affiliate]}
>&tt(){ │ ├ [backup]}
>&tt(){ │ ├ [execute]}
>&tt(){ │ ├ [MIME]}
>&tt(){ │ ├ [other]}
>&tt(){ │ ├ [payment]}
>&tt(){ │ ├ [pl]}
>&tt(){ │ ├ [plugin]}
>&tt(){ │ ├ [record]}
>&tt(){ │ ├ [skin]}
>&tt(){ │ ├ main.cgi}
>&tt(){ │ └ rf.cgi}
>&tt(){ └ [public_html]}
>&tt(){[統合ファイル]}
>&tt(){ ├ [config]}
>&tt(){ ├ [database]}
>&tt(){ ├ [log]}
>&tt(){ ├ [mail]}
>&tt(){ └ [session]}
-ディレクトリ 統合ファイル の中身を cgi-bin にコピーします。
-その結果は(一部)このようになるはずです。
>&tt(){[Apache_server]}
>&tt(){ ├ [cgi-bin]}
>&tt(){ │ ├ [affiliate]}
>&tt(){ │ ├ [backup]}
>&tt(){ │ ├ [config]}
>&tt(){ │ ├ [database]}
>&tt(){ │ ├ [execute]}
>&tt(){ │ ├ [log]}
>&tt(){ │ ├ [MIME]}
>&tt(){ │ ├ [mail]}
>&tt(){ │ ├ [other]}
>&tt(){ │ ├ [payment]}
>&tt(){ │ ├ [pl]}
>&tt(){ │ ├ [plugin]}
>&tt(){ │ ├ [record]}
>&tt(){ │ ├ [session]}
>&tt(){ │ ├ [skin]}
>&tt(){ │ ├ main.cgi}
>&tt(){ │ └ rf.cgi}
>&tt(){ └ [public_html]}
-続いて AjaxZip 2.0 を統合します。
-統合先ディレクトリこちらです。
>&tt(){[Apache_server]}
>&tt(){ └ [public_html]}
>&tt(){ └ [skin]}
>&tt(){ └ [js]}
>&tt(){ └ [ajaxzip2]}
-統合すると(一部)このようになるはずです。
>&tt(){[ajaxzip2]}
>&tt(){ ├ [data]}
>&tt(){ ├ ajaxzip2.js}
>&tt(){ ├ jquery.js}
>&tt(){ └ prototype.js}
-続いて openWYSIWYG を統合します。
-統合先ディレクトリこちらです。
>&tt(){[Apache_server]}
>&tt(){ └ [public_html]}
>&tt(){ └ [skin]}
>&tt(){ └ [js]}
>&tt(){ └ [openwysiwyg]}
-統合すると(一部)このようになるはずです。
>&tt(){[openwysiwyg]}
>&tt(){ ├ [icons]}
>&tt(){ ├ [popups]}
>&tt(){ ├ [styles]}
>&tt(){ └ wysiwyg.js}
-phone.pl は本体に含まれているので統合の必要はありません。
-最新版が出た場合は差し替える必要があります。
-ディレクトリはこちらです。
>&tt(){[Apache_server]}
>&tt(){ └ [cgi-bin]}
>&tt(){ └ [pl]}
>&tt(){ └ [kawasaki]}
>&tt(){ └ phone.pl}
2) 設定
-cgi-bin 内にあるファイル群の設置は example.com の トップディレクトリに行うとします。
-これの URL はこのようになるでしょう。
>&tt(){http://www.example.com/}
-これを FTP 側から見ると public_html となるでしょう。
>&tt(){[public_html]}
-public_html 内にあるファイル群の設置は同様に example.com の shop ディレクトリに行うとします。
-これの URL はこのようになるでしょう。
>&tt(){http://www.example.com/shop/}
-これを FTP 側から見ると以下のようになるでしょう。
>&tt(){[public_html]}
>&tt(){ └ [shop]}
-以上の前提についてはサーバによって差異がありますので、趣旨をよく理解したうえで調整をはかってください。
-では設定ファイルを開きます。
--設定ファイルを開き編集するには UTF-8N 対応のエディタが必要です。
-設定ファイルの位置は以下のようになります。
>&tt(){[Apache_server]}
>&tt(){ └ [cgi-bin]}
>&tt(){ └ [config]}
>&tt(){ └ [common]}
>&tt(){ └ config_common.pl}
-設定ファイルの内容は以下のようになります。
>################################################################################
># #
># CAFEMILK SHOPPING CART V5 #
># SOHO WORKSHOP CAFEMILK 全権留保 #
># #
>################################################################################
># こちらはショップ管理者共通設定ファイルです。
># ショップはこちらに設定を書き込んでください。
># 設定の記述は Perl の規則に従って行ってください。そうしないと全く動作しなくなり
># ます。
>
>use utf8;
># use encoding "utf8";
>
>package Cartconfig;
>sub config_common
> {
> my $config = shift;
># ここからが設定部分です。これより上部は書き換えないでください。
>################################################################################
>## CONFIG BIGIN ##
>################################################################################
>
> # ● パス等の設定
>
> # CGI-BINからPUBLIC_HTMLへのURLのパス
> # これは、CGIのWEB出力によって呼び出されるファイル、
> # たとえばスタイルシートやJSファイルの所在を示すパスです。
> # WEB出力においてスタイルシートが呼び出されていない場合は調整が必要
> # です。
> # 通常はパスではなくURLを設定してください。
> # [例]
> # $config->{path}{cgi_to_html} = 'http://example.jp/shop/';
> $config->{path}{cgi_to_html} = 'http://localhost:7859/shop/';
>
> # CGI-BINからPUBLIC_HTMLへのLOCALのパス
> # これは、CGIが操作するファイル、
> # たとえば商品の画像をアップロードしたり参照したりする際に用いるパス
> # です。
> # これは$config->{path}{cgi_to_html}と整合している必要があります。
> # [LOCALにおいてcgi-bin/shop/main.cgiからpublic_html/shop/を参照し、
> # 一方でURLにおいてhttp://example.jp/cgi-bin/shop/main.cgiから
> # http://example.jp/shop/が参照されるシステムの場合]
> # $config->{path}{cgi_to_file} = '../../public_html/shop/';
> # [単にmain.cgiから./web/を参照する場合]
> # $config->{path}{cgi_to_file} = 'web/';
> $config->{path}{cgi_to_file} = '../../public_html/shop/';
>
> # main.cgiのあるURL
> # [例]
> # $config->{url}{root} = 'http://example.jp/cgi-bin/shop/';
> $config->{url}{root} = 'http://localhost:7859/cgi-bin/shop/';
>
> # main.cgiのあるSSLのURL
> # [例]
> # $config->{url}{sslroot} = 'https://example.jp/cgi-bin/shop/';
> # SSL専用のサーバがある場合などにおいて本製品はSSLで動作しないことが
> # あります。
> # [SSLを使用しない場合]
> # その場合は$config->{url}{root}と同じ値を設定します。
> # $config->{url}{sslroot} = 'http://example.jp/cgi-bin/shop/';
> $config->{url}{sslroot} = 'http://localhost:7859/cgi-bin/shop/';
>
> # 画像のあるURL
> # [例]
> # $config->{url}{imageroot} = 'https://example.jp/shop/';
> # 商品の画像をアップロードしても表示されない場合に調整が必要です。
> $config->{url}{imageroot} = 'http://localhost:7859/shop/';
>
> # CGI名
> # [通常]
> # $config->{path}{cgi} = 'main.cgi';
> # [拡張子を省略できる場合]
> # $config->{path}{cgi} = 'main';
> $config->{path}{cgi} = 'main.cgi';
>
> # PATH_INFOモード
> # 通常は無効です。
> # [無効]
> # $config->{path_info} = '0';
> # [有効]
> # $config->{path_info} = '1';;
> $config->{path_info} = '0';
>
> # ● カートの設定
>
> # 送料の方式
> # [無料]
> # $config->{mailing}{mode} = '0';
> # [固定]
> # $config->{mailing}{mode} = '1';
> # [都道府県]
> # $config->{mailing}{mode} = '2';
> # その他の方式にする場合はカスタマイズが必要です。
> $config->{mailing}{mode} = '2';
>
> # 固定送料
> # $config->{mailing}{mode} = '1'の場合の固定送料です。
> # [780円の場合]
> # $config->{mailing}{basic_cost} = '780';
> $config->{mailing}{basic_cost} = '780';
>
> # 都道府県送料
> # $config->{mailing}{mode} = '2'の場合の都道府県送料です。
> # [北海道が1050円の場合]
> # $config->{mailing}{prefecture_cost}[1] = '1050';
> # 数値と都道府県の対応は以下の通りです。
> # 0: [使用しません]
> # 1: 北海道
> # 2: 青森県
> # 3: 岩手県
> # 4: 宮城県
> # 5: 秋田県
> # 6: 山形県
> # 7: 福島県
> # 8: 茨城県
> # 9: 栃木県
> # 10: 群馬県
> # 11: 埼玉県
> # 12: 千葉県
> # 13: 東京都
> # 14: 神奈川県
> # 15: 新潟県
> # 16: 富山県
> # 17: 石川県
> # 18: 福井県
> # 19: 山梨県
> # 20: 長野県
> # 21: 岐阜県
> # 22: 静岡県
> # 23: 愛知県
> # 24: 三重県
> # 25: 滋賀県
> # 26: 京都府
> # 27: 大阪府
> # 28: 兵庫県
> # 29: 奈良県
> # 30: 和歌山県
> # 31: 鳥取県
> # 32: 島根県
> # 33: 岡山県
> # 34: 広島県
> # 35: 山口県
> # 36: 徳島県
> # 37: 香川県
> # 38: 愛媛県
> # 39: 高知県
> # 40: 福岡県
> # 41: 佐賀県
> # 52: 長崎県
> # 43: 熊本県
> # 44: 大分県
> # 45: 宮崎県
> # 46: 鹿児島県
> # 47: 沖縄県
> # 離島などに対応するにはカスタマイズが必要です。
> $config->{mailing}{prefecture_cost}[1] = '1050';
> $config->{mailing}{prefecture_cost}[2] = '1050';
> $config->{mailing}{prefecture_cost}[3] = '1050';
> $config->{mailing}{prefecture_cost}[4] = '1050';
> $config->{mailing}{prefecture_cost}[5] = '1050';
> $config->{mailing}{prefecture_cost}[6] = '1050';
> $config->{mailing}{prefecture_cost}[7] = '1050';
> $config->{mailing}{prefecture_cost}[8] = '1050';
> $config->{mailing}{prefecture_cost}[9] = '1050';
> $config->{mailing}{prefecture_cost}[10] = '1050';
> $config->{mailing}{prefecture_cost}[11] = '1050';
> $config->{mailing}{prefecture_cost}[12] = '1050';
> $config->{mailing}{prefecture_cost}[13] = '1050';
> $config->{mailing}{prefecture_cost}[14] = '1050';
> $config->{mailing}{prefecture_cost}[15] = '1050';
> $config->{mailing}{prefecture_cost}[16] = '1050';
> $config->{mailing}{prefecture_cost}[17] = '1050';
> $config->{mailing}{prefecture_cost}[18] = '1050';
> $config->{mailing}{prefecture_cost}[19] = '1050';
> $config->{mailing}{prefecture_cost}[20] = '1050';
> $config->{mailing}{prefecture_cost}[21] = '1050';
> $config->{mailing}{prefecture_cost}[22] = '1050';
> $config->{mailing}{prefecture_cost}[23] = '1050';
> $config->{mailing}{prefecture_cost}[24] = '1050';
> $config->{mailing}{prefecture_cost}[25] = '1050';
> $config->{mailing}{prefecture_cost}[26] = '1050';
> $config->{mailing}{prefecture_cost}[27] = '1050';
> $config->{mailing}{prefecture_cost}[28] = '1050';
> $config->{mailing}{prefecture_cost}[29] = '1050';
> $config->{mailing}{prefecture_cost}[30] = '1050';
> $config->{mailing}{prefecture_cost}[31] = '1050';
> $config->{mailing}{prefecture_cost}[32] = '1050';
> $config->{mailing}{prefecture_cost}[33] = '1050';
> $config->{mailing}{prefecture_cost}[34] = '1050';
> $config->{mailing}{prefecture_cost}[35] = '1050';
> $config->{mailing}{prefecture_cost}[36] = '1050';
> $config->{mailing}{prefecture_cost}[37] = '1050';
> $config->{mailing}{prefecture_cost}[38] = '1050';
> $config->{mailing}{prefecture_cost}[39] = '1050';
> $config->{mailing}{prefecture_cost}[40] = '1050';
> $config->{mailing}{prefecture_cost}[41] = '1050';
> $config->{mailing}{prefecture_cost}[42] = '1050';
> $config->{mailing}{prefecture_cost}[43] = '1050';
> $config->{mailing}{prefecture_cost}[44] = '1050';
> $config->{mailing}{prefecture_cost}[45] = '1050';
> $config->{mailing}{prefecture_cost}[46] = '1050';
> $config->{mailing}{prefecture_cost}[47] = '1050';
>
> # 送料無料購入額
> # $config->{mailing}{mode} = '1'もしくは'2'の場合、一定額購入時に送
> # 料無料とすることができます。その場合の購入額を入力してください。
> # [無効にする場合]
> # $config->{mailing}{free_cost} = '0';
> # [10,000円にする場合]
> # $config->{mailing}{free_cost} = '10000';
> $config->{mailing}{free_cost} = '10000';
>
> # 有効にする決済のID
> # 決済処理はモジュールによって実施されます。そのIDを指定してください。
> # 新規に決済を追加するにはモジュールの作成が必要です。
> # [代引決済を有効にする場合]
> # $config->{payment}{id_list} = ['delivery_collect'];
> # [ZEUS決済を追加する場合]
> # $config->{payment}{id_list} = ['delivery_collect','zeus'];
> # 利用できるIDは以下の通りです。
> # delivery_collect : 代金引換
> # bank_transfer : 銀行振込
> # postal_transfer : 郵便払込
> # zeus : ZEUS決済 Link Point 方式
> # ※ ZEUS決済の他の方式について導入されるショップは開発元までご相談
> # ください。
> $config->{payment}{id_list} = ['delivery_collect','bank_transfer','postal_transfer','zeus'];
>
> # お知らせ
> # 弊社製品を利用されるショップはぜひZEUSクレジットカード決済をご導入
> # ください。また、導入にあたっては、有利なプランを用意しておりますの
> # で、ぜひ弊社サイト内にある資料請求専用ページから資料請求を行ってく
> # ださい。
>
> # ZEUS加盟店IPコード
> # [例]
> # $config->{payment}{zeus}{ip} = '91197';
> $config->{payment}{zeus}{ip} = '';
>
> # 代引手数料テーブル
> # 代引手数料を動的に計算するためのテーブルです。
> # 代引手数料は支払金額(小計ではなく合計)から算出されます。
> # table_1が支払金額、table_2が手数料額です。
> # 各設定値は税込みの値となります。
> # カードの手数料は計上しません。計上するにはカスタマイズが必要です。
> # [ヤマトグループの手数料を計上する場合]
> # $config->{payment}{delivery_collect}{table_1} = ['9999','29999','99999','300000'];
> # $config->{payment}{delivery_collect}{table_2} = [ '315', '420', '630', '1050'];
> # [佐川急便の手数料を計上する場合]
> # $config->{payment}{delivery_collect}{table_1} = ['10000','30000','100000','300000','500000','1000000','1000000000'];
> # $config->{payment}{delivery_collect}{table_2} = [ '315', '420', '630', '1050' , '2100', '3150', '4200'];
> # [手数料を無料とする場合]
> # $config->{payment}{delivery_collect}{table_1} = ['1000000000'];
> # $config->{payment}{delivery_collect}{table_2} = [ '0'];
> $config->{payment}{delivery_collect}{table_1} = ['9999','29999','99999','300000'];
> $config->{payment}{delivery_collect}{table_2} = [ '315', '420', '630', '1050'];
>
> # 内税率
> # 内税額を計算するための税率です。
> # [5%である場合]
> # $config->{tax}{inclusive}{rate} = '5';
> $config->{tax}{inclusive}{rate} = '5';
>
> # お知らせ
> # 弊社製品を利用されるショップはぜひa8.netアフィリエイトをご導入くだ
> # さい。問い合わせと申し込み手続きは弊社サイトから行うことができます。
>
> # A8.netのプログラムID
> # [A8.netと契約していない場合]
> # $config->{affiliate}{a8}{pid} = '';
> $config->{affiliate}{a8}{pid} = '';
>
> # ● メールの設定
>
> # SENDMAILのパス
> # プロバイダの指示にしたがう値を入力してください。
> # [例]
> # $config->{sendmail}{path} = '/usr/sbin/sendmail';
> $config->{sendmail}{path} = '/usr/sbin/sendmail';
>
> # FORMアドレス
> # 自動送信メールの送信元アドレスです。
> # [例]
> # $config->{sendmail}{address}{shop}{from}[0] = 'shop@example.jp';
> $config->{sendmail}{address}{shop}{from}[0] = 'a-c@zpost.plala.or.jp';
>
> # TO アドレス
> # ショップ向け自動送信メールの送信先アドレスです。
> # 連番による複数設定ができます。
> # [例]
> # $config->{sendmail}{address}{shop}{to}[0] = 'shop@example.jp';
> $config->{sendmail}{address}{shop}{to}[0] = 'a-c@zpost.plala.or.jp';
> $config->{sendmail}{address}{shop}{to}[1] = 'cafemilk@xkf.milkcafe.to';
>
> # RETURN アドレス
> # 不達メールの転送先アドレスです。
> # [例]
> # $config->{sendmail}{address}{shop}{return}[0] = 'return@example.jp';
> $config->{sendmail}{address}{shop}{return}[0] = 'a-c@zpost.plala.or.jp';
>
> # ALERT アドレス
> # ショップの動作に問題があった場合の自動送信メールの送信先アドレスで
> # す。
> # 通常は動作しませんが、設定は行ってください。
> # [例]
> # $config->{sendmail}{address}{shop}{alert}[0] = 'alert@example.jp';
> $config->{sendmail}{address}{shop}{alert}[0] = 'a-c@zpost.plala.or.jp';
>
> # 配信 アドレス
> # 会員にメール配信をする際のFROMアドレスです。
> # [例]
> # $config->{sendmail}{address}{shop}{mail_delivery} = 'magazine@example.jp';
> $config->{sendmail}{address}{shop}{mail_delivery} = 'a-c@zpost.plala.or.jp';
>
> # ● ポイントの設定
>
> # ポイント機能
> # [有効]
> # $config->{point}{mode} = '1';
> # [無効]
> # $config->{point}{mode} = '0';
> $config->{point}{mode} = '1';
>
> # ポイントの有効日数
> # [例]
> # $config->{point}{expire_days} = '100';
> $config->{point}{expire_days} = '100';
>
> # ポイントの加算率
> # [5%である場合]
> # $config->{point}{rate} = '5';
> $config->{point}{rate} = '5';
>
> # ● その他の設定
>
> # 商品の監視モード
> # 商品の監視は、商品の売れすぎを監視して売れすぎる商品の販売を自動的に停
> # 止する機能です。一度にあまりに注文が殺到すると困るショップや、価格入力
> # ミスによる混乱を予防したいショップは有効にしてください。
> # [有効]
> # $config->{item}{guard} = '1';
> # [無効]
> # $config->{item}{guard} = '0';
> $config->{item}{guard} = '1';
>
>################################################################################
>## CONFIG END ##
>################################################################################
># ここまでが設定部分です。これより下部は書き換えないでください。
> }
>1;
-「CGI-BINからPUBLIC_HTMLへのURLのパス」を設定します。
> # CGI-BINからPUBLIC_HTMLへのURLのパス
> # これは、CGIのWEB出力によって呼び出されるファイル、
> # たとえばスタイルシートやJSファイルの所在を示すパスです。
> # WEB出力においてスタイルシートが呼び出されていない場合は調整が必要
> # です。
> # 通常はパスではなくURLを設定してください。
> # [例]
> # $config->{path}{cgi_to_html} = 'http://example.jp/shop/';
> $config->{path}{cgi_to_html} = 'http://www.example.com/shop/';
-「CGI-BINからPUBLIC_HTMLへのLOCALのパス」を設定します。
> # CGI-BINからPUBLIC_HTMLへのLOCALのパス
> # これは、CGIが操作するファイル、
> # たとえば商品の画像をアップロードしたり参照したりする際に用いるパス
> # です。
> # これは$config->{path}{cgi_to_html}と整合している必要があります。
> # [LOCALにおいてcgi-bin/shop/main.cgiからpublic_html/shop/を参照し、
> # 一方でURLにおいてhttp://example.jp/cgi-bin/shop/main.cgiから
> # http://example.jp/shop/が参照されるシステムの場合]
> # $config->{path}{cgi_to_file} = '../../public_html/shop/';
> # [単にmain.cgiから./web/を参照する場合]
> # $config->{path}{cgi_to_file} = 'web/';
> $config->{path}{cgi_to_file} = './shop/';
-「main.cgiのあるURL」を設定します。
--SSLを使用しない場合
> # main.cgiのあるURL
> # [例]
> # $config->{url}{root} = 'http://example.jp/cgi-bin/shop/';
> $config->{url}{root} = 'http://www.example.com/';
>
> # main.cgiのあるSSLのURL
> # [例]
> # $config->{url}{sslroot} = 'https://example.jp/cgi-bin/shop/';
> # SSL専用のサーバがある場合などにおいて本製品はSSLで動作しないことが
> # あります。
> # [SSLを使用しない場合]
> # その場合は$config->{url}{root}と同じ値を設定します。
> # $config->{url}{sslroot} = 'http://example.jp/cgi-bin/shop/';
> $config->{url}{sslroot} = 'http://www.example.com/';
-「画像のあるURL」を設定します。
> # 画像のあるURL
> # [例]
> # $config->{url}{imageroot} = 'https://example.jp/shop/';
> # 商品の画像をアップロードしても表示されない場合に調整が必要です。
> $config->{url}{imageroot} = 'http://www.example.com/shop/';
-「SENDMAILのパス」を設定します。
--パスはサーバによって異なります。プロバイダのサポート文書等を参照してください。
> # SENDMAILのパス
> # プロバイダの指示にしたがう値を入力してください。
> # [例]
> # $config->{sendmail}{path} = '/usr/sbin/sendmail';
> $config->{sendmail}{path} = '/usr/sbin/sendmail';
-ほかにも設定はありますがインストールに必要な作業は以上になります。
--可能ならメールアドレスの設定もこの時に済ませておくことができるでしょう。
3) PERL のパスの書き換え
-CGI の PERL のパスを書き換えます。
--CGI ファイルを開き編集するには UTF-8N 対応のエディタが必要です。
--パスはサーバによって異なります。プロバイダのサポート文書等を参照してください。
-書き換えるファイルは以下の通りとなります。
>&tt(){[Apache_server]}
>&tt(){ └ [cgi-bin]}
>&tt(){ ├ main.cgi}
>&tt(){ └ rf.cgi}
-書き換えるのは冒頭の一行です。
>#!/user/bin/perl
4) FTP でのアップロード
-以上の内容を FTP にてアップロードします。
--アップロードには UTF-8 転送に対応した FTP クライアントが必要です。
--アップロード先は設定したパスの値と一致していなければなりません。
-転送先ディレクトリ public_html には 転送元ディレクトリ public_html の中身をアップロードします。
--転送先ディレクトリ public_html に 転送元ディレクトリ public_html をそのディレクトリごとアップロードしてはなりません。
-転送先ディレクトリ shop には 転送元ディレクトリ cgi-bin の中身をアップロードします。
--転送先ディレクトリ shop に 転送元ディレクトリ cgi-bin をそのディレクトリごとアップロードしてはなりません。
-以下の CGI のパーミッションを 755 にします。
>&tt(){[public_html]}
>&tt(){ ├ main.cgi}
>&tt(){ └ rf.cgi}
-以下のディレクトリのパーミッションを 666 にします。
>&tt(){[public_html]}
>&tt(){ ├ [backup]}
>&tt(){ ├ [database]}
>&tt(){ ├ [log]}
>&tt(){ ├ [mail]}
>&tt(){ └ [session]}
5) 動作確認
-ブラウザにてアクセスを行い、動作することを確認します。
-アクセスする URL はこのようになるはずです。
>&tt(){http://www.example.com/main.cgi}
6) openWYSIWYG の設定
-openWYSIWYG の設定のために以下のファイルを開いてください。
>&tt(){wysiwyg.js}
-wysiwyg.js のあるディレクトは以下の通りです。
>&tt(){[Apache_server]}
>&tt(){ └ [public_html]}
>&tt(){ └ [skin]}
>&tt(){ └ [js]}
>&tt(){ └ [openwysiwyg]}
-以下の設定を参考にして設定してください。
>imagesDir = "http://www.example.com/shop/skin/js/openwysiwyg/icons/";
>cssDir = "http://www.example.com/shop/skin/js/openwysiwyg/styles/";
>popupsDir = "http://www.example.com/shop/skin/js/openwysiwyg/popups/";
>wysiwygWidth = 466;
>wysiwygHeight = 300;
//├└─│┌┐┘└├┬┤┴┼━┃┏┓┛┗┣┳┫┻╋
2010-05-28T11:14:54+09:00
1275012894
-
データベース ログデータベース
https://w.atwiki.jp/cafemilk/pages/32.html
*ログデータベース
-CAFEMILK SHOPIING CART V5 ではカンマ区切りCSV形式のデータベースを用います。
--文字コードは UTF-8N となります。
--エクセルの書式に対応しています。
-データベース運用の方法は用途に合わせて基本データベースとログデータベースの二種類があります。
-データベース関連の処理はフレームワークとなっていますので、カスタマイズ時の実装作業が楽です。
--レコードの各項目は SQL のようにカラム名をつけて操作することができ、効率的です。
-独自仕様であるため、SQL に常態化しているようなデータベースインジェクション脆弱性の危険がありません。
**ログデータベースの概要
-ログデータベースは、レコードを収めた10のファイルとそのカラム名を収めたファイルの11ファイルからなるデータベースを運用する形態となります。
--レコードは古くなると消えます。(ログローテンションします。)
--Flock を用いてロックすることはしません。
--ログデータベースでは書き込みは追記しかできません。
-ログデータベースを扱うモジュールのファイル名は以下の通りです。
>&tt(){cafemilk_database_log.pl}
-cafemilk_database_log.pl のあるディレクトリは以下の通りです。
>&tt(){[Apache_server]}
>&tt(){ └ [cgi-bin]}
>&tt(){ └ [pl]}
-ログデータベースの扱うデータベースのファイルは例えば以下の通りです。
>&tt(){item_news.0.log.csv.cgi : 新着商品のレコード0}
>&tt(){item_news.1.log.csv.cgi : 新着商品のレコード1}
>&tt(){item_news.2.log.csv.cgi : 新着商品のレコード2}
>&tt(){item_news.3.log.csv.cgi : 新着商品のレコード3}
>&tt(){item_news.4.log.csv.cgi : 新着商品のレコード4}
>&tt(){item_news.5.log.csv.cgi : 新着商品のレコード5}
>&tt(){item_news.6.log.csv.cgi : 新着商品のレコード6}
>&tt(){item_news.7.log.csv.cgi : 新着商品のレコード7}
>&tt(){item_news.8.log.csv.cgi : 新着商品のレコード8}
>&tt(){item_news.9.log.csv.cgi : 新着商品のレコード9}
>&tt(){item_column_list.csv... : 新着商品のカラム名}
-データベースは標準にてセーフモードで運用されます。
--パーミッションファイルのないディレクトにあるデータベースの読み書きはできません。
-標準のセーフモードは以下のように指定されています。
>$config->{database}{safety} = '1';
-$config->{database}{safety} を設定しているファイルは以下の通りです。
>&tt(){[Apache_server]}
>&tt(){ └ [cgi-bin]}
>&tt(){ └ [config]}
>&tt(){ └ [admin]}
>&tt(){ └ config_basic.pl}
-セーフモードにて要求されるパーミッションファイルは以下の通りです。
--ファイルの内容は何でもかまいせん。
>&tt(){[permit_database_connect.txt]}
**ログデータベースの操作のサンプル
-以下は、ログを追記する場合のサンプルとなります。
>>まずはデータベース接続
>my $log_database = Cafemilk_database_log->connect
> ({
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
> column_filename => 'log/access_log_column_list.csv',
> column_separator => ',',
> database_filename => 'log/access_log',
> database_separator => ',',
> record_stack => $config->{database}{log_stack}{common},
> });
>>ログとして書き込む内容の作成
>my $error = "@{$log_error}";
>my $alert = "@{$log_alert}";
>$error =~ s/\x0D\x0A|\x0D|\x0A//g;
>$alert =~ s/\x0D\x0A|\x0D|\x0A//g;
>my %records =
> (
> id => $userdata->{'time'},
> time => $userdata->{'time'},
> admin_name => $userdata->{admin_registry_values}{admin_name},
> user_name => $userdata->{user_registry_values}{user_name},
> execute => $userdata->{request_values}{execute}[0],
> ip_address => $ENV{'REMOTE_ADDR'},
> referer => $ENV{'HTTP_REFERER'},
> # post => $ENV{'CONTENT_LENGTH'},
> # get => $ENV{'QUERY_STRING'},
> # cookie => $ENV{'HTTP_COOKIE'},
> # error => $error,
> # alert => $alert,
> );
>>追記
>$log_database->postscript(\%records);
>>終了処理
>undef $log_database;
-以下は、最後のレコードを取得する場合のサンプルとなります。
>my $database = Cafemilk_database_log->connect
> ({
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
> column_filename => 'database/forum_thread_column_list.csv',
> column_separator => ',',
> database_filename => 'database/admin_forum_thread',
> database_separator => ',',
> record_stack => $config->{database}{session_stack}{admin_forum}{thread},
> });
>>条件に合う最後のレコードを取得
>my $extract_database = $database->extract_last_record
> ({
> extract_column_name => 'thread_id',
> extract_column_value => $message_values{thread_id},
> });
>>%thread_values にレコードのカラム名と値を格納
>%thread_values = $database->get_values_argument
> ({
> database_values => $extract_database,
> });
>undef $database;
-以下は、最後のレコードを取得して内容を修正し、追記する場合のサンプルとなります。
>my $database = Cafemilk_database_log->connect
> ({
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
> column_filename => 'log/sale_count_column_list.csv',
> column_separator => ',',
> database_filename => 'log/sale_count',
> database_separator => ',',
> record_stack => 10,
> });
>my $extract_database = $database->extract_last_record
> ({
> extract_column_name => 'dummy',
> extract_column_value => 'count',
> });
>>%count_values にレコードのカラム名と値を格納
>my %count_values = $database->get_values_argument
> ({
> database_values => $extract_database,
> });
>>%count_values の変更
>$count_values{count} ++;
>$status->{sale_count} = $count_values{count};
>$count_values{id} = $userdata->{'time'};
>$count_values{time} = $userdata->{'time'};
>$count_values{dummy} = 'count';
>>追記
>$database->postscript(\%count_values);
>undef $database;
-以下は、データベスーから特定の条件に合うレコード(複数)を抽出して、抽出された各レコードを順次処理していく場合のサンプルとなります。
>>まずはデータベース接続
>my $database = Cafemilk_database_log->connect
> ({
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
> column_filename => 'database/item_column_list.csv',
> column_separator => ',',
> database_filename => 'database/item_news',
> database_separator => ',',
> record_stack => $config->{database}{session_stack}{item}{news},
> });
>>全レコードの読み込み
>$database->get_record_all();
>>追記により重複しているレコードを最新のものを除いて削除
>$database->merge_database
> ({
> column_name => 'item_id',
> });
>>完全一致カラム抽出処理
>my $target = 'multiprice';
>$database->match_database
> ({
> column_name => 'item_type',
> match_word => $target,
> });
>>検索文字列の用意
>>文字列はスペース区切りで AND 検索となる
>my $words = $input_values{'search'};
>$words = Cafemilk_basic::decode_escape
> ({
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
> text => $words,
> });
>>検索の対象となるカラムの指定
>my @columns =
> (
> "item_id",
> "name_$userdata->{language_type}",
> "text_1_$userdata->{language_type}",
> "text_2_$userdata->{language_type}",
> "manufacturer_$userdata->{language_type}",
> "table_value_1_$userdata->{language_type}",
> "table_value_2_$userdata->{language_type}",
> "table_value_3_$userdata->{language_type}",
> "table_value_4_$userdata->{language_type}",
> "option_name_1_$userdata->{language_type}",
> "option_name_2_$userdata->{language_type}",
> "option_name_3_$userdata->{language_type}",
> );
>>検索実行
>$database->search_database
> ({
> search_column => \@columns,
> search_words => $words,
>>英字の大文字と小文字の区別
>>1 でしない
> character_mode => '1',
> });
>>並び替え処理
>$database->sort_database
> ({
> column_name => "price_main_$userdata->{currency_type}",
>>逆順処理
>>1 で逆順
> reverse_mode => '0',
>>並び替えモード
>>number_quick で数値モード
>>character_quick で文字モード
> sort_mode => 'number_quick',
> });
>>抽出・検索・並び替えされたレコードを取得
>my @lines = $database->get_extract_database();
>>レコード処理
>foreach (@lines)
> {
> my $line = $_;
>>レコードの分割とカラム名との関連づけ
> my %target_values = $database->get_values_argument
> ({
> database_values => $line,
> });
>>ここで例えばレコードの内容の表示処理を行う
> print $target_values{item_id};
> }
>>終了処理
>undef $database;
2009-11-02T18:10:02+09:00
1257153002
-
メニュー
https://w.atwiki.jp/cafemilk/pages/2.html
**メニュー
-[[トップページ]]
----
-[[製品の位置づけ]]
-[[製品の概要]]
-[[動作環境]]
-[[ダウンロード]]
-[[インストール 1>インストール ケース 1]]
-[[インストール 2>インストール ケース 2]]
-[[インストール 3>インストール 初期作業]]
-[[インストール 4>インストール その他]]
-[[バージョンアップ>インストール バージョンアップ]]
----
-[[基本エンジン>仕様 基本エンジン]]
-[[exeute 型プラグイン>プラグイン exeute 型]]
-[[plugin 型プラグイン>プラグイン plugin 型]]
-[[その他のプラグイン>プラグイン その他]]
-[[スキンの概要>スキン 概要]]
-[[テンプレートエンジン>スキン テンプレートエンジン]]
-[[基本データベース>データベース 基本データベース]]
-[[ログデータベース>データベース ログデータベース]]
// **管理作業用
// -[[@wikiご利用ガイド>>http://atwiki.jp/guide/]]
// -[[プラグイン紹介>プラグイン]]
// -[[まとめサイト作成支援ツール]]
&link_editmenu(text=ここを編集)
2009-10-26T17:17:53+09:00
1256545073
-
トップページ
https://w.atwiki.jp/cafemilk/pages/1.html
*CAFEMILK SHOPPING CART V5
-スキン＆プラグイン方式でカスタマイズが簡単＆自由な CAFEMILK SHOPPING CART V5 製品
-ここでは、製品についての種々の情報をまとめたり蓄積したりしています。
--公式の情報より圧倒的に詳しい内容です。
--内容については無責任・無保証です。あらかじめご承知おきください。
**バージョン
- 現在のバージョン - V5.1.6.R2
**基本
-[[製品の位置づけ]]
-[[製品の概要]]
-[[動作環境]]
-[[ダウンロード]]
-インストール
--[[ケース 1>インストール ケース 1]]
--[[ケース 2>インストール ケース 2]]
--[[初期作業>インストール 初期作業]]
--[[その他>インストール その他]]
--[[バージョンアップ>インストール バージョンアップ]]
**仕様
-[[基本エンジン>仕様 基本エンジン]]
-プラグイン
--[[exeute 型>プラグイン exeute 型]]
--[[plugin 型>プラグイン plugin 型]]
--[[その他>プラグイン その他]]
-スキン
--[[概要>スキン 概要]]
--[[テンプレートエンジン>スキン テンプレートエンジン]]
-データベース
--[[基本データベース>データベース 基本データベース]]
--[[ログデータベース>データベース ログデータベース]]
//-ツール
//-セキュリティ
**リンク
-公式
--[[公式ホーム>http://cafemilk.milkcafe.to/]]
//--[[更新情報など>http://cafemilk.milkcafe.to/v5forum/wforum.cgi?mode=newsort&page=0]]
//-そのほか
//--[[ショッピングカート比較>http://procart.web.fc2.com/]]
//**２ちゃんねる
//-[[現行スレ>http://pc11.2ch.net/test/read.cgi/php/1246680239/]]
//-[[テンプレ]]
//-発言集
//--[[有用な発言]]
//--[[ネタ]]
2009-10-26T17:10:09+09:00
1256544609
-
データベース 基本データベース
https://w.atwiki.jp/cafemilk/pages/31.html
*基本データベース
-CAFEMILK SHOPIING CART V5 ではカンマ区切りCSV形式のデータベースを用います。
--文字コードは UTF-8N となります。
--エクセルの書式に対応しています。
-データベース運用の方法は用途に合わせて基本データベースとログデータベースの二種類があります。
-データベース関連の処理はフレームワークとなっていますので、カスタマイズ時の実装作業が楽です。
--レコードの各項目は SQL のようにカラム名をつけて操作することができ、効率的です。
-独自仕様であるため、SQL に常態化しているようなデータベースインジェクション脆弱性の危険がありません。
**基本データベースの概要
-基本データベースは、レコードを収めた1つのファイルとそのカラム名を収めたファイルの2ファイルからなるデータベースを運用する形態となります。
--レコードは古くなっても消えません。(ログローテンションしません。)
--Flock を用いてロックすることができます。
-基本データベースを扱うモジュールのファイル名は以下の通りです。
>&tt(){cafemilk_database_basic.pl}
-cafemilk_database_basic.pl のあるディレクトリは以下の通りです。
>&tt(){[Apache_server]}
>&tt(){ └ [cgi-bin]}
>&tt(){ └ [pl]}
-基本データベースの扱うデータベースのファイルは例えば以下の通りです。
>&tt(){item.csv.cgi........ : 商品データベースのレコード}
>&tt(){item_column_list.csv : 商品データベースのカラム名}
-データベースは標準にてセーフモードで運用されます。
--パーミッションファイルのないディレクトにあるデータベースの読み書きはできません。
-標準のセーフモードは以下のように指定されています。
>$config->{database}{safety} = '1';
-$config->{database}{safety} を設定しているファイルは以下の通りです。
>&tt(){[Apache_server]}
>&tt(){ └ [cgi-bin]}
>&tt(){ └ [config]}
>&tt(){ └ [admin]}
>&tt(){ └ config_basic.pl}
-セーフモードにて要求されるパーミッションファイルは以下の通りです。
--ファイルの内容は何でもかまいせん。
>&tt(){[permit_database_connect.txt]}
**基本データベースの操作のサンプル
-以下は、データベスーから特定の条件に合うレコード(複数)を抽出して、抽出された各レコードを順次処理していく場合のサンプルとなります。
>>まずはデータベース接続
>my $database = Cafemilk_database_basic->connect
> ({
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
>>カラム名の所在の指定
> column_filename => 'database/item_column_list.csv',
>>カラム名の区切りコードを指定
>>値はカンマ固定
> column_separator => ',',
>>レコードの所在の指定
> database_filename => 'database/item.csv.cgi',
>>レコードの区切りコードを指定
>>値はカンマ固定
> database_separator => ',',
>>接続モード
> database_mode => '+<',
>>Flockの設定
>>ロックするときは '2' とする
> database_flock => '2',
> });
>>全レコードの読み込み
>$database->get_record_all();
>>完全一致カラム抽出処理
>my $target = 'multiprice';
>$database->match_database
> ({
> column_name => 'item_type',
> match_word => $target,
> });
>>検索文字列の用意
>>文字列はスペース区切りで AND 検索となる
>my $words = $input_values{'search'};
>$words = Cafemilk_basic::decode_escape
> ({
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
> text => $words,
> });
>>検索の対象となるカラムの指定
>my @columns =
> (
> "item_id",
> "name_$userdata->{language_type}",
> "text_1_$userdata->{language_type}",
> "text_2_$userdata->{language_type}",
> "manufacturer_$userdata->{language_type}",
> "table_value_1_$userdata->{language_type}",
> "table_value_2_$userdata->{language_type}",
> "table_value_3_$userdata->{language_type}",
> "table_value_4_$userdata->{language_type}",
> "option_name_1_$userdata->{language_type}",
> "option_name_2_$userdata->{language_type}",
> "option_name_3_$userdata->{language_type}",
> );
>>検索実行
>$database->search_database
> ({
> search_column => \@columns,
> search_words => $words,
>>英字の大文字と小文字の区別
>>1 でしない
> character_mode => '1',
> });
>>並び替え処理
>$database->sort_database
> ({
> column_name => "price_main_$userdata->{currency_type}",
>>逆順処理
>>1 で逆順
> reverse_mode => '0',
>>並び替えモード
>>number_quick で数値モード
>>character_quick で文字モード
> sort_mode => 'number_quick',
> });
>>抽出・検索・並び替えされたレコードを取得
>my @lines = $database->get_extract_database();
>>レコード処理
>foreach (@lines)
> {
> my $line = $_;
>>レコードの分割とカラム名との関連づけ
> my %target_values = $database->get_values_argument
> ({
> database_values => $line,
> });
>>ここで例えばレコードの内容の表示処理を行う
> print $target_values{item_id};
> }
>>終了処理
>undef $database;
-以下は、データベスーから特定の条件に合うレコード(単数)を抽出して、レコードを書き換える場合のサンプルとなります。
>my $database = Cafemilk_database_basic->connect
> ({
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
> column_filename => 'database/item_column_list.csv',
> column_separator => ',',
> database_filename => 'database/item.csv.cgi',
> database_separator => ',',
> database_mode => '+<',
> database_flock => '2',
> });
>$database->get_record_all();
>>商品コード 'hoge' のレコード(単独)を抽出
>my $extract_database = $database->extract_last_record
> ({
> extract_column_name => 'item_id',
> extract_column_value => 'hoge',
> });
>>レコードの分割とカラム名との関連づけ
>my %record = $database->get_values_argument
> ({
> database_values => $extract_database,
> });
>>ここで例えば商品の販売数を更新
>$record{sales_quantity} ++;
>>レコードの差し替え
>$database->replace_record
> ({
> extract_column_name => 'item_id',
> extract_column_value => 'hoge',
> records => \%record,
> });
>>上書き
>$database->overwrite();
>undef $database;
-以下は、特定の条件に合うレコードを削除する場合のサンプルとなります。
>my $database = Cafemilk_database_basic->connect
> ({
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
> column_filename => 'database/item_column_list.csv',
> column_separator => ',',
> database_filename => 'database/item.csv.cgi',
> database_separator => ',',
> database_mode => '+<',
> database_flock => '2',
> });
>$database->get_record_all();
>>商品コード 'hoge' のレコード(単独)を削除
>$database->delete_record
> ({
> extract_column_name => 'item_id',
> extract_column_value => 'hoge',
> });
>>上書き
>$database->overwrite();
>undef $database;
-以下は、レコードを追記する場合のサンプルとなります。
--追記を行う場合、get_record_all() や overwrite() は必要ありません。
>my $database = Cafemilk_database_basic->connect
> ({
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
> column_filename => 'database/item_column_list.csv',
> column_separator => ',',
> database_filename => 'database/item.csv.cgi',
> database_separator => ',',
> database_mode => '+<',
> database_flock => '2',
> });
>>レコードの作成
>my %record;
>>%recordにレコードのカラム名と値を格納 (省略)
>
>>追記
>$database->postscript(\%record);
>undef $database;
-以下はレコード数を確認する場合のサンプルとなります。
>my $database = Cafemilk_database_basic->connect
> ({
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
> column_filename => 'database/item_column_list.csv',
> column_separator => ',',
> database_filename => 'database/item.csv.cgi',
> database_separator => ',',
> database_mode => '+<',
> database_flock => '2',
> });
>$database->get_record_all();
>my $target = 'multiprice';
>$database->match_database
> ({
> column_name => 'item_type',
> match_word => $target,
> });
>>レコード数の取得
>my $stack = $database->get_stack();
>undef $database;
-以下はダブルソートのサンプルとなります。
>my $database = Cafemilk_database_basic->connect
> ({
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
> column_filename => 'database/item_column_list.csv',
> column_separator => ',',
> database_filename => 'database/item.csv.cgi',
> database_separator => ',',
> database_mode => '+<',
> database_flock => '2',
> });
>$database->get_record_all();
>>ダブルソート
>$database->double_sort_database
> ({
> column_name_1 => 'item_type',
> reverse_mode_1 => '0',
> sort_mode_1 => 'character_quick',
> column_name_2 => 'item_id',
> reverse_mode_2 => '0',
> sort_mode_2 => 'character_quick',
> });
>>ここに各処理(省略)
>undef $database;
**DUMMY 接続
-データベースのロックの衝突を防いだり、処理の速度を上げるために DUMMY 接続を用いることができます。
-また、DUMMY 接続をうまく使うことにより、あるプラグインで抽出検索並び替え等を行ったレコードを別のプラグインで再利用できます。
--DUMMY 接続では書き込みはできません。
-以下はDUMMY 接続のサンプルとなります。
>my $database = Cafemilk_database_basic->connect
> ({
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
> column_filename => 'database/item_column_list.csv',
> column_separator => ',',
> database_filename => 'database/item.csv.cgi',
> database_separator => ',',
> database_mode => '+<',
> database_flock => '2',
> });
>$database->get_record_all();
>my @lines = $database->get_extract_database();
>$userdata->{database}{lines}{item} = \@lines;
>undef $database;
>
>my $database = Cafemilk_database_basic->dummy
> ({
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
> column_filename => 'database/item_column_list.csv',
> column_separator => ',',
> database_separator => ',',
> });
>my @lines = @{$userdata->{database}{lines}{item}};
>>レコード処理
>foreach (@lines)
> {
> my $line = $_;
>>省略
> }
>undef $database;
**詳細
-データベース接続時の接続モードは以下のものの使用が禁止されています。
--OS の仕様により上書き時にデータが消えることがあるためです。
>&tt(){>}
>&tt(){>+}
-データベースに上書きがある場合、接続モードは以下を用いてください。
>&tt(){+<}
-データベース読み込むだけの場合、接続モードは以下を用いてください。
>&tt(){<}
-Flock は基本的に常に '2' です。
-postscript はただちに実行されるため、overwrite の必要はありません。
**並び替えモード
-並び替えモードは以下の通りとなります。
>&tt(){number_quick... : 数値のソート}
>&tt(){character_quick : 文字列のソート}
-以下のモードは使用を禁止されていますが、検索結果が確実でなくてもよい場合に、高速化を得ることができます。
>&tt(){number_basic... : 数値のソート}
>&tt(){character_basic : 文字列のソート}
-通常は使いませんが、ベンチマークを取りたい場合など、ほかに以下のソートが利用できます。
>&tt(){number_normal......... : 標準的なコードで書かれた早くないソート 数値}
>&tt(){character_normal...... : 標準的なコードで書かれた早くないソート 文字列}
>&tt(){number_schwartz....... : シュワルツ変換 数値}
>&tt(){character_schwartz ....: シュワルツ変換 文字列}
>&tt(){number_eimerbrigade... : バケットソート 数値}
>&tt(){character_eimerbrigade : バケットソート 文字列}
-通常は使いませんが、以下は検索結果が雑になるソートです。
>&tt(){number_greathattery... : いい加減ソート 数値}
>&tt(){character_greathattery : いい加減ソート 文字列}
2009-10-20T23:10:14+09:00
1256047814
-
スキン テンプレートエンジン
https://w.atwiki.jp/cafemilk/pages/30.html
*テンプレートエンジン
-CAFEMILK SHOPPING CART V5 製品には独自のテンプレートエンジンが搭載されており、通常の HTML ソースに独自タグによる表記を加え、それをテンプレートエンジンに通すことによってウエブ表示等のテキスト出力が完成するという仕組みになっています。
**タグ
-タグには以下の表記と種類があります。
>&tt(){<#key#>.......... : 低層テンプレートタグ}
>&tt(){<##key##>........ : 中層テンプレートタグ}
>&tt(){<###key###>...... : 高層テンプレートタグ}
>&tt(){<####key####>.... : 低層プラグインタグ}
>&tt(){<#####key#####>.. : 中層プラグインタグ}
>&tt(){<######key######> : 高層プラグインタグ}
-テンプレートタグは主に文字列の出力に用います。
-プラグインタグは plugin 型プラグイン (用語に注意) を呼び出すタグで、プログラムの実行とスキン部品の出力を行います。
--テンプレートタグが簡易、プラグインタグが高度、という位置づけになります。
-# 記号の多さは実行の優先度を表します。つまり、# 記号が多いタグほど優先して実行されます。
-どのタグにも必要に応じてオプションをつけることができます。
--オプションは : (コロン) 区切りで複数を指定できます。
-以下はオプションの付いたタグの一例です。
><#####mail_cart_record:package#####>
**構成
-テンプレートエンジンは、ウェブ処理用とメール処理用の 2 種類あります。
-基本的な振る舞いはどちらも同じとなります。
-ウェブ用テンプレートエンジンのファイル名は以下の通りとなります。
>&tt(){cafemilk_skin_html.pl}
-cafemilk_skin_html.pl は以下のファイルを参照します。
>&tt(){cafemilk_tag_html.pl}
-これらのファイルのあるディレクトリは以下の通りです。
>&tt(){[Apache_server]}
>&tt(){ └ [cgi-bin]}
>&tt(){ └ [pl]}
-メール用テンプレートエンジンのファイル名は以下の通りとなります。
>&tt(){cafemilk_skin_mail.pl}
-cafemilk_skin_mail.pl は以下のファイルを参照します。
>&tt(){cafemilk_tag_mail.pl}
-これらのファイルのあるディレクトリは以下の通りです。
>&tt(){[Apache_server]}
>&tt(){ └ [cgi-bin]}
>&tt(){ └ [pl]}
-基本エンジン (コントローラ) は、 execute の HTML テンプレート処理を肩代わりする仕様となっており、専用のテンプレートコントローラが用意されています。(用語注意)
--MAIL テンプレート処理のテンプレートコントローラはありません。execute 側がコントローラを内包することになります。
--plugin は常にテンプレートコントローラを内包します。
---内包することを望まない場合、execute 用のテンプレートコントローラを呼び出して使用することが可能です。
-テンプレートコントローラのファイル名は以下の通りとなります。
>&tt(){cafemilk_template_html.pl}
-cafemilk_template_html.pl のあるディレクトリは以下の通りです。
>&tt(){[Apache_server]}
>&tt(){ └ [cgi-bin]}
>&tt(){ └ [pl]}
*設定
-テンプレートタグおよびプラグインタグは、実行を許可されなければなりません。
--許可されていないタグは無視されます。
-あらかじめ規定値(許可のリスト)が設定されています。
-WEB テンプレートタグの規定値は以下に設定されています。
>$config->{list}{tag}{html}
-$config->{list}{plugin} を設定しているファイルは以下の通りです。
>&tt(){[Apache_server]}
>&tt(){ └ [cgi-bin]}
>&tt(){ └ [config]}
>&tt(){ └ [admin]}
>&tt(){ └ config_basic.pl}
-MAIL テンプレートタグの規定値は以下に設定されています。
>$config->{list}{tag}{mail}
-$config->{list}{plugin} を設定しているファイルは以下の通りです。
>&tt(){[Apache_server]}
>&tt(){ └ [cgi-bin]}
>&tt(){ └ [config]}
>&tt(){ └ [admin]}
>&tt(){ └ config_basic.pl}
-プラグインタグの規定値は以下に設定されています。
>$config->{list}{plugin}
-$config->{list}{plugin} を設定しているファイルは以下の通りです。
>&tt(){[Apache_server]}
>&tt(){ └ [cgi-bin]}
>&tt(){ └ [config]}
>&tt(){ └ [admin]}
>&tt(){ └ config_basic.pl}
*コントローラ
-テンプレートコントローラは、モジュールとして外部に持つことも、内部に持つこともできます。
--テンプレートエンジンはフレームワークですので操作 (コントロール) の方法がわかれば十分です。
-以下は、外部モジュールとなる cafemilk_template_html.pl のソースとなります。
--cafemilk_template_html.pl はコントローラとしての機能をすべて備えていますので、コントローラを plugin に内包させる場合などに参考にしてください。
>################################################################################
># #
># CAFEMILK SHOPPING CART V5 #
># SOHO WORKSHOP CAFEMILK 全権留保 #
># #
>################################################################################
>
>use strict;
># use warnings;
>use utf8;
># use encoding "utf8";
>use open ":utf8";
>
>require './pl/cafemilk_skin_html.pl';
>
>package Cafemilk_template_html;
>sub template
> {
> my $argument = shift;
> my $config = $argument->{config};
> my $userdata = $argument->{userdata};
> my $log_error = $argument->{log_error};
> my $log_alert = $argument->{log_alert};
> my $status = $argument->{status};
>>スキンのパスの受け取り。
> my $path = $argument->{skinpath};
>>テンプレートエンジンを操作するソースはここから
> # HTML スキンファイルを読み込みます。
>>まずはオブジェクト作成。
> my $skin_html_main = Cafemilk_skin_html->new
> ({
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
>>name は任意の文字列を充てる。
>>ここでは execute 名が使われている。
> name => "$userdata->{request_values}{execute}[0]",
> });
>>スキンの読み込み。
>>$path は相対パスで指定する。
> $skin_html_main->set_path($path);
>>プラグインタグ (plugin 型プラグイン) の処理。
> # 高層プラグインを抽出。
> $skin_html_main->load_plugin_high();
> # 高層プラグインを置換。
> $skin_html_main->replace_plugin_high
> ({
> allow => $config->{list}{plugin},
> plugin_path => "./$config->{path}{plugin}/",
> package => 'Cart_plugin',
> });
> # 中層プラグインを抽出。
> $skin_html_main->load_plugin_middle();
> # 中層プラグインを置換。
> $skin_html_main->replace_plugin_middle
> ({
> allow => $config->{list}{plugin},
> plugin_path => "./$config->{path}{plugin}/",
> package => 'Cart_plugin',
> });
> # 下層プラグインを抽出。
> $skin_html_main->load_plugin_low();
> # 下層プラグインを置換。
> $skin_html_main->replace_plugin_low
> ({
> allow => $config->{list}{plugin},
> plugin_path => "./$config->{path}{plugin}/",
> package => 'Cart_plugin',
> });
>>テンプレートタグの処理。
> # 高層タグを抽出。
> $skin_html_main->load_tag_high();
> # 高層タグを置換。
> $skin_html_main->replace_tag_high
> ({
> allow => $config->{list}{tag}{html},
> package => "Cafemilk_tag_html",
> });
> # 中層タグを抽出。
> $skin_html_main->load_tag_middle();
> # 中層タグを置換。
> $skin_html_main->replace_tag_middle
> ({
> allow => $config->{list}{tag}{html},
> package => "Cafemilk_tag_html",
> });
> # 下層タグを抽出。
> $skin_html_main->load_tag_low();
> # 下層タグを置換。
> $skin_html_main->replace_tag_low
> ({
> allow => $config->{list}{tag}{html},
> package => "Cafemilk_tag_html",
> });
> # HTML スキンの処理済みソースを取得します。
> my $source = $skin_html_main->get_source();
>>ここまで。
> }
>1;
-次の例は plugin におけるコントローラの実装例です。
>################################################################################
># #
># CAFEMILK SHOPPING CART V5 #
># SOHO WORKSHOP CAFEMILK 全権留保 #
># #
>################################################################################
>
>use strict;
># use warnings;
>use utf8;
># use encoding "utf8";
>
>package Cart_plugin;
>sub user_inquiry_step1_html
> {
> my $package = shift;
> my $argument = shift;
> my $config = $argument->{config};
> my $userdata = $argument->{userdata};
> my $log_error = $argument->{log_error};
> my $log_alert = $argument->{log_alert};
> my $status = $argument->{status};
> my $pin_name = 'user_inquiry_step1_html';
> my $path = "./$config->{path}{skin}/user/cgi/$config->{default}{user_type}/$userdata->{device_type}/$userdata->{language_type}/$userdata->{currency_type}/$userdata->{template_type}/pin_user_inquiry_step1.html";
> my %input_values;
> my @list =
> qw(
> input_1_email_1 input_1_email_2 input_inquiry
> );
> foreach (@list)
> {
> $input_values{$_} = $userdata->{request_values}{$_}[0];
> }
>>テンプレートタグ temporal に各情報を格納
>>格納は $userdata->{tag_data}{temporal}{$key} に行う
> foreach (keys %input_values)
> {
> $userdata->{tag_data}{temporal}{$_} = $input_values{$_};
> }
> if (($input_values{input_1_email_1} eq '')
> and ($input_values{input_1_email_2} eq ''))
> {
> $userdata->{tag_data}{temporal}{input_1_email_1} = $userdata->{user_registry_values}{'1_email_1'};
> $userdata->{tag_data}{temporal}{input_1_email_2} = $userdata->{user_registry_values}{'1_email_1'};
> }
>>ここからテンプレート処理 (コントローラ)
>
>>オブジェクト作成
> my $skin = Cafemilk_skin_html->new
> ({
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
> name => $pin_name,
> });
>>スキン読み込み
> $skin->set_path($path);
>>中層テンプレートタグの取得
> $skin->load_tag_middle();
>>許可リストの作成
>>ここでは temporal のみ許可
> my @list = qw(temporal);
>>中層テンプレートタグの処理
> $skin->replace_tag_middle
> ({
> allow => \@list,
> package => "Cafemilk_tag_html",
> });
>>コーディングルールにしたがいテンプレートタグ temporal の内容を消去
> undef $userdata->{tag_data}{temporal};
>>処理されたスキンの出力
> my $source = $skin->get_source();
> }
>sub user_inquiry_step1_mail
> {
> # none
> }
>1;
-この plugin では、plugin に固有の情報をすべて中層テンプレートタグ temporal にて出力しています。
-そのため、コントローラ部分から必要のない処理は一切省かれています。
--そのため、中層テンプレートタグしか処理されていません。
--また、規定の設定値 $config->{list}{tag}{html} は使用されていません。
-plugin での処理が省かれることにより、plugin で処理されなかった各種タグの処理は execute に回されます。
--たとば、テンプレートタグ path_material はスキン内に大量に出てきますが、これを繰り返し処理するとリソースを食うから、というのが理由です。最終的に execute のコントローラがすべてのタグを処理するので、上記のような処理でタグ処理に漏れがあったとしても問題はなく、plugin は plugin に固有のタグの処理に専念できるというわけです。
-plugin に固有の情報はテンプレートタグは temporal に格納することになります。コーディングルールにより temporal は逐次内容を undef することになっており、その情報が外部に干渉することはありません。
--たとえば、異なる plugin が <##temporal:hoge##> といった同じタグを用いても、あるいは、同じ plugin が複数実行されてその都度同じタグが異なる内容を出力する場合でも、干渉はないということです。
--他のプラグインで情報を利用する必要がある場合は message を使います。message は undef しないので値を使いまわせます。
-次の例はメール送信処理の例です。
--メール送信処理はフレームワーク化されているので手間がかかりません。
>>任意の処理名を設定
> my $mail_name = 'user_inquiry_step3_shop';
>>スキンのパスの指定
> my $path = "./$config->{path}{skin}/user/cgi/$config->{default}{user_type}/$userdata->{device_type}/$userdata->{language_type}/$userdata->{currency_type}/$userdata->{template_type}/mail_user_inquiry_step3_shop.txt";
>>オブジェクト作成
> my $skin = Cafemilk_skin_mail->new
> ({
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
> name => $mail_name,
> });
>
>>中略
>
>>スキンの読み込み
> $skin->set_path($path);
>>中層テンプレートタグの取得
> $skin->load_tag_middle();
>>規定値の取得
> my @list = @{$config->{list}{tag}{mail}};
>>中層テンプレートタグの処理
> $skin->replace_tag_middle
> ({
> allow => \@list,
> package => "Cafemilk_tag_mail",
> });
>>temporal は uendf する
> undef $userdata->{tag_data}{temporal};
>>処理されたスキンの取得
> my $source = $skin->get_source();
>>メール送信処理
> my $from = $config->{sendmail}{address}{shop}{from}[0];
> my $to = $input_values{input_1_email_1};
> my $cc = '';
> my $bcc = '';
> my $return = $config->{sendmail}{address}{shop}{return}[0];
> Cafemilk_mail::skin_sendmail
> ({
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
> from => $from,
> to => $to,
> cc => $cc,
> bcc => $bcc,
> source => $source,
> return => $return,
> });
2009-10-12T15:02:28+09:00
1255327348
-
スキン 概要
https://w.atwiki.jp/cafemilk/pages/29.html
*概要
**スキンの型
-スキンには種類とか型とか呼ばれる種別があります。
-その内容は以下の通りです。
-HTML スキン
--もしくはウェブ用スキン。
--ウェブ出力用のスキンで、execute 用と plugin 用とがあります。
-MAIL スキン
--もしくはメール用スキン。
--メール出力用のスキンです。
-WORDLIST 型スキン
--これは補助的なスキンです。
--条件に合わせて選択したうえで他のスキンに挿入する必要のある様々な文字列を扱います。
--たとえば曜日のリストといったものになります。
-スタイルシート
--HTML スキンが必要とする外部スタイルシートです。
**アドバイス
-製品を導入するショップのほとんどが、スキンを自作することを考えておられると思います。
-その際は以下の点にぜひご留意ください。
--標準スキンを改造するより、HP作成ソフトなどを使って新規にデザインを起こしてそれを移植する方がはるかに楽です。
--標準は全ページ3ペインとなっていますが、ページによっては2ペインとなるようにするとよさそうです。
---各ページにあるヘルプはくどいので省いたほうがいいかもしれません。
--2ペインにする場合でも3ペインにする場合でもメインの部分はブラウザの幅に合わせて表示幅が可変になるようにするのがスマートです。
-公式に[[スキン製作例>http://cafemilk.milkcafe.to/v5skin.html]]がありますのでよく読みましょう。
**独自タグについての予備知識
-CAFEMILK SHOPPING CART V5 製品には独自のテンプレートエンジンが搭載されており、通常の HTML ソースに独自タグによる表記を加え、それをテンプレートエンジンに通すことによってウエブ表示等のテキスト出力が完成するという仕組みになっています。
-タグには以下の表記と種類があります。
>&tt(){<#key#>.......... : 低層テンプレートタグ}
>&tt(){<##key##>........ : 中層テンプレートタグ}
>&tt(){<###key###>...... : 高層テンプレートタグ}
>&tt(){<####key####>.... : 低層プラグインタグ}
>&tt(){<#####key#####>.. : 中層プラグインタグ}
>&tt(){<######key######> : 高層プラグインタグ}
-テンプレートタグは主に文字列の出力に用います。
-プラグインタグは plugin 型プラグイン (用語に注意) を呼び出すタグで、プログラムの実行とスキン部品の出力を行います。
--テンプレートタグが簡易、プラグインタグが高度、という位置づけになります。
--が、スキン側から見ればどちらもただのタグです。
--これらは、スキン側から見る限り、違いを気にする必要はあまりありません。
-# 記号の多さは実行の優先度を表します。つまり、# 記号が多いタグほど優先して実行されます。
-どのタグにも必要に応じてオプションをつけることができます。
--オプションは : (コロン) 区切りで複数を指定できます。
-以下はオプションの付いたタグの一例です。
><#####mail_cart_record:package#####>
-以下は覚えておきたいテンプレートタグです。
>&tt(){path_cgi......... : CGIのファイル名}
>&tt(){url_root......... : CGIのURL}
>&tt(){url_sslroot...... : SSLでのCGIのURL}
>&tt(){path_material.... : スキン内で使用する素材画像ファイルのディレクトリ}
>&tt(){user_name........ : 会員のニックネーム}
>&tt(){user_point....... : 会員の所有ポイント}
>&tt(){mailing_free_cost : 送料無料購入額}
>&tt(){make_select...... : フォーム内の SELECT 入力欄}
>&tt(){message.......... : 汎用 オプションをつけて様々な語句を出力する}
>&tt(){temporal......... : 汎用 オプションをつけて様々な語句を出力する}
>&tt(){preview_user_type : ログイン属性}
>&tt(){category_bread... : パンくずナビ}
>&tt(){cart_stack....... : カートへの投入数}
>&tt(){cart_subtotal.... : カートの小計}
>&tt(){material_html.... : 汎用 HTML 部品の単純呼び出し}
**HTML execute スキン
-あるいは単に execute スキン。
-これは、ウェブに表示される各ページの全体をレイアウトするスキンです。
--そこに、プラグインタグやテンプレートタグという形で、スキン部品や各種要素が挿入されていきます。
-スキンのファイル名は以下のようになります。
>&tt(){exe_ + execute 名 + .html}
-通常、スキンは、PC 表示用と MOBILE (携帯) 表示用の 2 種類あって、それぞれ別のディレクトリにあります。
-execute スキンは以下のディレクトリに存在します。
>&tt(){[Apache_server]}
>&tt(){ └ [cgi-bin]}
>&tt(){ └ [skin]}
>&tt(){ └ [user]}
>&tt(){ └ [cgi]}
>&tt(){ └ [default]}
>&tt(){ ├ [web]}
>&tt(){ ├ └ [japanese]}
>&tt(){ ├ └ [yen]}
>&tt(){ ├ └ [default]}
>&tt(){ └ [mobile]}
>&tt(){ └ [japanese]}
>&tt(){ └ [yen]}
>&tt(){ └ [default]}
-HTML execute スキンはウェブページとなるものですので、head を出力しなければなりません。
-head においては以下の情報の出力が行われます。
>&tt(){title....... : ページのタイトル}
>&tt(){Content-Type : 文字コードは UTF-8 です}
>&tt(){robots...... : ロボット型クローラへの指示}
>&tt(){product..... : 製品の情報}
>&tt(){author...... : 制作者}
>&tt(){stylesheet.. : スタイルシートのパス}
>&tt(){script...... : JS スクリプトのパス 必要な場合のみ}
-以下はその一例です
><head>
><title>会員登録手続 > > 情報の入力</title>
><META HTTP-EQUIV='Content-Type' CONTENT='text/html; charset=UTF-8'>
><meta name='robots' content='&color(,#f2e59e){<#robots#>}'>
><meta name='product' content='&color(,#f2e59e){<##product##>}'>
><meta name='author' content='&color(,#f2e59e){<##author##>}'>
><link href='&color(,#f2e59e){<##path_css##>}' type='text/css' rel='stylesheet'>
><script src='&color(,#f2e59e){<##path_js##>}ajaxzip2/prototype.js'></script>
><script src='&color(,#f2e59e){<##path_js##>}ajaxzip2/ajaxzip2.js' charset='UTF-8'></script>
><script>AjaxZip2.JSONDATA = '&color(,#f2e59e){<##path_js##>}ajaxzip2/data';</script>
></head>
-実際の出力では独自タグ (この場合はテンプレートタグ) が置換されますので、例えば以下のようになります。
><head>
><title>会員登録手続 > > 情報の入力</title>
><META HTTP-EQUIV='Content-Type' CONTENT='text/html; charset=UTF-8'>
><meta name='robots' content='&color(,#f2e59e){noindex,follow}'>
><meta name='product' content='&color(,#f2e59e){CAFEMILK SHOPPING CART V5 TYPE A}'>
><meta name='author' content='&color(,#f2e59e){SOHO WORKSHOP CAFEMILK, TAKASHI MIYAHARA, 宮原 崇}'>
><link href='&color(,#f2e59e){http://www.example.com/shop/skin/user/cgi/default/web/japanese/yen/default/style_cafemilk.css}' type='text/css' rel='stylesheet'>
><script src='&color(,#f2e59e){http://www.example.com/shop/skin/js/}ajaxzip2/prototype.js'></script>
><script src='&color(,#f2e59e){http://www.example.com/shop/skin/js/}ajaxzip2/ajaxzip2.js' charset='UTF-8'></script>
><script>AjaxZip2.JSONDATA = '&color(,#f2e59e){http://www.example.com/shop/skin/js/}ajaxzip2/data';</script>
></head>
**HTML plugin スキン
-あるいは単に plugin スキン。
-これは、プラグインタグによって呼び出されるスキン部品となります。
-plugin 型プラグインが呼び出すスキンが 1 つのみの場合、たいてい、スキンのファイル名は以下のようになります。
>&tt(){pin_ + plugin 名 + .html}
-しかし、plugin 型プラグインは複数のスキンを読み込むことがあります。
-例えば、plugin 型プラグイン user_item_main が呼び出すスキンは以下のようになります。
--ファイル名が揃っているので判別は容易です。
>&tt(){pin_user_item_main_image.html}
>&tt(){pin_user_item_main_flash.html}
>&tt(){pin_user_item_main_text.html}
>&tt(){pin_user_item_main_table.html}
>&tt(){pin_user_item_main_submit_singletype.html}
>&tt(){pin_user_item_main_submit_multitype_1.html}
>&tt(){pin_user_item_main_submit_multitype_2.html}
>&tt(){pin_user_item_main_submit_multiprice_1.html}
>&tt(){pin_user_item_main_submit_multiprice_2.html}
-通常、スキンは、PC 表示用と MOBILE (携帯) 表示用の 2 種類あって、それぞれ別のディレクトリにあります。
-plugin スキンは以下のディレクトリ (execute スキンと同じディレクトリ) に存在します。
>&tt(){[Apache_server]}
>&tt(){ └ [cgi-bin]}
>&tt(){ └ [skin]}
>&tt(){ └ [user]}
>&tt(){ └ [cgi]}
>&tt(){ └ [default]}
>&tt(){ ├ [web]}
>&tt(){ ├ └ [japanese]}
>&tt(){ ├ └ [yen]}
>&tt(){ ├ └ [default]}
>&tt(){ └ [mobile]}
>&tt(){ └ [japanese]}
>&tt(){ └ [yen]}
>&tt(){ └ [default]}
-plugin 型プラグイン user_status のスキンは他の plugin スキンと異なり、ログイン状態によってスキンを切り替えるようになっています。そのため、同じファイル名 pin_user_status.html のスキンが 6 つあります。
-これらのスキンは以下のディレクトリに存在します。
>&tt(){[Apache_server]}
>&tt(){ └ [public_html]}
>&tt(){ └ [skin]}
>&tt(){ └ [user]}
>&tt(){ └ [cgi]}
>&tt(){ ├ [default]}
>&tt(){ ├ ├ [web]}
>&tt(){ ├ ├ └ [japanese]}
>&tt(){ ├ ├ └ [yen]}
>&tt(){ ├ ├ └ [default]}
>&tt(){ ├ └ [mobile]}
>&tt(){ ├ └ [japanese]}
>&tt(){ ├ └ [yen]}
>&tt(){ ├ └ [default]}
>&tt(){ ├ [guest]}
>&tt(){ ├ ├ [web]}
>&tt(){ ├ ├ └ [japanese]}
>&tt(){ ├ ├ └ [yen]}
>&tt(){ ├ ├ └ [default]}
>&tt(){ ├ └ [mobile]}
>&tt(){ ├ └ [japanese]}
>&tt(){ ├ └ [yen]}
>&tt(){ ├ └ [default]}
>&tt(){ └ [member]}
>&tt(){ ├ [web]}
>&tt(){ ├ └ [japanese]}
>&tt(){ ├ └ [yen]}
>&tt(){ ├ └ [default]}
>&tt(){ └ [mobile]}
>&tt(){ └ [japanese]}
>&tt(){ └ [yen]}
>&tt(){ └ [default]}
**MAIL スキン
-メールの本文を作成するスキン、という以外は HTML スキンとほぼ同じ振る舞いをします。
-スキンのファイル名は以下のようになります。
>&tt(){mail_ + メール名 + .txt}
-MAIL スキンは以下のディレクトリ (HTML スキンと同じディレクトリ) に存在します。
>&tt(){[Apache_server]}
>&tt(){ └ [cgi-bin]}
>&tt(){ └ [skin]}
>&tt(){ └ [user]}
>&tt(){ └ [cgi]}
>&tt(){ └ [default]}
>&tt(){ ├ [web]}
>&tt(){ ├ └ [japanese]}
>&tt(){ ├ └ [yen]}
>&tt(){ ├ └ [default]}
>&tt(){ └ [mobile]}
>&tt(){ └ [japanese]}
>&tt(){ └ [yen]}
>&tt(){ └ [default]}
-スキンの 1 行目は件名であることがあります。
-以下はスキンの例です。
>>1 行目は件名
>[SHOP] 問い合わせ<##user_time##>
>>メール本文
>※ このメールはショップ向けの自動発行メールです
>● 基本情報
>○ 手続名
> 問い合わせ
>○ 手続コード
> <##user_time##>
>○ 日時
> <##user_time_year##>年<##user_time_month##>月<##user_time_day##>日<##user_time_week##> <##user_time_hour##>時<##user_time_min##>分
>● 問い合わせ情報
>○ メールアドレス
> <##temporal:input_1_email_1##>
>○ 問い合わせ内容
><##temporal:input_inquiry##>
**WORDLIST 型スキン
-出力用の文字列を格納するスキンです。
-各項目は予約されており、並び替えることはしません。
-スキンのファイル名は以下のようになります。
>&tt(){list_ + WORDLIST 名 + .txt}
-WORDLIST 型スキンは以下のディレクトリ (HTML スキンと同じディレクトリ) に存在します。
>&tt(){[Apache_server]}
>&tt(){ └ [cgi-bin]}
>&tt(){ └ [skin]}
>&tt(){ └ [user]}
>&tt(){ └ [cgi]}
>&tt(){ └ [default]}
>&tt(){ ├ [web]}
>&tt(){ ├ └ [japanese]}
>&tt(){ ├ └ [yen]}
>&tt(){ ├ └ [default]}
>&tt(){ └ [mobile]}
>&tt(){ └ [japanese]}
>&tt(){ └ [yen]}
>&tt(){ └ [default]}
-例えば、list_input_status.txt の内容は以下のようになります。
>入力内容が不正です
>入力がありません
>文字数が不正です
>入力文字数が多すぎます
>入力文字数が少なすぎます
>入力内容が一致しません
>同じ文字列がすでに使用されています
>アカウント名とパスワードが同じです
>他との重複により使用が認められないパスワードです
>文字以上
>文字以内
>全角
>半角
>英数
>数字
>かな
>カナ
>数値が大きすぎます
>数値が小さすぎます
>桁数が不正です
-WORDLIST 型スキンの文字列は様々なところから呼び出されるので、変更する際には各所において表記に乱れが生じないか注意する必要があります。
**スタイルシート
-スタイルシートに特殊なところは何もありません。
-PC 表示のスタイルシートは外部にあります。
-PC 表示のスタイルシートは以下のディレクトリにあります。
>&tt(){[Apache_server]}
>&tt(){ └ [public_html]}
>&tt(){ └ [skin]}
>&tt(){ └ [user]}
>&tt(){ └ [cgi]}
>&tt(){ └ [default]}
>&tt(){ └ [web]}
>&tt(){ └ [japanese]}
>&tt(){ └ [yen]}
>&tt(){ └ [default]}
**material_html スキン部品
-内部において独自タグを用いないスキン部品は plugin 型プラグインを介すことなく、テンプレートタグ material_html を用いて単純な呼び出しを行うことができます。
--トップページにバナー型の広告を並べる場合など、頻繁に部品の差し替えがある場合に重宝します。
-material_html の使用例は以下の通りです。
><##material_html:sample##>
-上記の場合に呼び出されるスキン部品のファイル名は以下の通りです。
>&tt(){sample.html}
-material_html が呼び出すスキンは以下のディレクトリに置きます。
>&tt(){[Apache_server]}
>&tt(){ └ [cgi-bin]}
>&tt(){ └ [skin]}
>&tt(){ └ [user]}
>&tt(){ └ [material]}
//├└─│┌┐┘└├┬┤┴┼━┃┏┓┛┗┣┳┫┻╋
2009-10-02T17:43:11+09:00
1254472991
-
プラグイン その他
https://w.atwiki.jp/cafemilk/pages/28.html
*その他
-カスタマイズの利便が要求される幾つかの機能は、execute 型や plugin 型とは別にプラグイン化されています。
**決済プラグイン
-決済処理用のプラグインです。
--決済処理がプラグイン化されていることにより、決済の追加が容易になります。
-使用する決済の ID は以下の設定に記載されなければなりません。
>$config->{payment}{id_list}
-$config->{payment}{id_list} を設定しているファイルは以下の通りです。
>&tt(){[Apache_server]}
>&tt(){ └ [cgi-bin]}
>&tt(){ └ [config]}
>&tt(){ └ [common]}
>&tt(){ └ config_common.pl}
-以下は設定の例です。
># 有効にする決済のID
> # 決済処理はモジュールによって実施されます。そのIDを指定してください。
> # 新規に決済を追加するにはモジュールの作成が必要です。
> # [代引決済を有効にする場合]
> # $config->{payment}{id_list} = ['delivery_collect'];
> # [ZEUS決済を追加する場合]
> # $config->{payment}{id_list} = ['delivery_collect','zeus'];
> # 利用できるIDは以下の通りです。
> # delivery_collect : 代金引換
> # bank_transfer : 銀行振込
> # postal_transfer : ゆうちょ銀行払込
> # zeus : ZEUS決済 Link Point 方式
> # ※ ZEUS決済の他の方式について導入されるショップは開発元までご相談
> # ください。
> $config->{payment}{id_list} = ['delivery_collect','bank_transfer','postal_transfer','zeus'];
-上の設定の場合、以下の決済プラグインが読み込まれます。
>&tt(){delivery_collect.pl}
>&tt(){bank_transfer.pl}
>&tt(){postal_transfer.pl}
>&tt(){zeus.pl}
-以上のプラグインのあるディレクトリは以下の通りです。
>&tt(){[Apache_server]}
>&tt(){ └ [cgi-bin]}
>&tt(){ └ [payment]}
-以下の plugin は $config->{payment}{id_list} に基づいて決済関連のスキンを読み込みます。
>&tt(){pin_user_cart_step2_payment_lines.pl}
-pin_user_cart_step2_payment_lines.pl が読み込むスキンは例えば以下の通りです。
>&tt(){pin_user_cart_step2_payment_lines_delivery_collect.html}
>&tt(){pin_user_cart_step2_payment_lines_delivery_collect_close.html}
>&tt(){pin_user_cart_step2_payment_lines_bank_transfer.html}
>&tt(){pin_user_cart_step2_payment_lines_postal_transfer.html}
>&tt(){pin_user_cart_step2_payment_lines_zeus.html}
-以下の plugin は、場合によって決済関連のスキンを読み込みます。
>&tt(){pin_user_cart_step5_payment.pl}
-pin_user_cart_step5_payment.pl が読み込むスキンは例えば以下の通りです。
>&tt(){pin_user_cart_step5_zeus.html}
-決済プラグインを読み込むモジュールは以下の通りです。
--決済関連の基本的な処理はフレームワーク化されていますのであまり気にする必要はありません。
>&tt(){cafemilk_basic_pl}
-決済プラグインはオブジェクト方式で実装されなければなりません。
-決済プラグインは package を宣言しなければなりません。
-宣言する package 名は以下の通りとなります。
>Cafemilk_payment
-決済プラグインは以下のサブルーチンを持ちます。
>&tt(){new......................... : オブジェクト作成}
>&tt(){payment_ + 決済名 + _account : 費用計算等}
>&tt(){payment_ + 決済名 + _tag.... : 決済ページ投入情報作成}
-以下は決済プラグインの一例です。
>################################################################################
># #
># CAFEMILK SHOPPING CART V5 #
># SOHO WORKSHOP CAFEMILK 全権留保 #
># #
>################################################################################
>
>use strict;
># use warnings;
>use utf8;
># use encoding "utf8";
>
>>コーディングルールにより package 名を宣言
>package Cafemilk_payment;
>>オブジェクト作成
>>変更不可
>sub new
> {
> my $class = shift;
> my $argument = shift;
> my $config = $argument->{config};
> my $userdata = $argument->{userdata};
> my $log_error = $argument->{log_error};
> my $log_alert = $argument->{log_alert};
> my $status = $argument->{status};
> my $stock = $argument->{stock};
> if ($stock eq '')
> {
> $stock = 'cart';
> }
> my $self =
> {
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
> stock => $stock,
> };
> bless $self, $class;
> }
>>以下は費用計算等
>sub payment_zeus_account
> {
>>コーディングルールによって義務づけられた各種情報の格納処理
> my $class = shift;
> my $argument = shift;
> my $config = $class->{config};
> my $userdata = $class->{userdata};
> my $log_error = $class->{log_error};
> my $log_alert = $class->{log_alert};
> my $status = $class->{status};
> my $stock = $class->{stock};
>>決済費用等の取得が行われたことを告知
> $status->{$stock}{payment_cost} = '1';
>>決済名
> $userdata->{"$stock\_check"}{payment_name} = "ZEUS決済";
>>決済手数料
> $userdata->{"$stock\_check"}{valid_payment_cost} = 0;
>>決済手数料 ウェブ等表示用
> $userdata->{"$stock\_check"}{preview_payment_cost} = '0';
>>決済手数料の表示に続いて注意書き等が必要な場合
> $userdata->{"$stock\_check"}{payment_message_1} = '';
> }
>>以下は決済ページURLと値の作成
>sub payment_zeus_tag
> {
> my $class = shift;
> my $argument = shift;
> my $config = $class->{config};
> my $userdata = $class->{userdata};
> my $log_error = $class->{log_error};
> my $log_alert = $class->{log_alert};
> my $status = $class->{status};
> my $stock = $class->{stock};
> my %parameter;
> # 1
> $parameter{form_action} = "https://linkpt.cardservice.co.jp/cgi-bin/order.cgi?orders";
> # 2
> $parameter{send} = 'mall';
> # 3
> $parameter{clientip} = $config->{payment}{zeus}{ip};
> # 4
> $parameter{money} = $userdata->{"$stock\_check"}{grandtotal};
> # 5
> $parameter{custom} = 'yes';
> # 9
> $parameter{sendid} = "$userdata->{ordercode}";
> %parameter;
> }
>>最後に何か retern するのが Perl のお約束
>1;
**アフィリエイトプラグイン
-アフィリエイトプログラムが要求するコンバージョンコードを用意するプラグインです。
--用語は業者によって違っていることがあります。
-以下はファンコミュニケーションズの提供するA8.netの場合となります。
-プログラムIDは以下に記載します。
>$config->{affiliate}{a8}{pid}
-$config->{affiliate}{a8}{pid} を設定しているファイルは以下の通りです。
>&tt(){[Apache_server]}
>&tt(){ └ [cgi-bin]}
>&tt(){ └ [config]}
>&tt(){ └ [common]}
>&tt(){ └ config_common.pl}
-以下は設定の例です。
> # A8.netのプログラムID
> # [A8.netと契約していない場合]
> # $config->{affiliate}{a8}{pid} = '';
> $config->{affiliate}{a8}{pid} = 's0000000000000';
-以下のプラグインが読み込まれます。
>&tt(){a8.pl}
-a8.pl のあるディレクトリは以下の通りです。
>&tt(){[Apache_server]}
>&tt(){ └ [cgi-bin]}
>&tt(){ └ [affiliate]}
-a8.pl を使用するプラグインは以下の通りです。
>&tt(){pin_user_cart_step5_affiliate.pl}
-アフィリエイトプラグインはオブジェクト方式で実装されなければなりません。
-アフィリエイトプラグインは package を宣言しなければなりません。
-宣言する package 名は以下の通りとなります。
>Cafemilk_affiliate
-アフィリエイトプラグインは以下のサブルーチンを持ちます。
>&tt(){new................................. : オブジェクト作成}
>&tt(){affiliate_ + アフィリエイト名 + _tag : コンバージョンコード作成}
-a8.pl の内容は以下の通りです。
>################################################################################
># #
># CAFEMILK SHOPPING CART V5 #
># SOHO WORKSHOP CAFEMILK 全権留保 #
># #
>################################################################################
>
>use strict;
># use warnings;
>use utf8;
># use encoding "utf8";
>
>>コーディングルールにより package 名を宣言
>package Cafemilk_affiliate;
>>オブジェクト作成
>>変更不可
>sub new
> {
> my $class = shift;
> my $argument = shift;
> my $config = $argument->{config};
> my $userdata = $argument->{userdata};
> my $log_error = $argument->{log_error};
> my $log_alert = $argument->{log_alert};
> my $status = $argument->{status};
> my $stock = $argument->{stock};
> if ($stock eq '')
> {
> $stock = 'cart';
> }
> my $self =
> {
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
> stock => $stock,
> };
> bless $self, $class;
> }
>>コンバージョンコードの発行
>sub affiliate_a8_tag
> {
> my $class = shift;
> my $argument = shift;
> my $config = $class->{config};
> my $userdata = $class->{userdata};
> my $log_error = $class->{log_error};
> my $log_alert = $class->{log_alert};
> my $status = $class->{status};
> my $stock = $class->{stock};
> my %parameter;
> $parameter{form_action} = "https://px.a8.net/cgi-bin/a8fly/sales";
> $parameter{pid} = "$config->{affiliate}{a8}{pid}";
> $parameter{so} = "$userdata->{ordercode}";
> foreach (0 .. ($userdata->{$stock}{stack} - 1))
> {
> my $number = $_;
> my $price = $userdata->{"$stock\_check"}{price}[$number];
> my $quantity = $userdata->{$stock}{"quantity_$number"};
> my $total = $userdata->{"$stock\_check"}{get_price}[$number];
> my $id = $userdata->{$stock}{"id_$number"};
> if ($userdata->{"$stock\_check"}{option_number}[$number] ne '')
> {
> $id .= "-".$userdata->{"$stock\_check"}{option_number}[$number];
> }
> $parameter{sis} .= "\&si=$price\.$quantity\.$total\.$id";
> }
> $parameter{ts}
> = "$status->{datetime}{year}$status->{datetime}{month}"
> . "$status->{datetime}{day}$status->{datetime}{hour}"
> . "$status->{datetime}{min}$status->{datetime}{sec}";
> my $parameter
> = "<img src='$parameter{form_action}\?pid=$parameter{pid}\&so=$parameter{so}$parameter{sis}\&ts=$parameter{ts}' width='1' height='1' border='0'>";
> $parameter;
> }
>>最後に何か retern するのが Perl のお約束
>1;
**レコードプラグイン
-レコードプラグインは受注の情報などを CSV などのレコードの形にして出力するプラグインです。
-以下は標準伝票レコードの場合となります。
-標準伝票レコードのレコード名は以下のようになります。
>package
-ファイル名は以下のようになります。
>&tt(){package.pl}
-package.pl のあるディレクトリは以下の通りです。
>&tt(){[Apache_server]}
>&tt(){ └ [cgi-bin]}
>&tt(){ └ [record]}
-package.pl を使用するプラグインは以下の通りです。
>&tt(){pin_mail_cart_record.pl}
-plugin 型プラグイン mail_cart_record (pin_mail_cart_record.pl) を呼び出すプラグインタグにはオプションにレコード名がついていなければなりません。
-標準伝票レコードを呼び出すプラグインタグは以下の通りです。
>&tt(){<#####mail_cart_record:package#####>}
-pin_mail_cart_record.pl の内容は以下の通りとなります。
>################################################################################
># #
># CAFEMILK SHOPPING CART V5 #
># SOHO WORKSHOP CAFEMILK 全権留保 #
># #
>################################################################################
>
>use strict;
># use warnings;
>use utf8;
># use encoding "utf8";
>
>>コーディングルールにより package 名を宣言
>package Cart_plugin;
>>以下はウェブ処理用
>sub mail_cart_record_html
> {
> # none
> }
>>以下はメール処理用
>sub mail_cart_record_mail
> {
>>コーディングルールによって義務づけられた各種情報の格納処理
> my $package = shift;
> my $argument = shift;
> my $config = $argument->{config};
> my $userdata = $argument->{userdata};
> my $log_error = $argument->{log_error};
> my $log_alert = $argument->{log_alert};
> my $status = $argument->{status};
>>オプションにて指定されたレコード名の取得
> my $target = $argument->{values}[0];
>>準備
> my $source;
>>内容のチェック
> if (($target ne '' )
> and (-e "./record/$target.pl"))
> {
>>該当のレコードプラグインを呼び出し
> require "./record/$target.pl";
>>オブジェクトの作成
> my $record = Cafemilk_record->new
> ({
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
> });
>>レコードの取得
> my $name = "record_$target";
> $source = $record->$name();
> }
>>レコードを return
> $source;
> }
>>最後に何か retern するのが Perl のお約束
>1;
-レコードプラグインはオブジェクト方式で実装されなければなりません。
-レコードプラグインは package を宣言しなければなりません。
-宣言する package 名は以下の通りとなります。
>Cafemilk_record
-レコードプラグインは以下のサブルーチンを持ちます。
>&tt(){new................. : オブジェクト作成}
>&tt(){record_ + レコード名 : レコード作成}
-package.pl の内容は一部以下の通りです。
>################################################################################
># #
># CAFEMILK SHOPPING CART V5 #
># SOHO WORKSHOP CAFEMILK 全権留保 #
># #
>################################################################################
>
>use strict;
># use warnings;
>use utf8;
># use encoding "utf8";
>
>>コーディングルールにより package 名を宣言
>package Cafemilk_record;
>>オブジェクト作成
>sub new
> {
> my $class = shift;
> my $argument = shift;
> my $config = $argument->{config};
> my $userdata = $argument->{userdata};
> my $log_error = $argument->{log_error};
> my $log_alert = $argument->{log_alert};
> my $status = $argument->{status};
> my $self =
> {
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
> };
> bless $self, $class;
> }
>>以下はレコードの作成
>sub record_package
> {
>>コーディングルールによって義務づけられた各種情報の格納処理
> my $class = shift;
> my $argument = shift;
> my $config = $class->{config};
> my $userdata = $class->{userdata};
> my $log_error = $class->{log_error};
> my $log_alert = $class->{log_alert};
> my $status = $class->{status};
>>コーディングルールにより %input_values にリクエストされた各情報を格納
> my %input_values;
> my @list =
> qw(
> input_1_name_sei input_1_name_mei
> input_1_name_kana_sei input_1_name_kana_mei input_1_company_name
> input_1_company_name_kana input_1_zipcode_1 input_1_zipcode_2
> input_1_address_1 input_1_address_2 input_1_address_3 input_1_address_4
> input_1_address_5 input_1_phone_1 input_1_phone_2 input_1_email_1
> input_1_email_2 input_1_email_3 input_1_email_4 input_2_name_sei
> input_2_name_mei input_2_name_kana_sei input_2_name_kana_mei
> input_2_company_name input_2_company_name_kana input_2_zipcode_1
> input_2_zipcode_2 input_2_address_1 input_2_address_2 input_2_address_3
> input_2_address_4 input_2_address_5 input_2_phone_1
> );
> foreach (@list)
> {
> $input_values{$_} = $userdata->{request_values}{$_}[0];
> }
>>WORDLIST 型スキンを読み込み
> my @word_list = Cafemilk_basic::get_wordlist
> ({
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
> filename => "./$config->{path}{skin}/user/cgi/$config->{default}{user_type}/$userdata->{device_type}/$userdata->{language_type}/$userdata->{currency_type}/$userdata->{template_type}/list_prefecture.txt",
> });
> if ($input_values{input_1_address_1})
> {
> $input_values{input_1_address_1} = $word_list[$input_values{input_1_address_1}];
> }
> if ($input_values{input_2_address_1})
> {
> $input_values{input_2_address_1} = $word_list[$input_values{input_2_address_1}];
> }
>>レコードの作成の準備
> my %parameter;
> # A
> # 01 mode
> $parameter{mode} = "1";
> # 02 1_zipcode_1
> $parameter{'1_zipcode_1'} = $input_values{input_1_zipcode_1};
> # 03 1_zipcode_2
> $parameter{'1_zipcode_2'} = $input_values{input_1_zipcode_2};
> # 04 1_address_1
> $parameter{'1_address_1'} = $input_values{input_1_address_1};
> # 05 1_address_2
> $parameter{'1_address_2'} = $input_values{input_1_address_2};
> # 06 1_address_3
> $parameter{'1_address_3'} = $input_values{input_1_address_3};
> # 07 1_address_4
> $parameter{'1_address_4'} = $input_values{input_1_address_4};
> # 08 1_address_5
> $parameter{'1_address_5'} = $input_values{input_1_address_5};
> # 09 1_name_sei
> $parameter{'1_name_sei'} = $input_values{input_1_name_sei};
> # 10 1_name_mei
> $parameter{'1_name_mei'} = $input_values{input_1_name_mei};
>
>>中略
>
> # D
> # 01 year
> $parameter{year} = $status->{datetime}{year};
> # 02 month
> $parameter{month} = $status->{datetime}{month};
> # 03 day
> $parameter{day} = $status->{datetime}{day};
> # 04 ordercode
> $parameter{ordercode} = $userdata->{ordercode};
> # 05 payment_name
> $parameter{payment_name} = $userdata->{cart_check}{payment_name};
> # 06 user_name
> $parameter{user_name} = $userdata->{user_registry_values}{user_name};
> # 07 get_point
> $parameter{get_point} = $userdata->{cart_check}{get_point};
> # 08 total_point
> $parameter{total_point} = $userdata->{cart_check}{total_point};
>>レコードの仕上げと return
> # encode & pair
> my @pair;
> foreach (keys %parameter)
> {
> my $key = $_;
> my $encode = Cafemilk_basic::url_encode
> ({
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
> text => $parameter{$key},
> });
> my $pair = "$key=$encode";
> push (@pair,$pair);
> }
> my $record = join("&",@pair);
> }
>>お約束
>1;
2009-09-25T13:40:31+09:00
1253853631
-
プラグイン plugin 型
https://w.atwiki.jp/cafemilk/pages/27.html
*plugin 型
**用語に注意
-まずは用語に注意することを覚えてください。
--プラグインには exeute 型と plugin 型があります。
--単に plugin と書く場合、それは plugin 型プラグインを意味しています。
--plugin とプラグインは、発音は同じですが意味は同じではありません。
--plugin 型プラグインはスキン内のプラグインタグによって呼び出されます。
**plugin の役割 1
-わかりやすく言うと、ブラウザに示される各ページのスキン部品が plugin です。
-execute 型プラグインはページ特有の処理 (execute) を行い、必要に応じて plugin 型プラグインの実行を行います。
-plugin 型プラグインが担う補助的な役割は主にスキン部品部分の作成です。
-plugin 型プラグインは execute と同様、処理を実行することができます。
--個々の execute においては execute 型プラグインが主体となって重要な処理を行い、plugin 型プラグインはその補助的な処理を行います。
-plugin 型プラグインはそれ自身が plugin 型プラグインの実行を行うことができます。
--plugin は入れ子状もしくはツリー状に実行可能です。
--これは、スキンやスキン部品の中にスキン部品の多様な挿入が可能であるということを意味します。
-plugin 型プラグインはスキンを要求します。
--execute 型プラグインはウェブ表示全体のレイアウトを指定するスキンを要求します。
--それに対し、plugin 型プラグインは部品となるスキンを要求します。
--plugin 型プラグインにより取得されたスキンは、呼び出し元が execute 型プラグインである場合は execute 型プラグインにより取得されたスキンに挿入される形になります。
--plugin 型プラグインにより取得されたスキンは、呼び出し元が plugin 型プラグインである場合は plugin型プラグインにより取得されたスキンに挿入される形になります。
**plugin の役割 2
-製品はメール書式もテンプレートとなっており、メール書面のスキン部品も plugin です。
--その仕様は execute スキンの場合ととほぼ同じです。
**処理の準備
-処理の準備は plugin を呼び出す execute もしくは plugin が行います。
-execute もしくは plugin はスキンの読み込みによって実行すべき plugin 名を受け取ります。
--plugin の実行はスキンの中に専用タグ (プラグインタグ) を用いて記述します。
--スキンの側から見た plugin は純粋にスキン部品です。
-受け取るプラグインタグは例えば以下のようになります。
>&tt(){<#####user_inquiry_step3#####>}
-プラグインタグには : 区切りにてオプションをつけることが可能です。
--しかしこれはほとんど使用されていないようです。
-オプション付きのプラグインタグは例えば以下のようになります。
>&tt(){<#####mail_cart_record:package#####>}
-execute もしくは plugin は、その execute もしくは plugin に固有の plugin を許可しなければなりません。
-あらかじめ許可されている (固有ではない) plugin のリストは以下の通りです。
--許可される固有の plugin の plugin 名はこのリストに追記されることになります。
>$config->{list}{plugin}
-$config->{list}{plugin} を設定しているファイルは以下の通りです。
>&tt(){[Apache_server]}
>&tt(){ └ [cgi-bin]}
>&tt(){ └ [config]}
>&tt(){ └ [admin]}
>&tt(){ └ config_basic.pl}
-固有の plugin を許可するコードは例えば以下のようになります。
>my @list =
> qw(
> user_inquiry_step3
> );
>push (@{$config->{list}{plugin}},@list);
-plugin が許可されていない場合、スキン内に該当のプラグインタグがあっても無視されます。
**呼び出し
-plugin の呼び出しはテンプレートエンジンによって行われますのであまり気にする必要はありません。
--しかし plugin から plugin を呼び出す場合はテンプレートエンジンを操作するコードを書く (plugin にテンプレートコントローラを内蔵する) 必要があります。
--呼び出すファイル名は、plugin/pin_ + plugin 名 + .pl となります。
-plugin 名が user_inquiry_step3 である場合、以下のようになります。
>&tt(){plugin/pin_user_inquiry_step3.pl}
**package 名
-plugin 型プラグインは package を宣言しなければなりません。
--宣言する package 名は、Cart_plugin となります。
-宣言は以下のようになります。
>################################################################################
># #
># CAFEMILK SHOPPING CART V5 #
># SOHO WORKSHOP CAFEMILK 全権留保 #
># #
>################################################################################
>
>use strict;
># use warnings;
>use utf8;
># use encoding "utf8";
>
>package Cart_plugin;
**サブルーチン
-plugin 型プラグインは、ウェブ処理用とメール処理用の二つのサブルーチンを持たなければなりません。
--サブルーチン名は、plugin 名 + _html と plugin 名 + _mail となります。
-plugin 名が user_inquiry_step3 である場合、ウエブ処理用のサブルーチンは以下のようになります。
>sub user_inquiry_step3_html
**plugin の処理
-以下は比較的簡単な plugin の例です。
--読み込むスキンが一つだけで、テンプレートエンジンの操作も最小限です。
>################################################################################
># #
># CAFEMILK SHOPPING CART V5 #
># SOHO WORKSHOP CAFEMILK 全権留保 #
># #
>################################################################################
>
>use strict;
># use warnings;
>use utf8;
># use encoding "utf8";
>
>>コーディングルールにより package 名を宣言
>package Cart_plugin;
>>以下はウェブ処理用
>sub user_inquiry_step3_html
> {
>>コーディングルールによって義務づけられた各種情報の格納処理
> my $package = shift;
> my $argument = shift;
> my $config = $argument->{config};
> my $userdata = $argument->{userdata};
> my $log_error = $argument->{log_error};
> my $log_alert = $argument->{log_alert};
> my $status = $argument->{status};
>>HTML テンプレートエンジンの使用にあたって処理名を準備
> my $pin_name = 'user_inquiry_step3_html';
>>HTML テンプレートエンジンで使用するスキンのパスを準備
> my $path = "./$config->{path}{skin}/user/cgi/$config->{default}{user_type}/$userdata->{device_type}/$userdata->{language_type}/$userdata->{currency_type}/$userdata->{template_type}/pin_user_inquiry_step3.html";
>>コーディングルールにより %input_values にリクエストされた各情報を格納……してません。
>>%input_values を宣言しているだけ。
> my %input_values;
>>コーディングルールにより $userdata->{tag_data} に HTML テンプレート用の各情報を格納
>>execute から execute 処理の成功を知らせる $status->{execute_success} を受け取ってその内容にしたがってテンプレートタグの値を変更している。
> if ($status->{execute_success})
> {
> $userdata->{tag_data}{temporal}{display_success_2} = 'none';
> }
> else
> {
> $userdata->{tag_data}{temporal}{display_submit} = 'none';
> $userdata->{tag_data}{temporal}{display_success_1} = 'none';
> }
>>HTML テンプレートエンジンのオブジェクトを作成
> my $skin = Cafemilk_skin_html->new
> ({
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
> name => $pin_name,
> });
>>スキンの読み込み
> $skin->set_path($path);
>>スキン内の HTML MIDDLE テンプレートタグを読み込む
> $skin->load_tag_middle();
>>許可されるテンプレートタグを指定
>>許可されるのは temporal のみ
> my @list = qw(temporal);
>>許可されたリストに基づいて HTML MIDDLE テンプレートタグを処理する
> $skin->replace_tag_middle
> ({
> allow => \@list,
> package => "Cafemilk_tag_html",
> });
>>コーディングルールにしたがい $userdata->{tag_data}{temporal} は内容をクリア
> undef $userdata->{tag_data}{temporal};
>>HTML テンプレートの結果を取得して return
> my $source = $skin->get_source();
> }
>>以下はメール処理用
>>メール処理用サブルーチンは必要ないがコーディングルール上記述する
>sub user_inquiry_step3_mail
> {
> # none
> }
>>最後に何か retern するのが Perl のお約束
>1;
-以上の例では、HTML テンプレートエンジンの処理は部分的に実施されています。
--ここでタグの取得と処理が行われているのは MIDDLE テンプレートタグのみです。
--タグはプラグインタグとテンプレートタグ、それぞれに HIGH, MIDDLE, LOW がありますから、その一部しか活用していないことになります。
-以下は plugin が大量のスキンを読み込んでいる例です。
>>HTML 型スキンの呼び出し
> my %path;
> my %source;
> my $common = "./$config->{path}{skin}/user/cgi/$config->{default}{user_type}/$userdata->{device_type}/$userdata->{language_type}/$userdata->{currency_type}/$userdata->{template_type}";
> my @list =
> qw(
> cell_head cell_body_image cell_body_text cell_body_flash cell_border
> cell_foot cell_nocart cell_body_noitem cell_body_block
> );
> foreach (@list)
> {
> my $line = $_;
> $path{$line} = "$common/pin_user_cart_main_$line.html";
> my $skin = Cafemilk_skin_html->new
> ({
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
> name => $pin_name,
> });
> $skin->set_path($path{$line});
> $source{$line} .= $skin->get_source();
> }
>>続いてWORDLIST 型スキンの呼び出し
> my @word_list_price_foot = Cafemilk_basic::get_wordlist
> ({
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
> filename => "./$config->{path}{skin}/user/cgi/$config->{default}{user_type}/$userdata->{device_type}/$userdata->{language_type}/$userdata->{currency_type}/$userdata->{template_type}/list_price_foot.txt",
> });
> my @word_list_item_alert = Cafemilk_basic::get_wordlist
> ({
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
> filename => "./$config->{path}{skin}/user/cgi/$config->{default}{user_type}/$userdata->{device_type}/$userdata->{language_type}/$userdata->{currency_type}/$userdata->{template_type}/list_item_alert.txt",
> });
> my @word_list_tax_status = Cafemilk_basic::get_wordlist
> ({
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
> filename => "./$config->{path}{skin}/user/cgi/$config->{default}{user_type}/$userdata->{device_type}/$userdata->{language_type}/$userdata->{currency_type}/$userdata->{template_type}/list_tax_status.txt",
> });
> my @word_list_ship_status = Cafemilk_basic::get_wordlist
> ({
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
> filename => "./$config->{path}{skin}/user/cgi/$config->{default}{user_type}/$userdata->{device_type}/$userdata->{language_type}/$userdata->{currency_type}/$userdata->{template_type}/list_ship_status.txt",
> });
> my @word_list_cart_message = Cafemilk_basic::get_wordlist
> ({
> config => $config,
> userdata => $userdata,
> log_error => $log_error,
> log_alert => $log_alert,
> status => $status,
> filename => "./$config->{path}{skin}/user/cgi/$config->{default}{user_type}/$userdata->{device_type}/$userdata->{language_type}/$userdata->{currency_type}/$userdata->{template_type}/list_cart_message.txt",
> });
-この場合、商品の一覧を表示するにあたって、Flash が用いられているか / 画像が用いられているか / テキストのみか / などの諸条件に応じて使用するスキンを選択する必要があるので、それらのパスを一括して指定し、さらに読み込みまで行っています。
-また、各スキンにおいて要求されるテンプレートタグの値を用意するため、WORDLIST 型スキンも多数を読み込んでいます。
--このあと、それらのスキンを処理したものを、ヘッダとフッタの間に、適宜ボーダーを挟みながら繰り返し挿入していくコードがあります。
--スキンには繰り返しなどの制御命令が書けない仕様なので、繰り返しは plugin 型プラグイン内にて書くことになります。
-読み込まれているスキンが多数ある場合、それらのスキンの名称を見れば、その振る舞いがだいたい解るものです。
-plugin ではまれにオプションが用いられます。
--plugin 型プラグイン内におけるオプションの取得方法は以下の通りです。
>sub mail_cart_record_mail
> {
> my $package = shift;
> my $argument = shift;
> my $config = $argument->{config};
> my $userdata = $argument->{userdata};
> my $log_error = $argument->{log_error};
> my $log_alert = $argument->{log_alert};
> my $status = $argument->{status};
>>一つめのオプションを取得
>>複数ある場合は連番となる
> my $target = $argument->{values}[0];
2009-09-24T23:30:48+09:00
1253802648