README

en_US

此模块提供了一个循环，返回最佳（或最差）销售，以及另一个循环，返回与给定产品一起购买的最多的产品。

安装

手动安装，或使用composer

composer require thelia/best-sellers-module:~2.0

使用

此模块通过home.body钩子在首页显示您商店的4个最佳销售。

您还可以在模板（前台或后台）中添加任何位置，添加一个best_selling_products循环以显示您的最佳或最差销售。

在后台，您可以在“工具”菜单中看到您的最佳销售。

最后，产品的总销售数量将出现在产品页面上。

更新1.2.0 : 您现在可以选择用于计算最佳销售者的订单状态。已向模块中添加了一个配置页面，可通过“模块”页面访问。

钩子

此模块通过home.body钩子在首页显示您商店的4个最佳销售，并通过product.bottom钩子（现代模板）或product.additional钩子（默认模板）在产品页面上显示与当前产品一起购买的产品。

循环

best_selling_product循环

该模块提供了一个名为best_selling_product的循环，它扩展了product循环。因此，product循环的所有参数都可用。

best_selling_products循环

输入参数

product循环的所有参数都可用。

循环参数中添加了一个新的参数only_sold_products（默认值为false）。如果为true，则仅返回已售出的产品。未售出的产品将不返回。

如果为false（默认值），则返回所有产品，即使从未售出。

循环为循环`product`的order参数提供了两个新值

• sold_count_reverse：按销售数量降序排序
• sold_count：按销售数量升序排序

输出变量

product循环的所有变量都可用。

示例

获取您所有时间的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>

purchased_with_products循环

此循环基于过去的订单（已支付或未支付）返回与给定产品一起购买的产品

输入参数

输出参数

示例

获取与给定产品一起销售的顶级4个产品

<ul>
        {loop name="purchased-with" type="purchased_with_products" product_ref=$REF limit="4"}
            {loop type="product" name="product_list" ref=$PRODUCT_REF}
                <li>{$REF} : {$TITLE} : {$SOLD_COUNT}</li>
            {/loop}
        {/loop}
</ul>

fr_FR

此模块提供了一个循环，返回您的最佳（或最差）销售，以及另一个循环，允许您显示与给定产品一起购买的最多的产品。

安装

手动安装，或使用composer

composer require thelia/best-sellers-module:~2.0

使用

此模块通过'home.body'钩子在首页显示您商店的4个最佳销售

您还可以在模板的前台或后台中添加任何位置，添加一个best_selling_products循环以显示您的最佳或最差销售。

在后台，您可以在“工具”菜单中看到您的最佳销售。

最后，产品的总销售数量将出现在产品页面上。

更新1.2.0 : 模块现在允许您选择用于计算最佳销售者的订单状态。已向模块中添加了一个配置页面，可通过“模块”页面访问。

钩子

模块通过home.body钩子在首页显示您商店的4个最佳销售。它通过product.bottom钩子（现代模板）或product.additional钩子（默认模板）在产品页面上显示与当前产品一起购买的产品。

循环

此模块为您提供了 best_selling_products 循环，它扩展了 product 循环。因此，product 循环的所有参数都可用。它还提供了 purchased_with_products 循环，允许显示与特定商品一起购买的商品。

best_selling_products循环

输入参数

product 循环的所有参数都可用。

新参数 only_sold_products（默认为 false）被添加到循环参数中。如果为 true，则只返回已售出的产品。从未售出的产品不会被返回。

如果为 false（默认值），则返回所有产品，即使它们从未售出。

循环为 product 循环的 order 参数提供了两个额外值

• sold_count_reverse：按销售数量降序排列
• sold_count：按销售数量升序排列

输出变量

product 循环的所有变量都可用。

示例

获取您所有时间以来的前 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>

purchased_with_products循环

此循环可以通过查看已提交的订单（已支付或未支付）来返回与特定商品一起购买的商品

输入参数

输出变量

示例

获取与特定商品一起购买的最畅销的 4 个商品

<ul>
        {loop name="purchased-with" type="purchased_with_products" product_ref=$REF limit="4"}
            {loop type="product" name="product_list" ref=$PRODUCT_REF}
                <li>{$REF} : {$TITLE} : {$SOLD_COUNT}</li>
            {/loop}
        {/loop}
</ul>