Shopify 사이트에 댓글 추가

Shopify 앱 스토어에서 설치

1. Shopify 앱 스토어의 FastComments 목록을 엽니다.
2. 앱 추가를 클릭하고 설치 과정에서 원하는 요금제를 선택합니다.
3. 설치가 완료되면 Shopify가 FastComments 관리 페이지로 리디렉션합니다.

설치는 이것으로 완료됩니다. 테마 파일에 붙여넣을 것은 없습니다.

설치 시 설정되는 항목

설치는 수동으로 하게 될 모든 작업을 자동으로 수행합니다:

• 귀하의 상점용 FastComments 테넌트가 생성되어 상점 도메인에 연결됩니다.
• 귀하 상점의 URL이 테넌트의 승인 도메인에 추가되어 도메인 오류 없이 댓글이 로드됩니다.
• 모든 블록이 어떤 테넌트에 렌더링해야 하는지 알 수 있도록 fastcomments.tenant_id 샵 메타필드가 기록됩니다.
• Shopify 고객을 위한 싱글 사인온(SSO)이 기본으로 활성화됩니다.
• 청구는 Shopify 관리형 가격 정책을 통해 처리됩니다. 요금은 일반 Shopify 청구서에 표시됩니다. 업그레이드, 다운그레이드 또는 취소는 Shopify 관리자에서 설정 > 앱 및 판매 채널 > FastComments에서 가능합니다.

설치 전에 이미 귀하의 상점이 FastComments 고객이었다면, 설치는 새 테넌트를 생성하지 않고 기존 테넌트를 재사용합니다.

내장 관리자

Shopify 관리자에서 FastComments 앱을 열면 FastComments 백엔드로 원클릭 이동 가능한 타일이 있는 대시보드로 이동합니다:

• 대시보드: 계정 설정, 사용량 및 구독 세부정보.
• 검토 대기열: 상점 전반의 댓글을 승인, 거부 및 답글 작성.
• 사용자 지정: 위젯 색상, 글꼴, 검토 규칙 및 구성 조정.
• 평점 및 리뷰 도구: 리뷰 요약 블록을 사용하려면 별점 및 리뷰 질문을 설정.

각 타일은 일회용 로그인 링크로 FastComments를 열므로 별도의 로그인 정보가 필요 없습니다.

다음: 상점에 블록 추가

Shopify 테마 편집기(온라인 스토어 > 테마 > 맞춤설정)를 열고 댓글이나 리뷰를 추가하려는 템플릿을 연 다음 블록 추가를 클릭합니다. FastComments 블록은 앱 아래에 나타납니다. 이 가이드의 나머지 부분은 각 블록을 다룹니다.

FastComments 블록은 메인 댓글 위젯입니다. 블로그 포스트 템플릿, 상품 템플릿, 또는 토론 스레드나 실시간 채팅을 원하는 다른 모든 페이지에 추가하세요.

블록 추가하기

1. Shopify 테마 편집기를 엽니다 (온라인 스토어 > 테마 > 사용자 지정).
2. 댓글을 달고 싶은 템플릿을 선택합니다: 블로그 포스트, 상품, 또는 다른 페이지나 섹션 템플릿.
3. 댓글이 표시되길 원하는 섹션에서 블록 추가를 클릭합니다.
4. 앱 아래에서 FastComments를 선택합니다.
5. 저장을 클릭합니다.

블록이 즉시 나타납니다. 입력할 Tenant ID가 없습니다; 앱을 설치할 때 스토어의 테넌트가 자동으로 연결됩니다.

설정

페이지 식별자가 선택되는 방식

각 댓글 스레드는 URL ID로 구분됩니다. 블록은 자동으로 하나를 선택합니다:

• 블로그 포스트 템플릿: shopify-article-{article.id}, 슬러그와 제목 변경에도 안정적입니다.
• 상품 템플릿: shopify-product-{product.id}, 슬러그와 제목 변경에도 안정적입니다.
• 기타 템플릿: 요청 경로.

Custom URL ID를 설정하면 해당 값이 대신 사용됩니다. 여러 블록에서 동일한 Custom URL ID를 사용하여(예: 상품 페이지의 현지화된 변형에서) 하나의 댓글 스레드를 공유하세요.

Threaded vs Streaming

Threaded가 기본값입니다. 방문자가 서로 답글을 달고, 투표하며, 조정 도구가 예상대로 작동합니다. 블로그 포스트와 상품 리뷰에 가장 적합합니다.

Streaming은 스레딩을 제거하고 새 댓글이 게시되는 대로 실시간으로 표시하여 채팅 피드처럼 보입니다. 상품 출시, 라이브 이벤트, 커뮤니티 페이지에 가장 적합합니다.

