Merge pull request #146 from TeamEver/codex/add-shortcodes-for-best-sellers

CySSoO · web-flow · commit 6e969a593272 · 2025-07-25T09:03:32.000+02:00
Add feature best sales shortcodes
diff --git a/README.md b/README.md
@@ -105,6 +105,8 @@ You can create your own shortcodes from the "Shortcodes" tab accessible in the "
 - `[best-sales 10 carousel=true]`: Displays the top ten best-selling products. Optional parameters: `days`, `orderby`, `orderway`.
 - `[categorybestsales id="8" nb="10"]`: Displays the best-selling products from category ID 8. Optional parameters: `orderby`, `orderway`.
 - `[brandbestsales id="3" nb="10"]`: Displays the best-selling products from brand ID 3. Optional parameters: `orderby`, `orderway`.
+- `[featurebestsales id="2" nb="10"]`: Displays the best-selling products with feature ID 2. Optional parameters: `orderby`, `orderway`.
+- `[featurevaluebestsales id="5" nb="10"]`: Displays the best-selling products with feature value ID 5. Optional parameters: `orderby`, `orderway`.
 - `[random_product nb="10" carousel=true]`: Displays ten random products in a carousel.
 - `[linkedproducts nb="8" orderby="date_add" orderway="DESC"]`: Displays products linked to the current product in a Bootstrap carousel.
 - `[accessories nb="8" orderby="date_add" orderway="DESC"]`: Displays accessories of the current product in a Bootstrap carousel.
@@ -304,6 +306,8 @@ Vous pouvez créer vos propres shortcodes depuis l'onglet "Shortcodes" accessibl
 - `[best-sales 10 carousel=true]` : Affiche les dix meilleures ventes. Paramètres optionnels : `days`, `orderby`, `orderway`.
 - `[categorybestsales id="8" nb="10"]` : Affiche les meilleures ventes de la catégorie 8. Paramètres optionnels : `orderby`, `orderway`.
 - `[brandbestsales id="3" nb="10"]` : Affiche les meilleures ventes de la marque 3. Paramètres optionnels : `orderby`, `orderway`.
+- `[featurebestsales id="2" nb="10"]` : Affiche les meilleures ventes associées à la caractéristique 2. Paramètres optionnels : `orderby`, `orderway`.
+- `[featurevaluebestsales id="5" nb="10"]` : Affiche les meilleures ventes pour la valeur de caractéristique 5. Paramètres optionnels : `orderby`, `orderway`.
 - `[random_product nb="10" carousel=true]` : Affiche dix produits aléatoires en carousel.
 - `[linkedproducts nb="8" orderby="date_add" orderway="DESC"]` : Affiche les produits liés au produit courant en carousel Bootstrap.
 - `[accessories nb="8" orderby="date_add" orderway="DESC"]` : Affiche les accessoires du produit courant en carousel Bootstrap.
@@ -488,6 +492,8 @@ Puedes crear tus propios shortcodes desde la pestaña "Shortcodes" disponible en
 - `[best-sales 10 carousel=true]`: Muestra los diez productos más vendidos. Parámetros opcionales: `days`, `orderby`, `orderway`.
 - `[categorybestsales id="8" nb="10"]`: Muestra los productos más vendidos de la categoría 8. Parámetros opcionales: `orderby`, `orderway`.
 - `[brandbestsales id="3" nb="10"]`: Muestra los productos más vendidos de la marca 3. Parámetros opcionales: `orderby`, `orderway`.
+- `[featurebestsales id="2" nb="10"]`: Muestra los productos más vendidos con la característica 2. Parámetros opcionales: `orderby`, `orderway`.
+- `[featurevaluebestsales id="5" nb="10"]`: Muestra los productos más vendidos con el valor de característica 5. Parámetros opcionales: `orderby`, `orderway`.
 - `[random_product nb="10" carousel=true]`: Muestra diez productos aleatorios en carrusel.
 - `[linkedproducts nb="8" orderby="date_add" orderway="DESC"]`: Muestra productos relacionados con el producto actual en un carrusel Bootstrap.
 - `[accessories nb="8" orderby="date_add" orderway="DESC"]`: Muestra los accesorios del producto actual en un carrusel Bootstrap.
