cqfdev / best-sellers-module
Requires
- thelia/installer: ~1.1
README
en_US
本模块提供了一个循环,返回最佳(或最差)销售。
安装
手动安装或使用composer
composer require cqfdev/best-sellers-module:~1.0
使用
此模块通过 home.body
钩子在前页显示您商店的4个最佳销售。
您还可以在模板(前台或后台)中添加您想要的位置,一个 best_selling_products
循环来显示您的最佳或最差销售。
在后台,您可以在“工具”菜单中看到您的最佳销售。
最后,产品的总销售数量出现在产品页面上。
更新1.2.0:现在您可以选择哪些订单状态被考虑在内以计算您的最佳销售。模块中已添加一个配置页面。从模块页面访问。
钩子
此模块通过 home.body
钩子在前页显示您商店的4个最佳销售。
循环
模块提供循环 best_selling_product
,它扩展了循环 product
。因此,所有 product
循环的参数都可用。
best_selling_products
循环
输入参数
循环 product
的所有参数都可用。
循环为循环 `product` 的参数 order
提供两个新值
- sold_count_reverse:按销售数量降序排序
- sold_count:按销售数量升序排序
参数 | 描述 |
---|---|
start-date | 要考虑的期间开始日期。默认为1970年1月1日。 |
end-date | 要考虑的期间结束日期。默认为今天的日期。 |
输出变量
循环 product
的所有变量都可用。
变量 | 描述 |
---|---|
$SOLD_QUANTITY | 在考虑的期间内售出的产品数量 |
$SOLD_AMOUNT | 在考虑的期间内销售的总税额 |
$SALE_RATIO | 在考虑的期间内的销售百分比 |
示例
获取您有史以来10个最佳销售
<ul>
{loop type="best_selling_products" name="best-sellers" limit=10 order='sold_count_reverse'}
<li>{$REF} : {$TITLE} : {$SOLD_QUANTITY}</li>
{/loop}²²
</ul>
获取您本月的5个最佳销售
<ul>
{loop type="best_selling_products" name="best-sellers-this-month" order='sold_count_reverse' start_date={$smarty.now|date_format:'%Y-%m-01'} limit=5}
<li>{$REF} : {$TITLE} : {$SOLD_QUANTITY}</li>
{/loop}
</ul>
获取您有史以来10个最差销售
<ul>
{loop type="best_selling_products" name="best-sellers" limit=10 order='sold_count'}
<li>{$REF} : {$TITLE} : {$SOLD_QUANTITY}</li>
{/loop}
</ul>
fr_FR
Ce module vous fournit une boucle qui retourne vos meilleures (ou vos pires) ventes.
安装
手动或使用composer
composer require cqfdev/best-sellers-module:~1.0
用法
此模块通过“home.body”钩子在首页显示您商店的4个最佳销量。
您还可以在您的前台模板或后台管理界面中添加任何位置,以显示您的最佳或最差销量,使用循环best_selling_products
。
在后台,您可以在“工具”菜单中查看您的最佳销量。
最后,产品的总销量将显示在产品页面上。
更新1.2.0:该模块现在允许您选择用于计算最佳销量的订单状态。已添加一个配置页面,可通过“模块”页面访问。
钩子
该模块通过钩子home.body
在首页显示您商店的4个最佳销量。
循环
该模块提供了一个循环best_selling_products
,它扩展了循环product
。因此,所有循环product
的参数都是可用的。
best_selling_products
循环
输入参数
所有循环product
的参数都是可用的。
循环为循环product
的参数order
提供了两个额外值:
- sold_count_reverse:按销量降序排列
- sold_count:按销量升序排列
参数 | 描述 |
---|---|
start-date | 要考虑的期间开始日期。默认为1970年1月1日。 |
end-date | 要考虑的期间结束日期。默认为今天。 |
输出变量
所有循环product
的变量都是可用的。
变量 | 描述 |
---|---|
$SOLD_QUANTITY | 考虑期间内售出的产品数量 |
$SOLD_AMOUNT | 考虑期间内销售的增值税总额 |
$SALE_RATIO | 考虑期间内的营业额百分比 |
示例
获取您所有时间的10个最佳销量
<ul>
{loop type="best_selling_products" name="best-sellers" limit=10 order='sold_count_reverse'}
<li>{$REF} : {$TITLE} : {$SOLD_QUANTITY}</li>
{/loop}
</ul>
获取本月的5个最佳销量
<ul>
{loop type="best_selling_products" name="best-sellers-this-month" order='sold_count_reverse' start_date={$smarty.now|date_format:'%Y-%m-01'} limit=5}
<li>{$REF} : {$TITLE} : {$SOLD_QUANTITY}</li>
{/loop}
</ul>
获取您所有时间的10个最差销量
<ul>
{loop type="best_selling_products" name="best-sellers" limit=10 order='sold_count'}
<li>{$REF} : {$TITLE} : {$SOLD_QUANTITY}</li>
{/loop}
</ul>