ユーザー入力のフォーム関連のクラスによく

$objFormParam->addParam(“お電話番号1”, ‘tel01’, TEL_ITEM_LEN, ‘n’, array(“EXIST_CHECK”, “SPTAB_CHECK”, “NUM_CHECK”, “MAX_LENGTH_CHECK”));

などと書かれているが、この”EXIST_CHECK”とか”SPTAB_CHECK”とか、実際何をチェックしているのかあいまいだったので調べてみました。

実際のチェックは
/data/class/SC_CheckError.php
に書かれています。

“HTML_TAG_CHECK”: HTMLのタグをチェックする

“EXIST_CHECK”: 必須入力の判定

“EXIST_CHECK_REVERSE”: 必須入力の判定(逆順)

“SPTAB_CHECK”: スペース、タブの判定（スペース、タブ、改行のみの入力はできません。）

“NO_SPTAB”: スペース、タブの判定（スペース、タブ、改行は含めないで下さい。）

“ZERO_START”: ゼロで開始されている数値の判定（0で始まる数値が入力されています。）

“SELECT_CHECK”: 必須選択の判定（選択されていません。）

“EQUAL_CHECK”: 同一性の判定（～と～が一致しません。）

“DIFFERENT_CHECK”: 値が異なることの判定（～と～は、同じ値を使用できません。）

“GREATER_CHECK”: 値の大きさを比較する （～は～より大きい値を入力できません。）

“MAX_LENGTH_CHECK”: 最大文字数制限の判定（○字以下で入力してください。）

“MIN_LENGTH_CHECK”: 最小文字数制限の判定（○字以上で入力してください。）

“MAX_CHECK”: 最大数値制限の判定 （n以下で入力してください。）←コメントでは「最大文字数制限の判定」と書かれているがたぶん間違い。

“MIN_CHECK”: 最小数値制限の判定（n以上で入力してください。）

“NUM_CHECK”: 数字の判定（は数字で入力してください。）

“NUM_POINT_CHECK”: 小数点を含む数字の判定（は数字で入力してください。）

“ALPHA_CHECK”: 半角の判定（は半角英字で入力してください。）

“TEL_CHECK”: 電話番号の判定（数字チェックと文字数チェック）

“FULL_EXIST_CHECK”:　関連項目が完全に満たされているか判定（ が入力されていません。）←全部入力されているかのチェック？使われていない？

“ALL_EXIST_CHECK”: 関連項目がすべて満たされているか判定（はすべての項目を入力して下さい。）←たとえば郵便番号など二つのテキストフィールドが入力されているかどうか

“ONE_EXIST_CHECK”: 関連項目がどれか一つ満たされているか判定（どちらか一方が入力されていればOK）

“TOP_EXIST_CHECK”: 上位の項目が満たされているか判定（は先頭の項目から順番に入力して下さい。）←規格の選択などで使用している。

“KANA_CHECK”: カタカナの判定

“KANABLANK_CHECK”: カタカナの判定２(タブ、スペースは許可する)

“ALNUM_CHECK”: 英数字の判定

“GRAPH_CHECK”: 英数記号の判定

“ZERO_CHECK”: 必須選択の判定（ひとつは選択してね）

“NUM_RANGE_CHECK”: 桁数の判定 (○○はｎ桁～ｎ桁で入力して下さい。)

“NUM_COUNT_CHECK”: 桁数の判定（○○はｎ桁で入力して下さい。）

“EMAIL_CHECK”: メールアドレス形式の判定

“EMAIL_CHAR_CHECK”: メールアドレスに使用できる文字の判定

“URL_CHECK”: URL”: URL形式の判定

“IP_CHECK”:  IPアドレスの判定

“FILE_EXT_CHECK”: 拡張子の判定

“FIND_FILE”: ファイルが存在するかチェックする

“FILE_EXIST_CHECK”: ファイルが上げられたか確認

“FILE_SIZE_CHECK”: ファイルサイズの判定（制限）

“FILE_NAME_CHECK”: ファイル名の判定（ファイル名に日本語やスペースは使用しないで下さい）

