Caracool Vinos self-updates

La carta de vinos de un restaurante, leída del Word que ya edita el propio restaurante, y publicada como una página que se filtra por tipo, uva, bodega, zona y precio, con un globo que gira hasta la zona de cada vino.

Es un plugin de la casa, con el mismo chasis que Caracool Carta y Caracool Churra: cuelga del menú «Caracool» del escritorio, se actualiza desde las releases de GitHub y no trae ninguna librería de servidor. En el navegador sí lleva tres (d3-geo, d3-array y topojson-client) y la geometría del mundo, y van dentro del plugin, nunca de un CDN.

Cómo se usa

Desde la 0.5.0 el plugin es un cliente ligero de Caracool Bodega (bodega.caracool.net): no lee el Word. Lo lee y lo publica Caracool en Bodega, para cada cliente, y esta web recibe la carta ya leída con su licencia.

1. Caracool → Vinos → Conexión. Se pega la licencia que Caracool emite en Bodega para este dominio (una por web; también puede ir en wp-config.php como CARACOOL_LICENCIA).
2. La carta llega sola. Cuando Caracool publica una en Bodega, la web recibe un aviso y la recoge al momento; por si acaso, la comprueba dos veces al día (con ETag: si no hay nada nuevo, no viaja nada), y en la pestaña Carta está «Comprobar ahora». Si Bodega no responde, la web sigue con la última carta que recibió.
3. En la página, el widget de Elementor Explorar los vinos o el shortcode [caracool_vinos]. El bloque es el globo (o la red) con la lista y los filtros. Los colores y las letras salen del Kit del sitio.

El diseño lo decide Caracool en Bodega (la pestaña Diseño del cliente): las vistas que tiene la web (Mapa y Red; Lista va siempre), el diseño, la piel del panel de filtros y las esquinas. Llega con la carta y manda; si Bodega todavía no ha dicho nada, se queda lo de antes.

En Ajustes se enciende o se apaga cada vista que da Bodega, se elige la escena (de día o de noche) y si el visitante tiene el sol y la luna para cambiarla, y qué se ve: los precios, la ubicación en bodega, «Mis vinos», qué zonas van delante en la lista y los textos del pie y de «sin carta».

Los colores: el Kit, el widget y la hoja

La hoja del bloque no lleva ningún color escrito: cada token propio (--cv-tinta, --cv-crema, --cv-texto, --cv-borde, --cv-rojo…) apunta a una variable global del Kit de Elementor (--e-global-color-*), con el valor de El Churra de reserva. Los cuatro colores del sistema (Principal, Secundario, Texto, Acento) existen en todos los Kits; los demás (cremaclara, crema, arena, borde, ocremadera) existen porque se crearon con ese nombre en el Kit de El Churra, y en otra web caerían en la reserva. Para eso está la pestaña Estilo del widget:

• Colores de la casa: Tinta, Texto, Acento, Fondo, Papel, Arena y Bordes. Los tres primeros van enlazados de fábrica a Secundario, Texto y Principal del Kit (el icono del globo en cada control); cualquiera se puede enlazar a otro global o dejar suelto para este bloque.
• Colores del vino: Tinto, Blanco, Rosado y Espumoso. No son del Kit, son el color del vino en la copa; se pueden afinar.
• Letras: titulares y texto. Sin tocar, la tipografía Principal y la de Texto del Kit.
• De noche: fondo, papel, textos, bordes, arena y acento de la escena de noche (el acento, enlazado al Acento del Kit).

Ningún control estila nada: cada uno escribe su token en el bloque ({{WRAPPER}} .cv-explorador { --cv-tinta: … }), y la hoja cuelga de los tokens. Así no hay pelea con el Estilo del tema, y el shortcode sin Elementor sigue con la cadena Kit → reserva. Los tintes derivados (el país al pasar, el velo del panel, la banda de la fila) salen de los tokens con color-mix().

El panel de filtros: una estructura, tres pieles

El panel va en tres tramos separados por un filete: arriba los tipos, cada uno con una gota del color del vino (el champagne con un aro dorado, el mágnum con una botella); en medio la búsqueda, con lupa y un aspa para borrar, y los cinco filtros (uva, zona, bodega, precio y Parker), cada uno con su icono; y abajo «Mis vinos» a la izquierda y, a la derecha, Mapa · Red · Lista y el sol y la luna.

Cada filtro es un desplegable nativo puesto encima, transparente: se abre el del sistema, pero se ve el campo con lo elegido (sin la cuenta) y un aspa para quitarlo. Por eso la fila de chips de debajo ya no repite los filtros: solo lleva el país pinchado en el globo, la selección compartida y «Quitar todos». Si un filtro elegido se queda sin vinos al combinarlo con otros, el campo lo sigue enseñando.

La estructura es la misma en las tres pieles; cambia el aspecto (data-panel en el bloque):

• Mosaico (la de El Churra, de fábrica): los tipos en fichas con la cuenta a la derecha, la búsqueda como un campo relleno, los filtros como baldosas con el icono grande y el sol y la luna como un interruptor que se desliza.
• Píldoras: todo en píldoras con su icono y los filtros a tercios.
• Ficha: sin cajas; los tipos como pestañas subrayadas con la cuenta volada, la búsqueda en la letra de titulares sobre una raya y los filtros en celdas con el rótulo en versalitas, como la ficha de una cata.

La elige Caracool en Bodega. (En una web a la que Bodega todavía no ha mandado diseño, vale lo de antes: Ajustes o panel="ficha".)

Las esquinas (también desde Bodega). Con «Las de la web», el plugin lee del Estilo del tema del Kit la esquina de los botones y la de los campos de formulario, y las pasa al panel como --cv-radio-boton y --cv-radio-campo: Mis vinos, Mapa · Red · Lista y el sol y la luna van como los botones de la web; la búsqueda, los tipos y los filtros, como sus campos (si el Kit no define campos, como los botones). Solo la esquina: el color y el relleno los pone el panel, porque cambian de día a noche. Viajan en un `