설치 후 위젯이 표시되지 않는다면 거의 대부분 다음 세 가지 중 하나가 원인입니다. 실제 운영 중인 페이지에 코드 스니펫이 없거나, 페이지가 캐시되어 있거나, 콘텐츠 보안 정책(CSP)이 스크립트를 차단하고 있는 경우입니다.
실제 운영 중인 페이지에 스니펫이 있는지 확인하기
게시된 사이트를 열고 페이지 소스에서 accessibird를 검색하세요. 검색 결과가 없다면 변경 사항이 저장되지 않았거나 배포되지 않은 것입니다. CMS에서 다시 게시하거나 코드 변경 사항을 다시 배포하세요.
캐시를 우회하기
브라우저와 CDN은 HTML과 스크립트를 적극적으로 캐시합니다. Ctrl+Shift+R(Mac에서는 Cmd+Shift+R)로 강력 새로고침을 실행하세요. Cloudflare 같은 CDN을 사용한다면 해당 페이지의 캐시도 삭제하세요.
콘텐츠 보안 정책 확인하기
사이트에서 엄격한 Content-Security-Policy 헤더를 전송한다면 script-src와 connect-src에 accessibird.com을 허용해야 할 수 있습니다. 브라우저 콘솔을 열어 보세요. 스크립트가 차단되면 콘솔에 명확하게 표시되며, 정책의 허용 범위를 넓히면 해결할 수 있습니다.
테스트 페이지에서 확인하기
대시보드의 위젯 테스트 페이지는 다른 요소의 영향을 받지 않는 환경에서 위젯을 로드합니다. 여기서는 작동하지만 사이트에서는 작동하지 않는다면 Accessibird가 아니라 사이트 쪽에 문제가 있는 것입니다.
실제 운영 중인 사이트에서 로드하기
위젯 요청은 반드시 회원님의 웹사이트에서 직접 전송되어야 합니다. Localhost와 미리보기 주소는 "활성" 또는 "확인됨" 상태 판정에 반영되지 않으므로 실제 운영 중인 사이트에서 확인하세요.