WordPress
- 블록 편집기에서
/html을 입력하고 ‘사용자 정의 HTML’ 블록을 고르세요. - 코드를 붙여넣은 다음 페이지를 업데이트하거나 발행하세요.
클래식 편집기에서는 ‘텍스트’ 탭에 붙여넣으세요. WordPress는 필터링되지 않은 HTML을 올릴 권한이 있는 사용자(보통 관리자와 편집자)의 임베드 코드만 유지합니다. WordPress.com에서는 호스팅 기능을 켠 유료 요금제가 필요합니다.
항목을 입력하고, 방문자가 룰렛을 어떻게 쓸지 고른 다음, 코드 조각 하나만 복사하세요. HTML을 넣을 수 있는 https 페이지라면 어디서든 작동하며, 계정, 플러그인, 비용이 필요 없습니다.
서버에서 룰렛을 만들려면 ChoiceSpin 개발자 API로 룰렛을 저장하고, 바로 돌릴 수 있는 링크를 만들고, 임베드한 룰렛의 회전을 제어하세요.
이 코드를 HTML 블록이나 임베드 블록에 붙여넣으세요. 룰렛 크기가 페이지에 맞게 조정됩니다.
항목은 저희 서버가 아니라 코드 안에 저장됩니다. 페이지 소스를 볼 수 있는 사람은 누구나 항목을 읽을 수 있으니, 공개하면 안 되는 이름, 비밀번호, 계정 정보는 넣지 마세요.
세 단계만 거치면 페이지에 룰렛이 올라갑니다. 언제든 다시 와서 바꿀 수 있습니다.
위에 항목을 한 줄에 하나씩 2개에서 100개까지 입력하세요. 조작 방식, 색상, 회전 시간을 고르세요.
미리보기에서는 방문자가 쓰게 될 룰렛이 그대로 작동하므로, 여기서 테스트로 돌려 보면 내 페이지에서 어떻게 움직일지 알 수 있습니다.
코드 조각을 페이지의 HTML 블록이나 임베드 블록에 붙여넣은 다음, 평소처럼 페이지를 게시하세요.
대부분의 사이트 빌더에는 HTML이나 임베드 코드용 블록이 있지만, 부르는 이름은 서비스마다 다릅니다. 직접 작성하는 페이지라면 <body> 안에서 룰렛이 나타날 위치에 코드 조각을 붙여넣으세요. 따로 추가할 script 태그, 스타일시트, API 키는 없습니다.
/html을 입력하고 ‘사용자 정의 HTML’ 블록을 고르세요.클래식 편집기에서는 ‘텍스트’ 탭에 붙여넣으세요. WordPress는 필터링되지 않은 HTML을 올릴 권한이 있는 사용자(보통 관리자와 편집자)의 임베드 코드만 유지합니다. WordPress.com에서는 호스팅 기능을 켠 유료 요금제가 필요합니다.
Wix Studio에서는 Add Elements에서 Embed & Social, Embed Code 순서로 들어가면 같은 요소가 있습니다.
임베드 코드는 Core, Plus, Advanced 요금제와 이전 Business, Commerce 요금제에서 작동하며, Basic 요금제에서는 작동하지 않습니다. 로그인한 상태에서 룰렛이 보이지 않으면 Preview in Safe Mode로 페이지를 확인하세요.
Code Embed를 쓰려면 유료 Workspace 요금제나 Site 요금제가 필요합니다.
룰렛을 테마 섹션에 넣으려면 Edit theme을 열고 Add section을 클릭한 다음 Custom Liquid를 선택하세요.
/embed를 입력하고 Embed link를 선택한 다음 링크를 붙여넣으세요.Notion은 링크만 받으므로 임베드 코드를 붙여넣어도 작동하지 않습니다.
학교에서 Canvas의 콘텐츠 보안 정책을 켜 두었다면, 관리자가 허용 도메인에 choicespin.com을 추가해야 할 수 있습니다.
포럼 게시글에서는 임베드 코드가 제거되며, Content cleaning everywhere가 켜진 사이트에서는 모든 영역에서 제거됩니다.
요금제에서 임베드 코드가 제거되거나 도구가 링크만 받는다면, 위의 출력 형식을 ‘직접 링크’로 바꾸세요. 링크나 버튼으로 붙여넣으면 같은 룰렛이 별도 페이지에서 열립니다.
프레젠테이션 앱에서는 임베드 코드가 실행되지 않으므로 링크를 쓰는 방법이 가장 확실합니다. 슬라이드쇼 중에 한 번 클릭하면 브라우저 탭에 룰렛이 열리고 바로 돌릴 수 있습니다.
슬라이드에서 텍스트를 선택하고 삽입 메뉴에서 링크(Ctrl+K, Mac에서는 ⌘+K)를 선택한 다음 직접 링크를 붙여넣으세요. 프레젠테이션 중에 링크를 클릭해 룰렛을 열고 돌린 뒤 다시 슬라이드로 돌아가면 됩니다.
텍스트나 도형을 선택하고 Ctrl+K(Mac에서는 ⌘+K)를 누른 다음 직접 링크를 붙여넣으세요. 슬라이드쇼 중에 링크를 클릭하면 브라우저에서 룰렛이 열립니다. Microsoft는 무료 Web Viewer 추가 기능을 2024년 12월에 종료했습니다. 다른 회사의 유료 추가 기능으로 슬라이드 안에 웹페이지를 표시할 수 있지만, 저희는 테스트해 보지 않았습니다.
코드는 콘텐츠 영역을 최대 760픽셀 너비까지 채우며, 높이는 너비에 맞춰 정해집니다.
첫 줄에 있는 max-width:760px 값을 480px처럼 더 작은 너비로 바꾸세요. 룰렛도 함께 작아지고 가운데 정렬이 유지됩니다.
min-height 값은 좁은 화면에서 프레임이 너무 낮아지지 않게 막아 줍니다. 기본 룰렛은 460픽셀, 돌리기 버튼이 있으면 560픽셀, 방문자가 편집할 수 있으면 760픽셀입니다. 이 값은 지우지 마세요.
Wix, Google Sites 같은 빌더에서는 코드가 크기를 조절할 수 있는 상자 안에 들어갑니다. 스크롤 막대 없이 룰렛 전체와 출처 표시 줄이 다 보일 때까지 상자를 끌어 늘리세요.
임베드 룰렛은 ChoiceSpin과 같은 룰렛을 별도 프레임 안에서 실행합니다.
돌릴 때마다 모든 항목이 같은 확률을 가집니다. 최신 브라우저에서는 Web Crypto 난수로 당첨 항목을 고릅니다. 룰렛이 고르는 방식을 확인해 보세요.
방문자는 룰렛에 포커스를 맞추고 스페이스 바나 Enter 키를 눌러 돌릴 수 있습니다. 결과가 나올 때마다 스크린 리더가 읽어 줍니다.
프레임이 샌드박스로 격리되어 있어 쿠키를 설정하거나 브라우저에 아무것도 저장할 수 없습니다. 광고도 분석 도구도 불러오지 않습니다.
코드는 방문자가 룰렛 근처까지 스크롤했을 때만 룰렛을 불러오도록 브라우저에 요청하므로, 페이지 윗부분은 빠르게 유지됩니다.
복사한 코드는 그대로도 작동합니다. 페이지 코드를 직접 작성한다면 프레임의 샌드박스를 느슨하게 하지 않고도 window 메시지로 회전을 시작하고, 항목을 바꾸고, 당첨 항목을 받아 볼 수 있습니다.
페이지에 <button id="spin-from-page" type="button" disabled>Spin</button> 버튼을 추가하고 이 스크립트를 임베드 코드 뒤에 넣으세요. 룰렛은 ready 메시지를 보내기 전까지 명령을 무시하므로, 그때까지 버튼은 비활성 상태로 남아 있습니다.
const frame = document.querySelector('iframe[src^="https://choicespin.com/e"]');
const spinButton = document.querySelector("#spin-from-page");
// Every message carries the same channel and version.
function send(action, extra = {}) {
frame.contentWindow.postMessage(
{ channel: "choicespin.embed", version: 1, action, ...extra },
"*"
);
}
window.addEventListener("message", (event) => {
if (event.source !== frame.contentWindow || event.origin !== "null") return;
const data = event.data;
if (data?.channel !== "choicespin.embed" || data?.version !== 1) return;
if (data.event === "ready") spinButton.disabled = false;
if (data.event === "spin-end") console.log("Winner:", data.winner);
});
spinButton.addEventListener("click", () => send("spin"));
spin: 회전을 시작합니다setEntries: 문자열 2개에서 100개로 된 entries 배열로 항목을 바꿉니다addEntry: entry 문자열 하나를 추가합니다removeWinner: 가장 최근 당첨 항목을 삭제합니다reset: 코드에 있는 항목으로 되돌립니다ready, spin-start, winner와 index를 담은 spin-end, entries-changed, error. 각 이벤트는 현재 항목 수를 나타내는 count 값도 함께 보냅니다.
메시지를 보낼 때는 target에 "*" 값을 지정하세요. 샌드박스 프레임에는 지정할 수 있는 origin이 없기 때문입니다. 그래도 메시지는 그 프레임 하나에만 전달됩니다. 돌아오는 메시지의 origin은 "null" 값으로 나오므로, event.source도 그 프레임의 window일 때만 신뢰하세요. 룰렛은 자신을 임베드한 페이지의 메시지만 듣고, 형식이 잘못된 명령에는 error 이벤트로 응답합니다. 생성된 sandbox 속성과 referrerpolicy 속성은 그대로 두세요. 일반 명령에는 referrer에서 알아낸 부모 페이지의 origin이 필요합니다. 새로고침으로 그 referrer가 사라지면, 선택 사항인 개발자 도우미가 실제 HTTPS 부모 페이지와 검증된 핸드셰이크를 거쳐 다시 연결할 수 있습니다.
대부분의 문제는 코드를 붙여넣은 위치 때문에 생깁니다. 먼저 아래 내용을 확인하세요.
일반 텍스트 블록에 붙여넣은 경우입니다. 지운 다음 HTML 블록, 코드 블록, 임베드 블록 중 하나에 다시 붙여넣으세요.
룰렛은 https로 제공되는 페이지에서만 불러와집니다. 페이지 주소가 http로 시작하거나 요금제에서 임베드 코드가 제거된다면, 출력 형식을 ‘직접 링크’로 바꿔 링크로 연결하세요.
임베드 상자의 높이가 너무 낮은 경우입니다. 룰렛, 버튼, 출처 표시 줄이 모두 보일 때까지 상자를 아래로 늘리세요. 프레임만으로도 최소 460픽셀이 필요하고, 돌리기 버튼이 있으면 560픽셀, 방문자가 편집할 수 있으면 760픽셀이 필요합니다. 출처 표시 줄은 약 30픽셀을 더 차지합니다.
‘종료 효과음 재생’이 체크되어 있는지 확인하세요. 브라우저는 방문자가 프레임 안을 클릭하거나 키를 누른 뒤에만 소리를 허용하므로, 그 전에 내 코드로 시작한 회전에서는 소리가 나지 않습니다.
공개 페이지에 룰렛을 넣기 전에 알아 두면 좋은 짧은 답변입니다.
네. 비용이 들지 않고 가입도 필요 없으며, 같은 코드를 원하는 만큼 여러 페이지에 넣을 수 있습니다.
이 빌더로 만든 룰렛이라면 여기서 새 버전을 만들고 페이지의 기존 코드를 바꿔 넣으세요. 항목이 코드 안에 저장되어 있어서 따로 업데이트할 계정이나 저장본이 없습니다. 서버에서 API로 만든 룰렛은 저장된 기록이 따로 있습니다.
자기 사본만 바꿀 수 있습니다. ‘방문자 편집 허용’을 켜면 방문자가 새 항목을 입력할 수 있고, ‘당첨 항목 삭제’ 버튼이나 ‘당첨될 때마다 삭제’로 당첨 항목을 뺄 수 있습니다. 방문자가 바꾼 내용은 원래 룰렛이나 다른 사람의 사본에 영향을 주지 않으며, 새로고침하면 원래 항목으로 돌아옵니다.
아니요. 룰렛은 샌드박스 프레임 안에서 실행되므로 쿠키를 설정하거나 브라우저에 아무것도 저장할 수 없고, 광고나 분석 도구도 불러오지 않습니다. 빌더로 만든 룰렛은 항목이 코드에 들어 있어서 페이지 소스를 보는 사람은 누구나 항목을 읽을 수 있습니다. API로 만든 스냅샷은 서버에 저장되며 링크가 있는 사람은 누구나 볼 수 있습니다.
항목은 2개에서 100개까지, 항목당 최대 80자까지 넣을 수 있습니다. 항목이 링크 안에 담기기 때문에 모두 합쳐 약 3,900자까지 쓸 수 있으며, 일본어 같은 문자를 쓰면 이보다 적어집니다. 더 긴 목록이나 가중치, 결과 저장이 필요하다면 항목을 최대 2,000개까지 넣을 수 있는 ChoiceSpin 전체 기능 룰렛을 사용하세요.
네. 콘텐츠 영역의 너비를 꽉 채우고 높이가 460픽셀보다 낮아지지 않으므로 작은 화면에서도 글자를 읽을 수 있습니다. 방문자는 탭해서 룰렛을 돌립니다.
네. 코드를 복사하기 전에 ‘ChoiceSpin 출처 표시’ 체크를 해제하거나, 복사한 뒤 코드에서 출처 표시 줄을 지우세요. 어느 쪽이든 룰렛은 똑같이 작동합니다.
아니요. 룰렛만 있는 페이지에는 noindex가 설정되어 있어 검색 결과에 나오지 않습니다. 내 페이지의 검색 노출은 그 페이지의 콘텐츠와 설정에 따라 달라집니다.
전체 기능 룰렛에는 항목을 최대 2,000개까지 넣을 수 있고, 가중치, 이미지, 룰렛 저장, 결과 기록도 쓸 수 있습니다. 선생님이라면 교사용 가이드에서 수업 아이디어를 찾아보세요.