“FILE_NAME_CHECK_BY_NOUPLOAD”: ファイル名の判定(アップロード以外の時)

“CHECK_DATE”: 日付チェック[項目名,YYYY,MM,DD]

“CHECK_DATE2”: 日付チェック[項目名,YYYY,MM,DD,mm]

“CHECK_DATE3”: 日付チェック[項目名,YYYY,MM]

“CHECK_BIRTHDAY”: 誕生日チェック[項目名,YYYY,MM,DD]年の最大・最小数値のチェックがついている

“CHECK_SET_TERM”: 年月日に別れた2つの期間（YYYYMMDD）の妥当性をチェックし、整合性と期間を返す←要するに期間が正しいかどうか

“CHECK_SET_TERM2”: “CHECK_SET_TERM”のもっと細かい期間（YYYYMMDDHHmmss）のバージョン

“CHECK_SET_TERM3”: “CHECK_SET_TERM”の期間が年と月(YYYYMM)だけのバージョン

“DIR_CHECK”: ディレクトリがあるかどうか

“DOMAIN_CHECK”: ドメインの形式チェック

“MOBILE_EMAIL_CHECK”:  携帯メールアドレスのチェック

“CHECK_REGIST_CUSTOMER_EMAIL”: メールアドレスが会員登録されているか調べる

“PROHIBITED_STR_CHECK”: 禁止文字列のチェック

“EVAL_CHECK”: PHPコードとして評価可能かチェックする

代引きの手数料など一つ一つの支払い方法に説明文を入れたかったのでカスタマイズのメモ

データベーステーブルdtb_paymentにはmemo01とか02とか使われていないらしいカラムがあったのでそれを使うことにする。

１：管理画面のテンプレートを編集
data/Smarty/templates/admin/basis/payment_input.tpl
テーブルの行をひとつ追加
[html]
<tr>
<th>説明</th>
<!–{assign var=key value=”memo01″}–>
<td><textarea name=”<!–{$key}–>” cols=”60″ rows=”5″><!–{$arrForm[$key].value}–></textarea></td>
</tr>
[/html]

２：対象クラスを拡張
data/class_extends/pages/admin/basis/LC_Page_Admin_Basis_PaymentInput_Ex.php
フォームの内容を追加するためlfInitParamをオーバーライド
[PHP]function lfInitParam($mode, &$objFormParam) {
parent::lfInitParam($mode,$objFormParam);
$objFormParam->addParam(“説明”, “memo01”, STEXT_LEN, ‘KVa’, array(“SPTAB_CHECK”, “MAX_LENGTH_CHECK”));
}[/PHP]

３：公開側のテンプレートを編集
data/Smarty/templates/default/shopping/payment.tmpl
[html]
<!–{section name=cnt loop=$arrPayment}–>
<!–{$arrPayment[cnt].payment_memo01|h}–>
<!–{/section}–>
[/html]
※section ってよくわからないな。。foreachにしたい。。

４：データベースから値を持ってくるようにHelper_Purchase_Exクラスを編集
data/class_extends/helper_extends/SC_Helper_Purchase_Ex.php
getPaymentsByPriceをオーバーライドし、クエリにmemo01も入れるようにする
[php]
function getPaymentsByPrice($total,$deliv_id){
//省略
$payments = $objQuery->select(“payment_id, payment_method, rule, upper_rule, note, payment_image, charge, memo01”, “dtb_payment”, $where, $arrPaymentIds);
//省略
}[/php]

こちらのページ参考に商品詳細ページとリストページを静的URLにしたのですが、その影響でリストページがソートされなくなった。

調べてみると、どうやら
data/class/pages/products/LC_page_products_list.php
の
$this->arrForm = $_REQUEST;//時間が無いのでコレで勘弁してください。 tao_s
が影響している模様。

.htaccessを以下のように書き換えた。

RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
#RewriteRule ^detail([0-9]+).html+ detail.php?product_id=$1 [L]
RewriteRule ^detail([0-9]+).html+ detail.php?product_id=$1&%{QUERY_STRING} [L]
#RewriteRule ^list([0-9]+).html+ list.php?category_id=$1 [L]
RewriteRule ^list([0-9]+).html+ list.php?category_id=$1&%{QUERY_STRING} [L]

