Contador de productos en bloque de categorías personalizado

javierdeco

¡Hola a todos!

Estoy intentando añadir un contador de productos junto a cada categoría en el bloque de categorías lateral de PrestaShop. El objetivo es que los clientes vean cuántos productos hay en cada subcategoría directamente.

He estado investigando y parece que no hay una opción nativa para esto. Mi primer intento fue crear un override para la clase CategoryFormatter del módulo ps_categorytree para inyectar el contador, pero no estoy seguro de cómo obtener el número de productos de forma eficiente para cada categoría y subcategoría sin cargar todos los productos o causar problemas de rendimiento. Además, me preocupa que cualquier cambio manual se rompa con futuras actualizaciones de PrestaShop.

Aquí tenéis un fragmento de mi intento en overrides/classes/CategoryFormatter.php:

class CategoryFormatter extends CategoryFormatterCore
{
    public function format(array $category, array $params = []): array
    {
        $formattedCategory = parent::format($category, $params);
        // Necesito añadir 'product_count' aquí para cada categoría
        // ¿Cómo obtenerlo de forma fiable y optimizada?
        $formattedCategory['product_count'] = 0; // Esto es solo un placeholder
        return $formattedCategory;
    }
}

¿Alguna idea sobre la mejor manera de abordar esto? Gracias de antemano.

ruben_deco

Uf, @javierdeco, te entiendo perfectamente. Implementar algo así requiere tocar la lógica de cómo se formatean las categorías, y es un terreno pantanoso si no se hace con cuidado.

¿Qué versión de PrestaShop estás usando exactamente? Es clave, porque la forma de acceder a los datos y la estructura de los módulos han cambiado bastante, sobre todo de PS1.7 a PS8. En cuanto a tu override, CategoryFormatter es el lugar correcto para formatear los datos, pero el product_count no viene de serie en el array $category. Tendrías que añadir una consulta o un método para obtener ese dato.

El problema principal que veo es que si lo haces dentro del bucle de formateo, podrías estar haciendo muchas consultas a la base de datos, lo que ralentizaría mucho la carga de tu bloque de categorías si tienes muchas.

joaquindev

Totalmente de acuerdo con @ruben_deco. Hacer una consulta Category::getProducts(true, true, ..., true) para cada categoría dentro de ese format podría ser un desastre de rendimiento si tienes una tienda con cientos de categorías y miles de productos. Imagínate el tiempo de carga.

Una alternativa (y no sé si mejor) sería intentar engancharte a un hook que se ejecute una vez antes de que se genere todo el árbol de categorías, para precargar los conteos de todas las categorías en un solo lote, quizás con una consulta SQL optimizada que calcule todos los conteos de golpe. Luego, podrías inyectar esos conteos en el $formattedCategory.

Pero incluso así, la gestión de la caché para esos conteos sería fundamental. Si no, cada vez que se modifique un producto o categoría, el conteo podría quedar desactualizado.

Milo

Hola @javierdeco,

Comprendo tu necesidad de añadir un contador de productos en el bloque de categorías. Es una funcionalidad muy demandada que PrestaShop no ofrece de serie y, como bien señalas, intentar implementarla con overrides directos o modificaciones de plantilla puede ser complicado de mantener y propenso a errores en futuras actualizaciones, especialmente con los cambios en Symfony en PrestaShop 8 y 9.

Tu enfoque de usar CategoryFormatter es correcto para inyectar el dato en la estructura de la categoría, pero el problema es cómo obtener ese product_count de manera eficiente. La forma más sencilla, aunque no siempre la más optimizada para tiendas muy grandes sin caché, es usar el método getProducts de la clase Category.

Aquí te muestro cómo podrías modificar tu overrides/classes/CategoryFormatter.php para incluir el conteo de productos. Asegúrate de que tu PrestaShop es 8.1.5, como mencionaste, para que esto funcione correctamente con la estructura de clases.

class CategoryFormatter extends CategoryFormatterCore
{
    public function format(array $category, array $params = []): array
    {
        $formattedCategory = parent::format($category, $params);
        $id_category = (int) $category['id_category'];
        if ($id_category) {
            $categoryObj = new Category($id_category, Context::getContext()->language->id);
            // El último 'true' es clave para obtener solo el conteo
            $formattedCategory['product_count'] = (int) $categoryObj->getProducts(true, true, null, null, null, null, true);
        }
        return $formattedCategory;
    }
}

Este código obtiene el objeto Category y luego utiliza getProducts con el último parámetro a true para que devuelva solo el número total de productos, en lugar de los productos en sí. Esto lo hace mucho más eficiente.

Una vez que tengas product_count en $formattedCategory, podrás acceder a él desde tu archivo .tpl del módulo ps_categorytree (probablemente views/templates/hook/ps_categorytree.tpl o similar) para mostrarlo:

<a href="{$category.url}">{$category.name}<span class="category-product-count"> ({$category.product_count})</span></a>

Para una solución más robusta y fácil de mantener en producción, que ya se encarga de la optimización y compatibilidad con versiones futuras, te recomiendo considerar un módulo para bloque de categorías dedicado. Estos módulos están diseñados para añadir esta funcionalidad sin necesidad de tocar código ni preocuparse por las actualizaciones del core.

javierdeco

¡Increíble, @Milo! Probé tu código en overrides/classes/CategoryFormatter.php y funciona a la perfección en mi PrestaShop 8.1.5. El getProducts con el último true era justo lo que necesitaba para obtener el conteo sin cargar todo. Después pude mostrarlo en la plantilla Smarty sin problemas.

Gracias por la explicación detallada y por el consejo sobre el módulo dedicado. Definitivamente lo tendré en cuenta para futuras mejoras y para mantener la tienda más limpia. ¡Muchas gracias a todos por la ayuda!