Asyntai AI Chatbot TYPO3'e 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>
} - Replace
YOUR_WIDGET_IDwith your actual widget ID - TYPO3 backend'inde önbelleği temizleyin
Alternatif: Fluid Template Kullanma (FooterAssets)
For sites using Fluid templates, you can use the FooterAssets section:
- 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)
For extension developers, TYPO3 v10.3+ offers the AssetCollector API:
- 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 website yeni bir tarayıcı sekmesinde veya gizli pencerede ziyaret edin. Sağ alt köşede sohbet widget'ı düğmesini görmeniz gerekir. Düzgün açıldığından ve çalıştığından emin olmak için tıklayın.
Widget'ı göremiyorsunuz mu? 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