SDK v2 — نصب و پیکربندی
راهنمای کامل نصب Pushfa SDK v2، تنظیم autoPrompt، نصب سرویسورکر و مقایسه سرویس عادی با پوش پایدار.
نصب SDK
کد زیر را در <head> یا انتهای <body> سایت قرار دهید. مقدار YOUR_PUBLIC_KEY کلید عمومی سرویس در پنل است.
<script
src="https://pushfa.com/notification-v2.js?api_public_key=YOUR_PUBLIC_KEY"
type="module">
</script>
نصب سرویسورکر
فایل سرویسورکر را از پنل (روبروی سرویس، دریافت کانفیگ) دانلود و با نام pushfa-messaging-sw.js در ریشه سایت آپلود کنید.
# فایل باید در این آدرس در دسترس باشد:
https://yourdomain.com/pushfa-messaging-sw.js
غیرفعال کردن نمایش خودکار (Auto Prompt)
اگر میخواهید کنترل بیشتری بر زمان نمایش درخواست داشته باشید—مثلاً فقط در صفحات خاص یا پس از انجام اقدامات خاص—Auto Prompt را غیرفعال کنید. قبل از لود SDK این تنظیم را اضافه کنید:
<script>
window.PushfaConfig = { autoPrompt: false };
</script>
<script
src="https://pushfa.com/notification-v2.js?api_public_key=YOUR_PUBLIC_KEY"
type="module">
</script>
استایل درخواست: مرورگر، آماده یا سفارشی
استایل درخواست از پنل سرویس و بخش «تنظیمات عضویت» انتخاب میشود. حالتهای آماده پوشفا مثل OneSignal و Bottom sheet باکس نرم آماده را نمایش میدهند. حالت «پیشفرض مرورگر» باکس نرم پوشفا را رد میکند و مستقیماً prompt اصلی مرورگر را اجرا میکند. حالت «پرامپت سفارشی سایت» هیچ UI آمادهای نمایش نمیدهد و فقط رویداد pushfaCustomPromptRequest را برای نمایش UI خودتان اجرا میکند.
window.addEventListener('pushfaCustomPromptRequest', () => {
document.querySelector('#my-soft-prompt').hidden = false;
});
document.querySelector('#my-soft-prompt-accept').onclick = async () => {
await window.Pushfa.requestPermission();
};
document.querySelector('#my-soft-prompt-later').onclick = () => {
window.Pushfa.snoozePrompt(7);
};
سازگاری با مرورگرها
SDK v2 پوشفا روی مرورگرهای مدرن دسکتاپ و اندروید کار میکند.
| مرورگر | وضعیت | نکته |
|---|---|---|
| Chrome ≥ 50 | ✅ پشتیبانی کامل | دسکتاپ و اندروید |
| Firefox ≥ 44 | ✅ پشتیبانی کامل | دسکتاپ |
| Edge (Chromium) | ✅ پشتیبانی کامل | دسکتاپ و اندروید |
| Samsung Internet | ✅ پشتیبانی کامل | اندروید |
| Safari ≥ 16 (macOS) | ⚠️ محدود | نیاز به تأیید کاربر در تنظیمات سافاری |
| iOS Safari ≥ 16.4 | ⚠️ محدود | فقط PWA یا افزودن به صفحه اصلی |
پشتیبانی iOS از وبپوش
اپل از نسخه iOS 16.4+ پشتیبانی از وبپوش را برای آیفون و آیپد آغاز کرده است. برخلاف اندروید که وبپوش بهمحض بازدید در مرورگر پشتیبانیشده کار میکند، اپل چند شرط اضافه دارد: وجود فایل manifest.json و اضافه کردن سایت به صفحه اصلی توسط کاربر. اگر سایت شما PWA است، نیازی به این اقدام نیست.
<button type="button" id="pushfa-ios-home-demo">
نمایش راهنمای Add to Home Screen برای iOS
</button>
<script>
document.getElementById('pushfa-ios-home-demo').addEventListener('click', () => {
// بعد از بستن، تا 7 روز دوباره نمایش نده
window.Pushfa.showIosInstallPrompt(7);
});
// اگر میخواهید بعد از بستن دیگر نمایش داده نشود:
// window.Pushfa.showIosInstallPrompt();
</script>
سرویس عادی در مقابل پوش پایدار
در پنل سرویس نوع سرویس را انتخاب کنید. سرویس عادی از Firebase Cloud Messaging (FCM) و Service Worker استفاده میکند. پوش پایدار (SosNet) برای محیطهایی که دسترسی به سرورهای Google ندارند طراحی شده و بدون لود Firebase SDK توکن را از زیرساخت پوشفا دریافت میکند.