=== Marciano Flame ===
Contributors: hostarys
Tags: mascota, animacion, shortcode, web component
Requires at least: 6.0
Tested up to: 6.6
Requires PHP: 7.4
Stable tag: 1.0.0
License: Propietario (Hostarys)

Marciano, la mascota llama animada de Hostarys, en cualquier entrada o página mediante el shortcode [marciano].

== Description ==

Inserta a Marciano, la llama animada de Hostarys, con un shortcode. El script del componente solo se carga en las páginas donde aparece (en el pie, sin afectar al resto del sitio).

Marciano es un activo de marca propiedad de Hostarys. Uso reservado a sitios de Hostarys y sus clientes autorizados.

= Shortcode =

`[marciano]`

Atributos (todos opcionales):

* `mood` — expresión base: dots, hearts, spiral, sleepy, cross, angry, surprised, happy, sad, wink, thinking.
* `color` — negro, ember, cyan, lime, violet, hostarys, lavanda, noche, un color hex (#e24922) o rgb()/hsl().
* `eye` — color de los ojos (mismo formato que color).
* `bg` — color de fondo (por defecto transparente).
* `glow` — resplandor. `glow="1"` o `glow="true"` activa; un número como `glow="1.5"` fija la intensidad (máx. 3).
* `accessory` — glasses, sunglasses, bowtie, crown, santa, headphones. Varios separados por espacio o coma.
* `status` — online, busy, degraded, down, maintenance (fija la expresión según el estado del servicio).
* `sound` — sonidos sintetizados (suenan tras el primer clic del visitante).
* `sleep_after` — segundos sin actividad hasta dormirse (por defecto 20; 0 = nunca).
* `drag` — se puede arrastrar y lanzar.
* `react` — reacciona a la página: scroll rápido, envío y errores de formularios, copiar, conexión.
* `social="false"` — no mira ni reacciona a otros Marcianos de la página.
* `lite` — modo ligero (menos efectos). `lite="auto"`: solo en equipos modestos.
* `hidden_start` — empieza apagado (útil con JavaScript propio que llame a `enter()`).
* `interactive="false"` — sin ratón, clics ni sueño automático.
* `width` — ancho CSS: número + px, %, rem, em o vw. Por defecto 240px.
* `align` — left, center o right.
* `class` — clases CSS extra para el contenedor.
* `say` — texto que dice en un bocadillo al cargar la página.

Los atributos booleanos aceptan 1, true, yes, on o sí. También se pueden escribir sin valor: `[marciano glow drag]`.

= Ejemplos =

`[marciano]`

`[marciano color="ember" glow="1" align="center"]`

`[marciano mood="happy" accessory="sunglasses bowtie" width="180px" align="right"]`

`[marciano color="hostarys" status="maintenance" say="Estamos de mantenimiento, ¡volvemos enseguida!"]`

`[marciano color="#7d2efd" eye="#ffffff" bg="#1a2129" glow="2" drag react sound]`

= Etiqueta HTML directa =

Los editores también pueden pegar la etiqueta en el editor de código o en un bloque HTML personalizado:

`<marciano-flame color="cyan" glow></marciano-flame>`

El plugin permite la etiqueta y sus atributos en el contenido y carga el script automáticamente cuando la detecta. Para que hable al cargar, añade `data-say="Hola"`.

= Control desde JavaScript =

`document.querySelector("marciano-flame").play("hearts");`

Métodos: queue, play, clearQueue, enter, exit, say, lipSync, resetPosition. Evento: `moodchange`.

== Installation ==

1. En el escritorio de WordPress ve a Plugins > Añadir nuevo > Subir plugin y sube `marciano-flame.zip`.
2. Activa «Marciano Flame».
3. Escribe `[marciano]` en cualquier entrada, página o bloque Shortcode.

== Frequently Asked Questions ==

= ¿Carga el script en todas las páginas? =

No. Solo se encola cuando se usa el shortcode o la etiqueta aparece en el contenido.

= ¿Guarda opciones en la base de datos? =

No. Desactivarlo y borrarlo no deja restos.

= ¿Cómo lo actualizo? =

El plugin se genera con `python tools/build-marciano.py` en el proyecto de Marciano, que crea `wordpress/marciano-flame.zip`. Sube el zip nuevo para sustituir la versión instalada.

== Changelog ==

= 1.0.0 =
* Primera versión: shortcode [marciano], soporte de la etiqueta <marciano-flame> en el contenido.
