オーバーライドについて

オーバーライドシステムについて
 
■オーバーライドシステム
 
Zencart がテンプレートファイルを読み込む際には、まずはじめに各ファイルに対して「オーバーライド」ファイルが存在しているかどうかを確認します。もし、「オーバーライドファイル」が存在しない場合には、デフォルトのコアファイルを読み込みます。

■ファイルに対して何らかの編集を行いたいと思う場合には、まずオーバーライド可能であるかどうかをご確認ください。

以下の様な場合には、オーバーライドが可能です。

1、変更したいファイルのあるディレクトリ内に"custom"あるいは"classic"の様な名前のサブディレクトリがある
2、パスに /template_default/ あるいは、/custom/とか、/classic/ などのテンプレートフォルダ名が含まれる場合
  例) /includes/templates/template_default/common/

(※ 残念ながら、すべてのファイルにおいてオーバーライドが可能なわけではありません。また管理画面には対応していません。)

■オーバーライド可能なファイルである事がわかったら、以下の様な手順で修正しましょう。

1、 オーバーライドの規則に合わせて、利用しているテンプレートフォルダ名で新しいフォルダを作成します。

仮に、修正したいファイルのパスに /template_default/ あるいは、/custom/ や /classic/ の様なテンプレートディレクトリが含まれている場合。

デフォルトのpath:  includes/templates/template_default/common/
オーバーライドpath: includes/templates/<テンプレートフォルダ名>/common/

デフォルトのpath:  includes/templates/template_default/templates/
オーバーライドpath: includes/templates/<テンプレートフォルダ名>/templates/

デフォルトのpath:  includes/templates/template_default/buttons/japanese/
オーバーライドpath: includes/templates/<テンプレートフォルダ名>/buttons/japanese/

の様な関係になります。

ファイルを修正するには、
1、編集したいファイル”だけ”を新しいディレクトリにコピーして追加してください。
2、新しいフォルダに保存されたコピーファイルを修正します。

( ※オーバーライドする必要のないファイルはコピーしないようにして下さい)

このように常にオーバーライドを心がけるようにする事で、もしものトラブルの時にもオーバーライドファイルを削除するだけで、デフォルトのファイルが読み込まれるようになり、すぐに復旧が可能です。
また、バージョンアップ等の際にも編集したデフォルトのファイルが上書きされてしまうようなトラブルを避ける事もできます。

その他注意点:

■ includes/templates/template_default フォルダには、デフォルトとなるコアなテンプレートファイルが多数含まれています。
  このフォルダは、他のテンプレートフォルダとは異なり、全てのベースとなるテンプレートを保存するためのものです。