Aller au contenu principal

Web Push - Customisations

Dans cet article, nous allons approfondir plusieurs aspects de notre bibliothèque Web qui peuvent être personnalisés en fonction de vos besoins.

Définir les clés dans le code Au lieu de s'appuyer sur le fichier de configuration notificare-services.json, qui est le fichier que vous avez récupéré dans votre TransferBox, il est possible de définir ces paramètres directement dans le code. Pour configurer Notificare, vous devez exécuter le code suivant avant toute autre interaction avec la bibliothèque.

import { configure } from 'notificare-web/core';

configure({
  applicationKey: '{{ YOUR APPLICATION KEY }}',
  applicationSecret: '{{ YOUR APPLICATION SECRET }}',
});

La méthode configure() accepte le même objet que le fichier notificare-services.json et doit être appelée avant la méthode launch() afin de s'assurer que les bonnes clés sont utilisées.
Après avoir défini les clés directement dans le code, vous pouvez supprimer en toute sécurité le fichier notificare-services.json.

Options de configuration​

La fonction configure() et le fichier notificare-services.json prennent tous deux en entrée le même objet. Ci-dessous, une description et les exigences pour chaque propriété.

applicationKey obligatoire​

Vous pouvez trouver la clé d'application dans le fichier notificare-services.json fourni dans votre TransferBox.

applicationSecret obligatoire​

Vous pouvez trouver la clé secrète de l'application dans le fichier notificare-services.json fourni dans votre TransferBox.

applicationVersion​

La version de votre application (par exemple 1.0.0). Cette propriété est enregistrée sur l'appareil et est utile pour gérer les mises à jour.

language​

Définit la langue du site web. Elle est utilisée pour l'intégration guidée des notifications Push avec du contenu localisé.

ignoreTemporaryDevices​

Empêche l'enregistrement des appareils temporaires. Lorsque ce paramètre est activé, le SDK n'enregistrera un appareil que si les notifications à distance ont été activées.

ignoreUnsupportedWebPushDevices​

Empêche l'enregistrement des appareils temporaires qui ne sont pas capables de recevoir des notifications à distance. Lorsque ce paramètre est activé, le SDK continuera d’enregistrer les appareils temporaires uniquement s’ils sont capables de recevoir des notifications à distance. Vous pouvez cibler ces appareils avec des messages intégrés à l'application pour encourager l’activation des notifications à distance.

serviceWorker​

L’emplacement du fichier du service worker dans votre application. Par défaut : /sw.js.

serviceWorkerScope​

Le scope (périmètre) de votre service worker. Vous pouvez consulter ce guide pour plus d'informations.

Remplacer le thème par défaut​

Les éléments d'interface utilisateur du SDK s’adaptent automatiquement à l'apparence préférée du système d'exploitation.
Si vous souhaitez forcer l'affichage en mode clair ou sombre, vous pouvez le faire en utilisant l’attribut data-notificare-theme pour remplacer le thème par défaut.

<html data-notificare-theme='light'>
  <!-- more code ... -->
</html>