Configuration de la boîte de réception des messages pour Cordova

Le plugin Pushwoosh pour Cordova inclut la Boîte de réception des messages (la Boîte de réception de l’application « icône en forme de cloche ») dans la même dépendance pushwoosh-cordova-plugin que celle utilisée pour les notifications push. Aucune étape d’installation supplémentaire n’est nécessaire.

Prérequis

• Le SDK Pushwoosh de base pour Cordova est déjà intégré et envoie des notifications push.

Afficher la boîte de réception

Appelez presentInboxUI() sur le même objet pushwoosh que vous avez initialisé avec cordova.require :

var pushwoosh = cordova.require("pushwoosh-cordova-plugin.PushNotification");

pushwoosh.presentInboxUI();

Cela ouvre un écran natif (un view controller sur iOS, une Activity sur Android) avec l’apparence par défaut du SDK.

Personnaliser le style

Passez un objet de style à presentInboxUI(). Chaque clé est facultative :

Clé	Personnalise
dateFormat	Formatage de la date
defaultImageIcon	L’icône par défaut à côté d’un message sans image
unreadImage	Le marqueur de messages non lus (iOS uniquement)
listErrorImage	Affichée lorsque le chargement de la liste échoue
listEmptyImage	Affichée lorsque la liste ne contient aucun message
listErrorMessage	Texte d’erreur (non localisé)
listEmptyMessage	Texte de liste vide (non localisé)
defaultTextColor	Couleur de texte par défaut (iOS uniquement)
accentColor	Couleur d’accentuation
backgroundColor	Couleur de fond
highlightColor	Couleur de sélection
titleColor	Couleur du titre du message
readTitleColor	Couleur du titre pour les messages lus (Android uniquement)
descriptionColor	Couleur de la description du message
readDescriptionColor	Couleur de la description pour les messages lus (Android uniquement)
dateColor	Couleur de la date du message
readDateColor	Couleur de la date pour les messages lus (Android uniquement)
dividerColor	Couleur du séparateur
barTitle	Le titre de l’écran de la boîte de réception
barBackgroundColor	La couleur de fond de la barre de titre
barAccentColor	La couleur du bouton de retour de la barre de titre
barTextColor	La couleur du texte de la barre de titre

pushwoosh.presentInboxUI({
    dateFormat: "dd.MM.yyyy",
    accentColor: "#3498db",
    backgroundColor: "#ffffff",
    titleColor: "#333333",
    descriptionColor: "#666666",
    listEmptyMessage: "Aucun message pour le moment"
});

Gérer les messages par programmation

Chargez la liste des messages, les décomptes de lecture et agissez sur des messages individuels sans ouvrir l’écran intégré. Ceci est utile pour une interface utilisateur de boîte de réception personnalisée ou un badge de non-lus :

// Tableau d'objets InboxNotification
pushwoosh.loadMessages(function(messages) {
    messages.forEach(function(message) {
        console.log(message.title + ": " + message.message);
    });
}, function(error) {
    console.error("Échec du chargement : " + error);
});

pushwoosh.unreadMessagesCount(function(count) {
    console.log("Messages non lus : " + count);
});

pushwoosh.messagesCount(function(count) { /* nombre total de messages */ });
pushwoosh.messagesWithNoActionPerformedCount(function(count) { /* sur lesquels aucune action n'a encore été effectuée */ });

pushwoosh.readMessage(messageCode);
pushwoosh.deleteMessage(messageCode);
pushwoosh.performAction(messageCode); // exécute l'action par défaut du message, par ex. l'ouverture d'une URL