创建ECShop自定义页面需新建PHP文件并引入init.php以调用系统功能，通过数据库操作与Smarty模板展示数据，再创建对应DWT模板文件完成页面显示。
ECShop要做自定义页面，或者说想加一个单独的页面，核心思路其实就是创建一个新的PHP文件，让它能跑起来，并且能调用ECShop的底层数据和模板系统。最直接的方法，就是自己写一个PHP文件，然后通过URL去访问它。当然，如果你只是想展示一些静态内容，ECShop自带的文章系统也能凑合用，但灵活性就差远了。
解决方案
要实现一个真正意义上的ECShop自定义页面，通常我们会采用以下步骤：
创建PHP文件： 在ECShop的根目录下，或者你当前使用主题的目录下（比如
themes/你的主题名/
），新建一个PHP文件，例如my_custom_page.php
。-
引入ECShop核心文件： 在这个新建的PHP文件开头，你需要引入ECShop的初始化文件，这样才能使用ECShop的数据库连接、Smarty模板引擎、以及各种内置函数。通常是这样写：
<?php define('IN_ECS', true); // 定义IN_ECS常量，确保能正常加载ECShop核心 require(dirname(__FILE__) . '/includes/init.php'); // 引入ECShop初始化文件 // 以下是你的自定义页面逻辑 // ... ?>如果你的文件放在了主题目录下，路径可能需要调整，比如
require(dirname(dirname(dirname(__FILE__))) . '/includes/init.php');
，具体看你的文件层级。 -
编写页面逻辑： 在
init.php
引入之后，你就可以像在ECShop其他页面一样，使用$db
对象进行数据库操作，使用$smarty
对象分配变量到模板。 例如，你可能想从数据库里取一些数据：$sql = "SELECT article_id, title FROM " . $ecs->table('article') . " WHERE cat_id = 1 ORDER BY add_time DESC LIMIT 5"; $latest_articles = $db->getAll($sql); $smarty->assign('latest_articles', $latest_articles); -
加载模板： 最后，你需要告诉ECShop显示哪个模板文件。通常我们会创建对应的
.dwt
模板文件，放在当前主题的目录下。assign_template(); // 分配模板相关变量，如网站名称、Meta信息等 $position = assign_ur_here(); // 生成当前页面的位置导航（面包屑） $smarty->assign('page_title', '我的自定义页面'); // 设置页面标题 $smarty->assign('ur_here', $position['ur_here']); // 分配面包屑导航 $smarty->display('my_custom_page.dwt'); // 显示你的模板文件 -
创建DWT模板文件： 在你的主题目录下（
themes/你的主题名/
），创建一个与PHP文件对应的DWT文件，例如my_custom_page.dwt
。这个文件里可以包含HTML结构，并使用Smarty语法输出你分配的变量。<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title>{$page_title}</title> {insert_scripts files='common.js'} <link href="{$ecs_css_path}" rel="stylesheet" type="text/css" /> </head> <body> <!-- #BeginLibraryItem "/library/page_header.lbi" --><!-- #EndLibraryItem --> <div class="block box"> <div class="blank"></div> <!-- #BeginLibraryItem "/library/ur_here.lbi" --><!-- #EndLibraryItem --> </div> <div class="blank"></div> <div class="block clearfix"> <div class="AreaL"> <!-- 侧边栏内容，如果需要 --> </div> <div class="AreaR"> <div class="box"> <div class="box_1"> <h3><span>我的自定义内容</span></h3> <div class="boxCenterList"> <p>这里是我的自定义页面的内容。我可以显示从PHP逻辑中获取的数据。</p> <h4>最新文章列表：</h4> <ul> {foreach from=$latest_articles item=article} <li><a href="article.php?id={$article.article_id}">{$article.title}</a></li> {/foreach} </ul> </div> </div> </div> </div> </div> <div class="blank5"></div> <!-- #BeginLibraryItem "/library/page_footer.lbi" --><!-- #EndLibraryItem --> </body> </html>这样，通过访问
http://你的域名/my_custom_page.php
，你就能看到这个自定义页面了。
ECShop自定义页面如何集成到导航栏或菜单？
做好了自定义页面，下一步自然是让用户能方便地找到它，集成到导航栏或菜单就是最常见的做法。这块儿ECShop提供了两种主要方式，我个人觉得各有优劣。
方法一：通过后台“自定义导航”功能添加（推荐，非技术人员友好）
ECShop后台有一个“系统设置” -> “自定义导航”的功能，这是最省心的方式。
- 登录ECShop后台。
- 点击“系统设置” -> “自定义导航”。
- 点击“添加导航”。
- 在“导航名称”里填上你希望显示的名字，比如“我的专属页面”。
- “链接地址”填入你自定义页面的URL，比如
/my_custom_page.php
（注意是相对路径，从网站根目录开始）。 - 选择“是否显示”为“是”，选择“是否新窗口”根据需要。
- “排序”可以调整它在导航栏中的位置。
- “位置”选择“顶部”，这样它就会出现在主导航栏。
- 保存。
这种方式的好处是，你不需要动任何代码，操作简单，对于不熟悉代码的运营人员来说非常友好。缺点是，它只能添加到ECShop预设的导航位置，比如顶部、底部，如果你想在某个侧边栏或者特定区域添加链接，这个功能就不够灵活了。
方法二：直接修改主题模板文件（灵活，但需谨慎）
如果你对ECShop的模板结构比较熟悉，或者需要把链接放到非标准导航区域，直接修改主题模板文件是更灵活的选择。
ECShop的主导航通常在
themes/你的主题名/library/page_header.lbi这个文件中（具体文件名可能因主题而异，但大同小异）。你可以在其中找到类似
<li><a href="category.php?id=1">分类名称</a></li>这样的导航项，然后依葫芦画瓢，添加你的自定义页面链接：
<!-- 假设这是page_header.lbi的部分内容 -->
<div id="mainNav">
<ul>
<li><a href="index.php">首页</a></li>
<!-- 其他分类或默认导航项 -->
<li><a href="my_custom_page.php">我的专属页面</a></li> <!-- 添加你的自定义页面链接 -->
</ul>
</div>修改完后，记得清除ECShop的缓存（后台“清除缓存”），刷新页面就能看到效果了。这种方式的优点是你可以精确控制链接的位置和样式，但缺点是，如果你的主题有更新，或者你更换了主题，这些修改可能就需要重新做一遍。所以，我个人建议，如果不是对主题结构非常了解，或者没有特殊需求，尽量还是用后台的“自定义导航”功能。
自定义页面中如何调用ECShop的数据和函数？
自定义页面之所以“自定义”，很重要的一个方面就是它能和ECShop的现有数据、功能进行交互。这可不是简单的HTML展示，而是能跑ECShop底层逻辑的。
核心在于你文件开头的那句
require(dirname(__FILE__) . '/includes/init.php');。一旦这个文件被正确引入，你就获得了“进入ECShop世界”的通行证。
-
数据库操作：
$db
对象和$ecs
对象$db
：这是ECShop的数据库操作对象，你可以用它来执行SQL查询、插入、更新等。$db->getAll($sql)
：获取所有符合条件的记录。$db->getRow($sql)
：获取第一条符合条件的记录。$db->getOne($sql)
：获取查询结果的第一个字段值。$db->query($sql)
：执行非查询操作（如INSERT, UPDATE, DELETE）。
$ecs
：这个对象主要用来获取表名，配合$db
使用更安全，避免硬编码表前缀。$ecs->table('goods')：会返回ecs_goods
（如果你的表前缀是ecs_
）。
-
例子：获取最新的5件商品
$sql_goods = "SELECT goods_id, goods_name, shop_price FROM " . $ecs->table('goods') . " WHERE is_on_sale = 1 ORDER BY add_time DESC LIMIT 5"; $latest_goods = $db->getAll($sql_goods); $smarty->assign('latest_goods', $latest_goods); // 分配给Smarty模板
-
Smarty模板引擎：
$smarty
对象$smarty->assign('变量名', $变量值)：这是把PHP变量传递给DWT模板的关键。模板中就可以用{$变量名}来显示。$smarty->display('模板文件名.dwt')：显示指定的DWT模板文件。
-
ECShop内置函数和库
- 很多ECShop的常用功能都是通过函数实现的，比如获取商品信息、分类信息、用户登录状态等。
-
例子：获取商品详情
如果你想在自定义页面显示某个商品的详细信息，可以这样：
include_once(ROOT_PATH . 'includes/lib_goods.php'); // 引入商品相关的库 $goods_id = 123; // 假设你要获取ID为123的商品 $goods_info = get_goods_info($goods_id); $smarty->assign('goods_info', $goods_info); -
用户登录状态：
用户是否登录，可以通过判断
$_SESSION['user_id']
是否存在来判断。if (!empty($_SESSION['user_id'])) { $user_name = $_SESSION['user_name']; $smarty->assign('is_logged_in', true); $smarty->assign('user_name', $user_name); } else { $smarty->assign('is_logged_in', false); } -
其他常用函数：
assign_template()
：分配网站基本信息到模板，如网站名称、Meta关键词等。assign_ur_here()
：生成面包屑导航数据。url_format()
：格式化URL。
基本上，只要
init.php引入正确，你就可以把ECShop当成一个强大的PHP框架来用，各种数据和功能都能信手拈来。当然，前提是你得知道ECShop内部的函数和变量命名规则。我个人建议，遇到不确定的，可以去ECShop的官方文档或者现有页面（比如
goods.php、
category.php）里找找灵感，看看它们是怎么调用的。
ECShop自定义页面开发中常见的坑与注意事项？
开发自定义页面，说实话，看似简单，但实际操作起来总会遇到一些小麻烦，尤其是ECShop这种老牌系统。我结合自己踩过的坑，总结了一些需要注意的地方：
-
编码问题：BOM头引发的血案 这是ECShop开发中最常见也最让人头疼的问题之一。如果你用一些编辑器（比如旧版的Dreamweaver，或者设置不当的Notepad++）创建PHP文件，它可能会默认保存为“UTF-8 BOM”格式。而ECShop的PHP文件通常是“UTF-8 无BOM”。
- 现象： 页面顶部出现空白行，或者更严重的是“Headers already sent”错误。
- 原因： BOM头在PHP解析时会被当作输出内容，导致在PHP发送HTTP头之前就有了输出，从而引发错误。
- 解决： 务必将所有自定义的PHP文件保存为“UTF-8 无BOM”格式。大多数现代编辑器都有这个选项，比如VS Code、Sublime Text等。
-
路径问题：
require
和include
的相对路径 当你把自定义PHP文件放在不同的目录下时，require(dirname(__FILE__) . '/includes/init.php');
这句的相对路径就需要小心了。dirname(__FILE__)
：返回当前文件所在的目录。- 如果你把
my_custom_page.php
放在根目录，那么dirname(__FILE__)
就是ECShop根目录。 - 如果你放在
themes/你的主题名/
下，那么dirname(__FILE__)
就是主题目录，你需要向上跳两级才能找到includes
目录，比如require(dirname(dirname(dirname(__FILE__))) . '/includes/init.php');
。 - 建议： 为了避免这种路径困扰，我个人倾向于把自定义的独立页面PHP文件直接放在ECShop根目录下，这样路径管理最简单。
-
缓存问题：改了代码不生效？ ECShop有自己的缓存机制，包括Smarty模板缓存和数据缓存。有时候你修改了PHP代码或DWT模板，但刷新页面却看不到变化。
-
解决： 登录ECShop后台，点击“系统设置” -> “清除缓存”。如果还是不行，手动删除
temp/caches
和temp/compiled
目录下的所有文件（但不删除目录本身）。
-
解决： 登录ECShop后台，点击“系统设置” -> “清除缓存”。如果还是不行，手动删除
-
安全隐患：SQL注入和XSS 虽然ECShop自带的
$db
对象在某些情况下会做一些处理，但自己手写SQL查询时，仍然要警惕SQL注入。-
SQL注入： 当你从
$_GET
、$_POST
等获取用户输入并直接拼接到SQL语句中时，就可能发生。-
错误示例：
$id = $_GET['id']; $sql = "SELECT * FROM " . $ecs->table('goods') . " WHERE goods_id = " . $id; -
改进： 对用户输入进行严格的过滤和验证。ECShop的
$db->getOne()
等方法在处理参数时会做一些转义，但如果你执行复杂的$db->query()
，最好自己用addslashes()
或者intval()
等函数进行处理。
-
错误示例：
-
XSS（跨站脚本攻击）： 当你把用户输入未经处理就直接输出到页面时，可能导致恶意脚本执行。
-
Smarty： Smarty模板默认会对变量进行HTML实体编码，所以通常比较安全。但如果你使用
{$变量|unescape}或者{literal}等，就需要特别小心了。
-
Smarty： Smarty模板默认会对变量进行HTML实体编码，所以通常比较安全。但如果你使用
-
SQL注入： 当你从
性能考虑：按需加载 自定义页面时，不要一股脑地加载所有ECShop的库文件和数据。只引入你真正需要的
lib_goods.php
、lib_article.php
等，可以减少不必要的资源消耗。-
代码规范和可维护性： 虽然是自定义页面，但如果未来可能需要他人维护，或者页面逻辑复杂，遵循一些基本的代码规范还是很有必要的：
- 注释： 关键代码段加上注释，解释逻辑。
- 变量命名： 保持清晰、有意义的变量名。
- 结构化： 如果页面逻辑很复杂，考虑将一些功能封装成函数，或者引入ECShop的其他模块化机制。
自定义页面给了ECShop极大的扩展性，但同时也要求开发者对PHP和ECShop的内部机制有一定了解。遇到问题，多看看ECShop核心文件（比如
flow.php,
goods.php等）的实现方式，通常能找到解决思路。
