Built on WIX Headless

Form 위젯

자동 저장 초안, 다단계 양식, 조건부 필드, 스팸 방지, 연락처, 회원, 자동화 및 Pro pay-on-submit 등 방문자 제출물을 CMS 컬렉션으로 수집하여 Form 패널에서 모든 설정을 찾습니다.

Form 위젯은 컬렉션을 연결하고, 필드와 라벨을 선택하고, 방문자가 이미지, 동영상, Media Gallery 업로드를 포함하여 제출할 수 있도록 하는 단일 요소입니다. 긴 양식을 단계로 분할하고, 조건이 충족될 때만 필드를 표시하고, Wix 연락처를 생성하고, 사이트 회원을 등록하고, Wix Automations을 실행하세요. Pro에서는 Wix Checkout를 통해 제출 시 결제 금액을 징수하고, reCAPTCHA/허니팟/속도 제한을 사용하여 스팸을 차단하고, 연락처 라벨이나 회원 배지 및 그룹을 할당할 수 있습니다.

제출물은 컬렉션에 포함되므로 나중에 Table 또는 Repeater를 사용하여 표시할 수 있습니다. 이 페이지에 업데이트 표시를 사용하면 제출이 성공하자마자 같은 페이지의 목록이 새로 고쳐집니다. 데이터 새로 고침을 참조하세요.

비디오 튜토리얼

<아이프레임 src="https://www.youtube.com/embed/xjM8Mnon3Dk" title="CMS for Harmony에서 Form 위젯 구성" allow="가속도계; 자동 재생; 클립보드 쓰기; 암호화된 미디어; 자이로스코프; PIP(picture-in-picture); 웹 공유" 전체 화면 허용 >

YouTube에서 시청하세요⟧

사용 사례 예

  • 문의 양식 — CMS에 문의를 저장하고 Wix 연락처를 생성(또는 업데이트)합니다. 선택적으로 CRM 라벨을 할당합니다.
  • 다단계 접수 — 긴 신청서를 다음/뒤로 페이지로 분할합니다. 이전 답변이 일치하는 경우에만 추가 질문을 표시합니다.
  • 초안 접수 — 자동 저장은 회원이 제출할 때까지 컬렉션에 완료되지 않은 회원의 제출 또는 방문자의 초안을 이 브라우저에 보관합니다.
  • 회원 가입 — 제출 시 로그인 이메일과 비밀번호를 사용하여 사이트 회원을 생성합니다. 선택적으로 배지를 할당하거나 그룹에 추가할 수 있습니다.
  • 스팸 방지 섭취 — Spam & bot protection reCAPTCHA, 허니팟 필드 및 제출 속도 제한(Pro)이 포함되어 있습니다.
  • 유료 등록 — Wix Checkout(Pro)을 통해 수수료를 징수한 다음 제출 항목에 다시 주문 필드를 작성하세요.
  • 라이브 목록 — 같은 페이지에 Form + Repeater; 이 페이지에 업데이트가 표시됩니다 새 항목이 즉시 표시됩니다.

Form 구성

AI로 구축: 패널 상단에서 AI setup를 열고 필드를 설명하고 사본을 제출한 다음 Manual에서 수정하세요. 세부정보: AI setup.

  1. 추가 → Elements → Installed Apps → CMS for Harmony에서 Form을 추가합니다.
  2. 위젯을 선택 → 열기 Settings.
  3. 콘텐츠에서 컬렉션을 연결하고 필드를 선택합니다.
  4. 선택적으로 다중 페이지 양식에 대해 단계를 켭니다.
  5. 필드 설정(레이블, 입력 유형, 단계 할당, Show only when, Hidden fields) 및 제출(선택 사항인 자동 저장 포함)을 구성합니다.
  6. 선택적으로 연락처, 회원, Spam & bot protection(Pro) 및/또는 결제(Pro)를 켭니다.
  7. 라이브(또는 미리보기) 사이트에 게시하고 테스트합니다. 결제 체크아웃 및 스팸 확인은 라이브 사이트에서 실행됩니다.

내용

위치: Manual 개요 → 콘텐츠 드릴 행

어디: Settings → 콘텐츠

  1. 컬렉션을 설정합니다(Wix CMS만 해당 — Form은 외부 데이터베이스를 사용하지 않음).
  2. 방문자가 채울 필드를 선택합니다(숫자 및 URL 필드는 일치하는 입력 유형을 얻습니다. 색상은 기본 선택기를 사용하고 HEX를 저장합니다. 날짜/날짜 및 시간/시간 선택기, 이미지, 비디오 업로드, Media Gallery 다중 업로드, Reference 및 Multi-reference 필드는 연결된 컬렉션에서 로드된 검색 가능한 드롭다운을 사용합니다).
  3. 컬렉션의 만들기(삽입)가 익명 제출을 차단하는 경우 Settings에 알림이 표시되고 누가 삽입할 수 있는지를 통해 CMS 권한을 조정할 수 있습니다(또는 전체 권한 대화 상자 열기). 편집기 캔버스에는 디자인하는 동안 닫을 수 있는 배너가 표시됩니다. 목록 위젯의 디스플레이에 대한 읽기 권한과 같은 개념입니다.

