Configuración de Marks
La página Marks requiere la capacidad manage_woocommerce. Los ajustes se guardan en marks_settings, se validan por tipo y los valores numéricos se limitan a rangos seguros.
Activación y posición
Section titled “Activación y posición”enabled controla toda la función. Cuando está desactivada, Marks tampoco carga su CSS en el escaparate.
Los controles show_on_single y show_on_loop permiten elegir la salida en páginas de producto y bucles. Marks usa los hooks de WooCommerce correspondientes, de modo que un tema que los elimine puede necesitar el shortcode en su plantilla personalizada.
Reglas automáticas
Section titled “Reglas automáticas”| Ajuste | Evaluación | Valor inicial | Estilo |
|---|---|---|---|
show_sale_badge | $product->is_on_sale() | Activo | Ámbar |
show_new_badge | Fecha de creación dentro de la ventana | Activo | Verde |
show_low_stock_badge | Stock gestionado, cantidad mayor que 0 y hasta el umbral | Activo | Ámbar |
show_bestseller_badge | Ventas totales desde el umbral | Activo | Acento |
show_discount_percent_badge | Ahorro porcentual positivo | Inactivo | Rojo |
show_free_shipping_badge | Clase de envío incluida en la lista | Inactivo | Verde |
show_out_of_stock_badge | $product->is_in_stock() es falso | Activo | Gris |
Puedes cambiar las etiquetas de Oferta, Nuevo, Pocas unidades, Más vendido, Envío gratis y Agotado. La regla de descuento no tiene una etiqueta fija, calcula el porcentaje a partir de los precios.
Umbrales
Section titled “Umbrales”- Nuevo, 30 días de forma predeterminada.
- Pocas unidades, 3 unidades de forma predeterminada.
- Más vendido, 25 ventas totales de forma predeterminada.
- Envío gratis, lista de slugs de clases de envío, con
free-shippingcomo valor inicial.
La regla de pocas unidades sólo se aplica cuando WooCommerce gestiona el stock del producto y la cantidad es positiva. Un producto sin stock se reserva para la regla Agotado.
En Envío gratis introduce slugs, no nombres visibles. Si tienes varias clases, utiliza la lista aceptada por el campo y comprueba una referencia de cada clase en la tienda.
Etiqueta de oferta del tema
Section titled “Etiqueta de oferta del tema”Cuando show_sale_badge está activo, Marks puede ocultar el flash de oferta nativo de WooCommerce. Esta opción evita que una tarjeta muestre a la vez la insignia de Marks y el texto Sale! del tema.
Apariencia y límites
Section titled “Apariencia y límites”- Forma de píldora o cuadrada.
- Texto opcional en mayúsculas.
- Máximo inicial de 4 insignias en la página de producto.
- Máximo inicial de 3 insignias en el bucle.
El límite se aplica según esta prioridad: manual, Oferta, Nuevo, Pocas unidades, Más vendido, Descuento, Envío gratis y Agotado.
Los colores de las reglas automáticas son semánticos y no se asignan por producto. La edición gratuita ofrece una única insignia manual por producto.
Datos de la insignia manual
Section titled “Datos de la insignia manual”manual_badge_text, etiqueta general. Si está vacía, la insignia manual queda desactivada.manual_badge_style, color general con uno de los cinco valores semánticos._marks_manual_text, texto visible._marks_manual_style, uno deaccent,success,warning,dangeroneutral.
Los dos primeros valores pertenecen a marks_settings. Los metadatos se almacenan en el producto y permiten que cada referencia tenga su propio texto y, si hace falta, un color distinto.
Hooks para desarrolladores
Section titled “Hooks para desarrolladores”| Hook | Tipo | Uso |
|---|---|---|
storefront_kit_product_badges | filtro | Modifica la lista final de insignias del motor compartido. |
marks_sanitize_settings | filtro | Modifica los ajustes validados antes de guardarlos. |
marks_admin_settings_after_manual_table | acción | Añade contenido tras la sección manual de los ajustes. |
Antes de depender de la forma exacta de un array, revisa la versión del plugin y conserva las claves existentes. Escapa siempre cualquier HTML añadido al resultado.
Marks expone variables CSS en el contenedor de insignias. Puedes sobrescribirlas desde el tema hijo sin modificar archivos del plugin. Consulta un ejemplo en Uso.
Desinstalación
Section titled “Desinstalación”La desinstalación elimina marks_settings y marks_db_version. Conserva _marks_manual_text y _marks_manual_style en los productos para no destruir contenido editorial al retirar el plugin. No modifica pedidos, clientes ni otros datos de WooCommerce.