Changes between Version 1 and Version 2 of カスタマイズと移行の手引（v2.0）

Timestamp:

2007/10/09 12:52:56 (15 years ago)

Author:

nanasess

Comment:

--

カスタマイズと移行の手引（v2.0）

@@ -1 +1 @@
 ''このページは書きかけです...''
-= カスタマイズと移行の手引（v1.5） =
+= カスタマイズと移行の手引（v2.0） =
 
-EC-CUBE 1.5 では, 以前のバージョンより, 大幅なアーキテクトの変更を行いました.[[BR]]
+EC-CUBE 2.0 では, 以前のバージョンより, 大幅なアーキテクトの変更を行いました.[[BR]]
 これは主に, アップグレード時のマージ作業緩和, 自動アップデート機能実装のためと, より柔軟なカスタマイズを可能にするためです.
 
@@ -9 +9 @@
  1. ディレクトリ構成
     * ディレクトリ構成が大きく変わりました.
-      * [wiki:ディレクトリ構成（v1.5）]
+      * [wiki:ディレクトリ構成（v2.0）]
       * ''data/lib'', ''data/include'' 以下の関数群は, '''data/class/util''', '''data/class/helper''' 以下のクラスへ移動しました.
         * '''data/class/util''' 以下のクラスは, スタティック参照するユーティリティ系のクラスです.
@@ -24 +24 @@
 
 == カスタマイズの手引 ==
-EC-CUBE 1.5 からは, 以前のバージョンでの課題であった, バージョンアップ時におけるマージ作業が大幅に緩和されます.[[BR]]
+EC-CUBE 2.0 からは, 以前のバージョンでの課題であった, バージョンアップ時におけるマージ作業が大幅に緩和されます.[[BR]]
 また, 「自動アップデート」機能により, 配信サーバーによる自動的なバグフィックスや, バージョンアップが可能となりました.[[BR]]
 是非, 以下の方法でカスタマイズを実施して下さい!
 
- * '''data/class''' 以下に '''***_extends''' というディレクトリがあります. この中にカスタマイズ用のクラス群があります.
-    * 関数をカスタマイズする場合は, 必ず '''***_extends''' 以下のクラスで継承し, オーバーライドしてカスタマイズして下さい. 
+ * '''data/class_extends''' 以下にカスタマイズ用のクラス群があります.
+    * 関数をカスタマイズする場合は, 必ず '''***_extends''' 以下のクラスで継承し, オーバーライドしてカスタマイズして下さい.
       * EC-CUBE がバージョンアップした場合でも, これらのファイルは '''更新されない''' ため, 煩わしいマージ作業から開放されます.
  1. html 以下のファイルを修正したい場合は, '''data/class/pages''' 以下を見て下さい.
  2. html と同じ階層構造になっており, '''LC_Page_ディレクトリ名_ファイル名.php''' というようなクラスファイルがあり, この中にロジックが詰まっています. しかし, '''このクラスをカスタマイズしてはいけません.'''
- 3. '''data/class/page_extends''' に, 同様の階層構造があります. '''LC_Page_ディレクトリ名_ファイル名_Ex.php''' というクラスファイルがあり, これらは '''data/class/pages''' のクラス群を継承しています. 
+ 3. '''data/class/page_extends''' に, 同様の階層構造があります. '''LC_Page_ディレクトリ名_ファイル名_Ex.php''' というクラスファイルがあり, これらは '''data/class/pages''' のクラス群を継承しています.
  4. このクラスの, '''init()''', '''process()''', '''destroy()''' という関数をカスタマイズすることにより html 以下のファイルの動作を修正できます.
    * index.php に対応するクラスのみ, '''LC_Page_ディレクトリ名_Ex.php''' というように, ファイル名及びクラス名が省略されています.
-   * ''EC-CUBE 1.5 では, 以前のバージョンのロジックを「ほぼそのまま」移植しているため, リファクタリングが不十分です. これは新規バージョンで徐々に改善していく予定です''
+   * ''EC-CUBE 2.0 では, 以前のバージョンのロジックを「ほぼそのまま」移植しているため, リファクタリングが不十分です. これは新規バージョンで徐々に改善していく予定です''
+
+=== テンプレート機能の改善 ===
+EC-CUBE 2.0 からは, モバイル, 管理ページ を含む, すべての画面において, カスタムテンプレートが作成可能となりました.[[BR]]
+ * デフォルトのテンプレートは以下へ配置
+   * アップデート機能は, これらのファイルも上書きする
+{{{
+   html/user_data/templates/default/js
+   html/user_data/templates/default/css
+   html/user_data/templates/default/img
+   data/Smarty/templates/default      -> メイン, ヘッダ/フッタ, その他
+   data/Smarty/templates/default/cp   -> キャンペーン用
+   data/Smarty/templates/default/bloc -> ブロック
+   data/Smarty/templates/default/bloc/cp -> キャンペーン用 ブロック
+   data/Smarty/templates/default/
+   data/Smarty/templates/default/cp  -> キャンペーン用 メイン, ヘッダ/フッタ
+}}}
+ * 管理画面から修正可能なテンプレート, CSS
+   * これらのファイルは, アップデート機能はアクセスしない
+   * 管理画面から修正した場合のみ, 下記のファイルを参照する(common.css
+     を除く)
+   * 下記のファイルを削除すると, default テンプレート or カスタムテン
+     プレートのファイルを参照する.
+{{{
+   html/user_data/css/common.css -> CSS編集
+   html/user_data/include/bloc/*.tpl -> ブロック編集
+   html/user_data/include/*.tpl      -> ヘッダ/フッタ編集
+   html/user_data/templates/*.tpl      -> メイン編集
+   html/user_data/*.php      -> 新規ページ作成
+   html/user_data/*.tpl      -> 新規ページテンプレート
+}}}
+ * カスタムテンプレートを作成する場合は, default の部分を他の名前に変更する.
+   * アップデート機能はカスタムテンプレートを上書きしない
+   * テンプレートの切り替えは, 定数の値を変更することで対応する[[BR]]
+     例) default -> custom
+     * 管理画面から変更可能
+     * html/user_data/css/common.css は手作業で修正する必要あり.
+