RReslifyKnowledge Center

Sorun Giderme

Rezervasyon widget'ı görünmüyor

Kurulumdan sonra restoran web sitesinde görünmeyen rezervasyon widget'ı için yerleştirme, portal erişimi ve web sitesi ayarlarını kontrol edin.

8 dk/

Reslify widget'ı restoran web sitesine eklendiği halde başlatıcı, çekmece, modal veya satır içi rezervasyon akışı görünmüyorsa bu rehberi kullanın.

Kontrol testiyle başlayın

Web sitesi kodunu değiştirmeden önce aynı restoranı üç yerde kontrol edin:

  1. Ayarlar / Portal içinde Portalı aç seçin. Bağımsız rezervasyon sayfası açılmıyorsa önce portal erişimini veya rezervasyon sayfasını düzeltin.
  2. Ayarlar / Portal / Portal ayarları / Kurulum içinde Yerleştirme önizlemesini aç seçin. Bağımsız sayfa açılıyor ama yerleştirme önizlemesi açılmıyorsa portal erişimi, yerleştirme yapılandırması veya seçili restorana odaklanın.
  3. Restoran web sitesini misafir gibi, tercihen gizli pencerede açın. İlk iki kontrol çalışıyor ama web sitesi çalışmıyorsa web sitesi kurulumu, izin verilen originler, script engelleyiciler veya sayfa yerleşimine odaklanın.

Widget açılıyor ve restoran markasını, arama kontrollerini ya da Uygun slot bulunamadı. veya Seçili tarihte uygun slot yok. gibi mesajları gösteriyorsa widget kurulmuştur. Bu, görünmeyen widget değil müsaitlik problemidir.

Portal erişimini doğrulayın

Ayarlar / Portal sayfasını açın ve Portal erişimi bölümünü kontrol edin.

  • Misafirlerin canlı web sitesinde widget'ı kullanabilmesi için Portal erişim modu Herkese açık olmalıdır.
  • Kısıtlı, panelden yalnızca ekip açılışları içindir. Doğrudan bağlantı veya yerleştirme açan genel ziyaretçiler bulunamadı görür ve herkese açık kurulum kopyalama işlemleri devre dışı kalır.
  • Kapalı, Portalı aç, Portal tasarımcısını aç, Yerleştirme önizlemesini aç ve herkese açık kurulum işlemlerini engeller.

Portal erişim modunu yalnızca sahipler ve yöneticiler değiştirebilir. Personel, erişim izin verdiğinde ekip önizleme açılışlarını kullanabilir; ancak kısıtlı veya kapalı widget'ı genel misafirler için çalışır hâle getiremez.

Kurulum kod parçasını doğrulayın

Ayarlar / Portal / Portal ayarları / Kurulum bölümünü açın ve aktif restorandan güncel widget kodunu kopyalayın. Kurulum ipucu, bağlantıların ve kod parçalarının herkese açık kurulumlar için hazır olduğunu söylemelidir.

Web sitesi değişikliğine uygun çıktıyı kullanın:

  • Modal yerleştirme scripti, başlatıcı düğmesi ekler ve rezervasyonu ortalanmış katmanda açar.
  • Çekmece yerleştirme scripti, başlatıcı düğmesi ekler ve rezervasyonu sayfanın yanından açar.
  • Satır içi yerleştirme scripti, #reslify-booking kapsayıcısını içerir ve rezervasyon akışını doğrudan o sayfa bölümüne yerleştirir.
  • Ham yerleştirme URL’si, normal kopyala-yapıştır web sitesi kurulumu değil, daha çok önizleme veya özel iframe hedefidir.
  • Widget script URL’si, kendi script etiketini yazan geliştiriciler içindir.

Üretilen modal, çekmece ve satır içi scriptlerde güncel data-reslify-merchant değeri ve data-reslify-mode değeri bulunmalıdır. Web sitesi kodu farklı bir restorana, eski bir portal hostuna veya canlı sitede staging scriptine işaret ediyorsa doğru panel ortamından yeni kodla değiştirin.

