cafemilk @ ウィキ

データベースログデータベース

2009-11-02T18:10:02+09:00

*ログデータベース -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.

データベース基本データベース

2009-10-20T23:10:14+09:00

*基本データベース -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(){　└　[

スキンテンプレートエンジン

2009-10-12T15:02:28+09:00

*テンプレートエンジン -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-bi

スキン概要

2009-10-02T17:43:11+09:00

*概要 **スキンの型 -スキンには種類とか型とか呼ばれる種別があります。 -その内容は以下の通りです。 -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####>.... : 低層プ

プラグインその他

2009-09-25T13:40:31+09:00

*その他 -カスタマイズの利便が要求される幾つかの機能は、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']; -上の設定の場合、以下の決済プ

プラグイン plugin 型

2009-09-24T23:30:48+09:00

*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 です。

プラグイン exeute 型

2009-09-21T19:49:09+09:00

*execute 型 **用語に注意 -まずは用語に注意することを覚えてください。 --プラグインには exeute 型と plugin 型があります。 --プログラム実行の基本単位は execute 型プラグインで、これを execute と呼びます。 --ウェブの各ページは execute の結果出力されます。 --execute 型プラグインは execute 名で呼ばれる一連の処理を扱います。 --execute 型プラグインは、自己診断処理, execute 処理, 後処理を実施します。 **execute の役割 -わかりやすく言うと、ブラウザに示される各ページが execute です。 -execute 型プラグインはページ特有の処理 (execute) を行い、必要に応じて plugin 型プラグインの実行を行います。 --個々の execute においては execute 型プラグインが主体となって重要な処理を行い、plugin 型プラグインはその補助的な処理を行います。 --plugin 型プラグインが担う補助的な役割は主にスキン部品部分の作成です。 -execute 型プラグインも plugin 型プラグインも共にスキンを要求します。 --execute 型プラグインはウェブ表示全体のレイアウトを指定するスキンを要求します。 --それに対し、plugin 型プラグインは部品となるスキンを要求します。 ---plugin 型プラグインにより取得されたスキンは execute 型プラグインにより取得されたスキンに挿入される形になります。 **処理の準備 -処理の準備は基本エンジン (コントローラ) が行います。 -コントローラはリクエストによって実行すべき execute 名を受け取ります。 -受け取るリクエストは例えば以下のようになります。 >&tt(){main.cgi?execute=admin_gate} -リクエストによって execute が指示されなかった場合、規定値が適用されます。 -規定値は以下に設定されています。 >$config->{default}{execute_type} -$config->{default}{execute_type} を設定しているファイルは以下の通

仕様基本エンジン

2009-09-19T15:25:19+09:00

*基本エンジン -もしくはコントローラ --製品は MVC モデルに基づいて製作されています。 **基本エンジンの概要 -CAFEMILK SHOPPING CARAT V5 におけるコントローラの役割は以下のファイルが担います。 >&tt(){main.cgi} -コントローラのファイル名は変更が可能です。 --変更した場合は変更にあわせて設定も変更する必要があります。 -コントローラはユーザーからのリクエストを受け付けます。 -コントローラはクッキーの取得と検査と発行を行います。 -コントローラはセッションを発行し、ログイン処理を行います。 -コントローラはリクエストに応じてプラグインの一種である execute 型プラグインの実行処理を行います。 -コントローラはテンプレートエンジンの発行する WEB ソースを出力します。 **基本エンジンのソース -ソースの引用と解説 >#!c:/user/local/bin/perl510/bin/perl.exe >>書き換えの例 >>#!/user/local/bin/perl >################################################################################ ># # ># CAFEMILK SHOPPING CART V5 # ># SOHO WORKSHOP CAFEMILK 全権留保 # ># # >################################################################################ ># 本プログラムは UTF-8 で

インストールバージョンアップ

2009-09-13T21:52:29+09:00

*バージョンアップ -バージョンアップの告知は管理画面のトップにて行われます。 -セキュリティ関連の更新があった場合は差し替えを行いましょう。 **注意点 -新しいバージョンを単に上書きするようなことはしないでください。 --特にディレクトリ統合ファイルにあるものを上書きすると、設定がクリアされ、そのうえ、商品情報等のデータベースが消失することになります。 **その 1 -次のバージョンへ差し替える場合。 -バージョンアップの詳細は製品に添付されている以下のファイルに記されています。 >02バージョン情報.txt -通常はこのファイルの内容にしたがって差し替えを行います。 -設定やデータベースといったファイルに更新があった場合は差分を調べたうえで慎重に差し替えを行わなければなりません。 **その 2 -2 つ以上進んだバージョンへ差し替える場合。 -面倒ですが差分を調べて差し替えを行います。 **差分の抽出 -差分の抽出にあたってソフトウェアを用意します。 -必要なソフトウェアは以下の通りです。 >AikoWin >WinMerge -AikoWin --[[ダウンロードページ>http://nomal.que.ne.jp/kohi/freesoft.shtml]] -WinMerge --公式版 [[ダウンロードページ>http://winmerge.org/]] --日本語版 [[ダウンロードページ>http://www.geocities.co.jp/SiliconValley-SanJose/8165/winmerge.html]] -比較用にディレクトリを 3 つ作成します。 -ディレクトリの役割はこのようになります。 >&tt(){A [古いバージョンのアーカイブのファイル群]} >&tt(){B [新しいバージョンのアーカイブのファイル群]} >&tt(){C [現在運用しているもののファイル群]} -AikoWin を用い A と B を比較して B にある同一のファイルを削除します。 -AikoWin を用い A と C を比較して C にある同一のファイルを削除します。 -WinMerge の 3 ペインモードにて B と C に残ったファイルについて A と B と C を比較し

インストールその他

2010-10-23T20:16:17+09:00

*その他 -手っ取り早く本運用に進めるための情報です。 **ドメイントップを main.cgi にしたい -通常ドメインのトップは index.html と相場が決まっていますが、サーバによってはアクセスコントロールファイル (.haccess) を用いるとドメイントップのファイル名を変更することができます。 -.haccess に記述する内容は以下の通りです。 >DirectoryIndex main.cgi **CGI であることを隠蔽したい 1 -サーバによってはアクセスコントロールファイル (.haccess) を用いると、完全に隠蔽とはいきませんが、拡張子.cgiをなくした状態での運用が可能です。 -.haccess に記述する内容は以下の通りです。 > >ForceType cgi-script > -これにあわせて設定を変更します。 -設定ファイルの位置は以下のようになります。 >&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()

cafemilk @ ウィキ

データベース ログデータベース

データベース 基本データベース

スキン テンプレートエンジン

スキン 概要

プラグイン その他