Dashboard'a Dön

Belgeler

Asyntai'yi nasıl kullanacağınızı öğrenin

Asyntai AI Chatbot TYPO3'e Nasıl Eklenir

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

Yerleştirme Kodunu Al

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:

  1. TYPO3 Backend'inize giriş yapın
  2. Web → Template bölümüne gidin
  3. Sayfa ağacında kök sayfanızı seçin
  4. "Edit the whole template record" seçeneğine tıklayın (veya "Info/Modify" ve ardından "Setup" seçin)
  5. 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>
  6. YOUR_WIDGET_ID kısmını dashboard'daki gerçek widget kimliğinizle değiştirin
  7. "Kaydet"'e tıklayın
  8. 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:

  1. Site paketi klasörünüze gidin: packages/your_sitepackage/Configuration/TypoScript/
  2. setup.typoscript dosyasını açın veya oluşturun
  3. 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>
    }
  4. Replace YOUR_WIDGET_ID with your actual widget ID
  5. TYPO3 backend'inde önbelleği temizleyin

Alternatif: Fluid Template Kullanma (FooterAssets)

For sites using Fluid templates, you can use the FooterAssets section:

  1. Fluid şablon dosyanıza gidin (genellikle Resources/Private/Templates/ içinde)
  2. 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>
  3. Sayfa düzeninizin FooterAssets bölümünü render ettiğinden emin olun:
    <f:render section="FooterAssets" optional="true" />
  4. 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:

  1. PHP kodunuzda (örneğin, bir controller veya middleware), AssetCollector'ı enjekte edin
  2. 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.