zen-cart 网上抄的，方便个人学习

zen-cart模板参考文档,如何修改Zen-cart模板

2009年09月13日 星期日 13:28

Zen Cart的模板设计比较复杂，需要一定的时间来熟悉。一旦你了解了它的结构，就会慢慢习惯了。

首先要阅读常见问答部分的：如何添加、制作新模板。 Zen Cart的设计没有什么特别，与以前设计HTML页面是一样的。只是整个页面分成了好几个部分，并加入了PHP代码。通常，页面分为页眉 (header)，页脚(footer)，边框(sideboxes)。所以设计页面的时候，要记住Zen Cart是如何组织这些页面的。

页面是通过CSS样式表来控制的。样式表控制表格单元的背景图案、字体的颜色和样式等等。所以，假如你需要修改边框标题栏的字体，那么查看样式表文件。
Zen Cart在页面添加图像有两种方式。可以使用图像目录的相对路径，或者在模板中用php变量定义图像。如果你使用https服务器，并且采用相对图像路径，那么https的图像目录下也要有同样的图像，否则https服务器很可能会给出警告提示。

php学习之家
Zen Cart可以设置成任意的html/flash的界面，只是比通常的html页面的设计费时。你可以从修改缺省的模板开始，先修改CSS文件和三栏格式的界面。开始先采用不同的颜色，很快就可以设计出完全不同的风格。

最后，在设计模板前要先计划好你网页的内容，事半功倍。
下面是zen cart页面各部分相对应模板文件的一个列表：

文件路径	注释
index.php	主文件
includes/templates/[custom template folder]/common/html_header.php	页面的head部分
includes/templates/[custom template folder]/common/tpl_main_page.php	页面的body部分
includes/templates/[custom template folder]/common/tpl_header.php	所有页面的页眉
(column left)
includes/templates/[custom template folder]/common/main_template_vars.php	决定页面的内容部分，缺省为 ‘tmp_index_default.php’
首页 - 缺省
includes/templates/[custom template folder]/templates/tmp_index_default.php	首页模板文件
首页 - 显示分类
includes/templates/[custom template folder]/templates/tpl_index_categories.php	首页上显示分类时的模板文件
includes/modules/[custom template folder]/pages/index/category_row.php	选择要显示的分类
includes/templates/[custom template folder]/templates/tpl_index_category_row.php	显示分类
首页 - 显示指定分类
includes/templates/[custom template folder]/templates/tpl_index_product_list.php	首页上显示指定的分类时采用的模板文件
includes/modules/[custom template folder]/product_listing.php	将商品数据添加到数组
includes/templates/[custom template folder]/templates/tpl_modules_product_listing.php	显示商品数量和商品导航菜单
includes/templates/[custom template folder]/common/tpl_list_box_content.php	显示商品数组
商品信息页面
includes/templates/[custom template folder]/templates/tpl_product_info_display.php	显示单件商品信息
购物车页面
includes/templates/[custom template folder]/templates/tpl_shopping_cart_default.php	购物车页面
(column right)
includes/templates/[custom template folder]/common/tpl_footer.php	所有页面的页脚

最近一直在调度zen-cart，找到了下面这篇文章，是关于如果修改zen cart模版的，很有用，，跟大家分享一下。

DIR_WS_CATALOG // zent cat目录 这些在includes/configure.php定义

meta_tags.php //定义网站的meta信息。这些是从数据库中取出来的。在includes/modules/下面

HTML_PARAMS //模板语言常量文件定义的。

$current_page_base 在includes/init_inicludes/init_sanitize.php $_GET['main_page']

manufacturers_id 生产厂商ID

product_id 产品ID

$tmp_pagename index_home

有加载modules/pages

======================

首页加载的文件

html_header.php

