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를 추가하는 내장 기능이 있습니다:
- 관리자로 Moodle 사이트에 로그인하세요
- Site administration으로 이동하세요
- Appearance → Additional HTML로 이동하세요
- "Before BODY is closed" 섹션으로 스크롤하세요
- 텍스트 영역에 Asyntai 임베드 코드를 붙여넣으세요
- "Save changes"를 클릭하세요
팁: "Before BODY is closed"에 코드를 추가하면 닫는 </body> 태그 바로 앞에 배치됩니다. 이는 채팅 위젯의 권장 배치이며 메인 페이지 콘텐츠가 로드된 후에 로드됩니다.
대체 방법: 테마 설정 사용
많은 Moodle 테마(Boost 및 그 변형 포함)에는 사용자 정의 JavaScript를 추가하기 위한 자체 설정이 있습니다:
- Go to Site administration → Appearance → Themes
- 활성 테마(예: Boost)의 Theme settings를 클릭하세요
- "Raw SCSS", "Additional HTML" 또는 "Custom JavaScript" 섹션을 찾으세요
- JavaScript 필드가 있으면 거기에 Asyntai 임베드 코드를 붙여넣으세요
- "Save changes"를 클릭하세요
- 캐시를 삭제하세요: Site administration → Development → Purge caches
참고: 테마별 설정은 테마마다 다릅니다. 테마에 JavaScript 필드가 없으면 위의 Additional HTML 방법을 사용하세요.
대체 방법: 로컬 플러그인 만들기
더 많은 제어를 위해 간단한 로컬 플러그인을 만들 수 있습니다:
- Moodle 설치에 폴더 구조를 만드세요:
local/asyntaichatbot/ - version.php를 만드세요:
<?php
defined('MOODLE_INTERNAL') || die();
$plugin->component = 'local_asyntaichatbot';
$plugin->version = 2024010100;
$plugin->requires = 2022041900; - lib.php를 만드세요:
<?php
defined('MOODLE_INTERNAL') || die();
function local_asyntaichatbot_before_footer() {
global $PAGE;
$PAGE->requires->js_call_amd('local_asyntaichatbot/loader', 'init');
} - 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);
}
};
}); YOUR_WIDGET_ID를 실제 위젯 ID로 교체하세요- Site administration → Notifications로 이동하여 플러그인을 설치하세요
- 설치 후 캐시를 삭제하세요
중요: 로컬 플러그인 방법은 파일을 만들기 위해 명령줄 액세스가 필요합니다. 대부분의 사용자에게는 Additional HTML 방법이 더 간단하고 충분합니다.
대체 방법: 테마 푸터 템플릿 편집
테마의 푸터 템플릿을 직접 편집할 수도 있습니다:
- 테마 폴더로 이동하세요:
theme/YOUR_THEME/ - layout 파일을 찾으세요 (예:
layout/columns2.php또는templates/columns2.mustache) - 닫는
</body>태그 또는 푸터 섹션을 찾으세요 </body>바로 앞에 Asyntai 임베드 코드를 추가하세요- 파일을 저장하세요
- Moodle 캐시를 삭제하세요
중요: 테마 파일을 직접 편집하면 테마를 업데이트할 때 변경 사항이 손실될 수 있습니다. 보다 영구적인 솔루션을 위해 자식 테마나 Additional HTML 방법을 사용하세요.
3단계: 설치 확인
변경 사항을 저장하고 캐시를 삭제한 후, 새 브라우저 탭이나 시크릿 창에서 Moodle 사이트를 방문하세요. 오른쪽 하단에 채팅 위젯 버튼이 표시되어야 합니다. 클릭하여 올바르게 열리고 작동하는지 확인하세요.
위젯이 보이지 않나요? 모든 Moodle 캐시를 삭제하세요: Site administration → Development → Purge all caches로 이동하세요. 브라우저 캐시를 지우거나 시크릿 창에서 확인해 보세요. 캐시 플러그인이나 리버스 프록시를 사용하는 경우 해당 캐시도 지우세요.
Weebly