사이트별 위젯 설정
설정은 사이트 단위로 저장됩니다. 한 계정에 여러 사이트가 있어도 서로 영향을 주지 않습니다.
패널과 실행 버튼
패널 제목·설명·폭·테마를 정하고, 실행 버튼의 위치·크기·모양·색상과 접근성 이름을 지정합니다. 오른쪽 미리보기는 입력하는 즉시 반영되므로 저장 전에 배치를 확인할 수 있습니다.
접근성 이름은 화면 낭독기가 실행 버튼을 읽을 때 쓰는 문장입니다. “접근성 도구”처럼 기능을 알 수 있는 이름을 쓰고, “버튼”·“클릭” 같은 말은 넣지 않습니다.
제공할 도구 선택
사이트 성격에 맞는 도구만 켭니다. 도구가 많을수록 패널이 길어져 오히려 찾기 어려워집니다. 글자 크기·줄 간격·고대비는 대부분의 사이트에서 먼저 켜는 항목입니다.
설정 화면의 도구 목록과 실제 화면 보정 동작은 같은 계약을 씁니다. 저장한 설정은 사이트에 설치된 위젯에 그대로 적용됩니다.
허용 Origin
Origin은 프로토콜 + 호스트 + 포트 조합입니다. 설정 API는 등록된 Origin과 정확히 일치하는 요청에만 응답하므로, 개발 주소와 운영 주소가 다르면 각각 등록해야 합니다.
https://example.kr와https://www.example.kr는 서로 다릅니다.- 경로 단위 허용(
/sub/)과 와일드카드는 지원하지 않습니다. - Origin을 모두 지우면 위젯이 어떤 페이지에서도 설정을 받지 못합니다.
허용 Origin은 보안 경계라서 위젯 디자인 저장과 분리된 화면에서 관리하고, 변경도 리비전으로 남습니다.
저장과 리비전 복원
저장하면 현재 설정이 즉시 바뀌고 리비전 번호가 1 증가합니다. 변경 메모를 남기면 나중에 어떤 변경이었는지 목록에서 알아보기 쉽습니다.
이전 리비전을 복원해도 과거 이력을 덮어쓰지 않습니다. 복원 역시 새 리비전 으로 기록되므로, 복원한 뒤 다시 원래대로 되돌릴 수 있습니다.
운영 상태와 중지
운영 중 상태에서만 설정 API가 응답합니다. 잠시 위젯을 내려야 하면 삭제 대신 운영 중지를 쓰세요. 설정과 리비전이 그대로 남고 언제든 다시 시작할 수 있습니다.
사이트 삭제는 공개키·현재 설정·리비전 이력을 모두 지우며 되돌릴 수 없습니다. 삭제 화면에서 등록 도메인을 직접 입력해야 진행됩니다.
설정이 반영되지 않는 것처럼 보이면 문제 해결 문서의 캐시 항목을 먼저 확인해 주세요.