ECCUBEの問い合わせフォームに任意の値を引数として渡す方法

2015/06/25 2017/03/12

ECCUBEの問い合わせフォームに値を渡す方法の解説

問い合わせフォームに値を渡す

　

　
ECCUBEで、上記の画面のイメージのように、お問い合わせフォームに値を渡せるようにする方法を解説します。
　
この記事では商品一覧ページから商品情報を引数に問い合わせをする想定にしていますが、ボタンが設置できれば引き渡すものは商品情報に限らずなんでも OKです。
　
　
また、この記事は、ECCUBE 2.13.3で確認を行いました。
2.12系では試していませんが、大きく違わなさそうなので動くんじゃないかと思います。
　
　

テンプレートファイルの修正箇所

「お問い合わせへ」のボタンの設置

　
最初に「お問い合わせへ」のボタンを設置です。
　
最初の画像のように商品一覧の場合は下記のファイルになります。
/data/smarty/templates/default/products/list.tpl
　
ボタンを設置したい場所に下記のコードを追加します。
ただし、これを設置する場所は、商品情報のページなどに編集する場合は、商品情報の <form> …… </form>の間ではないところに編集する必要があります。

<form method="POST" action="<!--{$smarty.const.HTTPS_URL}-->contact/<!--{$smarty.const.DIR_INDEX_PATH}-->">
<input type="hidden" name="<!--{$smarty.const.TRANSACTION_ID_NAME}-->" value="<!--{$transactionid}-->" />
<input type="hidden" name="mode" value="inquiry">
<input type="hidden" name="shohin" value="<!--{$arrProduct.name|h}-->">
<input type="submit" name="submit" value="この商品をお問い合わせ">
</form>

<form method="POST" action="contact/">

<input type="hidden" name="" value="" />

</form>

　
「mode=inquiry」の時に「shohin」に商品情報を入れて POSTするという処理になります。
5行目の「shohin」の valueの値には「商品名（$arrProduct.name）」を編集する処理になっていますが、違う値を編集する場合はここを変更してください。
　
<form> …… </form>の間に編集したい場合は、JavaScriptで POSTする方法を採る必要があります。
　
　

入力フォームのテンプレートに表示の追加

　
お問い合わせフォームの入力テンプレートに、送られてきた情報を編集する箇所を追加します。
　
対象ファイルは下記のファイルになります。
/data/smarty/templates/default/contact/index.tpl
　
以下が送られてきた情報を表示させる箇所です。テキストを表示させたい場所に追加をします。
if文で送られてきた値があるときだけ表示を行います。

<!--{if $arrForm.shohin.value}-->
■お問い合わせ商品：
<!--{$arrForm.shohin.value|default:$arrData.shohin|h}-->
<!--{/if}-->

■お問い合わせ商品：

　
　
下記は、送られてきた情報を hiddenで保持するための設定です。
34行目あたりの「<input type=”hidden” name=”mode” value=”confirm” />」の次の行に編集するといいでしょう。

<input type="hidden" name="shohin" value="<!--{$arrForm.shohin.value|default:$arrData.shohin|h}-->" />

1	<input type="hidden" name="shohin" value="<!--{$arrForm.shohin.value\|default:$arrData.shohin\|h}-->" />

入力確認画面のテンプレートに表示の追加

　
お問い合わせフォームの入力確認ページに編集する箇所を追加します。
　
対象ファイルは下記のファイルになります。
/data/smarty/templates/default/contact/confirm.tpl
　
フォームの入力画面と同じく、テキストを表示させたい場所に追加をします。

<!--{if $arrForm.shohin.value}-->
■お問い合わせ商品：
<!--{$arrForm.shohin.value|default:$arrData.shohin|h}-->
<!--{/if}-->

■お問い合わせ商品：

確認メールのテンプレートに表示の追加

　
入力完了後に送信される確認メールのメールテンプレートにも情報を編集する箇所を追加します。
　
対象ファイルは下記のファイルになります。
/data/smarty/templates/default/mail_templates/contact_mail.tpl
　
入力画面と同じく、テキストを表示させたい場所に追加をします。

<!--{if $arrForm.shohin.value}-->
■問い合わせ商品：<!--{$arrForm.shohin.value}-->
<!--{/if}-->

■問い合わせ商品：

独習PHP 第3版

プログラムファイルの修正箇所

実際の処理をするプログラムの追加

　
最後に、実際に処理を行うプログラムファイルの変更を行います。
　
対象ファイルは下記のファイルになります。
/data/class/pages/contact/lc_page_contact.php
　
126行目あたりの「default:」の上あたりに編集をします。（82行目辺りにある「switch ($this->getMode()) {」の処理の分岐の一つとして、追加します。）
　

case 'inquiry':
  $this->lfInitParam2($objFormParam);
  $objFormParam->setParam($_POST);
  $this->arrErr = $objFormParam->checkError();
  $this->arrForm = $objFormParam->getFormParamList();
  break;

case 'inquiry':

$this->lfInitParam2($objFormParam);

$objFormParam->setParam($_POST);

$this->arrErr = $objFormParam->checkError();

$this->arrForm = $objFormParam->getFormParamList();

break;

　
最初のボタンの追加のところで説明した、「mode=inquiry」の時に「shohin」に商品情報が送られてくるため、それを受け取る処理になります。
3行目の「$_POST」で送信されてきた情報を受け取りますが、入っているのは「shohin」のみにします。
　
　
続けて、155行目辺りに下記を追加します。（「function lfInitParam(&$objFormParam)」の中の 1項目として追加します。）

$objFormParam->addParam('商品名', 'shohin', STEXT_LEN, 'KVa', array('SPTAB_CHECK', 'MAX_LENGTH_CHECK'));

1	$objFormParam->addParam('商品名', 'shohin', STEXT_LEN, 'KVa', array('SPTAB_CHECK', 'MAX_LENGTH_CHECK'));

　
　
157行目辺りに下記を追加します。（「function lfInitParam(&$objFormParam)」の次の関数として追加をします。）

public function lfInitParam2(&$objFormParam)
{
    $objFormParam->addParam('商品名', 'shohin', SMTEXT_LEN, 'KVa', array('EXIST_CHECK', 'SPTAB_CHECK', 'MAX_LENGTH_CHECK'));
}

public function lfInitParam2(&$objFormParam)

{

$objFormParam->addParam('商品名', 'shohin', SMTEXT_LEN, 'KVa', array('EXIST_CHECK', 'SPTAB_CHECK', 'MAX_LENGTH_CHECK'));

}

　
関数「lfInitParam2」として、商品情報が送られてきた状態でお問い合わせに来る場合の関数として想定していますので、「EXIST_CHECK」を入れていますが、ない場合も想定する場合は「EXIST_CHECK」は外してください。
155行目に追加する方の行には、商品に関連しないお問い合わせの場合もあるため「EXIST_CHECK」は入れていません。（この場合は、「case ‘inquiry’:」を通らず、「default」の処理の方を通ります。）
　
　
以上の対応で、お問い合わせフォームに情報を引数で渡して、確認メールにもその情報を送れるようになります。
　
思っていたよりは簡単に出来ましたね。

- PHP・Smarty・ECCUBE