같은 페이지에 여러 블록

블록은 동일한 템플릿에 두 번 이상 추가할 수 있습니다. 예를 들어, 상품 페이지 상단에 리뷰 요약을, 하단에 FastComments 블록을 배치할 수 있습니다. 블록들이 URL ID를 공유하므로 요약이 아래의 댓글을 반영합니다.

팁

• 블록은 테넌트를 찾지 못하면 테마 편집기 미리보기에서 노란색 알림과 함께 자신을 숨깁니다. 라이브 스토어에서 이것이 나타나면 FastComments 앱을 다시 설치하세요.
• 상품 페이지의 경우, FastComments 블록은 상품 리뷰 위젯 역할도 합니다. 페이지 상단에 별점 요약을 위해 FastComments - Reviews Summary와 함께 사용하세요.

FastComments - Comment Count 블록은 단일 페이지에 대한 작은 댓글 수를 표시합니다. 블로그 포스트 목록, 제품 카드 또는 댓글이 있는 페이지로 연결되는 모든 템플릿에 사용하여 방문자가 클릭하기 전에 각 스레드의 활성화 정도를 확인할 수 있습니다.

블록 추가하기

1. Shopify 테마 편집기를 엽니다.
2. 댓글 수를 표시하려는 템플릿을 엽니다. 예를 들어 Blog 템플릿(포스트 목록) 또는 제품 목록 섹션입니다.
3. 각 항목을 렌더링하는 섹션에서 Add block을 클릭합니다.
4. Apps에서 FastComments - Comment Count를 선택합니다.
5. Save를 클릭합니다.

설정

댓글 수와 댓글 스레드의 일치 방식

Comment Count 블록은 FastComments 블록과 동일한 자동 감지 로직을 사용합니다:

• 블로그 포스트 템플릿: shopify-article-{article.id}
• 제품 템플릿: shopify-product-{product.id}
• 기타 템플릿: 요청 경로

페이지의 FastComments 블록에 Custom URL ID를 설정한 경우, Comment Count 블록에도 동일한 Custom URL ID를 설정하여 동일한 스레드를 가리키도록 하세요.

팁

• 페이지의 모든 항목에 대한 댓글 수는 하나의 요청으로 가져오므로, 긴 목록의 모든 항목에 블록을 추가해도 추가 왕복 비용이 발생하지 않습니다.
• 목록의 각 아티클 또는 제품당 하나의 Comment Count 블록이 예상되는 사용 방식입니다. 블록은 필요한 만큼 여러 번 추가할 수 있습니다.

The FastComments - Recent Comments 블록은 스토어 전체에서 최근 댓글을 보여줍니다. 사이드바, 푸터 또는 홈페이지 섹션에 최신 활동을 표시하는 데 사용하세요.

블록 추가

1. Shopify 테마 편집기를 엽니다.
2. 피드를 표시할 템플릿을 엽니다. 사이드바 섹션, 홈페이지 또는 블로그 인덱스가 적합합니다.
3. 해당 섹션에서 Add block을 클릭합니다.
4. Apps 아래에서 FastComments - Recent Comments를 선택합니다.
5. Save를 클릭합니다.

설정

팁

• 각 댓글은 작성된 페이지로 링크되므로, 이 블록은 "사람들이 지금 무엇에 대해 이야기하고 있는지"를 안내해 주는 내비게이션 힌트 역할도 합니다.
• 피드는 스토어 전체에 적용됩니다. 단일 페이지의 최근 댓글만 표시하려면 해당 페이지에서 FastComments 블록을 사용하세요.

The FastComments - 최근 토론 블록은 스토어에서 최근 댓글 활동이 가장 활발한 페이지들을 페이지당 한 항목씩 나열합니다. 개별 댓글보다 활성 스레드를 방문자에게 노출하고 싶을 때 사용하세요.

블록 추가

1. Shopify 테마 편집기를 엽니다.
2. 피드가 들어갈 템플릿을 엽니다(예: 사이드바, 푸터, 블로그 인덱스 또는 홈페이지 섹션).
3. 해당 섹션에서 블록 추가를 클릭합니다.
4. 앱에서 FastComments - 최근 토론을 선택합니다.
5. 저장을 클릭합니다.

설정

최근 토론 vs 최근 댓글

두 블록은 동일한 데이터를 가져오지만 서로 다른 뷰를 표시합니다:

