Product badges

Las etiquetas son distintivos de color sobre las imágenes de los productos. Ayudan a los clientes a identificar rápidamente ofertas, novedades, productos más vendidos y productos con poco stock.

Activar el módulo

Ve a WooCommerce > Polski > Módulos de tienda y activa la opción Product Badges. El módulo reemplazará la etiqueta predeterminada “¡Oferta!” de WooCommerce por etiquetas personalizadas y configurables.

Etiquetas automáticas

Las etiquetas automáticas se generan a partir de los datos del producto. No requieren configuración manual - tras activarlas funcionan de inmediato en todos los productos.

Oferta

Se muestra cuando el producto tiene un precio de oferta establecido. De forma predeterminada muestra el porcentaje de descuento (p. ej. -25%) en lugar del texto estándar “¡Oferta!”.

Configuración del formato:

Opción	Descripción	Ejemplo
Porcentaje	Porcentaje de descuento	-25%
Importe	Importe del ahorro	-50 PLN
Texto	Texto personalizado	Promoción
Porcentaje + importe	Ambos valores	-25% (-50 PLN)

// Cambiar el formato de la etiqueta de oferta
add_filter('polski/badges/sale_format', function (): string {
    return 'percentage'; // 'percentage', 'amount', 'text', 'both'
});

Para productos variables, el porcentaje se calcula en función de la variante con el mayor descuento.

Novedad

Se muestra en productos añadidos en los últimos X días. Predeterminado 14 días.

// Cambiar el periodo de novedad
add_filter('polski/badges/new_days', function (): int {
    return 30; // productos añadidos en los últimos 30 días
});

Poco stock

Se muestra cuando la cantidad en stock del producto cae por debajo del umbral establecido. El umbral predeterminado es el valor definido en WooCommerce (WooCommerce > Ajustes > Productos > Inventario > Umbral de poco stock).

Contenido de la etiqueta: ¡Últimas X unidades! (donde X es la cantidad actual).

// Texto personalizado de la etiqueta de poco stock
add_filter('polski/badges/low_stock_text', function (string $text, int $stock): string {
    if ($stock <= 3) {
        return '¡Últimas unidades!';
    }
    return sprintf('Quedan %d', $stock);
}, 10, 2);

Más vendido

Se muestra en los productos con el mayor número de ventas. Predeterminado los 10 productos principales de la tienda.

// Cambiar el límite de más vendidos
add_filter('polski/badges/bestseller_limit', function (): int {
    return 20;
});

El cálculo de los más vendidos se almacena en caché en la API de transients (24 horas de forma predeterminada).

Etiquetas manuales (por producto)

Además de las etiquetas automáticas, puedes añadir etiquetas personalizadas a productos individuales. En el editor de productos, dentro de Datos del producto, encontrarás la pestaña Badges.

Opciones de la etiqueta manual:

• Texto - contenido mostrado en la etiqueta (p. ej. “Recomendado”, “Eco”, “Envío gratis”)
• Color de fondo - color de la etiqueta (selector de color)
• Color del texto - color del texto en la etiqueta
• Posición - arriba a la izquierda, arriba a la derecha, abajo a la izquierda, abajo a la derecha
• Prioridad - orden de visualización cuando un producto tiene varias etiquetas

El número máximo de etiquetas en un solo producto es 4 (automáticas + manuales combinadas). Este límite evita saturar la miniatura.

// Cambiar el límite de etiquetas por producto
add_filter('polski/badges/max_per_product', function (): int {
    return 3;
});

Posicionamiento de las etiquetas

Las etiquetas automáticas tienen posiciones predeterminadas:

Etiqueta	Posición predeterminada
Oferta	Arriba a la izquierda
Novedad	Arriba a la derecha
Poco stock	Abajo a la izquierda
Más vendido	Arriba a la derecha

Las posiciones se configuran en los ajustes del módulo. Si dos etiquetas tienen la misma posición, se apilan verticalmente.

Formas de las etiquetas

Formas disponibles:

• Rectángulo - predeterminado
• Rectángulo redondeado - border-radius
• Círculo - para textos cortos (p. ej. “-25%”)
• Cinta - forma decorativa con un sesgo

Configuración en los ajustes: WooCommerce > Polski > Módulos de tienda > Badges > Forma.

Visibilidad de las etiquetas

Las etiquetas se muestran en:

• Páginas de categoría y archivo (fichas de producto)
• Página de producto individual (imagen principal)
• Slider de productos (módulo slider)
• Vista rápida (módulo quick view)
• Resultados de búsqueda

Puedes desactivar las etiquetas en ubicaciones seleccionadas:

// Desactivar las etiquetas en la página de producto individual
add_filter('polski/badges/show_on_single', '__return_false');

Etiquetas para productos variables

Para productos variables:

• Oferta - muestra el mayor porcentaje de descuento entre todas las variantes
• Poco stock - se muestra cuando al menos una variante tiene poco stock
• Novedad - según la fecha de alta del producto (no de la variante)

Estilos CSS

Clases CSS:

• .polski-badge - clase base de la etiqueta
• .polski-badge--sale - oferta
• .polski-badge--new - novedad
• .polski-badge--low-stock - poco stock
• .polski-badge--bestseller - más vendido
• .polski-badge--custom - etiqueta manual
• .polski-badge--top-left - posición arriba a la izquierda
• .polski-badge--top-right - posición arriba a la derecha
• .polski-badge--bottom-left - posición abajo a la izquierda
• .polski-badge--bottom-right - posición abajo a la derecha
• .polski-badge--rectangle - forma rectangular
• .polski-badge--circle - forma circular
• .polski-badge--ribbon - forma de cinta

Ejemplo de estilo:

.polski-badge--sale {
    background-color: #dc2626;
    color: #ffffff;
    font-weight: 700;
    font-size: 0.75rem;
    padding: 4px 8px;
}

Rendimiento

Las etiquetas automáticas se almacenan en caché en el meta del producto (_polski_badges_cache) y se actualizan al guardar cada producto. El cálculo de los más vendidos se realiza una vez cada 24 horas a través de la API de transients.

Resolución de problemas

La etiqueta de oferta no muestra el porcentaje - comprueba que el precio normal del producto esté establecido. Sin un precio normal, no se puede calcular el porcentaje.

La etiqueta manual no aparece - comprueba el límite de etiquetas por producto. Si el producto ya tiene 4 etiquetas automáticas, la manual no se mostrará.

Las etiquetas tapan el botón de vista rápida - cambia la posición de las etiquetas o del botón de vista rápida en los ajustes del módulo.

Reportar problemas: github.com/wppoland/polski/issues

Esta página tiene únicamente fines informativos y no constituye asesoramiento legal. Consulta a un abogado antes de la implementación. Polski for WooCommerce es software de código abierto (GPLv2) proporcionado sin garantía.