詳細ページなどをAjaxを使ってiframeで表示したいとき、共通のheader,footerを表示したくなかった。
でも管理画面のページレイアウト詳細設定で「共通のヘッダーを使用する」と「共通のフッターを使用する」のチェックボックスをはずしてしまうと、iframeで表示しない場合も表示されなくなってしまうので、iframeでの表示と通常の表示とで、読み込むヘッダーとフッタを変更したい。

１：まず
data/class_extends/SC_View_Ex.php
のassignTemplatePath()をオーバーライド
header_tpl_for_iframeとfooter_tpl_for_iframeとしてheader_iframe.tplとfooter_iframe.tplを新規で定義
[PHP]
function assignTemplatePath($device_type_id) {
parent::assignTemplatePath($device_type_id);
$templatePath = SC_Helper_PageLayout_Ex::getTemplatePath($device_type_id);
$header_tpl_for_iframe = $templatePath . “header_iframe.tpl”;
$footer_tpl_for_iframe = $templatePath . “footer_iframe.tpl”;

$this->assign(“header_tpl_for_iframe”, $header_tpl_for_iframe);
$this->assign(“footer_tpl_for_iframe”, $footer_tpl_for_iframe);
}

[/PHP]

２：該当するクラス（今回の場合は詳細ページなので）
data/class_extends/page_extends/products/LC_Page_Products_Detail_Ex.php
のprocessをオーバーライドし、arrPageLayoutにisIframeプロパティを追加。
クエリにdisplayMode=iframeとなっていたときにtrueに設定。

[PHP]
function process() {
$this->arrPageLayout[“isIframe”] = $this->getDisplayMode() == “iframe” ;
parent::process();
}
[/PHP]

displayModeはほかでも遣う気がしたのでページクラスを拡張
data/class_extends/page_extends/LC_Page_Ex.php
[PHP]
function getDisplayMode() {
$pattern = ‘/^[a-zA-Z0-9_]+$/’;
$mode = null;
if (isset($_GET[‘displayMode’]) && preg_match($pattern, $_GET[‘displayMode’])) {
$mode =  $_GET[‘displayMode’];
} elseif (isset($_POST[‘displayMode’]) && preg_match($pattern, $_POST[‘displayMode’])) {
$mode = $_POST[‘displayMode’];
}
return $mode;
}
[/PHP]

３：メインテンプレート
data/Smarty/default/site_main.tpl
にヘッダーとフッターを読み込むところがあるので分岐する。
[PHP]
<!–{if $arrPageLayout.isIframe}–>
<!–{include file= $header_tpl_for_iframe}–>
<!–{else}–>
<!–{include file= $header_tpl}–>
<!–{/if}–>
[/PHP]
[PHP]
<!–{if $arrPageLayout.isIframe}–>
<!–{include file= $footer_tpl_for_iframe}–>
<!–{else}–>
<!–{include file= $footer_tpl}–>
<!–{/if}–>
[/PHP]

４：読み込む専用のヘッダーとフッターを追加する
data/Smarty/default/header_iframe.tpl
data/Smarty/default/footer_iframe.tpl

５：html/products/.htaccessの内容を変更する。※！詳細ページを静的にしていない場合は必要ないです。
こちらのページを参考に詳細ページを静的URLにしていたので下記のように記述していたんですが、
RewriteRule ^detail([0-9]+).html+ detail.php?product_id=$1 [L]
これだURLのクエリ情報が付与されなかったため下記のように変更。
RewriteRule ^detail([0-9]+).html+ detail.php?product_id=$1&%{QUERY_STRING} [L]

＊追記 2011/11/31
この記事関係のない部分で別の問題もあったので最終的に.htaccessはこうなった。

