Moodle에 Asyntai AI 챗봇을 추가하는 방법

Moodle LMS 웹사이트를 위한 단계별 가이드

임베드 코드 받기

1단계: 임베드 코드 가져오기

먼저 Asyntai 대시보드로 이동하여 "임베드 코드" 섹션까지 아래로 스크롤하십시오. 다음과 같은 형태의 고유 임베드 코드를 복사하십시오:

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

참고: 위의 코드는 예시일 뿐입니다. 개인 위젯 ID가 포함된 고유한 임베드 코드를 대시보드에서 복사해야 합니다.

2단계: Additional HTML 사용 (권장)

Moodle에는 모든 페이지에 사용자 정의 HTML/JavaScript를 추가하는 내장 기능이 있습니다:

  1. 관리자로 Moodle 사이트에 로그인하세요
  2. Site administration으로 이동하세요
  3. Appearance → Additional HTML로 이동하세요
  4. "Before BODY is closed" 섹션으로 스크롤하세요
  5. 텍스트 영역에 Asyntai 임베드 코드를 붙여넣으세요
  6. "Save changes"를 클릭하세요

팁: "Before BODY is closed"에 코드를 추가하면 닫는 </body> 태그 바로 앞에 배치됩니다. 이는 채팅 위젯의 권장 배치이며 메인 페이지 콘텐츠가 로드된 후에 로드됩니다.

대체 방법: 테마 설정 사용

많은 Moodle 테마(Boost 및 그 변형 포함)에는 사용자 정의 JavaScript를 추가하기 위한 자체 설정이 있습니다:

  1. Go to Site administration → Appearance → Themes
  2. 활성 테마(예: Boost)의 Theme settings를 클릭하세요
  3. "Raw SCSS", "Additional HTML" 또는 "Custom JavaScript" 섹션을 찾으세요
  4. JavaScript 필드가 있으면 거기에 Asyntai 임베드 코드를 붙여넣으세요
  5. "Save changes"를 클릭하세요
  6. 캐시를 삭제하세요: Site administration → Development → Purge caches

참고: 테마별 설정은 테마마다 다릅니다. 테마에 JavaScript 필드가 없으면 위의 Additional HTML 방법을 사용하세요.

대체 방법: 로컬 플러그인 만들기

더 많은 제어를 위해 간단한 로컬 플러그인을 만들 수 있습니다:

  1. Moodle 설치에 폴더 구조를 만드세요: local/asyntaichatbot/
  2. version.php를 만드세요:
    <?php
    defined('MOODLE_INTERNAL') || die();
    $plugin->component = 'local_asyntaichatbot';
    $plugin->version = 2024010100;
    $plugin->requires = 2022041900;
  3. lib.php를 만드세요:
    <?php
    defined('MOODLE_INTERNAL') || die();

    function local_asyntaichatbot_before_footer() {
      global $PAGE;
      $PAGE->requires->js_call_amd('local_asyntaichatbot/loader', 'init');
    }
  4. amd/src/ 폴더와 loader.js 파일을 만드세요:
    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. YOUR_WIDGET_ID를 실제 위젯 ID로 교체하세요
  6. Site administration → Notifications로 이동하여 플러그인을 설치하세요
  7. 설치 후 캐시를 삭제하세요

중요: 로컬 플러그인 방법은 파일을 만들기 위해 명령줄 액세스가 필요합니다. 대부분의 사용자에게는 Additional HTML 방법이 더 간단하고 충분합니다.

대체 방법: 테마 푸터 템플릿 편집

테마의 푸터 템플릿을 직접 편집할 수도 있습니다:

  1. 테마 폴더로 이동하세요: theme/YOUR_THEME/
  2. layout 파일을 찾으세요 (예: layout/columns2.php 또는 templates/columns2.mustache)
  3. 닫는 </body> 태그 또는 푸터 섹션을 찾으세요
  4. </body> 바로 앞에 Asyntai 임베드 코드를 추가하세요
  5. 파일을 저장하세요
  6. Moodle 캐시를 삭제하세요

중요: 테마 파일을 직접 편집하면 테마를 업데이트할 때 변경 사항이 손실될 수 있습니다. 보다 영구적인 솔루션을 위해 자식 테마나 Additional HTML 방법을 사용하세요.

3단계: 설치 확인

변경 사항을 저장하고 캐시를 삭제한 후, 새 브라우저 탭이나 시크릿 창에서 Moodle 사이트를 방문하세요. 오른쪽 하단에 채팅 위젯 버튼이 표시되어야 합니다. 클릭하여 올바르게 열리고 작동하는지 확인하세요.

위젯이 보이지 않나요? 모든 Moodle 캐시를 삭제하세요: Site administration → Development → Purge all caches로 이동하세요. 브라우저 캐시를 지우거나 시크릿 창에서 확인해 보세요. 캐시 플러그인이나 리버스 프록시를 사용하는 경우 해당 캐시도 지우세요.