Yaygın kurulum sorunları
OneSignal kontrol paneli kurulumunuzu doğrulayın
WordPress kurulum kılavuzundaki her adımı tamamladığınızdan emin olun:- OneSignal uygulamanızı oluştururken WordPress Plugin seçeneğini seçin
- Site URL’niz tarayıcı URL’siyle tam olarak eşleşmelidir
- Örneğin,
https://example.com,https://www.example.comile aynı değildir. Bir sürümü tutarlı bir şekilde kullanın. - Push için yalnızca bir site origin’i desteklenir. Same-origin policy’ye bakın.
- Örneğin,
- En az bir izin istemi eklediğinizden emin olun.
OneSignal kodunu manuel olarak eklemeyin
OneSignal WordPress eklentisi, başlatma betiğini ve service worker’ı otomatik olarak içerir. Sürüm 3+, eklentininsdk_files dizininde düz bir OneSignalSDKWorker.js barındırır ve yolu eklentinin init kodunda ayarlar. Worker’ı site kök dizinine yüklemezsiniz ve serviceWorkerPath’i kendiniz ayarlamazsınız.
- Sitenize OneSignal JavaScript
initkodu eklemeyin. - Eklentiyle birlikte Özel Kod kurulumu kullanmayın.
init seçeneklerine veya özel bir worker konumuna ihtiyacınız varsa, eklentiyi kaldırın ve Özel Kod kurulumu’nu izleyin. Bu, eklentinin service worker’ını taşımanın bir yolu değil, WordPress’ten tam bir geçiştir.
Gönderi yayımlandığında bildirim gönder
Bir gönderi, sayfa veya özel gönderi türü yayımladığınızda OneSignal, abonelerinize otomatik olarak bildirim gönderebilir.
OneSignal Push Notifications meta kutusu—gerekirse sürükleyerek yeniden konumlandırın
- Düzenleyicinin sağ ve alt tarafındaki meta kutularını kontrol edin. Gerektiğinde sürükleyip bırakabilirsiniz.
- OneSignal Push Notifications meta kutusunun işaretlendiğinden emin olmak için düzenleyicinin üstündeki Ekran Seçenekleri’ni kontrol edin.

OneSignal Push Notifications meta kutusunun işaretlendiğini gösteren Ekran Seçenekleri
- Özel Gönderi Türü kullanıp kullanmadığınızı kontrol edin. Bu genellikle URL’de
post_type=your_custom_typeolarak bulunur. Öyleyse, OneSignal WordPress eklenti ayarlarındaki Custom Post Types alanına özel gönderi türünü ekleyin.

Özel gönderi türü adının nerede bulunacağına dair örnek
Sitenizde sorun giderme nasıl yapılır
Eklentinin aktif olduğunu doğrulayın ve geliştirici araçlarını açın

Sitenize sağ tıklayın, Denetle'ye tıklayın ve Konsol sekmesini açın.
Konsolda OneSignal hatalarını kontrol edin
Tarayıcıda abonelik durumunu kontrol edin
null veya boş bir değer görebilirsiniz. OneSignal is not defined görürseniz birkaç saniye bekleyip tekrar deneyin ya da önce Yaygın OneSignal konsol hataları bölümündeki konsol hatalarını düzeltin—SDK, ertelenmiş yükleyici aracılığıyla hâlâ yükleniyor olabilir.
Konsolda OneSignal Abonelik ID'nizi bulun.
OneSignal kontrol panelinde Abonelik ID'sini doğrulayın

Abonelik ID'si için OneSignal kontrol panelinizde arama yapın.
Bir test push bildirimi gönderin
Yaygın OneSignal konsol hataları
SdkInitError: OneSignal: This web push config can only be used on … Your current origin is …

Site URL uyuşmazlığı hatası.
PushPermissionNotGrantedError: The user dismissed the permission prompt.
Ziyaretçi tarayıcı istemini reddetti. Bekleme süresi dolana kadar tekrar görünmeyecektir.
Tarayıcı kuralları için Web izin istemleri’ne bakın veya hemen yeniden denemek için site verilerini temizleyin.
The OneSignal web SDK can only be initialized once.

Yinelenen OneSignal başlatma hatası.
Installing service worker failed.. 403 or 404 error

Service Worker dosyası eksik (403/404).
OneSignalSDKWorker.js dosyasını sdk_files dizininden sunar. WordPress.org kurulumları onesignal-free-web-push-notifications klasörünü kullanır. Zip’ten kurduysanız klasör farklı olabilir. your-site.com yerine kendi adresinizi yazın ve klasör adını wp-admin’deki Eklentiler ile eşleştirin:
https://your-site.com/wp-content/plugins/onesignal-free-web-push-notifications/sdk_files/OneSignalSDKWorker.js
Şu tek satırlık JavaScript kodunu görmelisiniz:
sdk_files dizininden OneSignalSDKWorker.js.php sunuyordu. Konsolunuz hâlâ bir .js.php URL’si istiyorsa, eski worker’ı kullanıyorsunuz demektir. Yalnızca bu kurulumlar için geçerli olan PHP çalıştırma notları için Solid Security ve Örnek .htaccess’e bakın.
Yaygın eklenti desteği
CDN’ler ve önbellek eklentileri OneSignal’in gerekli dosyalarını engelleyebilir. WordPress.org kurulumlarıonesignal-free-web-push-notifications eklenti dizinini kullanır. Zip’ten kurduysanız klasör farklı olabilir (örneğin OneSignal-WordPress-Plugin). wp-admin’deki Eklentiler’i veya wp-content/plugins/ dizinini kontrol edin ve aşağıdaki yollarda o adı kullanın.
Şu eklentiye özgü ayarları kullanın:
Autoptimize
Excluded scripts bölümüne şunu ekleyin:WP Rocket
CDN > Exclude Files From CDN altına şunu ekleyin:LiteSpeed Cache
CDN > Exclude Path altına şunu ekleyin:WP Super Cache
- Settings > WP Super Cache > CDN bölümüne gidin
- Exclude if substring bölümüne şunu ekleyin:
onesignal-free-web-push-notifications - Contents > Delete Cache’e tıklayın
WP Engine
WP Engine, CDN’si aracılığıyla eklenti URL’lerini yeniden yazabilir. HTML Post-Processing kuralları ortama özeldir; aşağıdaki kod parçacığı yalnızca bir örnektir—uygulamadan önce yolları WP Engine desteği veya Kullanıcı Portalınız ile doğrulayın. WP Engine plugin > General Settings > HTML Post-Processing bölümünde aşağıdakine benzer kurallara ihtiyaç duyabilirsiniz. Her yer tutucuyu sizin sitenizin ve WP Engine CDN ana bilgisayar adınızın değerleriyle değiştirin:W3 Total Cache
- Performance > CDN bölümüne gidin
- Rejected files altına şunu ekleyin:

