Documentation #70811
Décrire l'intégration des notifications webpush aux notifications sur le portail et lier ça avec la doc PWA
0%
Description
Ça fait suite à une question de Nicolas Gif du CD13 (#70807) sur l'intégration des notifications webpush au système de notification dans combo, ça n'est apparemment pas décrit dans la doc.
Je décrirai le gros du truc dans la partie PWA de la doc, avec un lien vers la page sur les notifications pour l'usage de celles-ci.
Coté documentation des notifications, juste un petit paragraphe pour dire que ça existe et un lien vers la section dans la doc PWA.
Coté page PWA, il faudra signaler les limitations actuelles : tous les navigateurs sont supportés sauf Safari MacOS&iOS, avec changement prochainement pour MacOS et l'année prochaine pour iOS : https://pushalert.co/blog/safari-web-push-api-support-browser-notifications/).
Historique
Mis à jour par Pierre Cros il y a plus d'un an
- Statut changé de Nouveau à Information nécessaire
- Assigné à mis à Benjamin Dauvergne
Pour moi y a presque rien à documenter vu qu'il n'y a rien à configurer : si la PWA est activée, l'action de notif est aussi une notif push. Je me trompe ?
Si je me trompe pas, c'est une phrase sur chaque page et voilà (le lien depuis la page PWA vers la page notif existe déjà, je pourrai faire le lien inverse).
Mis à jour par Pierre Cros il y a plus d'un an
(et ok pour l'avertissement que tu pointes concernant la gestion du truc par les différents navigo)
Mis à jour par Benjamin Dauvergne il y a plus d'un an
Pierre Cros a écrit :
Pour moi y a presque rien à documenter vu qu'il n'y a rien à configurer : si la PWA est activée, l'action de notif est aussi une notif push. Je me trompe ?
Je pensais aussi mais non il y a une case à cocher explicite sur le page de configuration, tout en bas, voir https://moncompte-departement13.test.entrouvert.org/manage/pwa/ par exemple.
Mais c'est effectivement déjà décrit sur la page (https://doc-publik.entrouvert.com/admin-fonctionnel/progressive-web-app-pwa/) au milieu du reste et je ne l'avais pas vu. Ma demande finalement ce serait d'avoir une section explicite pour les notifications. Il me semble que chaque fonctionnalité un peu technique de la PWA devraient avoir une section parce que cet acronyme est quand même flou pour les gens. Je verrai bien une section :
h2. Notifications « WebPush » blabla sur ce que ça fait... <lien vers la page notification> [bloc warning sur le support par les navigos]
Le bloc warning existant qui ne parle que des icônes irait bien lui aussi dans une section "Icône sur l'écran d'accueil". Je complexifie peut-être mais je trouve ça plus lisible, les gens peuvent sauter les titres des sections qui ne les intéresse pas alors que là il faut lire tout un paragraphe pour trouver l'information sur une fonctionnalité.
Le warning générique "La PWA peut avoir des comportements ou fonctionnalités un peu différents en fonction des smartphones utilisés. Google, Microsoft, Apple, et autres ont une intégration hétérogène des fonctionnalités PWA." remonterait en haut de page.
Si je me trompe pas, c'est une phrase sur chaque page et voilà (le lien depuis la page PWA vers la page notif existe déjà, je pourrai faire le lien inverse).
Coté notifications (https://doc-publik.entrouvert.com/admin-fonctionnel/fabrique-de-workflows/les-actions-de-workflow/notification-au-demandeur/) une phrase suffirait oui, pour dire qu'il faut l'activer, avec un lien profond vers la nouvelle section.
Mis à jour par Pierre Cros il y a plus d'un an
- Statut changé de Information nécessaire à Solution déployée
J'ai fait tout ce que tu demandais (et pas mal d'autres choses), je suis d'accord avec toi c'était devenu un peu le foutoir cette page.
https://doc-publik.entrouvert.com/admin-fonctionnel/progressive-web-app-pwa/#notifications-webpush
La phrase et le lien sur l'autre page
https://doc-publik.entrouvert.com/admin-fonctionnel/fabrique-de-workflows/les-actions-de-workflow/notification-au-demandeur/#generalites
Demande aux devs, même si c'est cool de modifier la doc admin fonctionnel, faites relire par un CPF si possible (cette doc est faite pour des non développeurs), j'ai enlevé un paragraphe entier, trop complet/complexe :
Si l'option "Icône Adaptative" est activée, celle-ci pourra être recadrée de différente manières selon les appareils. Dans ce cas, une zone sûre, garantie visible, est définie. Elle correspond à un cercle centré au milieu de l'icône et de rayon égal aux 40% de la taille de l'icône. Tout ce qui en sort sera potentiellement rogné, en fonction l'appareil sur lequel elle est affichée.
Remplacé par une simple mention (bien plus vague, certes) à l'endroit où on parle d'icône :
« Icône Adaptative » permet d'activer et visualiser (cercle en pointillé sur l'icône) la zone centrale importante qui sera utilisée par certains navigateurs.
Mis à jour par Benjamin Dauvergne il y a plus d'un an
Remarque qui n'a rien à voir avec ce que tu as fait: le lien profond ne marche pas (depuis notification vers PWA), l'ancre est bonne, si je vais dans la barre d'URL et que j'appuie sur "Entrée" (alors que la page est déjà chargée) ça m'amène bien à la section "Notifications «webpush»" mais pas au chargement de la page.
C'est ce lien :
https://doc-publik.entrouvert.com/admin-fonctionnel/progressive-web-app-pwa/#notifications-webpush
Ça semble venir du fait que les ancres de destination sont créées à la volée en JS, mais donc après le chargement de la page. Je vais ouvrir un ticket.