• 최근 댓글: 최신 개별 댓글들의 평면 목록입니다. "방금 무슨 말이 있었나"를 보여주기에 적합합니다.
• 최근 토론: 페이지당 한 항목씩, 가장 최근 활동 순으로 정렬됩니다. "지금 어떤 스레드가 활발한가"를 보여주기에 적합합니다.

동일한 스토어에서 둘 다 사용할 수 있습니다. 예를 들어 블로그 사이드바에 최근 댓글을, 홈페이지에는 최근 토론을 배치할 수 있습니다.

The FastComments - Top Pages 블록은 상점에서 전체적으로 댓글 활동이 가장 많은 페이지들을 나열합니다. 가장 많이 논의된 게시물 또는 상품을 노출하는 데 사용하세요.

블록 추가

1. Shopify 테마 편집기를 엽니다.
2. 사이드바, 푸터 또는 블로그 인덱스 섹션 등 목록을 표시할 템플릿을 엽니다.
3. 해당 섹션에서 Add block을 클릭합니다.
4. Apps 아래에서 FastComments - Top Pages를 선택합니다.
5. Save를 클릭합니다.

설정

Top Pages vs Recent Discussions

• Top Pages는 총 참여도를 기준으로 순위를 매깁니다. 따라서 동일한 게시물들이 한동안 상단에 머무르는 경향이 있습니다. "popular posts" 사이드바에 적합합니다.
• Recent Discussions는 최신 활동을 기준으로 순위를 매겨 목록이 자주 교체됩니다. "what's hot right now" 패널에 적합합니다.

The FastComments 블록은 싱글 사인온을 지원하여 Shopify 고객이 별도의 FastComments 계정을 만들지 않고도 자신의 신원으로 댓글을 작성할 수 있게 합니다.

작동 방식

상점에 로그인한 방문자가 FastComments 블록이 있는 페이지를 열면:

1. 블록이 Shopify customer 객체를 감지합니다.
2. 서명된 앱 프록시 요청을 통해 고객의 이름과 이메일을 FastComments로 전송합니다.
3. FastComments는 shopify-{customerId} 키로 사용자 계정을 생성하거나 매칭하므로, 동일한 고객은 세션이나 재설치에 관계없이 항상 동일한 FastComments 사용자에 매핑됩니다.
4. 방문자의 이름이 댓글에 표시됩니다. 다시 로그인하라는 요청을 받지 않습니다.

방문자가 상점에 로그인하지 않은 경우, 블록은 익명 댓글 작성으로 대체됩니다(또는 위젯 구성에 따라 FastComments 로그인 흐름이 나타납니다).

SSO 끄기

SSO는 모든 FastComments 블록에서 기본적으로 활성화되어 있습니다. 특정 블록에서 비활성화하려면:

1. Shopify 테마 편집기를 엽니다.
2. 블록을 포함한 템플릿을 열고 블록을 클릭하여 선택합니다.
3. SSO의 선택을 해제합니다.
4. 저장을 클릭합니다.

댓글 작성자가 대화에서 별도의 정체성을 선택하도록 하려면 SSO를 끄십시오. 예: 직원들이 다른 표시 이름으로 댓글을 다는 내부 커뮤니티 페이지.

FastComments가 수신하는 정보

각 고객에게 전송되는 SSO 페이로드에는 다음이 포함됩니다:

• Shopify 고객 ID에서 파생된 사용자 ID (shopify-{customerId}).
• 고객의 이메일(사용자 식별에 사용되며 공개적으로 표시되지 않음).
• 고객의 표시 이름(댓글 작성자 이름으로 사용됨).

주문 내역, 결제 정보 또는 주소 데이터는 전송되지 않습니다. 페이로드는 서버 측에서 서명되며, 고객의 브라우저는 자격 증명을 절대 보지 않습니다.

로그인 및 로그아웃 링크

SSO가 활성화되면 댓글 위젯의 로그인 및 로그아웃 링크는 표준 Shopify 고객 계정 경로인 /account/login 및 /account/logout을 가리킵니다. 별도로 구성할 것은 없습니다. 이 링크들은 고객 계정이 활성화된 모든 상점에서 작동합니다.

색상, 글꼴, 중재 규칙, 허용되는 HTML, 익명 댓글 작성 기능은 모두 스토어의 브랜딩에 맞게 구성할 수 있습니다.

Shopify 관리자에서 FastComments 앱을 열고 Customize 타일을 클릭하여 위젯 커스터마이즈 화면을 엽니다. 이 화면은 일회용 로그인 링크를 사용하므로 별도의 로그인은 필요하지 않습니다.

맞춤 설정 옵션 전체 목록은 맞춤 설정 및 구성 가이드를 참조하세요.