【3.0.15】お問い合わせのカスタマイズ

今回は社内からの質問についての返答です。
内容としては以下の物でした。
　
　EC-CUBE3 でお問い合わせ内容の項目を変更したい。
　
何処かがプラグインを作っていそうなのですが無料では見当たらない様です。
お問い合わせ関係はお問い合わせの内容を管理するプラグインが多く、項目変更は見当たらないとのことでした。
・・・これは会社のプラグインとして発表するチャンスかな（笑）
　
とは云え今回の案件は短納期の為、本体のカスタマイズでも良いのとのことです。
まぁ、それであれば本体をカスタマイズしてしまいましょう。
　
担当から状況を確認したところ、とりあえず入力画面のテンプレートから任意項目を削除したが確認ページへ遷移しないとのことです。
まぁ、良くも悪くも EC-CUBE 2系との違いですね。
EC-CUBE 2系であれば簡単な部類なカスタマイズなんですが、3系の場合ある程度変更が必要なようですね。
　
今回の変更項目については以下のようなものでした。
　
　■項目の追加
　　・会社名【任意】
　
　■項目の削除
　　・お名前（フリガナ）【任意】
　　・住所（郵便番号・都道府県・住所）【任意】
　　・電話番号【任意】
　
追加項目はともかく削除に関しては任意項目のため非表示で対応できると考えたそうです。
しかし、結果として buildForm の項目を触らないといけないようです。
　
　・
　・
　・
　
対応内容は以下のようになりました。
取り急ぎ、これでメールフォームの変更完了です。
　
　
１．フォーム内容の設定
　●ファイル
　　＜インストールフォルダ＞/src/Eccube/Form/Type/Front/ContactType.php
　●モジュール
　　buildForm
　●参考行目
　　40行目ぐらいから
　●変更内容

1/**
2 * {@inheritdoc}
3 */
4public function buildForm(FormBuilderInterface $builder, array $options)
5{
6    $builder
7        ->add('name', 'name', array(
8            'required' => true,
9        ))
10        ->add('kana', 'kana', array(
11            'required' => false,
12        ))
13        ->add('zip', 'zip', array(
14            'required' => false,
15        ))
16        ->add('address', 'address', array(
17            'required' => false,
18        ))
19        ->add('tel', 'tel', array(
20            'required' => false,
21        ))
22        ->add('email', 'email', array(
23            'required' => true,
24            'constraints' => array(
25                new Assert\NotBlank(),
26                new Assert\Email(array('strict' => true)),
27            ),
28        ))
29        ->add('contents', 'textarea', array(
30            'help' => 'form.contact.contents.help',
31            'constraints' => array(
32                new Assert\NotBlank(),
33            ),
34        ));
35}

　↓

1/**
2 * {@inheritdoc}
3 */
4public function buildForm(FormBuilderInterface $builder, array $options)
5{
6    $builder
7        ->add('company_name', 'text', array(
8            'required' => false,
9        ))
10        ->add('name', 'name', array(
11            'required' => true,
12        ))
13        ->add('email', 'email', array(
14            'required' => true,
15            'constraints' => array(
16                new Assert\NotBlank(),
17                new Assert\Email(array('strict' => true)),
18            ),
19        ))
20        ->add('contents', 'textarea', array(
21            'help' => 'form.contact.contents.help',
22            'constraints' => array(
23                new Assert\NotBlank(),
24            ),
25        ));
26}

　●概要説明
　　不要部分の削除と「会社名」の追加をしています。
　　EC-CUBE の場合には会員情報に「会社名」が存在する為、変数名を「company_name」で統一しています。
　　入力内容は「text」タイプです。
　　後は”任意項目”とするため「required」を「false」としています。

1->add('company_name', 'text', array(
2    'required' => false,
3))

　　この辺りを色変更すると独自の入力項目を作成できますのでお試しください（笑）
　
　
２．お問い合わせ入力画面の変更
　●ファイル
　　＜インストールフォルダ＞/src/Eccube/Resource/template/default/Contact/index.twig
　　※「＜インストールフォルダ＞/app/template/default/Contact」に複製してから作業するようにしましょう。
　●テンプレート
　　テンプレートファイル top_box__body_inner内
　●参考行目
　　50行目ぐらいから
　●変更内容

