MODX'e Asyntai AI Chatbot Nasıl Eklenir

MODX CMS 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: MODX Şablonuna Ekleme (Önerilen)

Chatbot'u eklemenin önerilen yolu, MODX Şablonunuzu doğrudan MODX Manager'da düzenlemektir:

MODX Manager'ınıza (yönetim paneli) giriş yapın
Sol kenar çubuğunda Elements > Templates bölümüne gidin
Sitenizin şablonunu açın (genellikle "BaseTemplate" veya aktif şablonunuz)
Şablon kodunda kapanış </body> etiketini bulun
Asyntai gömme kodunuzu kapanış </body> etiketinden hemen önce yapıştırın
Şablonu kaydetmek için "Save" düğmesine tıklayın

<!-- Your existing template content -->

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

İpucu: Kodu kapanış </body> etiketinden hemen önce eklemek, chatbot'un tüm sayfa içeriğinden sonra yüklenmesini sağlar; bu, sohbet widget'ları için önerilen yerleşimdir ve sayfa yüklemenizi yavaşlatmaz.

Alternatif Yöntem 1: MODX Chunk Kullanma

Gömme kodunu ayrı ve yeniden kullanılabilir tutmak için bir MODX Chunk kullanabilirsiniz:

MODX Manager'da Elements > Chunks bölümüne gidin
Yeni bir chunk oluşturmak için \"New Chunk\" düğmesine tıklayın
Chunk'ı "asyntaiWidget" olarak adlandırın
Asyntai gömme kodunuzu chunk içerik alanına yapıştırın
"Kaydet"'e tıklayın
Şablonunuzu açın (Elements > Templates altında)
Chunk çağrısı [[$asyntaiWidget]] kodunu kapanış </body> etiketinden hemen önce ekleyin
Şablonu kaydedin

<!-- In your Template, before </body> -->
[[$asyntaiWidget]]
</body>
</html>

İpucu: Chunk kullanmak, özellikle sitenizde birden fazla şablon kullanıyorsanız, gömme kodunu tek bir yerden yönetmeyi ve güncellemeyi kolaylaştırır.

Alternatif Yöntem 2: MODX Sistem Ayarları Kullanma (HTML Head/Footer)

Bazı MODX kurulumları, Sistem Ayarları aracılığıyla footer scriptleri için yer tutucular içerir:

MODX Manager'da System > System Settings bölümüne gidin
"htmlhead" ile filtreleyin veya footer scriptleri için özel bir sistem ayarı arayın
Kurulumunuzda footer scriptleri için bir yer tutucu varsa (örneğin [[++footer_scripts]]), bunu kullanabilirsiniz
Sistem ayarı değerini Asyntai gömme kodunuz olarak ayarlayın
İlgili [[++footer_scripts]] yer tutucusunun şablonunuzda kapanış </body> etiketinden önce mevcut olduğundan emin olun
Sistem ayarını kaydedin

<!-- In your Template, before </body> -->
[[++footer_scripts]]
</body>
</html>

Not: Bu yöntem, MODX kurulumunuzun footer scriptleri için özel bir sistem ayarına sahip olmasına bağlıdır. Yoksa, özel bir sistem ayarı oluşturabilir ve şablonunuzda [[++setting_key]] sözdizimini kullanarak referans verebilirsiniz.

Alternatif Yöntem 3: MODX Eklentisi Kullanma (OnWebPagePrerender)

Gelişmiş bir yaklaşım için, chatbot kodunu her sayfaya otomatik olarak enjekte eden bir MODX Plugin oluşturabilirsiniz:

MODX Manager'da Elements > Plugins bölümüne gidin
Yeni bir eklenti oluşturmak için \"New Plugin\"'e tıklayın
Eklentiyi "AsyntaiChatbot" olarak adlandırın
Aşağıdaki PHP kodunu eklenti kod alanına yapıştırın:

$output = &$modx->resource->_output;
$script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
$output = str_replace('</body>', $script . '</body>', $output);

"System Events" sekmesine tıklayın
Bu eklentinin bu olayda çalışması için "OnWebPagePrerender" yanındaki kutuyu işaretleyin
"Kaydet"'e tıklayın

Önemli: YOUR_WIDGET_ID yerine Asyntai Kontrol Paneli'ndeki gerçek widget kimliğinizi yazın. Bu eklenti, MODX sitenizdeki her sayfaya chatbot scriptini oluşturulmadan önce otomatik olarak enjekte edecektir.

Adım 3: Önbelleği Temizleyin ve Doğrulayın

Yukarıdaki yöntemlerden herhangi birini kullanarak gömme kodunu ekledikten sonra, MODX önbelleğini temizlemeniz ve kurulumu doğrulamanız gerekir:

MODX Yöneticisinde Manage > Clear Cache bölümüne gidin (veya üst menüdeki önbellek temizleme simgesine tıklayın)
Web sitenizi yeni bir tarayıcı sekmesinde veya gizli pencerede açın
Sayfanızın sağ alt köşesinde sohbet widget düğmesini görmelisiniz
Düzgün açıldığından ve çalıştığından emin olmak için tıklayın

Widget'ı göremiyor musunuz? MODX Yöneticisinde Manage > Clear Cache bölümünden MODX önbelleğini temizlediğinizden emin olun. Ayrıca tarayıcı önbelleğinizi temizlemeyi veya siteyi gizli pencerede görüntülemeyi deneyin. Plugin yöntemini kullandıysanız, eklentiniz için "OnWebPagePrerender" sistem olayının işaretlendiğini doğrulayın.