ec-cube / ec-cube2

EC-CUBE official repository version 2

EC-CUBE 4.2

4.1からの更新内容はリリースノートをご確認ください。

• 本ドキュメントはEC-CUBEの開発者を主要な対象者としております。
• パッケージ版はEC-CUBEオフィシャルサイトで配布しています。
• カスタマイズやEC-CUBEの利用、仕様に関しては開発コミュニティをご利用ください。
• 本体開発にあたって不明点などあればIssueをご利用下さい。
• EC-CUBE 3系の保守については、 EC-CUBE/ec-cube3にて開発を行っております。
• EC-CUBE 2系の保守については、 EC-CUBE/ec-cube2にて開発を行っております。

インストール

EC-CUBE 4.2のインストール方法

開発ドキュメントの インストール方法 の手順に従ってインストールしてください。

CSS の編集・ビルド方法

Sass を使用して記述されています。 Sass のソースコードは html/template/{admin,default}/assets/scss にあります。 前提として [https://nodejs.org/ja/] より、 Node.js をインストールしておいてください。

以下のコマンドでビルドすることで、 html/template/**/assets/css に CSS ファイルが出力されます。

npm ci # 初回およびpackage-lock.jsonに変更があったとき
npm run build # Sass のビルド

docker compose を使用している場合は以下のコマンドを実行してください

# 初回およびpackage-lock.jsonに変更があったとき
docker compose -f docker-compose.yml -f docker-compose.dev.yml -f docker-compose.nodejs.yml run --rm -T nodejs npm ci
# Sass のビルド
docker compose -f docker-compose.yml -f docker-compose.dev.yml -f docker-compose.nodejs.yml run --rm -T nodejs npm run build

JavaScript のビルド方法

フロントエンドで使用する JavaScript のライブラリは npm で管理されています。 JavaScript のライブラリは webpack でバンドル/minifyされます。 バンドルするライブラリを変更する場合は、テンプレートごとに以下の bundle.js を修正し、リビルドしてください。

• html/template/admin/assets/js/bundle.js
• html/template/default/assets/js/bundle.js
• html/template/install/assets/js/bundle.js

npm ci # 初回およびpackage-lock.jsonに変更があったとき
npm run build # Sass 及び JavaScript のビルド

JavaScript ライブラリのみをビルドしたい場合は以下でも可能です。

npx webpack

docker compose を使用している場合は以下のコマンドを実行してください

# 初回およびpackage-lock.jsonに変更があったとき
docker compose -f docker-compose.yml -f docker-compose.dev.yml -f docker-compose.nodejs.yml run --rm -T nodejs npm ci
# Sass のビルド
docker compose -f docker-compose.yml -f docker-compose.dev.yml -f docker-compose.nodejs.yml run --rm -T nodejs npm run build
# JavaScript ライブラリのみのビルド
docker compose -f docker-compose.yml -f docker-compose.dev.yml -f docker-compose.nodejs.yml run --rm -T nodejs npx webpack

動作確認環境

• Apache 2.4.x (mod_rewrite / mod_ssl 必須)
• PHP 7.4.x / 8.0.x / 8.1.x
• PostgreSQL 10.x or higher / MySQL 5.7.x or 8.0.x
• ブラウザー：Google Chrome

詳しくは開発ドキュメントの システム要件 をご確認ください。

ドキュメント

EC-CUBE 4.x 開発ドキュメント@doc4.ec-cube.net

EC-CUBE 4.x 系の仕様や手順、開発Tipsに関するドキュメントを掲載しています。 修正や追記、新規ドキュメントの作成をいただく場合、以下のレポジトリからPullRequestをお送りください。 https://github.com/EC-CUBE/doc4.ec-cube.net

開発への参加

EC-CUBE 4.2の不具合の修正、機能のブラッシュアップを目的として、継続的に開発を行っております。
コードのリファクタリング、不具合修正以外のPullRequestを送る際は、Pull Requestのコメントなどに意図を明確に記載してください。

Pull Requestの送信前に、Issueにて提議いただく事も可能です。 Issuesの利用方法については、こちらをご確認ください。

Slackでも本体の開発に関する意見交換などを行っております。

コピーライトポリシーへの同意

コードの提供・追加、修正・変更その他「EC-CUBE」への開発の御協力（Issue投稿、Pull Request投稿など、GitHub上での活動）を行っていただく場合には、 EC-CUBEのコピーライトポリシーをご理解いただき、ご了承いただく必要がございます。 Issueの投稿やPull Requestを送信する際は、EC-CUBEのコピーライトポリシーに同意したものとみなします。

ec-cube2's Issues

商品登録時に先頭が0の数字がそのまま表示されてしまう

概要

商品登録ページにて、販売価格等の半角数字を入力する項目で0が先頭の値("0100"など)を入力すると確認ページでそのままの値で表示されてしまう。

発生箇所

商品管理>商品登録
商品管理>商品登録>確認ページ

発生頻度

毎回

再現手順

商品管理>商品登録のページにて、

• 通常価格
• 販売価格
• 在庫数
• 商品送料(有効にしていれば)
• ポイント付与率
• 販売制限数

の項目に0で始まる値を半角数字で入力して
"確認ページへ"ボタンを押す。
確認ページで0で始まる値がそのまま表示されてしまう

ただし、この手順で入力された値は登録後に商品マスタで確認すると先頭の0を除いた値となっている。

-

確かに例外ではあるが、CSV の取得機能を実装してあるのだから、自然復帰を期待できる。

管理機能＞商品選択ポップアップ画面で規格2のonchangeに存在しないfnCheckStock()が使われている

http://svn.ec-cube.net/open_trac/changeset/23448 で削除されていると思われるfnCheckStock()が templates/admin/order/product_select.tpl で呼び出されている。

<dd>
    <select name="classcategory_id2" id="<!--{$class2}-->" style="<!--{$arrErr[$class2]|sfGetErrorColor}-->" onchange="fnCheckStock(this.form);"></select>
    <!--{if $arrErr[$class2] != ""}-->
    <br /><span class="attention">※ <!--{$tpl_class_name2[$id]}-->を入力して下さい。</span>
    <!--{/if}-->
</dd>

レスポンスヘッダ X-Content-Type-Options が出力されていない。

概要

X-Content-Type-Options:nosniffが出力されておらず、
クロスサイトスクリプティング等の攻撃被害につながる危険性がある。

対応

レスポンスヘッダ X-Content-Type-Options:nosniff を出力する。

帳票の発行日の文言が統一されていない

概要

帳票の作成ウインドウには"発行日"と表記されているが
出力される帳票には"作成日"と表記されているので文言が統一されていない

発生箇所

受注管理＞個別出力
受注管理＞編集＞帳票出力

発生頻度

毎回

-

MySQL 5.7.5 以降でエラー発生

storage_engine <= 5.7.4
default_storage_engine >= 5.5.3

http://xoops.ec-cube.net/modules/newbb/viewtopic.php?topic_id=16981&post_id=74582&forum=2
http://dev.mysql.com/doc/refman/5.7/en/server-system-variables.html#sysvar_default_storage_engine
http://dev.mysql.com/doc/refman/5.5/en/server-system-variables.html#sysvar_default_storage_engine

送料を0にできる不具合

やり方
送付先の都道府県を設定するときにページのソースをいじり，
北海道=1, 青森=2,...と割り当ててある都道府県のIDを0に設定し送信する．

こうすることで処理が適切に行われず送料が0円に設定されるようです．

郵便番号CSVが存在しないとエラー停止する不具合を修正

商品一覧の価格順並び替えが登録されていない商品規格に影響される

商品一覧で価格順に表示した際に、登録していない規格の価格を含めた状態で並び替えられます。
再現手順は以下の通りです。

1. 2.13.5 をインストール。
2. 商品ID:1 アイスクリームの商品管理＞商品登録(商品規格)を開く。
3. いずれかの規格の販売価格を 1 に変更、登録のチェックボックスを外し、登録。
4. 商品一覧を開き、価格順 で並び替える。

SC_Product::findProductIdsOrder() が、dtb_products_class.del_flg を考慮していないための現象と思われます。

EC-CUBE 2.13.4, 2.13.5 で確認。

会員登録時の確認用Eメールアドレス入力がコピペ許可になっているため、効果がない。

概要

　会員登録時の確認用Eメールアドレス入力がコピペ許可になっているため、確認用途で設置するには効果が薄い。
　結果的に、Eメールアドレスの誤入力を誘発する可能性が上がる。

対応

　スマホ、PCの会員登録入力フォームにおいて、該当カラムのコピペ入力を付加とする。

帳票の商品名で途中に改頁があると次頁の表示が崩れる

帳票PDFを出力する際、商品名が長くて2行以上になる商品のセルの途中で改ページが行われると、商品名以降の列が次のページに表示され、レイアウトが崩れます。

LC_Page_Admin_Products_Product::lfHasSameProductImage() 「$this->objUpFile」って存在しないかと

Warning が発生すると、セッションが切れてしまう場合がある

Warning が発生した際に「不正なページ移動です」エラー画面になってしまう場合がある模様。
通常、「不正なページ移動です」エラー画面になった場合は、 data/logs/error.log が出力されるが、このケースは出力されないため、原因の特定が困難である。
#69 によるデグレード。

レスポンスヘッダ X-XSS-Protection が出力されていない。

概要

レスポンスヘッダにてX-XSS-Protection:1を出力することにより、
クロスサイトスクリプティング攻撃による被害を軽減することができる。

帳票の住所が長い場合に改行されずに他の項目にかぶって表示されてしまう

概要

受注管理＞受注登録で注文者情報の住所(字数制限200文字)に長い文字列を入れて登録し、その注文の帳票を出力すると帳票の住所の欄が改行されずに隣のロゴにかぶって表示されてしまう

発生箇所

受注管理＞受注管理＞帳票個別出力

発生頻度

毎回

無効な支払方法で購入手続きを通過できる

存在しない支払方法IDでさえ抜けられる。

• 入力内容のご確認画面で「お支払方法」は空欄となる。
• デベロッパーツールで書き換えて確認。

2.13.3のプラグインアップデート機能が動作しない

フォーラムにて報告あり

http://xoops.ec-cube.net/modules/newbb/viewtopic.php?topic_id=15315&forum=9&post_id=69412#forumpost69412

帳票発行日がご注文日より前の日付で作成できてしまう

概要

帳票作成時に"発行日"の欄にご注文日より前の日付を入力して帳票を作成することができてしまう

発生箇所

受注管理＞個別出力
受注管理＞編集＞帳票出力

発生頻度

毎回

不適切な投稿

受注管理＞受注登録で2商品以上ある状態で、変更を行っても正しく変更されない

http://svn.ec-cube.net/open_trac/ticket/2585
こちらの問題と根っこは同じです

どちらも原因は、shipping_ の更新はフォームの値を上書きするが、 order_detail は 追加して削除をするので 並び順に差異が生まれる為です

変更でも、checkInsertOrderProductsを呼んでいることが問題

自動ロールバックをオンにして誤って決済処理中にステータスを変更するとオーダーが削除される

管理画面＞受注登録・編集画面にて、お名前（フリガナ）にカタカナ以外の文字を登録できてしまう

概要

画面：管理画面＞受注登録画面
現象：お名前（フリガナ）にカタカナ以外の文字を登録できてしまう

対応

　バリデーションチェック("KANA_CHECK")を追加し、カタカナ以外の文字が入力された際にエラーを表示する

csv出力設定完了時に表示崩れ

概要

画面：管理画面＞コンテンツ管理＞csv出力設定画面
現象：csv出力設定完了時に表示崩れが起きる。（alertウィンドを消すまで）
検証環境：IE 11, Firefox 36, Chrome 41

対応

　alertウィンドを表示するタイミングを変更する。

管理画面の商品選択用ポップアップ画面の商品コード検索が重いという不具合の漏れ

http://svn.ec-cube.net/open_trac/ticket/1931

受注編集画面が漏れている

プラグイン管理で、「アップロード」と「インストール」を分離。

フォーラムで提案され、コードまで書いてありました。 他のCMSを見ても必須の機能だと思います。

http://xoops.ec-cube.net/modules/newbb/viewtopic.php?topic_id=12779&post_id=58850&order=0&viewmode=flat&pid=58845&forum=7#forumpost58850

現状、プラグイン管理では、「インストール」の指示で、・圧縮ファイルをアップロード・圧縮ファイルの解凍・dtb_pluginへの登録・プラグインのインストールになるかと思います。当方で借りているサーバーは、かつて：SSHが利用できた。いま：SSHが許可されない。また、PHPによる圧縮ファイルの解凍ができない。つまり、プラグイン管理機能でのインストールができないのです。そのため、解凍したプラグインをアップロードし、ファイルに記述されているインストール内容を手作業で実施しています。そこで、WordPressのようにアップロードとインストールを分離できれば、手作業による誤りもなくなりありがたいのです。

Tracからの転記

Tracでのコメント

• Author: Kim

プラグインの開発仕様に関わるため、ひとまずバックログへと移動します。

新着情報管理　順番の変更が出来ない

概要

「□番目に移動」の□内に全角数字を入力すると移動が出来ない。エラー文も表示されない。「商品の並び替え」は全角数字でも移動する。

発生個所

管理画面>コンテンツ管理＞新着情報管理

頻度

常に起こっていると思われる。

Masterをチェックアウトして確認しています。

決済処理中ロールバックによって会員ログイン中の画面でエラーが出る不具合

SC_Helper_Purchase::rollbackOrder($order_id, $orderStatus = ORDER_CANCEL, $is_delete = false)で決済処理中の受注をロールバックする場合、

1. 決済処理中の受注を取得し、その受注IDでステータスをキャンセルに変更する。
2. その受注IDに紐づく一時受注を取得する。
3. 一時受注の削除フラグを0にして保存する。
   という手順を踏みます。
   しかし、受注ステータスが決済処理中で、かつ一時受注が存在しない受注が存在する場合、
   2で一時受注が取得できず、そのまま3で保存しようとするためDBエラーが発生します。
   このロールバック処理はPENDING_ORDER_CANCEL_FLAGがtrueで会員ログイン時はページ読み込み毎に呼び出されるため、上記の条件に合致する受注を持つ会員は毎回エラーページが表示されます。
   そのため3の手順を
4. 「一時受注が存在する場合、」一時受注の削除フラグを0にして保存する。
   に変更する必要があります。

再現方法:
PENDING_ORDER_CANCEL_FLAGをtrueに変更する。
受注登録画面で任意の会員+決済処理中のステータスで受注を登録する。
受注登録した会員でログインする。

消費税加算額の配列添字のtypo

○: tax_adjust
☓: tax_adjuts

SC_CartSession 内の配列要素の扱いが怪しい

[0]としている箇所が疑わしい。

うち1箇所は #85 で削除済み。

未検証だが、常に NULL が渡ったりしていないだろうか。その場合、商品規格を使った、商品毎の税率設定に不備を生じる懸念を感じる。

商品管理　商品の並び替えが出来ない

概要

一番上の商品に対する「□番目へ移動」の指示が正常に反映されない。
しばらく動かしていると、正常に作動するようになる。
また、商品の上下の移動は最初から可能。

発生個所

管理画面>商品管理>商品並び替え

頻度

初回のみと思われる

Masterをチェックアウトして確認しています。

帳票発行時に不要なバリデートが行われている

概要

帳票発行時に発行日の"年"、"月"、"日"の以下のバリデートはCHECK_DATEでチェックできているため、不必要であるにもかかわらず行われている。

• "年"が数値であるか
• "月"が数値であるか
• "日"が数値であるか
• "月"が1以上12以下であるか
• "日"が1以上31以下であるか

発生箇所

受注管理＞個別出力
受注管理＞編集＞帳票出力

商品別税率機能の不具合

trac のほうにしか登録されていなかったので備忘録として。
http://svn.ec-cube.net/open_trac/ticket/2616

http://xoops.ec-cube.net/modules/newbb/viewtopic.php?viewmode=thread&topic_id=15055&forum=10&post_id=67418#forumpost67418

一覧ではproduct_class_idがsfCalcIncTaxに対して渡されていない事に関係する不具合みたいです。

6ddbf536d2192e625457f277fc17c429297cd3b9 によって通過しなくなった処理が放置されている

定休日管理のタイトルの字数制限が表記と異なる

概要

定休日管理登録用フォームのタイトルの項目に"(上限100文字)"と表記しているが、51文字以上の文字列を入力すると"※ タイトルは50字以下で入力してください。"と表示されて弾かれてしまう。

発生箇所

基本情報管理＞定休日管理

発生頻度

毎回

再現手順

1. 基本情報管理＞定休日管理にてタイトルの項目に51文字以上の文字列を入力する
2. 妥当な日付を入力する
3. "この内容で登録する"ボタンを押す
4. エラーメッセージが表示されて入力が弾かれる

【管理画面＞基本情報管理＞SHOPマスター】Googleマップ範囲外の座標を指定するとマップが表示されない

概要

画面：管理画面＞基本情報管理＞SHOPマスター
現象：Googleマップ範囲外の座標を入力した後に"地図で設定"を押下すると地図が表示されない。

対応

　Googleマップ範囲外の座標が入力されている場合は北緯35度東経135度を指定する。

"お届け先を指定"チェックボックスにチェックがないと"お届け先を複数指定する"ボタンが表示されない(SP)

概要

画面：スマートフォン,"会員登録をせずに購入"時のお客様情報入力画面
現象："お届け先を指定"チェックボックスにチェックがないと"お届け先を複数指定する"ボタンが表示されない。

配送先を複数指定する際に"お届け先を指定"チェックボックスをチェックする必要がある。
結果、お客様情報入力画面にて別の配送先情報を入力しなければ次の画面に進むことができない。

対応

　ボタンの表示位置を変更、PC同様にお届け先の複数指定ができるよう修正。

cvs出力で特定ユーザが出力されない

フォーラムより
http://xoops.ec-cube.net/modules/newbb/viewtopic.php?topic_id=16652&forum=11&post_id=73501#forumpost73501

データ移行csvとかでも抜けて痛い目にあいます

プラグイン機能 テンプレートに対するトランスフォームが環境によって正常に動作しない

PHPがリンクしているlibxmlのバージョンが2.7未満の場合に生じる問題

具体的な不具合
・テキストのみのテンプレート（主にメールテンプレート）の場合に、libxmlのバージョンが古いと記号類が数値参照形式になってしまう。
・長大なHTMLの場合、正常にパースできない

パース自体が失敗している場合に処理を迂回するような改修の必要性がありそうです。

詳細は下記コミュニティ内にて http://xoops.ec-cube.net/modules/newbb/viewtopic.php?topic_id=12017&forum=10&post_id=55450#forumpost55450

※主にhetemlサーバーで生じる模様

Tracからの転記

EC-CUBE/ec-cubeからもってこれるものをもってくる

https://github.com/EC-CUBE/ec-cubeからもってこれるものはもってくる。

• robots.txt
• appveyor.yml

など

プラグインでZIP形式のサポート

プラグインや, デザインテンプレートのアーカイブ形式を ZIP もサポートさせる.

ZIP 形式は PHP のデフォルトエクステンションに含まれていないが, 既に多くのレンタルサーバーがサポートしていると思われる

Trac からの転記

Tracでのコメント

• Author： poego

PHP5.1系のサポートを切ってPHP5.2以上にできるなら、ZipArchive? クラスが使えるので良いかと。
http://jp1.php.net/manual/ja/class.ziparchive.php
郵便番号ZIPの解凍のようにZip関数でやろうとすると、郵便番号とちがって、Zip内サブディレクトリを考慮しないといけないのでごちゃごちゃ独自実装する事になり不安がのこりそうです。

• Author： nanasess

  JSON と同様に 5.1 系の場合は PECL でインストールしてもらえれば良いのではないでしょうか??

• Author: Kim

  2.13系からは、PHP5.2以上となっているため小規模回収として取り扱い可能とし、次期バージョンでの実装を検討

郵便番号検索ページの URL 変更

リンク切れになっているため、変更が必要
http://search.post.japanpost.jp/zipcode/
↓
http://www.post.japanpost.jp/zipcode/

SC_Helper_TaxRule の処理で国別、県別税率の処理の不整合

キャッシュの確認の後にログインしているかどうかを判定しているため、TaxRuleの取得が一部不足している。

    public static function getTaxRule($product_id = 0, $product_class_id = 0, $pref_id = 0, $country_id = 0)
    {
        // 複数回呼出があるのでキャッシュ化
        static $data_c = array();

        // 初期化
        $product_id = $product_id > 0 ? $product_id : 0;
        $product_class_id = $product_class_id > 0 ? $product_class_id : 0;
        $pref_id = $pref_id > 0 ? $pref_id : 0;
        $country_id = $country_id > 0 ? $country_id : 0;

        // 一覧画面の速度向上のため商品単位税率設定がOFFの時はキャッシュキーを丸めてしまう
        if (OPTION_PRODUCT_TAX_RULE == 1) {
            $cache_key = "$product_id,$product_class_id,$pref_id,$country_id";
        } else {
            $cache_key = "$pref_id,$country_id";
        }

        if (empty($data_c[$cache_key])) {
            // ログイン済み会員で国と地域指定が無い場合は、会員情報をデフォルトで利用。管理画面では利用しない
            if (!(defined('ADMIN_FUNCTION') && ADMIN_FUNCTION == true)) {
                $objCustomer = new SC_Customer_Ex();
                if ($objCustomer->isLoginSuccess(true)) {
                    if ($country_id == 0) {
                        $country_id = $objCustomer->getValue('country_id');
                    }
                    if ($pref_id == 0) {
                        $pref_id = $objCustomer->getValue('pref');
                    }
                }
            }

SC_CartSession::getAllProductsPoint() で Warning 発生

Cannot use a scalar value as an array

PHP 5.4.16

追加した届け先の内容を修正しようとした時、内容をそのままに実行するとエラーが出る

開発フォーラムにて報告がありました
デフォルトの2.13.3で再現します

http://xoops.ec-cube.net/modules/newbb/viewtopic.php?topic_id=15484&post_id=69233&order=0&viewmode=flat&pid=69230&forum=8#forumpost69233

セッションチェックの強化

セッションの管理を強化する

SC_UploadFile::getFormFileList() 第1,2引数を省略可能とし、基本は省略する

$this->save_dir を使う。ただし、第3引数を利用するシーンもあるため、第1,2引数はデフォルトを NULL として、処理中に分岐処理する。

jQueryのバージョンアップによる不具合

• 商品の規格登録・編集で在庫無制限を解除しても在庫が登録できない

-

実質的な動作が変わらないものを扱う。

mb_convert_kana パラメーターが局所的に冗長