Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/lucumaagency/vaporis-dropdown/archive/refs/heads/main.zipVaporis · Boxes y Aroma de Regalo
Plugin de WooCommerce para la tienda Vaporis. Hace dos cosas:
- Aroma de regalo en boxes — en la ficha de cada box muestra un desplegable para que el cliente elija un aroma de regalo. El aroma entra al carrito como línea de producto real a precio 0, por lo que WooCommerce descuenta su stock, aparece en carrito/checkout/pedido/picking y se vincula al box (se añade, sincroniza la cantidad y se elimina junto a él).
- Círculos de color (swatches) — en los boxes variables reemplaza el
<select>del atributo de color (pa_color) por círculos clicables, manteniendo el select oculto para no romper la lógica de variaciones de WC.
El archivo principal del plugin (vaporis-boxes-aroma.php) está en la raíz
del repo para que herramientas tipo Git Deployer / Git Updater lo detecten:
WordPress solo reconoce plugins en la raíz de su carpeta o un nivel debajo.
Instalación
Opción A · Git Deployer / Git Updater
Apunta el deployer a este repo. Clona en wp-content/plugins/<repo>/ y, al estar
el .php con la cabecera en la raíz, WordPress lo detecta y se puede activar.
Opción B · Subida manual
- Descarga el repo como ZIP (o clónalo).
- En WordPress: Plugins → Añadir nuevo → Subir plugin → sube el ZIP → Activar.
Si antes pegaste el código en
functions.php, bórralo de ahí para evitar funciones duplicadas.
Cómo funciona el aroma de regalo
BOX → define solo el TAMAÑO del regalo (campo ACF cantidad_de_aroma_de_regalo)
CLIENTE → elige CUÁL aroma en el desplegable de la ficha
PLUGIN → cruza aroma + tamaño → encuentra la variación → la añade gratis
El tamaño lo decide la tienda (interno); el cliente solo elige el aroma. El desplegable solo lista aromas que existan en ese tamaño y con stock.
Configuración (constantes, en la cabecera del plugin)
| Constante | Por defecto | Para qué |
|---|---|---|
VAPORIS_CAT_BOX |
boxes |
Slug de la categoría de boxes |
VAPORIS_CAT_AROMAS |
aromas |
Slug de la categoría de aromas |
VAPORIS_META_GIFT_SIZE |
cantidad_de_aroma_de_regalo |
Campo ACF del box con el tamaño del regalo |
VAPORIS_ATTR_COLOR |
pa_color |
Taxonomía del atributo global de color |
El mapa color→hex de los círculos es filtrable con vaporis_color_map.
Requisitos
- WooCommerce.
- Atributo global
pa_colorpara los swatches (los atributos personalizados por producto no son taxonomía y no funcionan con los círculos). - ACF para el campo
cantidad_de_aroma_de_regaloen los boxes y las notas de los aromas.
Carpeta datos/
CSVs de importación y exports de ACF usados para montar productos (boxes y aromas) y sus imágenes. Material de referencia, no forma parte del plugin.
Las imágenes de difusores (~50 MB) no se versionan (ver
.gitignore).