1<div id="top_box__body_inner" class="dl_table">
2    <dl id="top_box__name">
3        <dt>{{ form_label(form.name) }}</dt>
4        <dd class="form-group input_name">
5            {{ form_widget(form.name.name01) }}
6            {{ form_widget(form.name.name02) }}
7            {{ form_errors(form.name.name01) }}
8            {{ form_errors(form.name.name02) }}
9        </dd>
10    </dl>
11    <dl id="top_box__kana">
12        <dt>{{ form_label(form.kana) }}</dt>
13        <dd class="form-group input_name">
14            {{ form_widget(form.kana.kana01) }}
15            {{ form_widget(form.kana.kana02) }}
16            {{ form_errors(form.kana.kana01) }}
17            {{ form_errors(form.kana.kana02) }}
18        </dd>
19    </dl>
20    <dl id="top_box__address_detail">
21        <dt>{{ form_label(form.address) }}</dt>
22        <dd>
23            <div id="top_box__zip" class="form-group form-inline input_zip {% if form.zip.zip01.vars.errors is not empty or form.zip.zip02.vars.errors is not empty %}has-error{% endif %}">{{ form_widget(form.zip) }}</div>
24            <div id="top_box__address" class="{% if form.address.pref.vars.errors is not empty or form.address.addr01.vars.errors is not empty or form.address.addr02.vars.errors is not empty %}has-error{% endif %}">
25                {{ form_widget(form.address) }}
26                {{ form_errors(form.address) }}
27            </div>
28        </dd>
29    </dl>
30    <dl id="top_box__tel">
31        <dt>{{ form_label(form.tel) }}</dt>
32        <dd>
33            <div class="form-inline form-group input_tel">
34                {{ form_widget(form.tel, {attr : {class : 'short'}}) }}
35                {{ form_errors(form.tel) }}
36            </div>
37        </dd>
38    </dl>
39    <dl id="top_box__email">
40        <dt>{{ form_label(form.email) }}</dt>
41        <dd>
42            <div class="form-group">
43                {{ form_widget(form.email) }}
44                {{ form_errors(form.email) }}
45            </div>
46        </dd>
47    </dl>
48    <dl id="top_box__contents">
49        <dt>{{ form_label(form.contents) }}</dt>
50        <dd>
51            <div class="column">
52                {{ form_widget(form.contents) }}
53                {{ form_errors(form.contents) }}
54            </div>
55        </dd>
56    </dl>
57</div>

　↓

1<div id="top_box__body_inner" class="dl_table">
2    <dl id="top_box___company_name">
3        <dt>{{ form_label(form.company_name) }}</dt>
4        <dd class="form-group">
5            {{ form_widget(form.company_name) }}
6            {{ form_errors(form.company_name) }}
7        </dd>
8    </dl>
9    <dl id="top_box__name">
10        <dt>{{ form_label(form.name) }}</dt>
11        <dd class="form-group input_name">
12            {{ form_widget(form.name.name01) }}
13            {{ form_widget(form.name.name02) }}
14            {{ form_errors(form.name.name01) }}
15            {{ form_errors(form.name.name02) }}
16        </dd>
17    </dl>
18    <dl id="top_box__email">
19        <dt>{{ form_label(form.email) }}</dt>
20        <dd>
21            <div class="form-group">
22                {{ form_widget(form.email) }}
23                {{ form_errors(form.email) }}
24            </div>
25        </dd>
26    </dl>
27    <dl id="top_box__contents">
28        <dt>{{ form_label(form.contents) }}</dt>
29        <dd>
30            <div class="column">
31                {{ form_widget(form.contents) }}
32                {{ form_errors(form.contents) }}
33            </div>
34        </dd>
35    </dl>
36</div>

　●概要説明
　　不要部分の削除と「会社名」の追加をしています。
　　EC-CUBE の場合には「company_name」の情報が会員情報用に作成されている為、標準の場合は以下の記述で「会社名」と表示されます。

`1`	`{{ form_label(form.company_name) }}`

項目名が異なる場合は以下の形で良いと思います。

`1`	`<dt>表示させたい項目名</dt>`

　
　
３．お問い合わせ入力内容確認画面の変更
　●ファイル
　　＜インストールフォルダ＞/src/Eccube/Resource/template/default/Contact/confirm.twig
　　※「＜インストールフォルダ＞/app/template/default/Contact」に複製してから作業するようにしましょう。
　●テンプレート
　　テンプレートファイル confirm_box__body_inner内
　●参考行目
　　41行目ぐらいから
　●変更内容

