OpenCart'e Asyntai AI Chatbot Nasıl Eklenir

OpenCart web siteleri için adım adım kılavuz

Platform:

Adım 1: Yerleştirme Kodunuzu Alın

Önce Asyntai Dashboard'unuza gidin ve "Yerleştirme Kodu" bölümüne inin. Şuna benzeyen benzersiz yerleştirme kodunuzu kopyalayın:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

Not: Yukarıdaki kod yalnızca bir örnektir. Kişisel widget kimliğinizi içerdiğinden, kendi benzersiz yerleştirme kodunuzu Dashboard'unuzdan kopyalamanız gerekir.

Adım 2: Footer Şablonunu Düzenleme (Önerilen)

Chatbot'u eklemenin en kolay yolu temanızın footer şablonunu düzenlemektir:

OpenCart dosyalarınıza FTP veya dosya yöneticisi üzerinden erişin
Temanızın footer şablonuna gidin:
- OpenCart 3.x/4.x: catalog/view/theme/YOUR_THEME/template/common/footer.twig
- OpenCart 2.x: catalog/view/theme/YOUR_THEME/template/common/footer.tpl
Footer dosyasını düzenlemek için açın
Kapanış </body> etiketini bulun
Asyntai yerleştirme kodunuzu </body> etiketinin hemen öncesine yapıştırın
Dosyayı kaydedin
OpenCart önbelleğini temizleyin: Dashboard → Mavi dişli simgesi (sağ üst) → Refresh veya system/storage/cache/ içeriğini silin

İpucu: Varsayılan temayı kullanıyorsanız, yol catalog/view/theme/default/template/common/footer.twig olacaktır. Şablon dosyalarını düzenlemeden önce her zaman yedek oluşturun.

Alternatif: Temanın Özel Kod Seçeneğini Kullanma

Many modern OpenCart themes include a built-in option for custom code:

OpenCart Yönetim Paneli'ne giriş yapın
Extensions → Themes (veya Extensions → Extensions → Themes) bölümüne gidin
Aktif temanızda Edit düğmesine tıklayın
Bir "Custom Code", "Footer Scripts" veya "Custom JavaScript" bölümü arayın
Asyntai yerleştirme kodunuzu yapıştırın
"Kaydet"'e tıklayın
Önbelleği temizleyin

Not: Tüm temalar bu seçeneğe sahip değildir. Temanız özel kod alanları içermiyorsa, şablon düzenleme yöntemini kullanın veya bir eklenti kurun.

Alternatif: Özel Kod Eklentisi Kullanma

Özel scriptler eklemek için OpenCart Marketplace'ten ücretsiz bir eklenti kurabilirsiniz:

OpenCart Marketplace'e gidin
"Custom Script", "Header Footer Scripts" veya "Custom Code" araması yapın
Uygun bir eklenti indirin ve kurun
Yönetim panelinizde Extensions → Extensions → Modules bölümüne gidin
Özel kod modülünü bulun ve kurun
Modülü yapılandırın ve Asyntai gömme kodunuzu footer bölümüne yapıştırın
Kaydedin ve önbelleği temizleyin

Önemli: Eklenti kullanmak, OpenCart güncellemelerinde korunacağı için çekirdek dosyaları düzenlemekten daha çok önerilir. Popüler eklentiler arasında pazaryerinde bulunan "Custom Script in Header & Footer" bulunur.

Alternatif: addScript Yöntemi Kullanma (Geliştiriciler İçin)

Geliştiriciler için, OpenCart 3.x/4.x scriptleri programatik olarak eklemenin bir yolunu sunar:

catalog/controller/common/footer.php dosyasını açın
$data['scripts'] = $this->document->getScripts('footer'); satırından önce aşağıdaki satırı ekleyin:
$this->document->addScript('https://asyntai.com/static/js/chat-widget.js', 'footer');
Data özniteliği için footer.twig'i manuel olarak dahil etmek üzere değiştirmeniz veya scriptler döngüsünden sonra satır içi JavaScript eklemeniz gerekecektir

Not: Widget'ın data özniteliği ile düzgün çalışması için, addScript yöntemi özel öznitelikleri doğrudan desteklemediğinden şablon yöntemi daha basittir.

Adım 3: Kurulumu Doğrulayın

Değişikliklerinizi kaydedip önbelleği temizledikten sonra, mağazanızı yeni bir tarayıcı sekmesinde veya gizli pencerede ziyaret edin. Sağ alt köşede sohbet widget düğmesini görmelisiniz. Doğru şekilde açıldığından ve çalıştığından emin olmak için üzerine tıklayın.

Widget'ı göremiyorsunuz mu? OpenCart önbelleğini temizlediğinizden emin olun. Yönetim panelinize gidin, sağ üst köşedeki mavi dişli simgesine tıklayın ve yenileme düğmelerine tıklayın. Ayrıca tarayıcı önbelleğinizi temizlemeyi veya gizli pencerede görüntülemeyi deneyin. Yanlış şablon dosyasını değiştirdiyseniz, temanızın düzenlediğiniz dosyayı kullandığını kontrol edin.