Настройка Message Inbox для Cordova

Плагин Pushwoosh для Cordova поставляет Message Inbox (входящие сообщения приложения, “иконка колокольчика”) как часть той же зависимости pushwoosh-cordova-plugin, которая используется для push-уведомлений. Дополнительная установка не требуется.

Предварительные требования

Базовый Pushwoosh Cordova SDK уже интегрирован и отправляет push-уведомления.

Отображение входящих сообщений

Вызовите presentInboxUI() на том же объекте pushwoosh, который вы инициализировали с помощью cordova.require:

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

pushwoosh.presentInboxUI();

Это открывает нативный экран (view controller на iOS, Activity на Android) со стандартным внешним видом SDK.

Настройка стиля

Передайте объект стиля в presentInboxUI(). Каждый ключ является необязательным:

Ключ	Что настраивает
`dateFormat`	Форматирование даты
`defaultImageIcon`	Иконка по умолчанию рядом с сообщением без изображения
`unreadImage`	Отметка о непрочитанных сообщениях (только для iOS)
`listErrorImage`	Отображается при ошибке загрузки списка
`listEmptyImage`	Отображается, когда в списке нет сообщений
`listErrorMessage`	Текст ошибки (не локализован)
`listEmptyMessage`	Текст для пустого списка (не локализован)
`defaultTextColor`	Цвет текста по умолчанию (только для iOS)
`accentColor`	Акцентный цвет
`backgroundColor`	Цвет фона
`highlightColor`	Цвет выделения
`titleColor`	Цвет заголовка сообщения
`readTitleColor`	Цвет заголовка для прочитанных сообщений (только для Android)
`descriptionColor`	Цвет описания сообщения
`readDescriptionColor`	Цвет описания для прочитанных сообщений (только для Android)
`dateColor`	Цвет даты сообщения
`readDateColor`	Цвет даты для прочитанных сообщений (только для Android)
`dividerColor`	Цвет разделителя
`barTitle`	Заголовок экрана входящих сообщений
`barBackgroundColor`	Цвет фона заголовка
`barAccentColor`	Цвет кнопки “назад” в заголовке
`barTextColor`	Цвет текста в заголовке

pushwoosh.presentInboxUI({
    dateFormat: "dd.MM.yyyy",
    accentColor: "#3498db",
    backgroundColor: "#ffffff",
    titleColor: "#333333",
    descriptionColor: "#666666",
    listEmptyMessage: "Сообщений пока нет"
});

Программное управление сообщениями

Загружайте список сообщений, количество прочитанных и выполняйте действия с отдельными сообщениями, не открывая встроенный экран. Это полезно для создания собственного интерфейса входящих сообщений или для значка с количеством непрочитанных сообщений:

// Массив объектов InboxNotification
pushwoosh.loadMessages(function(messages) {
    messages.forEach(function(message) {
        console.log(message.title + ": " + message.message);
    });
}, function(error) {
    console.error("Не удалось загрузить: " + error);
});

pushwoosh.unreadMessagesCount(function(count) {
    console.log("Непрочитанных сообщений: " + count);
});

pushwoosh.messagesCount(function(count) { /* общее количество сообщений */ });
pushwoosh.messagesWithNoActionPerformedCount(function(count) { /* сообщения, с которыми еще не было произведено действий */ });

pushwoosh.readMessage(messageCode);
pushwoosh.deleteMessage(messageCode);
pushwoosh.performAction(messageCode); // выполняет действие по умолчанию для сообщения, например, открывает URL