@@ -672,6 +678,8 @@ Puoi creare i tuoi shortcode dalla scheda "Shortcodes" nel sottomenu "Ever block
 - `[best-sales 10 carousel=true]`: Mostra i dieci prodotti più venduti. Parametri opzionali: `days`, `orderby`, `orderway`.
 - `[categorybestsales id="8" nb="10"]`: Mostra i prodotti più venduti della categoria 8. Parametri opzionali: `orderby`, `orderway`.
 - `[brandbestsales id="3" nb="10"]`: Mostra i prodotti più venduti del marchio 3. Parametri opzionali: `orderby`, `orderway`.
+- `[featurebestsales id="2" nb="10"]`: Mostra i prodotti più venduti con la caratteristica 2. Parametri opzionali: `orderby`, `orderway`.
+- `[featurevaluebestsales id="5" nb="10"]`: Mostra i prodotti più venduti con il valore caratteristica 5. Parametri opzionali: `orderby`, `orderway`.
 - `[random_product nb="10" carousel=true]`: Mostra dieci prodotti casuali in carosello.
 - `[linkedproducts nb="8" orderby="date_add" orderway="DESC"]`: Mostra i prodotti collegati a quello attuale in un carosello Bootstrap.
 - `[accessories nb="8" orderby="date_add" orderway="DESC"]`: Mostra gli accessori del prodotto corrente in un carosello Bootstrap.
