如何在 PrestaShop 1.7 中自定义分类页的产品查询 SQL

云丽大大_9761

云丽大大_9761

2026-01-14

855人浏览

原创

如何在 PrestaShop 1.7 中自定义分类页的产品查询 SQL

本文详解如何通过重写 category 类的 getproducts() 方法,在 prestashop 1.7 分类列表页中注入自定义 sql 查询逻辑,以支持按扩展字段(如 priority、state)精准排序与筛选产品。

在 PrestaShop 1.7 中,分类页面(Category Controller)展示的产品数据并非由单一 SQL 模板驱动,而是由 Category 类的 getProducts() 方法动态构建并执行两个核心查询:

  • 计数查询(COUNT):用于分页总数计算;
  • 数据查询(SELECT):获取实际展示的产品列表(含关联的图片、价格、属性等)。

该方法位于 classes/Category.php,是修改产品检索逻辑的唯一官方推荐入口。直接修改核心文件不可取,应通过覆盖(Override)机制安全扩展。

✅ 正确做法:创建 Category 类覆盖文件

在 override/classes/Category.php 中创建如下覆盖类:

Build MCP servers and clients for PHP applications with the official PHP SDK
Build MCP servers and clients for PHP applications with the official PHP SDK

使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。

下载
<?php class Category extends CategoryCore
{
    public function getProducts(
        $idLang,
        $p,
        $n,
        $orderBy = null,
        $orderWay = null,
        $getTotal = false,
        $active = true,
        $random = false,
        $randomNumber = 1,
        $ids = null,
        $exclude = null,
        $group_by = null
    ) {
        // 1️⃣ 构建自定义 WHERE 条件(示例:优先显示 state=1 且 priority > 0 的产品)
        $where = ' AND p.`state` = 1 AND p.`priority` > 0 ';

        // 2️⃣ 调用父类逻辑,但注入自定义条件
        $sql = 'SELECT p.*, product_shop.*, stock.out_of_stock, IFNULL(stock.quantity, 0) as quantity'
            . ', pl.`description`, pl.`description_short`, pl.`link_rewrite`, pl.`meta_description`,'
            . ' pl.`meta_keywords`, pl.`meta_title`, pl.`name`, image_shop.`id_image`, il.`legend`,'
            . ' m.`name` AS manufacturer_name, cl.`name` AS category_default, DATEDIFF(product_shop.`date_add`, DATE_SUB(NOW(), INTERVAL '.(Validate::isUnsignedInt(Configuration::get('PS_NB_DAYS_NEW_PRODUCT')) ? Configuration::get('PS_NB_DAYS_NEW_PRODUCT') : 20).' DAY)) > 0 AS new'
            . ', product_shop.price AS orderprice'
            . ' FROM `'._DB_PREFIX_.'category_product` cp'
            . ' LEFT JOIN `'._DB_PREFIX_.'product` p ON p.`id_product` = cp.`id_product`'
            . ' '.Shop::addSqlAssociation('product', 'p').'
            . ' LEFT JOIN `'._DB_PREFIX_.'product_lang` pl ON (p.`id_product` = pl.`id_product` AND pl.`id_lang` = '.(int) $idLang.Shop::addSqlRestrictionOnLang('pl').')'
            . ' LEFT JOIN `'._DB_PREFIX_.'category_lang` cl ON (cl.`id_category` = cp.`id_category` AND cl.`id_lang` = '.(int) $idLang.Shop::addSqlRestrictionOnLang('cl').')'
            . ' LEFT JOIN `'._DB_PREFIX_.'image_shop` image_shop ON (image_shop.`id_product` = p.`id_product` AND image_shop.cover = 1 AND image_shop.id_shop='.(int) Context::getContext()->shop->id.')'
            . ' LEFT JOIN `'._DB_PREFIX_.'image_lang` il ON (image_shop.`id_image` = il.`id_image` AND il.`id_lang` = '.(int) $idLang.')'
            . ' LEFT JOIN `'._DB_PREFIX_.'manufacturer` m ON (p.`id_manufacturer` = m.`id_manufacturer`)'
            . ' '.StockAvailable::addSqlAssociation('stock', 'p', false, Context::getContext()->shop->id).'
            . ' WHERE cp.`id_category` = '.(int) $this->id
            . $where // ? 注入自定义条件
            . Shop::addSqlRestriction(Shop::SHARE_PRODUCT)
            . ($active ? ' AND product_shop.`active` = 1' : '')
            . ($front ? ' AND product_shop.`visibility` IN ("both", "catalog")' : '');

        // 3️⃣ 自定义 ORDER BY(例如:先按 priority 降序,再按 date_add 降序)
        if (!$orderBy) {
            $orderBy = 'p.`priority`';
            $orderWay = 'DESC';
        }

        // 4️⃣ 执行查询(复用 PrestaShop 分页/缓存逻辑)
        if ($getTotal) {
            return (int) Db::getInstance(_PS_USE_SQL_SLAVE_)->getValue(
                'SELECT COUNT(*) FROM ('.$sql.') c'
            );
        }

        $result = Db::getInstance(_PS_USE_SQL_SLAVE_)->executeS(
            $sql
            . ' ORDER BY '.($orderBy == 'id_product' ? 'p.`id_product`' : $orderBy).' '.$orderWay
            . ' LIMIT '.(int) $n.' OFFSET '.(int) (($p - 1) * $n)
        );

        // 5️⃣ 补充处理(如添加图片 URL、价格格式化等),可调用 Product::getProductsProperties()
        return Product::getProductsProperties($idLang, $result);
    }
}

⚠️ 关键注意事项

  • 必须清除缓存:覆盖生效前,删除 var/cache/ 下所有内容(或后台「高级参数 → 性能」中点击「清除缓存」);
  • 避免硬编码表前缀:始终使用 _DB_PREFIX_ 常量;
  • 区分主从库:读操作使用 _PS_USE_SQL_SLAVE_,写操作禁用;
  • 保持分页兼容性:$getTotal 分支必须返回整型计数,否则分页将异常;
  • 不建议修改 COUNT 查询结构:若需复杂过滤,务必同步更新计数子查询中的 WHERE 条件,否则页码显示错误;
  • 优先使用 Hook 替代硬覆盖:对于简单排序/过滤,可考虑 actionProductSearchProviderQueryBuilder 钩子(PS 1.7.7+),更轻量且升级友好。

✅ 总结

通过安全覆盖 Category::getProducts(),你完全掌控了分类页的数据源。无论是按自定义字段 priority 加权排序、按 state 状态筛选,还是关联其他业务表,均可在此方法中灵活实现。记住:覆盖是手段,可维护性与兼容性才是目标——始终遵循 PS 覆盖规范,测试分页、缓存与多语言场景,确保升级无忧。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

php word 多语言

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

2023.10.12

5083

8

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.27

1031

4

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

2024.02.23

1329

5

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

7161

10

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

3783

4

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

2024.04.07

7140

11

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

2024.04.29

10021

6

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

1370

5

sql中删除一列的命令是什么
sql中删除一列的命令是什么

在sql中,使用alter table语句可以删除一列,语法为:alter table table_name drop column column_name。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

1192

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习