SW Shopware 6 Shopware Principiante

Popup Pro Newsletter — Guía completa

Instalar, configurar y explotar Popup Pro Newsletter: popup de suscripción a la newsletter que ofrece un código promocional en el primer pedido, códigos únicos por suscriptor mediante promociones nativas, activadores por tiempo/scroll y doble opt-in RGPD, para Shopware 6.6 y 6.7.

Actualizado Versión del módulo 1.0.0

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.

¿Te ha resultado útil esta página?

¿Sigues atascado? Contacta con soporte