Clustraly
Command Menu, prévisualisation & PWA

Rendez votre site installable : la meta d'installation PWA et l'enregistrement du service worker

Meta d'installation PWA + enregistrement du service worker une fonctionnalité du module Command Menu, prévisualisation & PWA de Clustraly. La meta d'installation PWA relie le manifest et les balises Apple web-app dans vos deux layouts, puis enregistre le service worker au chargement.

Le manifest lié, les balises Apple déclarées et le service worker enregistré au chargement de la page dans l'admin comme sur le public, sans une ligne à écrire.

Installable, sans effort

Votre site s'installe comme une app, sur mobile comme sur desktop

La balise <link rel=manifest> est présente dans vos deux layouts. Le navigateur reconnaît alors votre site comme application installable et propose l'ajout à l'écran d'accueil.

Une fois épinglé, il s'ouvre en mode standalone, sans la barre du navigateur l'IA prépare le terrain, vous gardez la main sur vos réglages.

  • Balise <link rel=manifest> câblée sur l'admin et le public
  • Ajout à l'écran d'accueil proposé par le navigateur
  • Ouverture en mode standalone, comme une app
Le câblage, fait pour vous

Manifest lié et balises Apple web-app déclarées dans vos deux layouts

Les layouts admin et public lient le manifest et déclarent les meta Apple web-app : apple-mobile-web-app-capable, status-bar-style et title.

Résultat sur iOS : l'icône se lance avec le bon titre et la bonne barre de statut, avec un comportement identique côté admin et côté public.

  • apple-mobile-web-app-capable, status-bar-style et title déclarés
  • Titre et barre de statut corrects au lancement sur iOS
  • Même câblage sur les deux layouts
Activé au chargement

Le service worker s'enregistre tout seul, au chargement de la page

Au window load, l'appel navigator.serviceWorker.register('<base>/service-worker.js') s'exécute et enregistre le service worker avec le bon chemin de base.

C'est ce déclencheur qui active le cache offline de la PWA vous n'avez rien à lancer manuellement.

  • Enregistrement via navigator.serviceWorker.register au window load
  • Chemin dérivé du <base> pour un enregistrement correct
  • Active le cache offline PWA sans action de votre part
Cas d'usage

De l'icône sur l'écran d'accueil à la lecture hors-ligne

Un lecteur épingle votre blog et le rouvre en un tap, en plein écran. Le service worker enregistré prend le relais quand la connexion se fait rare, sur le public.

L'espace d'administration profite du même enregistrement : la mécanique est la même des deux côtés.

  • Un lecteur épingle votre site et le rouvre instantanément
  • Le public reste consultable sur connexion instable
  • L'admin bénéficie du même enregistrement
Garde-fous

Compatible CSP et sans casse : nonce et échec silencieux

Le script d'enregistrement est nonce'd, donc compatible avec votre Content-Security-Policy : il s'exécute sans affaiblir votre politique.

Si le navigateur ne supporte pas les service workers ou si l'enregistrement échoue, l'appel échoue en silence rien ne casse, le site continue de fonctionner.

  • Script d'enregistrement nonce'd, compatible CSP
  • Échec silencieux si les service workers ne sont pas supportés
  • Aucune régression : le site fonctionne même sans PWA
Pourquoi ça compte

Prêt à l'emploi, sans compromis de sécurité

Clustraly câble le manifest, les balises Apple web-app et l'enregistrement du service worker dans vos deux layouts. Vous gardez la main sur vos réglages, et rien ne casse si la PWA n'est pas supportée.

FAQ

Questions fréquentes

Dois-je ajouter du code pour rendre mon site installable ?
Non. La balise <link rel=manifest> et les meta Apple web-app sont déjà présentes dans les layouts admin et public, et le service worker s'enregistre de lui-même au chargement de la page.
L'enregistrement du service worker est-il compatible avec ma Content-Security-Policy ?
Oui. Le script d'enregistrement porte un nonce (nonce'd), il est donc compatible CSP et s'exécute sans que vous ayez à assouplir votre politique de sécurité.
Que se passe-t-il si le navigateur ne supporte pas les service workers ?
L'appel échoue en silence (fail-silent). Le service worker n'est simplement pas enregistré et votre site continue de fonctionner normalement, sans erreur visible.
L'administration est-elle concernée, ou seulement le site public ?
Les deux. Le manifest est lié et le service worker enregistré aussi bien sur le layout admin que sur le layout public, avec le même comportement.
Prêt à commencer ?

Votre PWA, déjà câblée

Manifest lié, balises Apple web-app déclarées, service worker enregistré au chargement : la couche d'installation PWA est en place dans vos deux layouts, compatible CSP et sans risque de casse. Vous restez maître de vos réglages, Clustraly s'occupe de la plomberie.