e107에 Asyntai AI 챗봇을 추가하는 방법
e107 CMS 웹사이트를 위한 단계별 가이드
1단계: 임베드 코드 가져오기
먼저 Asyntai 대시보드로 이동하여 "임베드 코드" 섹션까지 아래로 스크롤하십시오. 다음과 같은 형태의 고유 임베드 코드를 복사하십시오:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
참고: 위의 코드는 예시일 뿐입니다. 개인 위젯 ID가 포함된 고유한 임베드 코드를 대시보드에서 복사해야 합니다.
2단계: 테마 템플릿에 추가 (권장)
챗봇을 추가하는 권장 방법은 e107 테마 템플릿 파일을 직접 편집하는 것입니다:
- e107 테마 폴더로 이동하세요:
e107_themes/yourtheme/ - 테마의 메인 템플릿 파일을 여세요 (보통 theme.php 또는 theme.html)
- 닫는
</body>태그를 찾으세요 </body>태그 바로 앞에 Asyntai 삽입 코드를 붙여넣으세요:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
</body>
팁: 테마가 theme.php를 사용하는 경우 푸터 HTML이 렌더링되는 섹션을 찾으세요. 임베드 코드는 모든 다른 콘텐츠 뒤에, 닫는 body 태그 앞에 배치해야 합니다.
대안 방법 1: e107 사용자 정의 머리글/바닥글 사용
테마 파일을 편집하지 않고 e107 관리자 패널을 통해 챗봇 스크립트를 추가할 수 있습니다:
- e107 관리자 패널에 로그인하세요
- Admin > Preferences > Site Preferences로 이동하세요
- "Custom Footer" 또는 "Footer Scripts" 섹션을 찾으세요
- 푸터 스크립트 텍스트 영역에 Asyntai 임베드 코드를 붙여넣으세요
- "Save"를 클릭하여 변경 사항을 적용하세요
참고: 테마 파일을 직접 편집하지 않으려는 경우 이 방법이 가장 쉽습니다. 스크립트가 e107 사이트의 모든 페이지에 자동으로 포함됩니다.
대안 방법 2: e107 플러그인 사용
보다 모듈화된 접근 방식으로 간단한 플러그인을 만들거나 플러그인 훅 시스템을 사용하여 챗봇 스크립트를 삽입할 수 있습니다:
- 간단한 플러그인을 만들거나 "Custom Pages" 플러그인을 사용하세요
- 플러그인 디렉토리에 e_footer.php 파일을 생성하여 e107의 플러그인 훅 시스템을 통해 스크립트를 추가하세요
- e_footer.php 내부에서 임베드 코드를 출력하세요:
<?php
// e_footer.php - Asyntai Chatbot Plugin Hook
echo '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
?>
팁: 플러그인 훅 방식은 챗봇 통합을 테마와 분리하여 유지하므로 테마를 변경해도 유지됩니다.
대안 방법 3: e107 메뉴 시스템 사용
e107의 내장 메뉴 시스템을 사용하여 푸터 영역에 챗봇 스크립트를 추가할 수 있습니다:
- e107 관리자 패널에 로그인하세요
- Admin > Menus로 이동하세요
- 사용자 정의 HTML 메뉴를 생성하세요
- 메뉴 콘텐츠에 Asyntai 임베드 코드를 붙여넣으세요
- 메뉴를 템플릿의 푸터 영역에 할당하세요
- 메뉴 구성을 저장하세요
중요: 메뉴 시스템을 사용할 때 할당하는 메뉴 영역이 원시 HTML/스크립트 출력을 지원하는지 확인하세요. 일부 메뉴 영역은 보안을 위해 스크립트 태그를 제거할 수 있습니다. 스크립트가 제거되면 다른 방법 중 하나를 사용하세요.
3단계: 설치 확인
변경 사항을 저장한 후 새 브라우저 탭이나 시크릿 창에서 e107 웹사이트를 방문하세요. 오른쪽 하단에 채팅 위젯 버튼이 보여야 합니다. 클릭하여 올바르게 열리고 작동하는지 확인하세요.
위젯이 보이지 않나요? Admin > Cache에서 e107 캐시를 지워보십시오. 브라우저 캐시도 지워보십시오. 임베드 코드가 올바르게 배치되어 있고 대시보드의 고유한 위젯 ID가 포함되어 있는지 확인하십시오.
Weebly