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

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

임베드 코드 받기

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

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

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

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

2단계: 푸터 템플릿 편집 (권장)

챗봇을 추가하는 가장 간단한 방법은 테마의 푸터 템플릿을 편집하는 것입니다:

  1. FTP 또는 파일 관리자를 통해 OpenCart 파일에 접근합니다
  2. 테마의 푸터 템플릿으로 이동합니다:
    • OpenCart 3.x/4.x: catalog/view/theme/YOUR_THEME/template/common/footer.twig
    • OpenCart 2.x: catalog/view/theme/YOUR_THEME/template/common/footer.tpl
  3. 푸터 파일을 편집을 위해 엽니다
  4. 닫는 </body> 태그를 찾으세요
  5. </body> 태그 바로 앞에 Asyntai 삽입 코드를 붙여넣으세요
  6. 파일을 저장하세요
  7. OpenCart 캐시 지우기: Dashboard → 파란색 톱니바퀴 아이콘 (오른쪽 상단) → Refresh 또는 system/storage/cache/ 내용을 삭제합니다

팁: 기본 테마를 사용하는 경우 경로는 catalog/view/theme/default/template/common/footer.twig입니다. 템플릿 파일을 편집하기 전에 항상 백업을 만드세요.

대안: 테마의 커스텀 코드 옵션 사용

많은 최신 OpenCart 테마에는 커스텀 코드를 위한 내장 옵션이 있습니다:

  1. OpenCart 관리자 패널에 로그인합니다
  2. Extensions → Themes (또는 Extensions → Extensions → Themes)로 이동합니다
  3. 활성 테마에서 Edit을 클릭합니다
  4. "Custom Code", "Footer Scripts" 또는 "Custom JavaScript" 섹션을 찾습니다
  5. Asyntai 임베드 코드를 붙여넣으세요
  6. "Save"를 클릭하세요
  7. 캐시를 지웁니다

참고: 모든 테마에 이 옵션이 있는 것은 아닙니다. 테마에 커스텀 코드 필드가 없는 경우 템플릿 편집 방법을 사용하거나 확장 기능을 설치하세요.

대안: 커스텀 코드 확장 기능 사용

OpenCart 마켓플레이스에서 무료 확장 기능을 설치하여 커스텀 스크립트를 추가할 수 있습니다:

  1. OpenCart 마켓플레이스로 이동하십시오
  2. "Custom Script", "Header Footer Scripts" 또는 "Custom Code"를 검색합니다
  3. 적합한 확장 기능을 다운로드하고 설치합니다
  4. 관리자 패널에서 Extensions → Extensions → Modules로 이동합니다
  5. 커스텀 코드 모듈을 찾아 설치합니다
  6. 모듈을 구성하고 푸터 섹션에 Asyntai 임베드 코드를 붙여넣습니다
  7. 저장하고 캐시를 지웁니다

중요: 확장 기능 사용은 핵심 파일을 편집하는 것보다 권장됩니다. OpenCart 업데이트 시에도 유지되기 때문입니다. 마켓플레이스에서 제공되는 "Custom Script in Header & Footer" 등의 인기 확장 기능이 있습니다.

대안: addScript 메서드 사용 (개발자용)

개발자의 경우, OpenCart 3.x/4.x는 프로그래밍 방식으로 스크립트를 추가할 수 있는 방법을 제공합니다:

  1. catalog/controller/common/footer.php를 엽니다
  2. $data['scripts'] = $this->document->getScripts('footer'); 앞에 다음 줄을 추가합니다:
    $this->document->addScript('https://asyntai.com/static/js/chat-widget.js', 'footer');
  3. data 속성의 경우, footer.twig를 수정하여 수동으로 포함하거나 스크립트 루프 후에 인라인 JavaScript를 추가해야 합니다

참고: data 속성과 함께 위젯이 올바르게 작동하려면 addScript 메서드가 커스텀 속성을 직접 지원하지 않으므로 템플릿 방법이 더 간단합니다.

3단계: 설치 확인

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

위젯이 보이지 않나요? OpenCart 캐시를 지우세요. 관리자 패널에서 오른쪽 상단의 파란색 톱니바퀴 아이콘을 클릭하고 새로고침 버튼을 클릭합니다. 또한 브라우저 캐시를 지우거나 시크릿 창에서 확인해 보세요. 잘못된 템플릿 파일을 수정한 경우, 테마가 편집한 파일을 사용하고 있는지 확인하세요.