# Popup Pro Newsletter — Guía completa

> Popup Pro Newsletter muestra en su tienda Shopware un popup de suscripción a la newsletter que recompensa a cada nuevo suscriptor con un código promocional válido en su primer pedido.…

- Página: <https://www.datafirefly.com/es/documentation/popup-pro-newsletter/>
- Idioma: es
- Actualizado el: 2026-06-17
- Otros idiomas: [fr](https://www.datafirefly.com/documentation/popup-pro-newsletter/index.md), [en](https://www.datafirefly.com/en/documentation/popup-pro-newsletter/index.md), [de](https://www.datafirefly.com/de/documentation/popup-pro-newsletter/index.md), [it](https://www.datafirefly.com/it/documentation/popup-pro-newsletter/index.md), [pl](https://www.datafirefly.com/pl/documentation/popup-pro-newsletter/index.md), [nl](https://www.datafirefly.com/nl/documentation/popup-pro-newsletter/index.md), [pt](https://www.datafirefly.com/pt/documentation/popup-pro-newsletter/index.md)
- Índice: <https://www.datafirefly.com/es/documentation/llms.txt>

Popup Pro Newsletter muestra en su tienda Shopware un popup de suscripción a la newsletter que recompensa a cada nuevo suscriptor con un código promocional válido en su primer pedido. El objetivo es doble: hacer crecer su lista de correo y generar una primera venta. El plugin se apoya exclusivamente en el **sistema de promociones nativo de Shopware** — no se crea ninguna entidad de base de datos personalizada — y ofrece dos modos de código (único por suscriptor o fijo), un descuento configurable en porcentaje o importe fijo, activadores por tiempo y scroll, y el alta a través de la ruta oficial de newsletter con doble opt-in opcional conforme al RGPD. Esta guía cubre la instalación, la configuración, el funcionamiento de los códigos promocionales, la personalización y la resolución de problemas. Compatible con Shopware 6.6 y 6.7.

Desde la 6.6, el storefront de Shopware ya no compila el JavaScript de los plugins al vuelo. El ZIP que instala **debe contener la carpeta dist/ del JS precompilado**. El ZIP distribuido por DataFirefly ya lo incluye; si reconstruye el plugin usted mismo, lea atentamente la sección de Instalación.

## Cómo funciona el código promocional

En la primera alta de un visitante, el plugin crea automáticamente una **promoción de Shopware** llamada «Popup Newsletter — Welcome», asignada al canal de venta actual, con el descuento definido en la configuración. Después, en cada alta:

- en modo **código único** (recomendado), se genera al vuelo un código individual y se vincula a la promoción mediante los _códigos individuales de promoción_ nativos de Shopware, y se devuelve al visitante: no compartible, trazable y limitable a un solo uso;
- en modo **código fijo**, la promoción lleva un único código público (tipo `WELCOME10`) mostrado a todos los suscriptores.

La promoción se gestiona por completo en **Marketing → Promociones**: periodo de validez, condiciones, reglas avanzadas. Para reservar la oferta al primer pedido, mantenga activada la opción «un uso por cliente»; para un control más estricto, añada una regla de Shopware (p. ej. «número de pedidos del cliente = 0») directamente en la promoción.

## Instalación

1. Descargue el archivo `DataFireflyPopupProNewsletter-v1.0.0.zip` desde su cuenta DataFirefly.
2. Instálelo desde **Administración → Extensiones → Mis extensiones → Cargar extensión**, o copie la carpeta descomprimida en `custom/plugins/`.
3. Instale y active el plugin: ``` bin/console plugin:refresh bin/console plugin:install --activate DataFireflyPopupProNewsletter bin/console cache:clear ```
4. Compile el tema para incluir los estilos del popup: ``` bin/console theme:compile ```

`theme:compile` es PHP puro: funciona en alojamiento compartido. En cambio, la **compilación de JavaScript** (`build-storefront.sh`) requiere Node y mucha memoria — no está pensada para el alojamiento compartido. Por eso el JS se entrega precompilado dentro del ZIP: nunca tiene que ejecutar el build en su servidor de producción.

### Si reconstruye el plugin usted mismo

En una instalación de desarrollo Shopware completa, el JS se compila así:

```
bin/console plugin:refresh
bin/console plugin:install --activate DataFireflyPopupProNewsletter
bash bin/build-storefront.sh
```

Esto genera `src/Resources/app/storefront/dist/storefront/js/data-firefly-popup-pro-newsletter/data-firefly-popup-pro-newsletter.js`. Vuelva a comprimir el plugin **con** esta carpeta `dist/` antes de desplegarlo en producción.

## Configuración

Abra **Extensiones → Mis extensiones → Popup Pro Newsletter → ⋯ → Configurar**. Los ajustes están organizados en tarjetas.

### General

- **Activar el popup**: activa o desactiva por completo la visualización.

### Visualización

- **Mostrar tras un retardo (segundos)**: el popup aparece pasados X segundos. `0` desactiva este activador.
- **Mostrar tras scroll (% de la página)**: el popup aparece al alcanzar ese porcentaje de scroll. `0` desactiva este activador.
- **No volver a mostrar durante (días)**: frecuencia de visualización por visitante, memorizada en el navegador.
- **Ocultar para clientes conectados**: no muestra el popup a clientes ya conectados.

Ambos activadores (retardo y scroll) son acumulables: el popup aparece en cuanto se cumple el _primero_ de los dos. Para un activador solo por scroll, ponga el retardo a `0`, y viceversa.

### Contenido

Título, subtítulo, placeholder del campo de correo, texto del botón, mensaje de éxito (use el placeholder `%code%` para insertar el código), mensaje de confirmación pendiente (doble opt-in), URL de ilustración opcional y color de acento. Todos estos textos son editables y traducibles.

### Código promocional

- **Modo de código**: `único` (recomendado) o `fijo`.
- **Código fijo / prefijo**: el código público en modo fijo, o el prefijo de los códigos individuales en modo único.
- **Tipo y valor del descuento**: porcentaje o importe fijo, valor libre.
- **Un uso por cliente**: limita la promoción a un solo uso para reservar la oferta al primer pedido.
- **Doble opt-in**: envía un correo de confirmación antes de entregar el código.

## Doble opt-in y RGPD

El alta pasa por la ruta oficial de newsletter de Shopware (`NewsletterSubscribeRoute`), lo que garantiza la sincronización con sus destinatarios existentes. Cuando el doble opt-in está activado, el visitante recibe su código solo tras confirmar su dirección por correo; mientras tanto se muestra en el popup el mensaje de espera personalizable. No se utilizan cookies de terceros: la memoria de «no volver a mostrar» se almacena en el navegador mediante `localStorage`.

El doble opt-in es recomendable para el cumplimiento del RGPD: acredita el consentimiento explícito del suscriptor. Puede activarlo o desactivarlo en cualquier momento en la configuración.

## Personalizar el popup

El marcado está aislado en `views/storefront/component/datafirefly/popup-newsletter.html.twig`, inyectado desde `views/storefront/base.html.twig` en el bloque `base_body`. Para cambiar la estructura del popup, sobrescriba esta plantilla en su tema. Los estilos están en `app/storefront/src/scss/base.scss` y el color de acento se controla con la variable CSS `--df-popup-accent`, alimentada a su vez por el ajuste «color de acento» de la configuración. El comportamiento (activadores, AJAX, copia del código) lo gestiona el plugin de storefront `PopupNewsletterPlugin`.

## FAQ y resolución de problemas

**El popup no aparece en absoluto.** En casi todos los casos, falta el JavaScript precompilado: compruebe que el ZIP instalado contiene la carpeta `dist/`, luego ejecute `theme:compile` y vacíe la caché. Inspeccione la página: el elemento `.df-popup-newsletter` debe estar presente en el DOM con el atributo `hidden` — es el JS el que lo revela.

**Lo cerré una vez y no vuelve a aparecer.** Es el comportamiento esperado: el plugin memoriza el cierre durante el número de días configurado, mediante la clave `dfPopupNewsletterDismissedAt` del `localStorage`. Para volver a probar, abra una ventana de navegación privada o vacíe el almacenamiento local del navegador.

**El popup aparece pero sin estilos.** El tema no se ha recompilado: ejecute `bin/console theme:compile`.

**El código no se aplica al carrito.** Compruebe en **Marketing → Promociones** que la promoción «Popup Newsletter — Welcome» está activa, asignada al canal de venta correcto y dentro de su periodo de validez. En modo único, verifique que el código individual no se haya usado ya.

**¿Qué ocurre al desinstalar?** La promoción y los códigos ya distribuidos se conservan deliberadamente para no invalidar códigos en circulación entre sus clientes. Elimínelos manualmente desde Marketing → Promociones si es necesario.

**¿Ralentiza el plugin mi tienda?** No: ninguna entidad personalizada, ninguna consulta adicional al cargar las páginas, un único archivo JS ligero y el SCSS compilado en su tema.