TYPO3'e Asyntai AI Chatbot Nasıl Eklenir
TYPO3 web siteleri için adım adım kılavuz
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: TypoScript footerData Kullanma (Önerilen)
Chatbot'u tüm sayfalara eklemenin en kolay yolu TypoScript footerData kullanmaktır:
- TYPO3 Backend'inize giriş yapın
- Web → Template bölümüne gidin
- Sayfa ağacında kök sayfanızı seçin
- "Edit the whole template record" seçeneğine tıklayın (veya "Info/Modify" ve ardından "Setup" seçin)
- Setup alanına aşağıdaki TypoScript kodunu ekleyin:
page.footerData.99 = TEXT
page.footerData.99.value = <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> YOUR_WIDGET_IDkısmını dashboard'daki gerçek widget kimliğinizle değiştirin- "Kaydet"'e tıklayın
- TYPO3 önbelleğini temizleyin: Admin Tools → Maintenance → Flush TYPO3 and PHP Cache
İpucu: footerData kullanmak, betiği kapanış </body> etiketinin hemen öncesine yerleştirir; bu, sohbet widget'ları için önerilir çünkü sayfa yüklemenizi yavaşlatmaz.
Alternatif: Site Paketi Kullanma (Site Paketleri İçin)
Bir site paketi kullanıyorsanız, betiği TypoScript yapılandırma dosyanız aracılığıyla ekleyebilirsiniz:
- Site paketi klasörünüze gidin:
packages/your_sitepackage/Configuration/TypoScript/ - setup.typoscript dosyasını açın veya oluşturun
- Aşağıdaki kodu ekleyin:
page.footerData {
99 = TEXT
99.value = <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
} YOUR_WIDGET_IDkısmını gerçek widget kimliğinizle değiştirin- TYPO3 backend'inde önbelleği temizleyin
Alternatif: Fluid Template Kullanma (FooterAssets)
Fluid şablonları kullanan siteler için FooterAssets bölümünü kullanabilirsiniz:
- Fluid şablon dosyanıza gidin (genellikle
Resources/Private/Templates/içinde) - Düzeninize veya şablonunuza bir FooterAssets bölümü ekleyin:
<f:section name="FooterAssets">
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
</f:section> - Sayfa düzeninizin FooterAssets bölümünü render ettiğinden emin olun:
<f:render section="FooterAssets" optional="true" /> - TYPO3 önbelleğini temizleyin
Önemli: FooterAssets özelliği TYPO3 v8 veya üstünü gerektirir. Daha eski sürümler için TypoScript footerData yöntemini kullanın.
Alternatif: AssetCollector Kullanma (Geliştiriciler İçin)
Eklenti geliştiricileri için TYPO3 v10.3+ AssetCollector API sunar:
- PHP kodunuzda (örneğin, bir controller veya middleware), AssetCollector'ı enjekte edin
- Betiği özel niteliklerle ekleyin:
use TYPO3\CMS\Core\Page\AssetCollector;
$this->assetCollector->addJavaScript(
'asyntai_chatbot',
'https://asyntai.com/static/js/chat-widget.js',
['async' => 'async', 'data-asyntai-id' => 'YOUR_WIDGET_ID']
);
Adım 3: Kurulumu Doğrulayın
Değişikliklerinizi kaydedip önbelleği temizledikten sonra, web sitenizi yeni bir tarayıcı sekmesinde veya gizli pencerede ziyaret edin. Sağ alt köşede 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? Tüm önbellekleri temizlediğinizden emin olun: Admin Tools → Maintenance → Flush TYPO3 and PHP Cache bölümüne gidin. Ayrıca tarayıcı önbelleğinizi temizlemeyi veya gizli pencerede görüntülemeyi deneyin. TypoScript kullanıyorsanız, şablonunuzun sayfa hiyerarşisine düzgün şekilde dahil edildiğini doğrulayın.
Weebly