Rezervasyon sayfası, yerleştirme ve widget script URL’sini gösteren Portal Kurulum sekmesi.
Widget web sitesine eklenirken güncel Kurulum sekmesi değerlerini kullanın.

Düğme metni, Uzaklık, Z-index, Modal genişliği, Çekmece tarafı, Başlatıcı konumu, Çekmece genişliği veya Satır içi minimum yükseklik değiştiyse yeni kodu kopyalamadan önce Portal ayarları değerlerini kaydedin. Bu değerler üretilen script niteliklerine yazılır.

İzin verilen originleri kontrol edin

Ayarlar / Portal / Portal ayarları / Genel / Çalışma zamanı bölümünü açın ve İzin verilen originler alanını inceleyin.

İzin verilen originler ayarlanmışsa tarayıcı origini birebir eşleşmelidir. Web sitesi sayfasındaki window.location.origin değerini kullanın: protokol, hostname ve varsa port. Sayfa yolu eklemeyin.

Widget'ın çalışacağı her hostu kontrol edin:

  • canlı domain
  • site ayrı kullanıyorsa www versiyonu
  • web sitesi ekibinin kullandığı staging, önizleme veya CMS hostu
  • testte kullanılan standart dışı port

Alan boşsa SDK herhangi bir hosta izin verir ve postMessage için mevcut web sitesi originini kullanır. Canlı web sitesi için açık originler denetim ve sorun giderme açısından daha kolaydır. Originleri kaydettikten sonra yeniden test etmeden önce web sitesi sayfasını yenileyin.

Widget canlıda çalışıyor ama staging'de çalışmıyorsa veya staging'de çalışıp canlıda çalışmıyorsa yönlendirmelerden sonra tarayıcıdaki son origini karşılaştırın. https://restoran.example ile https://www.restoran.example arasında yönlendirme yapmak SDK'nın doğruladığı origini değiştirir.

Rezervasyon widget'ı için Portal izin verilen originler yapılandırma.
İzinli originler, widget'ın çalışması beklenen her web sitesi host'unu içermelidir.

Tarayıcı geliştirici araçlarında origin problemi, Reslify embed: current origin is not allowlisted for postMessage benzeri bir konsol uyarısı olarak görünebilir.

Yerleşim ve başlatıcı ayarlarını kontrol edin

Ayarlar / Portal / Portal ayarları / Genel bölümünü açın ve widget modu ile başlatıcı davranışını doğrulayın.

  • Varsayılan mod, web sitesi scripti modu belirtmediğinde kullanılan yedektir. Üretilen kodlar kendi modunu ayarlar; bu nedenle eski bir script, web sitesi kodu güncellenene kadar modal, çekmece veya satır içi kullanmaya devam edebilir.
  • Düğme metni, SDK başlatıcısındaki metni ve modal ya da çekmece başlığını kontrol eder.
  • Z-index, başlatıcı, modal veya çekmecenin sticky navigasyon, çerez banner'ı, chat widget'ı ve diğer katmanların üstünde görünüp görünmediğini belirler.
  • Satır içi minimum yükseklik, satır içi kurulumların minimum yüksekliğini kontrol eder.

Modal için varsayılan başlatıcı, script'in sayfaya yerleştirildiği yerde görünür. Kod gizli bir şablon alanına, footer bloğuna veya kapalı bir CMS bileşenine yapıştırıldıysa misafirler düğmeyi görmeyebilir.

Çekmece için varsayılan başlatıcı, yapılandırılan Başlatıcı konumu ve Uzaklık değerleriyle sabitlenir. Başka bir web sitesi öğesi üstünü kapatıyorsa Z-index değerini artırın veya konumu ayarlayın.

Satır içi için geliştirici hem hedef öğeyi hem de data-reslify-target değerini bilinçli olarak değiştirmedikçe sağlanan div ve script'i birlikte tutun. #reslify-booking kapsayıcısı kaldırılırsa, çoğaltılırsa, CSS ile gizlenirse veya sayfa yüklenirken render edilmeyen bir sekmenin içine konursa rezervasyon akışı beklenen yerde görünmeyebilir.

