Dashboard'a Dön

Belgeler

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

Moodle'a Asyntai AI Chatbot Nasıl Eklenir

Moodle LMS 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: Ek HTML Kullanma (Önerilen)

Moodle, tüm sayfalara özel HTML/JavaScript eklemek için yerleşik bir özelliğe sahiptir:

  1. Moodle sitenize yönetici olarak giriş yapın
  2. Site administration bölümüne gidin
  3. Appearance → Additional HTML bölümüne gidin
  4. Scroll down to the "Before BODY is closed" section
  5. Asyntai gömme kodunuzu metin alanına yapıştırın
  6. "Save changes" düğmesine tıklayın

İpucu: Kodu "Before BODY is closed" bölümüne eklemek, onu kapanış </body> etiketinden hemen önce yerleştirir; bu, sohbet widget'ları için önerilen yerleşimdir ve ana sayfa içeriğinden sonra yüklenmesini sağlar.

Alternatif: Tema Ayarlarını Kullanma

Birçok Moodle teması (Boost ve türevleri dahil) özel JavaScript eklemek için kendi ayarlarına sahiptir:

  1. Go to Site administration → Appearance → Themes
  2. Aktif temanız için Theme settings seçeneğine tıklayın (ör. Boost)
  3. "Raw SCSS", "Additional HTML" veya "Custom JavaScript" bölümünü arayın
  4. Bir JavaScript alanı varsa, Asyntai gömme kodunuzu oraya yapıştırın
  5. "Save changes" düğmesine tıklayın
  6. Önbellekleri temizleyin: Site administration → Development → Purge caches

Not: Temaya özel ayarlar temalar arasında farklılık gösterir. Temanızda JavaScript alanı yoksa, yukarıdaki Additional HTML yöntemini kullanın.

Alternatif: Yerel Eklenti Oluşturma

Daha fazla kontrol için basit bir yerel eklenti oluşturabilirsiniz:

  1. Moodle kurulumunuzda klasör yapısını oluşturun: local/asyntaichatbot/
  2. version.php dosyasını oluşturun:
    <?php
    defined('MOODLE_INTERNAL') || die();
    $plugin->component = 'local_asyntaichatbot';
    $plugin->version = 2024010100;
    $plugin->requires = 2022041900;
  3. lib.php dosyasını oluşturun:
    <?php
    defined('MOODLE_INTERNAL') || die();

    function local_asyntaichatbot_before_footer() {
      global $PAGE;
      $PAGE->requires->js_call_amd('local_asyntaichatbot/loader', 'init');
    }
  4. amd/src/ klasörünü ve loader.js dosyasını oluşturun:
    define([], function() {
      return {
        init: function() {
          var script = document.createElement('script');
          script.async = true;
          script.src = 'https://asyntai.com/static/js/chat-widget.js';
          script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
          document.body.appendChild(script);
        }
      };
    });
  5. Replace YOUR_WIDGET_ID with your actual widget ID
  6. Eklentiyi kurmak için Site administration → Notifications bölümüne gidin
  7. Kurulumdan sonra önbellekleri temizleyin

Önemli: Yerel eklenti yöntemi dosya oluşturmak için komut satırı erişimi gerektirir. Çoğu kullanıcı için Additional HTML yöntemi daha basit ve yeterlidir.

Alternatif: Tema Footer Şablonunu Düzenleme

Temanızın footer şablonunu doğrudan da düzenleyebilirsiniz:

  1. Tema klasörünüze gidin: theme/YOUR_THEME/
  2. layout dosyalarını bulun (ör. layout/columns2.php veya templates/columns2.mustache)
  3. Find the closing </body> tag or the footer section
  4. Add your Asyntai embed code just before </body>
  5. Dosyayı kaydedin
  6. Moodle önbelleklerini temizleyin

Önemli: Tema dosyalarını doğrudan düzenlemek, temanızı güncellerken değişikliklerin kaybolabileceği anlamına gelir. Daha kalıcı bir çözüm için alt tema veya Additional HTML yöntemini kullanın.

Adım 3: Kurulumu Doğrulayın

Değişikliklerinizi kaydedip önbellekleri temizledikten sonra, Moodle sitenizi 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öremiyorsunuz mu? Tüm Moodle önbelleklerini temizlediğinizden emin olun: Site administration → Development → Purge all caches bölümüne gidin. Ayrıca tarayıcı önbelleğinizi temizlemeyi veya gizli pencerede görüntülemeyi deneyin. Önbellekleme eklentisi veya ters proxy kullanıyorsanız, bu önbellekleri de temizleyin.