1<div id="confirm_box__body_inner" class="dl_table">
2    <dl id="confirm_box__name">
3        <dt>{{ form_label(form.name) }}</dt>
4        <dd class="form-group">
5            {{ form_widget(form.name.name01) }}
6            {{ form_widget(form.name.name02) }}
7        </dd>
8    </dl>
9    <dl id="confirm_box__kana">
10        <dt>{{ form_label(form.kana) }}</dt>
11        <dd class="form-group">
12            {{ form_widget(form.kana.kana01) }}
13            {{ form_widget(form.kana.kana02) }}
14        </dd>
15    </dl>
16    <dl id="confirm_box__address">
17        <dt>{{ form_label(form.address) }}</dt>
18        <dd>
19            <div class="form-group">
20                {{ form_widget(form.zip) }}<br />
21                {{ form_widget(form.address) }}
22            </div>
23        </dd>
24    </dl>
25    <dl id="confirm_box__tel">
26        <dt>{{ form_label(form.tel) }}</dt>
27        <dd>
28            <div class="form-group">
29                {{ form_widget(form.tel) }}
30            </div>
31        </dd>
32    </dl>
33    <dl id="confirm_box__email">
34        <dt>{{ form_label(form.email) }}</dt>
35        <dd>
36            <div class="form-group">
37                {{ form_widget(form.email) }}
38            </div>
39        </dd>
40    </dl>
41    <dl id="confirm_box__contents">
42        <dt>{{ form_label(form.contents) }}</dt>
43        <dd>
44            <div class="column">
45                {{ form_widget(form.contents) }}
46            </div>
47        </dd>
48    </dl>
49</div>

　↓

1<div id="confirm_box__body_inner" class="dl_table">
2    <dl id="confirm_box__company_name">
3        <dt>{{ form_label(form.company_name) }}</dt>
4        <dd class="form-group">
5            {{ form_widget(form.company_name) }}
6        </dd>
7    </dl>
8    <dl id="confirm_box__name">
9        <dt>{{ form_label(form.name) }}</dt>
10        <dd class="form-group">
11            {{ form_widget(form.name.name01) }}
12            {{ form_widget(form.name.name02) }}
13        </dd>
14    </dl>
15    <dl id="confirm_box__email">
16        <dt>{{ form_label(form.email) }}</dt>
17        <dd>
18            <div class="form-group">
19                {{ form_widget(form.email) }}
20            </div>
21        </dd>
22    </dl>
23    <dl id="confirm_box__contents">
24        <dt>{{ form_label(form.contents) }}</dt>
25        <dd>
26            <div class="column">
27                {{ form_widget(form.contents) }}
28            </div>
29        </dd>
30    </dl>
31</div>

　●概要説明
　　不要部分の削除と「会社名」の追加をしています。
　　基本的には入力画面の変更と同じようなものですね。
　
　
４．送信メール内容の変更
　●ファイル
　　＜インストールフォルダ＞/src/Eccube/Resource/template/default/Mail/contact_mail.twig
　　※「＜インストールフォルダ＞/app/template/default/Mail」に複製してから作業するようにしましょう。
　●テンプレート
　　テンプレートファイル「■お名前　：」の辺りから
　●参考行目
　　40行目ぐらいから
　●変更内容

1■お名前　：{{ data.name01 }} {{ data.name02 }}{% if data.kana01 or data.kana02 %} ({{ data.kana01 }} {{ data.kana02 }}){% endif %} 様
2■郵便番号：{% if data.zip01 and data.zip02 %}〒{{ data.zip01 }} - {{ data.zip02 }}{% endif %}
3 
4■住所　　：{% if data.pref.name is defined %} {{ data.pref.name }}{% endif %}{{ data.addr01 }}{{ data.addr02 }}
5■電話番号：{{ data.tel01 }} - {{ data.tel02 }} - {{ data.tel03 }}
6■メールアドレス：{{ data.email }}
7■お問い合わせの内容
8 
9{{ data.contents }}

　↓

1■会社名　：{{ data.company_name }}
2■お名前　：{{ data.name01 }} 様
3■メールアドレス：{{ data.email }}
4■お問い合わせの内容
5 
6{{ data.contents }}

　●概要説明
　　不要部分の削除と「会社名」の追加をしています。
　　ちなみに管理者向けにも同じ内容のメールが送信される形です。
　
　
・・・という感じですね。
細かいところまでは確認できていませんが、メールが届くことは確認できたので良しとしましょう（笑）
本当はログインしている時用の処理やチョットした情報もあるるのですが、大分長くなったのでここで一区切りです。
　
　
残りの処理に関しては次回に持ち越しとさせて頂きます（笑）
と云うことでお問い合わせの項目変更についてでした。

EC-CUBE3 分室