Widget var ama zor görünüyorsa müsaitlik ayarlarını değiştirmeden önce başlatıcı renklerini, modal veya çekmece chrome'unu ve web sitesi temasını kontrol edin.

Web sitesi ve tarayıcı engelleyicilerini kontrol edin

Panel önizlemeleri çalışıyor ama restoran web sitesi hâlâ widget'ı göstermiyorsa yayınlanmış web sitesi sayfasını inceleyin:

  1. Sayfa yayınlandıktan sonra script etiketinin hâlâ var olduğunu doğrulayın. Bazı CMS editörleri scriptleri yalnızca kod ekleme veya özel HTML alanından eklenmediklerinde kaldırır.
  2. Script'in hâlâ data-reslify-merchant içerdiğini doğrulayın. Bu nitelik kaldırılırsa tarayıcı konsolu merchant bilgisinin eksik olduğunu belirten uyarı gösterebilir.
  3. Network sekmesinde tarayıcının booking-widget.js, yerleştirme yapılandırma rotası ve yerleştirme iframe'ini yükleyebildiğini doğrulayın.
  4. Tarayıcı konsolunda Reslify embed, origin, iframe veya engellenen script mesajlarını kontrol edin.
  5. Eklentilerin kapalı olduğu gizli pencerede test edin. Reklam engelleyiciler, gizlilik eklentileri, sıkı takip koruması, kurumsal filtreler veya web sitesi content security policy ayarı üçüncü taraf scriptleri ya da iframe'leri engelleyebilir.
  6. Sadece bir misafir etkileniyorsa farklı tarayıcı, cihaz veya ağ denemesini isteyin. Aynı web sitesi sayfasında tüm tarayıcılar başarısız oluyorsa bunu web sitesi kurulumu veya host yapılandırması sorunu olarak ele alın.

Kurulumu müsaitlikten ayırın

Sonuca göre sonraki inceleme alanını seçin:

| Gördüğünüz durum | Muhtemel alan | | --- | --- | | Portalı aç başarısız | Portal erişimi, seçili restoran, herkese açık sayfa veya destek incelemesi | | Portalı aç çalışıyor ama Yerleştirme önizlemesini aç başarısız | Yerleştirme erişimi, portal erişim tokenı, restoran ID'si veya yerleştirme rotası | | Paneldeki iki kontrol çalışıyor ama web sitesi başarısız | Web sitesi kodu, izin verilen originler, script engelleyiciler, z-index veya sayfa yerleşimi | | Widget yükleniyor ama saat göstermiyor | Müsaitlik, vardiyalar, özel günler, masa uygunluğu, deneyim kuralları, mevcut rezervasyonlar veya geçici slot tutmaları | | Modal veya çekmece başka öğenin arkasında açılıyor | Z-index, başlatıcı konumu, web sitesi katmanları, çerez banner'ı veya chat widget'ı | | Satır içi bölüm boş ya da çok kısa | #reslify-booking hedefi, gizli kapsayıcı, kaldırılmış script veya Satır içi minimum yükseklik |

Bağımsız rezervasyon sayfası ve widget yükleniyor ama ikisi de aynı slotsuz mesajı gösteriyorsa web sitesi kodunu tekrar tekrar değiştirmeyin. Misafirin kişi sayısı, tarih, konum veya alan ve deneyim değerleriyle aynı aramayı yeniden üretin; sonra Rezervasyonlar, Ayarlar / Vardiyalar, Ayarlar / Özel Günler, Ayarlar / Masa Planı ve Ayarlar / Deneyimler üzerinden müsaitliği inceleyin.

Destek ekibine veya web sitesi geliştiricisine iletirken web sitesi URL'sini, window.location.origin değerini, aktif restoranı, portal erişim modunu, kullanılan kod alanını ve tarayıcı konsolu ya da Network hatalarını birlikte paylaşın.

İlgili rehberler