diff --git a/models/EverblockTools.php b/models/EverblockTools.php
@@ -101,6 +101,12 @@ public static function renderShortcodes(string $txt, Context $context, Everblock
         if (strpos($txt, '[brandbestsales') !== false) {
             $txt = static::getBrandBestSalesShortcode($txt, $context, $module);
         }
+        if (strpos($txt, '[featurebestsales') !== false) {
+            $txt = static::getFeatureBestSalesShortcode($txt, $context, $module);
+        }
+        if (strpos($txt, '[featurevaluebestsales') !== false) {
+            $txt = static::getFeatureValueBestSalesShortcode($txt, $context, $module);
+        }
         if (strpos($txt, '[last-products') !== false) {
             $txt = static::getLastProductsShortcode($txt, $context, $module);
         }
@@ -1009,6 +1015,88 @@ protected static function getBestSellingProductIdsByBrand(int $brandId, int $lim
         return EverblockCache::cacheRetrieve($cacheId);
     }
 
+    protected static function getBestSellingProductIdsByFeature(int $featureId, int $limit, string $orderBy = 'total_quantity', string $orderWay = 'DESC', ?int $days = null): array
+    {
+        $context = Context::getContext();
+        $cacheId = 'everblock_bestSellingProductIds_feature_'
+            . (int) $context->shop->id . '_'
+            . $featureId . '_'
+            . $limit . '_'
+            . ($days ?? 'all') . '_'
+            . $orderBy . '_'
+            . $orderWay;
+
+        if (!EverblockCache::isCacheStored($cacheId)) {
+            $shopId = (int) $context->shop->id;
+            $sql = 'SELECT od.product_id, SUM(od.product_quantity) AS total_quantity'
+                . ' FROM ' . _DB_PREFIX_ . 'order_detail od'
+                . ' JOIN ' . _DB_PREFIX_ . 'orders o ON od.id_order = o.id_order'
+                . ' JOIN ' . _DB_PREFIX_ . 'product_shop ps ON od.product_id = ps.id_product'
+                . ' JOIN ' . _DB_PREFIX_ . 'feature_product fp ON od.product_id = fp.id_product'
+                . ' WHERE ps.active = 1'
+                . ' AND ps.id_shop = ' . $shopId
+                . ' AND o.id_shop = ' . $shopId
+                . ' AND fp.id_feature = ' . (int) $featureId;
+
+            if ($days !== null) {
+                $dateFrom = date('Y-m-d H:i:s', strtotime("-$days days"));
+                $sql .= ' AND o.date_add >= "' . pSQL($dateFrom) . '"';
+            }
+
+            $sql .= ' GROUP BY od.product_id'
+                . ' ORDER BY ' . pSQL($orderBy) . ' ' . pSQL($orderWay)
+                . ' LIMIT ' . (int) $limit;
+
+            $rows = Db::getInstance(_PS_USE_SQL_SLAVE_)->executeS($sql);
+            $ids = array_map(fn($row) => (int) $row['product_id'], $rows);
+            EverblockCache::cacheStore($cacheId, $ids);
+            return $ids;
+        }
+
+        return EverblockCache::cacheRetrieve($cacheId);
+    }
+
+    protected static function getBestSellingProductIdsByFeatureValue(int $featureValueId, int $limit, string $orderBy = 'total_quantity', string $orderWay = 'DESC', ?int $days = null): array
+    {
+        $context = Context::getContext();
+        $cacheId = 'everblock_bestSellingProductIds_feature_value_'
+            . (int) $context->shop->id . '_'
+            . $featureValueId . '_'
+            . $limit . '_'
+            . ($days ?? 'all') . '_'
+            . $orderBy . '_'
+            . $orderWay;
+
+        if (!EverblockCache::isCacheStored($cacheId)) {
+            $shopId = (int) $context->shop->id;
+            $sql = 'SELECT od.product_id, SUM(od.product_quantity) AS total_quantity'
+                . ' FROM ' . _DB_PREFIX_ . 'order_detail od'
+                . ' JOIN ' . _DB_PREFIX_ . 'orders o ON od.id_order = o.id_order'
+                . ' JOIN ' . _DB_PREFIX_ . 'product_shop ps ON od.product_id = ps.id_product'
+                . ' JOIN ' . _DB_PREFIX_ . 'feature_product fp ON od.product_id = fp.id_product'
+                . ' WHERE ps.active = 1'
+                . ' AND ps.id_shop = ' . $shopId
+                . ' AND o.id_shop = ' . $shopId
+                . ' AND fp.id_feature_value = ' . (int) $featureValueId;
+
+            if ($days !== null) {
+                $dateFrom = date('Y-m-d H:i:s', strtotime("-$days days"));
+                $sql .= ' AND o.date_add >= "' . pSQL($dateFrom) . '"';
+            }
+
+            $sql .= ' GROUP BY od.product_id'
+                . ' ORDER BY ' . pSQL($orderBy) . ' ' . pSQL($orderWay)
+                . ' LIMIT ' . (int) $limit;
+
+            $rows = Db::getInstance(_PS_USE_SQL_SLAVE_)->executeS($sql);
+            $ids = array_map(fn($row) => (int) $row['product_id'], $rows);
+            EverblockCache::cacheStore($cacheId, $ids);
+            return $ids;
+        }
+
+        return EverblockCache::cacheRetrieve($cacheId);
+    }
+
     public static function getWidgetShortcode($txt)
     {
         $txt = preg_replace_callback('/\[widget moduleName="(.+?)" hookName="(.+?)"\]/', function ($matches) {
@@ -1581,6 +1669,122 @@ public static function getBrandBestSalesShortcode(string $txt, Context $context,
         return $txt;
     }
 
+    public static function getFeatureBestSalesShortcode(string $txt, Context $context, Everblock $module): string
+    {
+        preg_match_all(
+            '/\[featurebestsales\s+id="?(\d+)"?(?:\s+nb=(\d+))?(?:\s+limit=(\d+))?(?:\s+days=(\d+))?(?:\s+carousel=(true|false))?(?:\s+orderby="?(\w+)"?)?(?:\s+orderway="?(\w+)"?)?\]/i',
+            $txt,
+            $matches,
+            PREG_SET_ORDER
+        );
+
+        foreach ($matches as $match) {
+            $featureId = (int)$match[1];
+            $limit = isset($match[2]) && $match[2] !== '' ? (int)$match[2] : (isset($match[3]) ? (int)$match[3] : 10);
+            $days = isset($match[4]) ? (int)$match[4] : null;
+            $carousel = isset($match[5]) && $match[5] === 'true';
+            $orderBy = isset($match[6]) ? strtolower($match[6]) : 'total_quantity';
+            $orderWay = isset($match[7]) ? strtoupper($match[7]) : 'DESC';
+
+            $allowedOrderBy = ['total_quantity', 'product_id'];
+            $allowedOrderWay = ['ASC', 'DESC'];
+            if (!in_array($orderBy, $allowedOrderBy)) {
+                $orderBy = 'total_quantity';
+            }
+            if (!in_array($orderWay, $allowedOrderWay)) {
+                $orderWay = 'DESC';
+            }
+
+            $productIds = static::getBestSellingProductIdsByFeature($featureId, $limit, $orderBy, $orderWay, $days);
+
+            if (!empty($productIds)) {
+                $everPresentProducts = static::everPresentProducts($productIds, $context);
+
+                if (!empty($everPresentProducts)) {
+                    $context->smarty->assign([
+                        'everPresentProducts' => $everPresentProducts,
+                        'carousel' => $carousel,
+                        'shortcodeClass' => 'featurebestsales'
+                    ]);
+
+                    $templatePath = static::getTemplatePath('hook/ever_presented_products.tpl', $module);
+                    $replacement = $context->smarty->fetch($templatePath);
+
+                    $shortcodeParts = ['[featurebestsales', 'id=' . $featureId];
+                    if (isset($match[2]) && $match[2] !== '') { $shortcodeParts[] = 'nb=' . $match[2]; }
+                    elseif (isset($match[3])) { $shortcodeParts[] = 'limit=' . $match[3]; }
+                    if (isset($match[4])) { $shortcodeParts[] = 'days=' . $match[4]; }
+                    if (isset($match[5])) { $shortcodeParts[] = 'carousel=' . $match[5]; }
+                    if (isset($match[6])) { $shortcodeParts[] = 'orderby=' . $match[6]; }
+                    if (isset($match[7])) { $shortcodeParts[] = 'orderway=' . $match[7]; }
+                    $shortcode = implode(' ', $shortcodeParts) . ']';
+
+                    $txt = str_replace($shortcode, $replacement, $txt);
+                }
+            }
+        }
+
+        return $txt;
+    }
+
+    public static function getFeatureValueBestSalesShortcode(string $txt, Context $context, Everblock $module): string
+    {
+        preg_match_all(
+            '/\[featurevaluebestsales\s+id="?(\d+)"?(?:\s+nb=(\d+))?(?:\s+limit=(\d+))?(?:\s+days=(\d+))?(?:\s+carousel=(true|false))?(?:\s+orderby="?(\w+)"?)?(?:\s+orderway="?(\w+)"?)?\]/i',
+            $txt,
+            $matches,
+            PREG_SET_ORDER
+        );
+
+        foreach ($matches as $match) {
+            $featureValueId = (int)$match[1];
+            $limit = isset($match[2]) && $match[2] !== '' ? (int)$match[2] : (isset($match[3]) ? (int)$match[3] : 10);
+            $days = isset($match[4]) ? (int)$match[4] : null;
+            $carousel = isset($match[5]) && $match[5] === 'true';
+            $orderBy = isset($match[6]) ? strtolower($match[6]) : 'total_quantity';
+            $orderWay = isset($match[7]) ? strtoupper($match[7]) : 'DESC';
+
+            $allowedOrderBy = ['total_quantity', 'product_id'];
+            $allowedOrderWay = ['ASC', 'DESC'];
+            if (!in_array($orderBy, $allowedOrderBy)) {
+                $orderBy = 'total_quantity';
+            }
+            if (!in_array($orderWay, $allowedOrderWay)) {
+                $orderWay = 'DESC';
+            }
+
+            $productIds = static::getBestSellingProductIdsByFeatureValue($featureValueId, $limit, $orderBy, $orderWay, $days);
+
+            if (!empty($productIds)) {
+                $everPresentProducts = static::everPresentProducts($productIds, $context);
+
+                if (!empty($everPresentProducts)) {
+                    $context->smarty->assign([
+                        'everPresentProducts' => $everPresentProducts,
+                        'carousel' => $carousel,
+                        'shortcodeClass' => 'featurevaluebestsales'
+                    ]);
+
+                    $templatePath = static::getTemplatePath('hook/ever_presented_products.tpl', $module);
+                    $replacement = $context->smarty->fetch($templatePath);
+
+                    $shortcodeParts = ['[featurevaluebestsales', 'id=' . $featureValueId];
+                    if (isset($match[2]) && $match[2] !== '') { $shortcodeParts[] = 'nb=' . $match[2]; }
+                    elseif (isset($match[3])) { $shortcodeParts[] = 'limit=' . $match[3]; }
+                    if (isset($match[4])) { $shortcodeParts[] = 'days=' . $match[4]; }
+                    if (isset($match[5])) { $shortcodeParts[] = 'carousel=' . $match[5]; }
+                    if (isset($match[6])) { $shortcodeParts[] = 'orderby=' . $match[6]; }
+                    if (isset($match[7])) { $shortcodeParts[] = 'orderway=' . $match[7]; }
+                    $shortcode = implode(' ', $shortcodeParts) . ']';
+
+                    $txt = str_replace($shortcode, $replacement, $txt);
+                }
+            }
+        }
+
+        return $txt;
+    }
+
     public static function getLinkedProductsShortcode(string $txt, Context $context, Everblock $module): string
     {
         if (!Tools::getValue('id_product')) {