６：lightbox的に表示したいのでプロダクトリストを編集する。今回はcolorboxを使用。
data/Smarty/default/products/list.tpl
jqueryとcolorboxを読み込んでおく。
[JAVASCRIPT]
$(document).ready(function() {
var colorbox_ajax = $(“.colorbox_ajax”);
$(“.colorbox_ajax”).each(function(){
var href = $(this).attr(“href”);
href += “?displayMode=iframe”;
$(this).attr(“href”,href);
});
$(“.colorbox_ajax”).colorbox({ width: “960px”, height: “420px”,iframe: true});
});
[/JAVASCRIPT]
[HTML]
<a href=”<!–{$smarty.const.P_DETAIL_URLPATH}–><!–{$arrProduct.product_id|u}–>.html” class=”colorbox_ajax”>product name</a>
[/HTML]
aタグのhrefには記述せず（直接来た場合はiframeじゃない版を表示したいので）、わざわざjqueryでループし、displayModeを付与した。

/data/class_extends/helper_extends/SC_Helper_Purchase_Ex.php
cleanupSessionをオーバーライド
[PHP]
function cleanupSession($orderId, &$objCartSession, &$objCustomer, $cartKey) {
$objCartSession->delAllAdditionalInfo();
parent::cleanupSession($orderId, $objCartSession, $objCustomer, $cartKey);
}
[/PHP]

※あらかじめ基本料金を基本情報として追加しておく。

合計金額に基本料金を追加する。
/data/class_extends/SC_CartSession_Ex.php

[PHP]
function calculate($productTypeId, &$objCustomer, $use_point = 0,
$deliv_pref = “”, $charge = 0, $discount = 0, $deliv_id = 0) {
$results = parent::calculate($productTypeId, $objCustomer, $use_point, $deliv_pref, $charge, $discount, $deliv_id);

$objDb = new SC_Helper_DB_Ex();
$col    = SC_Utils_Ex::sfGetCommaList(array(“basic_fee”));
$arrRet = $objDb->sfGetBasisData(true, $col);
$results[‘basic_fee’] = $arrRet[“basic_fee”];
$results[‘payment_total’] += $results[‘basic_fee’];

return $results;
}

[/PHP]

 

追記（2011/11/17）

culculateではなくて、getAllProductsTotalメソッド内で行ったほうがよさそうということで、変更しました。

[PHP]
function calculate($productTypeId, &$objCustomer, $use_point = 0,
$deliv_pref = “”, $charge = 0, $discount = 0, $deliv_id = 0) {
$results = parent::calculate($productTypeId, $objCustomer, $use_point, $deliv_pref, $charge, $discount, $deliv_id);

$objDb = new SC_Helper_DB_Ex();
$col    = SC_Utils_Ex::sfGetCommaList(array(“basic_fee”));
$arrRet = $objDb->sfGetBasisData(true, $col);
$results[‘basic_fee’] = $arrRet[“basic_fee”];
//$results[‘payment_total’] += $results[‘basic_fee’];

return $results;
}
function getAllProductsTotal($productTypeId) {
//省略

//基本料金を追加
$objDb = new SC_Helper_DB_Ex();
$col    = SC_Utils_Ex::sfGetCommaList(array(“basic_fee”));
$arrRet = $objDb->sfGetBasisData(true, $col);
$total += $arrRet[“basic_fee”];

return $total;
}

[/PHP]

 

１：データベースdtb_baseinfoに項目を追加