W3 Total Cache hariç tutma ayarları.
BunnyCDN
Eklentinin CDN Excluded Paths bölümünde onesignal’i hariç tutun.
BunnyCDN hariç tutma örneği.
CDN Enabler
Settings > CDN Enabler bölümünde “Exclusions”a şunu ekleyin:PressCDN
Exclude Directories bölümüne şunu ekleyin:Breeze
Settings > CDN > Exclude Content bölümüne şunu ekleyin:
Breeze hariç tutma örneği.
Hummingbird Pro
Hummingbird > Asset Optimization bölümüne gidin. JavaScript (OneSignal varlıkları orada görünüyorsa CSS de) altında, URL’lerionesignal-free-web-push-notifications veya OneSignalSDK içeren dosyaları bulun. Bunları küçültme/birleştirme/erteleme işlemlerinden hariç tutun ya da eklentinin bunları yeniden yazmaması veya geciktirmemesi için bu varlıkları Don’t load optimizasyonuna geçirin.

Hummingbird Pro Asset Optimization.
Sucuri
OneSignal dosyalarına izin vermek için Sucuri’nin Whitelist kılavuzunu izleyin.Solid Security (eski adıyla iThemes Security)
Sürüm 3+, statik birOneSignalSDKWorker.js dosyası sunar. Bu worker için eklentiler dizininde PHP çalıştırmaya ihtiyacınız yoktur.
Hâlâ eklenti v2 kullanıyorsanız veya worker URL’si .js.php ile bitiyorsa, OneSignalSDKWorker.js.php dosyasının çalışabilmesi için System Tweaks altındaki Disable PHP in Plugins (veya eşdeğer) seçeneğini devre dışı bırakın.

Eklentilerde PHP çalıştırma engellemesini yalnızca hâlâ v2 .js.php worker'ını sunuyorsanız devre dışı bırakın.
Defender Security plugin
Sürüm 3+, worker için PHP çalıştırmaya ihtiyaç duymaz. Prevent PHP execution açıksa, v3.js dosyası için sorun yoktur.
Hâlâ OneSignalSDKWorker.js.php (v2) sunuyorsanız, Prevent PHP execution seçeneğini devre dışı bırakın. Defender > Security Tweaks bölümüne gidin ve ayarı doğrulayın.
Service Worker erişimi için örnek .htaccess
v3 JavaScript worker’ına izin verin. Barındırma sağlayıcınız veya bir güvenlik eklentisiwp-content/plugins/ içindeki dosyaları engelliyorsa bunu kullanın.
sdk_files dizininden OneSignalSDKWorker.js.php sunar. Bu bloğu yalnızca o .js.php URL’si hâlâ kullanımdaysa ekleyin:
Require yerine Allow from all / Deny from all ile Order allow,deny kullanır. Barındırma sağlayıcınıza danışın veya sunucunuzun zaten kullandığı sözdizimiyle eşleştirin.Bildirim gönderdikten sonra sunucu yavaşlamaları veya siteye erişilememe
Bildirim gönderdikten sonra sunucunuz yavaşlıyorsa veya erişilemez hale geliyorsa, bu genellikle bildirim varlıklarından kaynaklanan artan yükten veya sınırlı sunucu kaynaklarından kaynaklanır.Kendi bildirim simgelerinizi barındırmayın
Bildirimlerde kullanılan resimleri kendi sunucunuzda barındırmaktan kaçının. Kendi bildirim simgelerinizi veya resimlerinizi barındırdığınızda, bir bildirim gönderildiğinde her alıcının tarayıcısı aynı anda resmi almaya çalıştığı için sunucunuz aşırı yüklenebilir. Sunucu yükünü azaltmak için, yüksek eşzamanlı erişim için optimize edilmiş resim barındırma çözümleri veya CDN hizmetleri kullanın.Barındırma kaynaklarını yükseltmeyi düşünün
Sunucu sorunları devam ederse, şunları yapmanız gerekebilir:- Barındırma planınızı yükseltin: Büyük ölçekli bildirim gönderilerini işlemek için daha yüksek bant genişliği veya daha güçlü barındırma gerekli olabilir.
- Barındırma sağlayıcınıza danışın: Sağlayıcınız, barındırma ortamınıza özel içgörüler veya optimizasyonlar sunabilir.