Ana içeriğe atla

​
Yaygın kurulum sorunları

​
OneSignal pano kurulumunuzu doğrulayın

WordPress kurulum kılavuzundaki her adımı tamamladığınızdan emin olun:
  • OneSignal uygulamanızı oluştururken WordPress Eklentisi 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.com ile 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 bölümüne bakın.
  • En az bir izin istemi eklediğinizden emin olun.

​
OneSignal kodunu manuel olarak eklemeyin

OneSignal WordPress eklentisi, başlatma komut dosyasını ve Service Worker’ı otomatik olarak içerir. ✅ Bu şu anlama gelir:
  • Temanıza, alt bilginize veya diğer eklentilere manuel olarak OneSignal JavaScript kodu eklememelisiniz.
❌ Özel Kod Kurulumu kullanmak istiyorsanız, çakışmaları önlemek için önce WordPress eklentisini kaldırın.

​
Sitenizde sorun giderme nasıl yapılır

1

Eklentinin aktif olduğunu doğrulayın ve geliştirici araçlarını açın

Sitenizi eklenti etkinken normal (gizli olmayan) bir tarayıcı penceresinde yükleyin.

Sitenize sağ tıklayın, Denetle'ye tıklayın ve Konsol sekmesini açın.

2

Konsolda OneSignal hatalarını kontrol edin

Konsol sekmesini açın, sayfayı yenileyin ve OneSignal ile ilgili kırmızı veya sarı hataları arayın. Yardım için Yaygın OneSignal Konsol hataları bölümüne bakın.
3

Tarayıcıda abonelik durumunu kontrol edin

Bunu konsola yapıştırın:
OneSignal.User.PushSubscription.id
Abone olunmuşsa, bir string (Abonelik ID’niz) döndürür.

Konsolda OneSignal Abonelik ID'nizi bulun.

4

OneSignal panosunda Abonelik ID'sini doğrulayın

OneSignal.com > Audience > Subscriptions’a gidin ve yukarıda döndürülen ID’yi arayın.

Abonelik ID'si için OneSignal panonuzda arama yapın.

5

Bir test push bildirimi gönderin

Abonelik varsa ve durum Subscribed ise, bir bildirim göndermek için Push kılavuzunu izleyin. Hiçbir şey görünmüyorsa, tarayıcıya özel düzeltmeler için Gösterilmeyen bildirimler bölümüne bakın.

​
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ı.

OneSignal panosundaki site URL’niz gerçek alan adınızla eşleşmiyor. Tarayıcıda gördüğünüz alan adıyla tam olarak eşleştiğinden emin olun.

​
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 bölümü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ı.

OneSignal’i iki kez yüklüyorsunuz. Eklentiyi kullanıyorsanız, manuel olarak eklenen OneSignal kodunu kaldırın.

​
Installing service worker failed.. 403 or 404 error

Service Worker dosyası eksik (403/404).

Bu dosyanın erişilebilir olduğundan emin olun: https://your-site.com/wp-content/plugins/onesignal-free-web-push-notifications/sdk_files/OneSignalSDKWorker.js Değilse, CDN veya önbellek sorunlarını çözmek için Yaygın eklenti desteği bölümüne bakın.

​
Yaygın eklenti desteği

CDN’ler ve önbellek eklentileri OneSignal’in gerekli dosyalarını engelleyebilir. Bu eklentiye özel ayarları kullanın:

​
Autoptimize

Excluded scripts bölümüne şunu ekleyin: 
wp-content/plugins/onesignal-free-web-push-notifications/sdk_files/(.*)

​
WP Rocket

CDN > Exclude Files From CDN altına şunu ekleyin: 
(.*)/onesignal-free-web-push-notifications/sdk_files/(.*)

​
LiteSpeed Cache

CDN > Exclude Path altına şunu ekleyin: 
(.*)/onesignal-free-web-push-notifications/sdk_files/(.*)
Ardından kaydet’e basın.

​
WP Super Cache

  1. Settings > WP Super Cache > CDN bölümüne gidin
  2. Exclude if substring bölümüne şunu ekleyin: onesignal-free-web-push-notifications
  3. Contents > Delete Cache’e tıklayın

​
WP Engine

WP Engine plugin > General Settings > HTML Post-Processing bölümüne şunları ekleyin, YOURSITEHERE yerine kendi sitenizi yazın:
text
#https?://(www\.)?(YOURSITEHERE\.com|mywpenginehandleHere.wpengine.com|wpengineCDNpathHere.wpengine.netdna-(ssl|cdn).com)/wp-(content|includes)#
=> https://wpengineCDNpathHere-wpengine.netdna-ssl.com/wp-$4
#https://wpengineCDNpathHere-wpengine.netdna-ssl.com/plugins/onesignal-free-web-push-notifications/#
=> https://mywebsiteHere.com/wp-content/plugins/onesignal-free-web-push-notifications/
#https://wpengineCDNpathHere-wpengine.netdna-ssl.com/wp-content/plugins/onesignal-free-web-push-notifications/#
=> https://mywebsiteHere.com/wp-content/plugins/onesignal-free-web-push-notifications/

​
W3 Total Cache

  1. Performance > CDN bölümüne gidin
  2. Rejected files altına şunu ekleyin:
{plugins_dir}/onesignal-free-web-push-notifications/sdk_files/*

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: 
onesignal-free-web-push-notifications

​
PressCDN

Exclude Directories bölümüne şunu ekleyin: 
/wp-content/plugins/onesignal-free-web-push-notifications/

​
Breeze

Settings > CDN > Exclude Content bölümüne şunu ekleyin: 
/onesignal-free-web-push-notifications/sdk_files/

Breeze hariç tutma örneği.

​
Hummingbird Pro

Asset Optimization bölümüne gidin, OneSignal SDK dosyasını bulun ve optimizasyondan kaldırın.

Hummingbird Pro Asset Optimization.

​
Sucuri

OneSignal dosyalarına izin vermek için Sucuri’nin Whitelist kılavuzunu izleyin.

​
iThemes Security plugin

System Tweaks altındaki “Disable PHP in Plugins” seçeneğini devre dışı bırakın.

iThemes PHP eklenti ayarı.

​
Defender Security plugin

“Prevent PHP execution” seçeneğini etkinleştirmeyin. Defender Plugin > Security Tweaks bölümüne gidin ve ayarın devre dışı olduğunu doğrulayın.

​
Service Worker erişimi için örnek .htaccess

html
<Files *.php>
Order allow,deny
Deny from all
</Files>
<Files OneSignalSDKWorker.js.php>
Allow from all
ForceType 'application/javascript; charset=UTF-8'
</Files>
<Files OneSignalSDKWorker.js>
Allow from all
ForceType 'application/javascript; charset=UTF-8'
</Files>

​
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 artan yük 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.