إعداد صندوق الرسائل الواردة لـ Cordova

تأتي إضافة Pushwoosh Cordova مع صندوق الرسائل الواردة (صندوق وارد التطبيق “أيقونة الجرس”) كجزء من نفس الاعتمادية pushwoosh-cordova-plugin المستخدمة للإشعارات الفورية. لا حاجة لخطوة تثبيت إضافية.

المتطلبات الأساسية

أن تكون حزمة تطوير البرمجيات (SDK) الأساسية لـ Pushwoosh Cordova مدمجة بالفعل وترسل الإشعارات الفورية.

عرض صندوق الوارد

استدعِ presentInboxUI() على نفس كائن pushwoosh الذي قمت بتهيئته باستخدام cordova.require:

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

pushwoosh.presentInboxUI();

يؤدي هذا إلى فتح شاشة أصلية (وحدة تحكم عرض على iOS، ونشاط على 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("Failed to load: " + error);
});

pushwoosh.unreadMessagesCount(function(count) {
    console.log("Unread messages: " + count);
});

pushwoosh.messagesCount(function(count) { /* إجمالي الرسائل */ });
pushwoosh.messagesWithNoActionPerformedCount(function(count) { /* لم يتم التفاعل معها بعد */ });

pushwoosh.readMessage(messageCode);
pushwoosh.deleteMessage(messageCode);
pushwoosh.performAction(messageCode); // ينفذ الإجراء الافتراضي للرسالة، على سبيل المثال، فتح عنوان URL