Plugin AppMovilFS para FacturaScripts

AppMovilFS convierte tu FacturaScripts en una aplicación instalable en el móvil (PWA) y le añade un centro de notificaciones con campana y contador de no leídas.

ACTUALIZA A LA 1.6 — SI TU FACTURASCRIPTS ESTÁ EN UNA SUBCARPETA, ANTES NO FUNCIONABA ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Muchísimas instalaciones no cuelgan de la raíz del dominio, sino de una subcarpeta: midominio.com/facturascripts/, /erp/, /fs/...

En esas instalaciones el plugin pedía el manifest, el service worker y los avisos a la RAÍZ del dominio. Cuatro 404. Resultado: la app no se podía instalar, el service worker no se registraba, el push no llegaba nunca y la campana se quedaba vacía para siempre. Y sin un solo mensaje que lo explicara: parecía que el plugin no hacía nada.

En la 1.6 todo cuelga de la carpeta real de tu instalación, así que funciona igual esté donde esté. Si lo instalaste y te pareció que no servía para nada, era esto: actualiza y vuelve a probarlo.

ADEMÁS: LA PANTALLA TE DICE QUÉ FALTA ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ La configuración trae una Comprobación de la instalación que responde de un vistazo: • En qué carpeta estás y desde dónde se sirve la app. • Si tu servidor va por https. Sin https ningún navegador instala la app ni entrega avisos push: es una regla del navegador, no un fallo del plugin. Ahora lo pone, en vez de dejarte adivinando. • Si los iconos están en su sitio (sin iconos no hay botón de instalar). • Si el cifrado del push está disponible en tu servidor.

Y EN IPHONE ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Safari nunca muestra botón de instalar: no existe en iOS. Los usuarios de iPhone y iPad buscaban un botón que no iba a aparecer. Ahora la campana detecta el iPhone y explica el camino real: Compartir > Añadir a pantalla de inicio.

NOVEDAD v1.5: EL PUSH AL MÓVIL YA FUNCIONA SIN INSTALAR NADA ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Hasta ahora, para que los avisos llegaran al móvil hacía falta composer y la librería minishlink/web-push. En la mayoría de hostings compartidos eso no es viable, así que en la práctica el push quedaba inservible: pulsabas «Generar claves VAPID» y el plugin te pedía instalar una librería.

Se acabó. Ahora el propio plugin genera las claves VAPID, firma el token y cifra el mensaje (aes128gcm, RFC 8291) usando solo la extensión openssl que ya trae PHP. Pulsas «Generar claves VAPID», activas el interruptor, y los avisos llegan al móvil.

Y el panel te dice de un vistazo en cuál de los cuatro estados estás: • Listo para enviar al móvil, con el número de dispositivos suscritos. • Faltan las claves VAPID (con el botón para generarlas). • Push desactivado: los avisos solo se ven dentro de la app. • Este servidor no tiene openssl con curva P-256 (raro, pero se avisa en vez de fallar en silencio).

Antes activabas el interruptor y te quedabas sin saber si aquello funcionaba o no.

QUÉ HACE ━━━━━━━━ • Instala FacturaScripts como aplicación en el móvil o el escritorio, con su icono en la pantalla de inicio. • Centro de notificaciones dentro de la app: campana con contador de no leídas. • Notificaciones push al móvil, que llegan aunque el usuario no tenga FacturaScripts abierto. • Las suscripciones que el navegador revoca se borran solas, sin dejar basura en la base de datos. • Botón de «Enviarme una notificación de prueba» para comprobarlo en un segundo.

PARA TUS OTROS PLUGINS ━━━━━━━━━━━━━━━━━━━━━━ Cualquier plugin puede mandar un aviso a un usuario con una sola línea:

Notificador::enviar('nick', 'Título', 'Mensaje', '/ListFacturaCliente', 'fas fa-file-invoice', 'MiPlugin');

Aparece en su campana y, si el push está configurado, también en su móvil.

EJEMPLO DE USO ━━━━━━━━━━━━━━ Instalas el plugin, pulsas «Generar claves VAPID» y activas el push. Tus comerciales instalan FacturaScripts en el móvil desde el navegador y aceptan los avisos. A partir de ahí, cada pedido nuevo les llega al teléfono aunque no tengan la aplicación abierta, y lo ven en la campana cuando entran.

REQUISITOS ━━━━━━━━━━ FacturaScripts 2025 o superior y PHP 8 con la extensión openssl (viene activada en prácticamente todos los hostings). Para el push, el sitio debe servirse por HTTPS: es un requisito de los navegadores, no del plugin.

Ideal para vencimientos, avisos de jornada, pedidos y cualquier evento de tus plugins.