新浪博客

Prestashop模块中添加自定义页面指导guideline

2026-01-13 15:26阅读：

http://blog.sina.cn/dpool/blog/u/1779758493

# 在 Prestashop 模块中增加一个前台页面（完整实践指南）
> 目标：在不影响现有业务的前提下，为模块新增一个独立前台页面（可用于演示页、活动页、表单页等）。
## 一、你需要改动的地方（总览清单）
1. **模块主文件**（`modules/你的模块名/你的模块名.php`）
- 定义模块信息（名称、版本等）
- 不一定需要新增 hook，但必须确保模块已安装
2. **前台控制器**（`modules/你的模块名/controllers/front/xxx.php`）
- 这是页面入口，处理请求并指定模板
3. **模板文件**（`modules/你的模块名/views/templates/front/xxx.tpl`）
- 页面内容 HTML
4. **静态资源**（可选）
- CSS/JS 放在 `modules/你的模块名/views/css` 和 `views/js`
5. **路由（可选）**
-
如需友好 URL，可在模块中添加路由规则（PS 1.7+）
---
## 二、具体步骤（带例子）
### 1）新建前台控制器
路径：
```
```
示例代码：
{
public $display_header = false; // 可选：不加载主题头部
public $display_footer = false; // 可选：不加载主题底部
public function initContent()
{
parent::initContent();
$this->context->smarty->assign(array(
'module_dir' => $this->module->getPathUri(),
'home_url' => $this->context->link->getModuleLink($this->module->name, 'demo'),
));
$this->setTemplate('module:yourmodule/views/templates/front/demo.tpl');
}
}
```
> 关键点：控制器命名规则必须为 `模块名 + 控制器名 + ModuleFrontController`。
---
### 2）新建模板文件
路径：
```
modules/yourmodule/views/templates/front/demo.tpl
```
## 五、总结
在 Prestashop 中新增模块页面，核心只要 3 件事：
1. 新建前台控制器
2. 新建模板文件
3. 使用模块路径访问
这样做完全独立，不影响现有业务逻辑，也方便后续扩展成多页面模块。

我的更多文章

下载客户端阅读体验更佳

APP专享