Reference 필드

Reference 및 Multi-reference 수집 필드는 양식 컬렉션에 포함된 경우 필드에 표시됩니다. 필드 설정의 옵션 라벨에 대해 연결된 컬렉션에서 Display field을 선택합니다. 실시간 양식에서 방문자는 검색하고 선택합니다(한 번에 10개 항목, 스크롤 시 더 많은 항목 로드). Reference 관련 항목 ID 하나를 저장합니다. Multi-reference 제출 후 여러 링크를 저장합니다.

필터 옵션 {#filter-options}

Reference 또는 Multi-reference 필드의 경우 필드 설정에서 필터 옵션을 열어 드롭다운에 표시되는 연결된 컬렉션 항목을 제한합니다. 필드, 조건 및 Choose value을 설정합니다. Table 및 Repeater의 검색 및 필터와 동일한 고정 필터 패턴입니다. Reference / Multi-reference Choose value에서는 This Page 슬러그를 선택하여 옵션이 현재 동적 페이지 항목을 따르도록 할 수 있습니다. This Page 슬러그를 참조하세요. 모든 항목을 나열하려면 필터 없음을 선택하세요(여전히 실시간 양식에서 검색 및 추가 로드 가능).

단계

위치: Manual 개요 — 단계를 전환한 다음 행을 엽니다.

위치: Settings → 단계

  1. 다단계 양식을 켭니다.
  2. 단계를 추가하고 각 단계 제목을 설정합니다(필드 설정에서 진행률 및 섹션 헤더로 표시됨).
  3. 필드 설정에서 각 필드를 단계에 할당합니다.
  4. 편집기의 미리보기 단계를 사용하면 캔버스에서 한 번에 한 페이지씩 볼 수 있습니다.
  5. 라이브 양식에서 방문자는 다음 / 뒤로를 사용합니다. 마지막 단계에서 실행을 제출하세요. Progress는 M의 N단계를 보여줍니다.

다중 단계를 끄면 모든 필드가 한 페이지에 나타납니다(이전 동작).

필드 설정

위치: Manual 개요 → 현장 설정 드릴 행

위치: Settings → 필드 설정

각 필드에 대해 라벨, 자리 표시자, 필수 및 입력 유형을 설정합니다. 구성원이 켜져 있으면 비밀번호 및 비밀번호 확인이 실시간 양식에 표시됩니다(레이블/자리 표시자는 여기에서 편집 가능하며 비밀번호는 컬렉션에 기록되지 않습니다).

입력 유형(텍스트 필드): 텍스트, 텍스트 영역, 드롭다운, 전화, Radio buttons 및 Checkbox. 라디오 및 Checkbox는 유형 컨트롤 아래에서 맞춤 옵션을 사용합니다. Checkbox는 다중 선택 목록을 저장합니다. 부울 컬렉션 필드는 단일 켜기/끄기 확인란을 유지합니다.

단계(다단계가 켜져 있는 경우): 필드를 단계에 할당합니다. 필드는 이 섹션의 단계 헤더 아래에 그룹화되어 있습니다.

Show only when: 다른 필드가 비어 있거나, 비어 있지 않거나 선택한 값과 같을 때까지 필드를 숨깁니다. 필수는 필드가 표시되는 동안에만 적용됩니다. 편집기에서 숨겨지는 필드에는 해치 오버레이가 표시되므로 해당 필드를 계속 찾을 수 있습니다.

Hidden fields {#숨겨진 필드}

요구사항: Pro 계획.

텍스트 및 URL 수집 필드(참조 필드 또는 추가 기능 아님):

  1. 필드 설정에서 숨겨진 필드를 켭니다.
  2. 값 소스: 고정 텍스트, URL query 매개변수 또는 페이지 URL(방문자가 제출할 때 쿼리 문자열을 포함한 전체 URL)을 선택합니다.
  3. URL query 매개변수의 경우 매개변수 이름을 설정하고 선택적으로 매개변수가 누락된 경우 대체를 설정합니다.
  4. 해당 필드는 실시간 양식에서 생략되며 제출 시 자동으로 채워집니다(자동 저장 초안 포함). 필수 및 Show only when 필드가 숨겨진 동안에는 적용할 수 없습니다.
  5. 편집기에서 숨겨진 필드에는 Hidden 배지와 해치 오버레이가 표시됩니다. Pro가 없는 사이트에서는 정상적인 입력이 다시 표시되므로 제출이 계속 작동합니다.

값은 비밀이 아니며 브라우저에 표시됩니다. API 키나 비밀번호에 숨겨진 필드를 사용하지 마세요.

제출

위치: Manual 개요 → 제출 드릴 행

장소: Settings → 제출

  1. 선택적으로 편집 가능한 양식 또는 자동 저장을 켭니다. 그 중 하나만 켜질 수 있습니다.
  2. 버튼 라벨, 제출 라벨, 성공 메시지를 설정합니다.
  3. After Submit을 설정하세요. 페이지에 머물거나 성공적으로 제출한 후 탐색하세요.
  4. 동일한 컬렉션을 사용하는 동일한 페이지에서 Table, Repeater, Slideshow, Media Gallery, Calendar, Chart 및 Dynamic Page 위젯을 다시 로드하려면 이 페이지의 업데이트 디스플레이를 켭니다. 전체 참조: 데이터 새로고침.

After Submit {#제출 후}

제출에서 After Submit은 양식이 성공할 때 발생하는 상황을 제어합니다.

옵션행동
Stay on Page (기본값)성공 메시지를 표시하고 방문자를 양식에 유지합니다.
Navigate to Page제출 후 다른 URL을 엽니다.

Navigate to Page을 선택한 경우 다음으로 이동을 선택하세요.

  1. 동적 페이지 URL — 방금 생성되었거나 업데이트된 행에 대한 항목 페이지를 빌드합니다(Dynamic Page 링크와 동일한 페이지 경로 / 항목 슬러그 패턴). “제출 후 새 목록 열기”에 사용하세요.
  2. 수동으로 입력 — 고정 URL을 설정합니다(예: /thank-you 또는 절대 링크).

제출이 성공한 후 탐색이 실행됩니다(pay-on-submit 또는 Create contact / Create member가 여전히 완료된 경우 포함). 동적 페이지 URL을 확인할 수 없는 경우 양식은 페이지에 유지되고 성공 메시지를 표시합니다.

자동 저장

장소: Settings → 제출

자동 저장은 방문자가 입력한 내용을 저장합니다. 수정 가능한 양식을 켜면 자동 저장이 꺼지고 그 반대의 경우도 마찬가지입니다.

  1. 자동 저장을 켭니다.
  2. 제출된 필드(부울)를 선택합니다. 컬렉션에 아직 제출된 필드가 없는 경우 제출된 필드 추가를 사용하여 제출됨이라는 필드를 만듭니다. 해당 필드는 양식에서 벗어납니다.
  3. 회원은 자신의 항목을 읽고 업데이트해야 합니다. 해당 권한이 누락된 경우 패널에서 수정을 제공합니다.

구성원은 제출된 필드가 false로 설정된 컬렉션에 초안 항목을 저장합니다. 양식을 다시 열면 해당 초안이 다시 시작됩니다. 제출은 동일한 항목을 업데이트하고 제출된 필드를 true로 설정합니다. 완료되지 않은 초안을 숨기려면 해당 필드의 목록을 필터링하세요.

로그인하지 않은 방문자는 제출할 때까지 이 브라우저에 초안을 보관합니다. 그런 다음 제출하면 새 컬렉션 항목을 작성하고 브라우저 초안을 지웁니다.

양식에 저장 중…, 저장됨 또는 저장할 수 없음이 표시됩니다. 계속 편집하세요. 다시 시도하겠습니다. 비밀번호는 초안에 저장되지 않습니다.

연락처

위치: Settings → 연락처

  1. Create contact를 켭니다.
  2. 지도 이메일(필수) 및 옵션 슬롯: 전화번호, 이름, 성, 성명, 회사, 직위.
  3. CMS에 값을 저장하려는 경우 컬렉션 필드를 선호합니다. 컬렉션에 저장되지 않은 양식 전용 필드에는 필드(연락처) 추가를 사용하세요.
  4. 선택적 매핑을 지우려면 드롭다운 옆에 있는 X를 사용합니다. 이메일은 연락처가 켜져 있는 동안에도 필요합니다.
  5. 선택적으로 Update existing contact을 켜서 새 연락처를 만드는 대신 일치하는 이메일이 해당 연락처를 업데이트하도록 합니다.
  6. 선택적으로 Assign contact labels(Pro)를 켜고 사이트의 연락처 CRM에서 라벨을 선택하세요. 라벨은 Create contact 실행 후에 적용됩니다.

Create member가 켜져 있으면 연락처가 활성화된 상태로 유지되므로 로그인 이메일과 프로필 필드가 매핑된 상태로 유지됩니다.

회원

장소: Settings → 멤버

  1. Create member(연락처도 활성화)를 켭니다.
  2. 로그인 이메일을 설정합니다(필수).
  3. 회원/연락처에서 원하는 다른 연락처 슬롯을 매핑합니다.
  4. 선택적으로 등록 후 로그인을 켭니다.
  5. 선택적으로 Assign Badges(Pro)를 켜고 사이트 회원에게서 배지를 선택하세요.
  6. 선택적으로 Add to groups (Pro)를 켜고 Wix 그룹을 선택합니다. 배지 및 그룹은 회원이 생성되거나 로그인 이메일과 일치할 때 제출 후 적용됩니다.
  7. 라이브 사이트에 등록을 게시하고 테스트합니다.

Spam & bot protection {#spam—bot-protection}

위치: Manual 개요 → Spam & bot protection 드릴 행

위치: Settings → Spam & bot protection

요구사항: Pro 계획. Pro가 없으면 이 토글은 이전에 저장했더라도 라이브 사이트에서 꺼진 상태로 유지됩니다.

자동 제출을 줄입니다. Spam & bot protection를 열고 다음 조합을 켜십시오.

  1. reCAPTCHA 사용 — 방문자는 Google reCAPTCHA(Wix Enterprise 키)를 사용하여 자신이 인간임을 확인합니다. 토큰은 제출 시 확인되며 해당 기능이 켜져 있을 때 Create member 등록에도 적용됩니다. 표시 시기 reCAPTCHA를 선택하세요.
    • 항상 — 양식에 표시되는 챌린지입니다.
    • 의심되는 봇의 경우 — 제출 시 보이지 않는 확인; 대부분의 방문자는 도전을 보지 못합니다.
  2. 허니팟 필드 — 봇이 자주 채우는 숨겨진 트랩 필드를 추가합니다. 실제 방문자는 결코 그것을 볼 수 없습니다. 해당 필드가 채워진 제출은 거부됩니다.
  3. 제출 속도 제한 — 앱 서버의 동일한 방문자로부터 약 분당 8개의 제출로 소프트 제한됩니다.

거부되거나 속도가 제한된 제출은 양식에 짧은 오류를 표시하고 컬렉션에 저장되지 않습니다.

Wix Automations

모든 성공적인 Form 제출은 Form submit 이벤트를 Wix Automations에 보고합니다(최선의 노력, 제출물 저장을 차단하지 않음).

자동화에서 CMS for Harmony Form submit 트리거를 선택합니다. 페이로드에는 제출 ID, 컬렉션 ID, 제출 시간, 결제 보류 플래그, 필드 값의 JSON 문자열 및 연락처가 매핑된 경우 이메일, 이름, 전화번호 및 연락처 ID(사용 가능한 경우)가 포함됩니다.

Form 결제 (Pro)

위치: Settings → 결제 (Pro)

Form 결제는 카탈로그 결제(디스플레이의 Add to cart / Buy now)와 별개입니다. 여기에서 방문자는 제출 시 고정 금액 또는 입력된 금액을 지불합니다.

  1. 컬렉션을 연결한 다음 결제를 엽니다.
  2. Enable payments을 켭니다(필요한 경우 Wix Stores 설치).
  3. 항목 이름(결제 시 품목)을 설정합니다.
  4. 가격: 고정 금액 또는 방문자가 금액 입력(실시간 양식에 필수 금액 필드 추가)을 선택합니다.
  5. 결제버튼 라벨을 설정하세요.
  6. 제출에 저장에서 주문 ID, 결제 총액 및 결제 상태를 매핑합니다. 결제가 성공하면 체크아웃 후 채워집니다.
  7. 라이브 사이트에 게시하고 테스트하세요.

Pro가 없으면 결제 토글이 꺼진 상태로 유지되고 패널에 업그레이드 메시지가 표시됩니다.

디자인

장소: Settings → 디자인

필드 간격, 모서리 반경, 배경, 테두리, 오류 색상, 버튼 배경, 텍스트 및 버튼 텍스트를 설정합니다.

FAQ

성공적으로 제출된 후 양식을 탐색할 수 있나요?

예 — After Submit는 Stay on Page 또는 Navigate to Page(동적 페이지 URL 또는 수동 URL)일 수 있습니다. After Submit을 참조하세요.

양식에서 스팸을 차단할 수 있나요?

Pro — reCAPTCHA, 허니팟에서 예, Spam & bot protection 아래 속도 제한을 제출하세요.

양식을 통해 연락처나 회원을 만들 수 있나요?

예 — Create contact / Create member, 선택적 레이블, 배지 및 그룹이 있습니다. 연락처 및 회원을 참조하세요.