OpenCart'e Asyntai AI Chatbot Nasıl Eklenir

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

Platform:

The Easy Way: Install the Asyntai Extension

We publish a free extension on the OpenCart Marketplace. It puts the chatbot on your storefront and connects your account, and there is no code to copy and no template to edit. It works on OpenCart 3.x and 4.x.

Download Asyntai - AI Chatbot from the OpenCart Marketplace
In your admin panel, go to Extensions → Installer and upload the ZIP file
Go to Extensions → Extensions, choose Modules in the list, find Asyntai AI Chatbot and press the green install button
Press edit, then press Connect to Asyntai. A window opens where you sign in or create an account.

That is all. The chatbot is live on your storefront when the window closes.

Your products, prices and stock

When you connect, the extension also lets Asyntai read your catalogue. Your assistant then answers with the price you charge today and tells shoppers what is in stock, instead of repeating whatever your pages said when they were last read.

Asyntai reads your products through a read-only address on your own store. Every request is signed, and the reply carries the prices a shopper would actually pay, with your tax rules already applied. You can switch this off at any time on the extension's settings screen.

Updating from version 1.0.0? OpenCart clears a module's settings when you uninstall it, so press Connect to Asyntai once after the update. From this version on, updates keep your connection.

Or Add the Code Yourself

Prefer not to install an extension? The rest of this page shows how to add the chatbot by hand. You will not get the catalogue reading this way.

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

First, go to your Asyntai Dashboard and scroll down to the "Embed Code" section. Copy your unique embed code which will look like this:

<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</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.

Step 2: Edit Footer Template

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

Birçok modern OpenCart teması, özel kod için yerleşik bir seçenek içerir:

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:

Go to the OpenCart Marketplace
"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öremiyor musunuz? 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.

Belgeler