２：data/class_extends/page_extends/admin/basis/LC_Page_Admin_Basis_Ex.phpを編集
[php]
// 追加項目
function lfGetCol() {
$arrCol = parent::lfGetCol();
$arrCol[] = “basic_fee”;
return $arrCol;
}
function lfInitParam(&$objFormParam, $post) {
parent::lfInitParam($objFormParam, $post);
$objFormParam->addParam(“基本料金”, “basic_fee”, PRICE_LEN, ‘n’, array(“NUM_CHECK”, “MAX_LENGTH_CHECK”));
}
[/php]
※この例は基本料金(basic_fee）を追加した。

３：管理画面のテンプレートを編集
data/Smarty/templates/admin/basis/index.tpl
[php]
<tr>
<th>基本料金<span> *</span></th>
<td>
<span><!–{$arrErr.basic_fee}–></span>
<input type=”text” name=”basic_fee” value=”<!–{$arrForm.basic_fee|h}–>” maxlength=”<!–{$smarty.const.PRICE_LEN}–>” size=”6″ style=”<!–{if $arrErr.basic_fee != “”}–>background-color: <!–{$smarty.const.ERR_COLOR}–>;<!–{/if}–>” /> 円
</td>
</tr>
[/php]

K : 「半角(ﾊﾝｶｸ)片仮名」を「全角片仮名」に変換
C : 「全角ひら仮名」を「全角かた仮名」に変換
V : 濁点付きの文字を一文字に変換。”K”,”H”と共に使用
n : 「全角」数字を「半角(ﾊﾝｶｸ)」に変換
a : 「全角」英字を「半角」英字に変換

１：データベース：dtb_customerに必要な項目を追加

２：それらの項目にセレクトボックスなどの配列情報があればマスターデータも用意する。マスターデータのテーブルは[mtb_]で始まるテーブルとして設置。

３：下記、拡張クラスのfunction init()の中で新しい変数を設定し追加したマスターデータを代入しておく。

• data/class_extends/page_extends/admin/customer/LC_Page_Admin_Customer_Edit_Ex.php
• data/class_extends/page_extends/admin/customer/LC_Page_Admin_Customer_Ex.php
• data/class_extends/page_extends/admin/mail/LC_Page_Admin_Mail_Ex.php
• data/class_extends/page_extends/admin/total/LC_Page_Admin_Total_Ex.php
• data/class_extends/page_extends/entry/LC_Page_Entry_Ex.php
• data/class_extends/page_extends/mypage/LC_Page_Mypage_Change_Ex.php
• data/class_extends/page_extends/shopping/LC_Page_Shopping_Ex.php

[php]
function init() {
parent::init();
$masterData = new SC_DB_MasterData_Ex();
$this->[任意の編集名：例：arrHeight] = $masterData->getMasterData(“[追加したマスタデータテーブル名：例：mtb_height]”);
}
[/php]

４：テンプレートを修正する

• /data/Smarty/templates/default/frontparts/form_personal_input.tpl
• /data/Smarty/templates/admin/customer/edit.tpl

[php]
<!–{if $flgFields > 1}–>
<tr>
<th>[タイトル：例：身長]<span>※</span></th>
<td>
<!–{assign var=key1 value=”`$prefix`[キーとなる変数：例：height]”}–>
<!–{if $arrErr[$key1]}–>
<div><!–{$arrErr[$key1]}–></div>
<!–{/if}–>
<select name=”<!–{$key1}–>”>
<option value=”” selected=”selected”>身長を選択</option>
<!–{html_options options=[マスターテーブルの変数名：例：$arrHeight] selected=$arrForm[$key1]}–>
</select>
</td>
</tr>
<!–{/if}–>
[/php]

• /data/Smarty/templates/default/entry/confirm.tpl
• /data/Smarty/templates/admin/customer/edit_confirm.tpl
• /data/Smarty/templates/default/mypage/change_confirm.tpl
• /data/Smarty/templates/default/shopping/confirm.tpl
• /data/Smarty/templates/default/mail_templates/order_mail.tpl

[php]
<tr>
<th>[タイトル：例：身長]<span>※</span></th>
<td>
<!–{$arrForm.[変数名:例：height]|h}–>
</td>
</tr>
[/php]

５：データチェックを追加する。データチェックのヘルパークラスの拡張クラスにファンクションを追加する。
/data/class_extends/helper_extends/SC_Helper_Customer_Ex.php
sfCustomerCommonParam()をオーバーライドし、ファンクションsfCustomerCommonParamEx()を追加で呼ぶようにする。
[php]
function sfCustomerCommonParam (&$objFormParam) {
parent::sfCustomerCommonParam($objFormParam);
SC_Helper_Customer_Ex::sfCustomerCommonParamEx($objFormParam);
}

function sfCustomerCommonParamEx (&$objFormParam) {
//カスタマイズここから
$objFormParam->addParam(“身長”, ‘height’, STEXT_LEN, ‘n’, array(“EXIST_CHECK”, “SPTAB_CHECK”, “MAX_LENGTH_CHECK”));
//カスタマイズココまで
}
[/php]