ECCUBE3(Symfony)のテンプレート(Twig)内でのシステムURL出力

忘備録として随時更新中。テンプレ内をよく探せば出てくるのだが、、、。

 

  • トップページURL

 

  • カレントページ(現在アクセスしているページ)URL

 

  • 商品一覧ページURL

 

  • 商品画像保存ディレクトリの絶対パス

 

  • 商品詳細ページURL

 

  • 商品詳細ページでのメイン画像URL (Pinterestボタンに画像URLのパラメタ付けたい時とか)

 

参考サイト)

 

ECCUBE3でカテゴリに補足情報を追加する

EC-CUBE 3.0.16
MySQL 5.6.19
PHP 5.6.36

例として、あるカテゴリに「関連A」(assoc_A)という補足情報を追加する場合。

1. テーブルへのカラム追加
dtb_categoryテーブルへ”assoc_A”という名前のカラムをtinyintタイプで追加。また、NULLを許可にする。

2. エンティティファイルに、セッターゲッター追加
/src/Eccube/Entity/Category.php

以下のように追記。

 

3. データベース定義ファイルへカラム追加
/src/Eccube/Resource/doctrine/Eccube.Entity.Category.dcm.yml

fields一覧にassoc_Aの項目を追加。データベースとエンティティクラスを接続するのがdcm.yml(Doctrineマッピングファイル)。これにより、Categoryエンティティのassoc_Aとdtb_categoryのassoc_Aカラムが接続される。

※データ型がint,smallint,tinyintでも、Formでcheckboxタイプを使う予定のため( 論理型(値が1か0のタイプ)と認識されるので)ブーリアンタイプにしておく。

ECCUBE3で使用できるtype一覧は過去記事参照

 

4. フォーム定義ファイルへの項目追加
/src/Eccube/Form/Type/Admin/CategoryType.php

下記のように、管理画面の商品登録フォームへ定義を追加。

 

5. 管理画面(カテゴリ登録画面)へフォーム表示
/app/template/admin/Product/category.twig

フォームを表示したい場所に下記のように記述。

 

6. 商品詳細ページへの表示
/app/template/default/Product/detail.twig

関連付けした情報を使って詳細ページでごにょごにょするには、多少の工夫が必要。これについては別途書く予定。

とりあえず以上。

 

参考URL)

 

 

ECCUBE3で商品に新しい項目を追加

EC-CUBE 3.0.16
MySQL 5.6.19
PHP 5.6.36

例として、商品名かな(name_kana)という項目を追加する場合。

1. テーブルへのカラム追加
dtb_productテーブルへ”name_kana”という名前のカラムをtextタイプ(またはvarchar)で追加。また、NULLを許可にする。

2. エンティティファイルに、セッターゲッター追加
/src/Eccube/Entity/Product.php

以下のように追記。

 

3. データベース定義ファイルへカラム追加
/src/Eccube/Resource/doctrine/Eccube.Entity.Product.dcm.yml

fields一覧にname_kanaの項目を追加。データベースとエンティティクラスを接続するのがdcm.yml(Doctrineマッピングファイル)。これにより、Productエンティティのname_kanaとdtb_productのname_kanaカラムが接続される。

ちなみに、EC-CUBE3が採用しているSymfonyの標準ORM、Doctorineで設定できるフィールドタイプは以下の通り。

 

4. フォーム定義ファイルへの項目追加
/src/Eccube/Form/Type/Admin/ProductType.php

下記のように、管理画面の商品登録フォームへ定義を追加。

上記の書き方で入力必須とならない場合(未入力で保存した際にエラーとならない)場合は、下記のようにする。

 

なお、フォームの入力形式として整数型としたい場合は、第2引数に”integer”, 浮動小数点型としたい場合は、第2引数に”number”を指定するなどして対応。

このほかにも選択型(choice型)も指定できる。詳細は公式ドキュメントを参照。

 

5. 管理画面(商品情報登録画面)へフォーム表示
/app/template/admin/Product/product.twig

フォームを表示したい場所に下記のように記述。

form_rowは、form_label、form_widget、form_errorsを同時に出力する関数。テキストの入力幅を小さくしたい場合などは、form_label、form_widget、form_errorsに分割するなどしてCSSで対応。

 

6. 商品詳細ページへの表示
/app/template/default/Product/detail.twig

フロント側で出力。好きな場所に下記のように記載。未登録であれば何も出力されない。

 

以上。

 

参考URL)

 

Twigの小技まとめ

文字列省略(Twig1.6以降)

 

HTML参照文字エスケープ

 

リプレース

 

改行文字をbrに

 

ループ

 

ループの中で使える便利なやつ

 

正規表現マッチング

 

その他は随時更新。

 

参考URL)

  •  https://hrroct.hatenablog.com/entry/2017/04/28/184032
  • https://qiita.com/assa/items/4fef2f3abd95248ed626
  • https://twig.symfony.com/doc/2.x/filters/replace.html
  • https://tetra-themes.com/eccube3-dump-498/
  • http://www.tomcky.net/entry/2018/02/08/010639
  • http://mononofu.hatenablog.com/entry/20111209/1323431291