tpl_index_default.php {indeXDefaultMainContent 首页可以编辑｝

tpl_modules_featured_products.php -> tpl_columnar_display.php

bannerOne banners [后台bannner控制]

logo 修改　tpl_header.php 页面 在模板的images/logo.gif

id=”mainwrapper”

common/tpl_header.php 功能：所有页面的页眉　基本可以不用或者广告用

id=”headerwrapper”

navColumnOnewrapper

navEZpagesTOp 简易页面的连接

左边分类在　templates/模板/sideboxes/下面　sql参数在categories.php

=============================

1. 在首页顶部增加连接的方法。

找到模板文件夹下面的zcen/tpl_header.php

在#topbarwrap与#topbar 增加一个<div>连接</div> 里面写上你要的连接

2. Logo的替换。这个在后台是没有的。在语包的文件里定义。

找到languages/english/zcen/header.php 找到Header_logo_image 常量 修改

或者 替换 模板下面的 logo.gif文件/includes/templates/zcen/images/logo.gif

3. 导航栏的东西〔这个后台的设计的）

样式调节#navEZPagesTop

后台的 参数调整：0 1 2

后台的 ezpage设置

4. 首页分类名称的修改

打开 /templates/languages/english.php

找到：define(”BOX_HEADING_CATEGORIES”,”CATEGORIES”)

改为：define(”BOX_HEADING_CATEGORIES”,”Select you game”);

主`

D:\WEB\zen-cart\includes\templates\classic\css\stylesheet.css

整个页面组织

D:\WEB\zen-cart\includes\templates\template_default\common\tpl_main_page.php

网页左右栏width源代码：<td id=”navColumnOne” class=”columnLeft” style=”width: 150px;”>

动态调用width: <?php echo COLUMN_WIDTH_LEFT; ?>”>，

在后台－configuration-layout里可以更改Column Width/

Column Width - Left Boxes

商品分类名称Categories更改:BOX_HEADING_CATEGORIES，

“D:\WEB\zen-cart\includes\languages\english.php”(78,11): define(’BOX_HEADING_CATEGORIES’, ‘Categories’);

spooer名称更改：define(’BOX_HEADING_BANNER_BOX’,'Sponsors’)

默认模板，左spooner对应’BOX_HEADING_BANNER_BOX’ 右上spooer对’BOX_HEADING_BANNER_BOX_ALL’

右下spooer对应BOX_HEADING_BANNER_BOX2

左边栏处理：只保留includes\templates\template_default\sideboxes\tpl_categories.php，在里面增加

图片链接

右边栏的处理：

1.后台设置为保留who’s onlie（sideboxes/whos_online.php），

与之对应的 tpl_box_default_right.php，查找<?php echo $title; ?>进行替换

2.添加左边栏目内容，对tpl_box_default_right.php更改：

中部修改：

＝＝＝＝＝＝＝＝＝＝＝

\includes\templates\template_default\templates\tpl_index_default.php

去掉顶部说明:<?php if (SHOW_CUSTOMER_GREETING == 1) { ?>

<h2 class=”greeting”><?php echo zen_customer_greeting(); ?></h2>

<?php } ?>

去掉欢迎信息：

<h1 id=”indexDefaultHeading”><?php echo HEADING_TITLE; ?></h1>

去掉顶部导航：

\includes\templates\template_default\common\tpl_main_page.php

<div id=”navBreadCrumb”><?php echo $breadcrumb->trail(BREAD_CRUMBS_SEPARATOR); ?></div>

模板顶部修改：

＝＝＝＝＝＝＝＝＝＝

\zen-cart\includes\templates\template_default\common

\tpl_header.php

<div id=”navMain”></div>内可增加链接

<?php

/**

* prepares and displays header output

*

*/

if (CUSTOMERS_APPROVAL_AUTHORIZATION == 1 && CUSTOMERS_AUTHORIZATION_HEADER_OFF == ‘true’ and ($_SESSION['customers_authorization'] != 0 or

$_SESSION['customer_id'] == ”)) {

$flag_disable_header = true;

}

require($template->get_template_dir(’tpl_header.php’,DIR_WS_

TEMPLATE, $current_page_base,’common’). ‘/tpl_header.php’);?>

上段从<div id=”mainWrapper”>抽出，放在它前面做全屏导航版块

顶部搜索按钮修改：

\includes\templates\template_default\common\tpl_header.php ：

<div id=”navMainSearch”><?php require(DIR_WS_MODULES . ’sideboxes/search_header.php’); ?></div>

自动生成导航栏:

\includes\templates\template_default\templates\

tpl_modules_categories_tabs.php

将其代码掏空，重新添加导航代码：

~~~~~~~~~~~~~~~~~~~~~~~~~

<?php

/**

* Module Template - categories_tabs

*

* Template stub used to display categories-tabs output

*

* @package templateSystem

* @copyright Copyright 2003-2005 Zen Cart Development Team

* @copyright Portions Copyright 2003 osCommerce

* @license http://www.zen-cart.com/license/2_0.txt GNU Public License V2.0

* @version $Id: tpl_modules_categories_tabs.php 3395 2006-04-08 21:13:00Z ajeh $

*/

include(DIR_WS_MODULES . zen_get_module_directory(FILENAME_CATEGORIES_TABS));

?>

<?php if (CATEGORIES_TABS_STATUS ==

‘1′ && sizeof($links_list) >= 1) { ?>

<div id=”navCatTabsWrapper”>

<div id=”navCatTabs”>

<ul>

<?php for ($i=0, $n=sizeof($links_list); $i<$n; $i++) { ?>

<li><?php echo $links_list[$i];?></li>

<?php } ?>

</ul>

</div>

</div>

<?php } ?>

~~~~~~~~~~~~~~~~~~~~~~

的log背景：

\zen-cart\includes\templates\template_default\common

\tpl_header.php

<div id=”tagline”><?php echo HEADER_SALES_TEXT;?></div>

底部导航修改：

\includes\templates\template_default\common\tpl_main_page.php

<div id=”bannerSix” class=”banners”><?php echo zen_display_banner(’static’, $banner); ?></div>

zen cart 打开错误信息显示调试开关

在调试zencart网店时，有时修改了某些文件，网店前台显示不完整了，或者出现了空白页面，可以通过以下方法打开错误提示：

打开文件 \includes\application_top.php ，找到

if (defined('STRICT_ERROR_REPORTING') && STRICT_ERROR_REPORTING == true) {

在前面增加一行

define('STRICT_ERROR_REPORTING', true);
Zen Cart 如何添加新的页面？
2009年10月06日 星期二 13:58

Zen Cart 添加新页面的方法有三种：

第一种，手动添加，要有一定的HTML基础：

首先，创建自己的模板文件。

附加页面在includes/languages/schinese/ 目录下，文件名为：page_2.php, page_3.php 和 page_4.php。

在includes/languages/schinese/下建立一个新目录，命名为 YOUR_TEMPLATE，然后将三个PHP文件拷贝到includes/languages/schinese/YOUR_TEMPLATE 目录下，您就可以随意修改了。

需要更多页面，只要再复制文件，然后命名为page_5，page_6 等等。

您还需要给附加页面添加头文件。

打开includes/ modules/ pages，复制您需要的所有 page_X 目录和目录内文件，按您的页面改名。

现在打开includes/ filenames.php文件，按照相同的命名规则修改文件。

在includes\languages\english\html_includes里增加新的页面。

最后，在includes/ templates/ YOUR_TEMPLATE/ templates/目录下，为附加页面创建模板页。复制tpl_page_X_default.php文件，然后再按照相同的命名规则改名。

要在”更多信息”方框内修改/添加新页面，将 /includes/ languages/ schinese.php文件，复制到模板目录下，找到定义more_information方框的段落，按您的需要修改”更多信息”，同时修改链接的名称。

剩下的就是添加链接到方框。复制 /includes/ modules /sideboxes/ more_information.php文件到模板目录，按照相同的模式添加您的链接，然后进入管理页面，工具->外观控制，设置该文件。

第二种，可以利用添加新页面的模块，要在官网上下载下来安装后才能使用。下载地址：add_pages_to_more_information_sidebox_2

第三种，利用EZPAGE直接添加新的页面，这种方法是最简单的方法，推荐用这种方法。
如何添加新的页面？精品
2008-01-14 23:42

首先，创建自己的模板文件。

附加页面在includes/languages/schinese/ 目录下，文件名为：page_2.php, page_3.php 和 page_4.php。

在includes/languages/schinese/下建立一个新目录，命名为 YOUR_TEMPLATE，然后将三个PHP文件拷贝到includes/languages/schinese/YOUR_TEMPLATE 目录下，您就可以随意修改了。

需要更多页面，只要再复制文件，然后命名为page_5，page_6 等等。

您还需要给附加页面添加头文件。

打开includes/ modules/ pages，复制您需要的所有 page_X 目录和目录内文件，按您的页面改名。

现在打开includes/ filenames.php文件，按照相同的命名规则修改文件。

最后，在includes/ templates/ YOUR_TEMPLATE/ templates/目录下，为附加页面创建模板页。复制tpl_page_X_default.php文件，然后再按照相同的命名规则改名。

要在"更多信息"方框内修改/添加新页面，将 /includes/ languages/ schinese.php文件，复制到模板目录下，找到定义more_information方框的段落，按您的需要修改"更多信息"，同时修改链接的名 称。

剩下的就是添加链接到方框。复制 /includes/ modules /sideboxes/ more_information.php文件到模板目录，按照相同的模式添加您的链接，然后进入管理页面，工具->外观控制，设置该文件。

zencart 1.3 以上版本，可以采用更简单的方法创建新页面、新链接。

1. 后台－工具－多语言简易页面，点击：安装多语言简易页面

2. 后台－工具－简易页面管理，可以任意增加、删除页面

首页界面：/include/templates/zccn/common/tpl_main_page.php

首页主样式表：/include/templates/zccn/css/schinese_stylesheet.css

首页左边栏目：

/includes/templates/template_default/common/tpl_box_default_left.php

商品分类内容修改：

/includes/modules/sideboxes/categories.php

/includes/templates/zccn/sideboxes/tpl_categories.php

推荐产品

/includes/modules/sideboxes/featured.php

/includes/templates/template_default/sideboxes/tpl_featured.php

新进产品

/includes/modules/sideboxes/whats_new.php

/includes/templates/template_default/sideboxes/tpl_whats_new.php

特价产品

/includes/modules/sideboxes/specials.php

/includes/templates/template_default/sideboxes/tpl_specials.php

数据库表

/includes/database_tables.php

首页中间商品修改：

/includes/templates/template_default/common/main_template_vars.php

/includes/templates/template_default/templates/tpl_index_default.php

内页中间商品修改：

/includes/templates/template_default/templates/tpl_index_catergories.php

首页中间 August新进商品

/includes/templates/template_default/templates/tpl_modules_whats_new.php

首页中间 August特价商品

/includes/templates/template_default/templates/tpl_modules_specials_default.php

首页中间 推荐商品

/includes/templates/template_default/templates/tpl_modules_featured_products.php

首页右边栏目：

/includes/templates/template_default/common/tpl_box_default_right.php

商品搜索

/includes/templates/template_default/sideboxes/tpl_search.php

客服中心

/includes/templates/template_default/sideboxes/tpl_ezpages.php

畅销商品

/includes/templates/template_default/sideboxes/tpl_best_sellers.php

商品评论

/includes/templates/template_default/sideboxes/tpl_reviews_write.php

在线名单

/includes/templates/template_default/sideboxes/tpl_whos_online.php

zen cart 打开错误

define('STRICT_ERROR_REPORTING', true)

***********************

ZenCart如何整合Wordpress博客？

如果你的ZenCart需要一个Blog来发布一些你的最新动态，可以试试Wordpress，并且用WOZ这个ZenCart的Module来把它们关联起来。WOZ的全名叫Wordpress
On ZenCart。

下面就详细介绍一下WOZ的安装方法，当然你可以在WOZ包里找到英文的安装说明。我所使用的版本为ZenCart1.3.8和Wordpress2.8.5，至于其它版本能否集成，没有测试过。

Wordpress on ZenCart总的来说有两种安装模式：

第一种是把Wordpress的文件全部解压到ZenCart的根目录下，另一种方法是把Wordpress单独放到ZenCart下新建的一个目录里。

两种方法最后访问Wordpress的地址都是：[Zen-Cart URL]/index.php?main_page=wordpress

第一步，安装Wordpress

把Wordpress解压到你的ZenCart目录下，然后把Wordpress的文件夹名改为blog，呵，看起来感觉会爽一些。

这一步的安装和普通的Wordpress安装没啥区别。

第二步：设置Wordpress

在Wordpress的后台设置一下，setting -> General -> Blog address(URL)

把Blog address (URL)改为[Zen-Cart URL]，即http://your.zen-cart.com

把主题设为默认主题。

第三步：上传WOZ的文件

建议用ftp直接覆盖：

把WOZ解压后的ZC_ROOT目录下的文件上传到服务器Zen-cart的安装目录下。

把WOZ解压后的WP_ROOT目录下的文件上传到服务器WordPress的安装目录下。

再把/ZC_ROOT/includes/templates/MY_TEMP/里的CSS文件上传到你的Zen-cart模板里的CSS文件夹里。这个是Wordpress的显示主题。

第四步：修改Wordpress的文件

在你的Wordpress安装目录下，找到[Path of WordPress]/wp-include/template-loader.php，把所有的“exit;”都替换成“return;”。

如果你的Wordpress版本比较新，就不需要做这一步的工作了。

第五步：修改Zen-cart文件

打开Zen-cart安装目录下的[Path of Zen-Cart]/includes/extra_configures/wordpress-config.php，把

define (’ABSPATH’,’/var/www/vhost/example.com/public_html/blog/’);

替换成

define (’ABSPATH’,’[Path of WordPress]‘);

比如说，在我本地我是改为这样的东西：

define (’ABSPATH’,’E:/mywebs/zen-cart/blog/’);

记住，这个路径得是你服务器上的绝对路径。

第六步：布局设置

在ZenCart后台管理面板的admin panel ? tools ? Layout Boxes Controller里，选择打开你需要的Wordpress侧栏框。所有和Wordpress有关的侧栏框都是以WP_XXX格式存在的。

第七步：检查

现在你可以通过

http://your.zen-cart.com/index.php?main_page=wordpress

这个网址来访问你的Wordpress了。

如果你能看到Wordpress，则表明你已经把Wordpress集成到了ZenCart里了。

完成了这七步，基本上就把Wordpress的显示页面整合到了ZenCart里面。

zen cart商品信息页面，显示相关产品，或you may also like products 的办法

产品页面“Customers who bought this product also purchased” 默认是按字面意义显示，即只有真正买了这个产品又购买了其他产品，才会显示。不然是不会显示的。

找到includes\classes\db\mysql\define_queries.php文件，修改SQL_ALSO_PURCHASED的 sql语句如下 以增加网站内部链接

DEFINE(‘SQL_ALSO_PURCHASED’ “select p.products_id p.products_image from ” . TABLE_PRODUCTS . ” p where p.products_status=’1′ order by rand() limit 0 3″);

或者：

DEFINE(‘SQL_ALSO_PURCHASED’, “SELECT

products.products_image,

products.products_price,

products_description.products_name,

products.products_date_added,

products.products_id

FROM

products

Inner Join products_description ON products.products_id = products_description.products_id

ORDER BY

products.products_date_added DESC,rand()

LIMIT 8″);
第一种办法有时候会导致网站打不开，就用第二种办法，推荐用第二种，