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

Concrete CMS(이전 Concrete5) 웹사이트를 위한 단계별 가이드

임베드 코드 받기

플랫폼:

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

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

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

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

2단계: 테마 푸터에 코드 추가 (권장)

Concrete CMS 웹사이트의 모든 페이지에 챗봇을 추가하는 가장 좋은 방법은 테마의 푸터 파일을 편집하는 것입니다:

FTP 또는 파일 관리자를 통해 Concrete CMS 설치에 접속하세요
/application/themes/your_theme_name/ 디렉토리로 이동하세요
footer.php 파일(또는 동등한 푸터 템플릿)을 찾아서 여세요
닫는 </body> 태그가 있는 줄을 찾으세요
</body> 태그 바로 앞에 Asyntai 삽입 코드를 붙여넣으세요
파일을 저장하고, 로컬에서 편집하는 경우 서버에 다시 업로드하세요
Concrete CMS 캐시 지우기: Dashboard → System & Settings → Clear Cache

팁: 닫는 </body> 태그 앞에 코드를 추가하면 페이지 콘텐츠 이후에 챗봇이 로드되어 더 나은 페이지 로딩 성능을 제공합니다. 이 방법은 이 테마를 사용하는 모든 페이지에 자동으로 챗봇을 추가합니다.

대체 방법 1: HTML 블록 (비개발자에게 가장 쉬움)

테마 파일을 편집하지 않으려면 Concrete CMS의 기본 HTML 블록을 사용할 수 있습니다:

Concrete CMS 대시보드에 로그인하세요
챗봇을 추가할 페이지로 이동하세요
도구 모음에서 Edit Page(연필 아이콘)를 클릭하세요
코드를 배치할 영역에서 Add Block을 클릭하세요
HTML 블록을 검색하여 선택하세요
HTML 편집기에 Asyntai 삽입 코드를 붙여넣으세요
Add를 클릭하여 블록을 저장하세요
Publish를 클릭하여 변경 사항을 적용하세요

참고: HTML 블록 방법은 특정 페이지에 챗봇을 추가하는 데 적합합니다. 사이트 전체 설치에는 각 페이지에 HTML 블록을 추가하거나 위에서 설명한 테마 푸터 방법을 사용해야 합니다. 블록의 시각적 배치는 챗봇이 표시되는 위치에 영향을 미치지 않으며, 여전히 오른쪽 하단에 표시됩니다.

대체 방법 2: 테마 헤더 파일

사이트 전체 설치를 위해 테마의 헤더 파일에 코드를 추가할 수도 있습니다:

FTP 또는 파일 관리자를 통해 Concrete CMS 파일에 접속하세요
/application/themes/your_theme_name/으로 이동하세요
header.php 파일(또는 elements/header.php)을 여세요
닫는 </head> 태그를 찾으세요
</head> 태그 바로 앞에 Asyntai 삽입 코드를 붙여넣으세요
파일을 저장하고 업로드하세요
대시보드에서 캐시를 지우세요

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

팁: Concrete CMS가 올바르게 작동하려면 header.php 파일에 <?php View::element('header_required'); ?>를 사용하여 필수 헤더 요소를 포함하세요.

대체 방법 3: 커스텀 템플릿 (고급)

더 세밀한 제어를 원하는 개발자를 위해 커스텀 페이지 템플릿을 만들 수 있습니다:

/application/themes/your_theme_name/에 새 페이지 템플릿 파일을 생성하세요
또는 기존 템플릿(예: default.php)을 복사하여 이름을 변경하세요
템플릿 파일의 </body> 앞에 Asyntai 삽입 코드를 추가하세요
Concrete CMS 대시보드에서 Pages & Themes로 이동하세요
Page Types를 클릭하세요
이 템플릿을 사용할 페이지 유형을 선택하세요
커스텀 템플릿을 페이지 유형에 할당하세요
이 페이지 유형을 사용하는 모든 페이지에 이제 챗봇이 포함됩니다

중요: 변경하기 전에 항상 테마 파일을 백업하세요. 가능하면 스테이징 사이트에서 먼저 수정 사항을 테스트하세요. 테마 파일을 잘못 편집하면 사이트의 레이아웃이나 기능이 손상될 수 있습니다.

3단계: 설치 확인

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

위젯이 보이지 않나요? Concrete CMS의 캐시를 지웠는지 확인하세요 (Dashboard → System & Settings → Clear Cache). 시크릿 창에서 사이트를 확인해 보세요. 모든 파일 변경 사항을 저장하고 업로드했는지 확인하세요. 브라우저 콘솔(F12)을 열어 JavaScript 오류가 있는지 확인하세요.