FastComments.com
Menu Icon

언어 🇰🇷 한국어
🇺🇸 English 🇧🇬 Български 🇨🇳 简体中文 🇹🇼 繁體中文 🇭🇷 Hrvatski 🇩🇰 Dansk 🇳🇱 Nederlands 🇫🇷 Français (France) 🇩🇪 Deutsch 🇬🇷 Ελληνικά 🇮🇱 עברית 🇮🇹 Italiano 🇯🇵 日本語 🇰🇷 한국어 🇵🇱 Polski 🇧🇷 Português (Brasil) 🇷🇺 Русский 🇷🇸 Srpski (Latinica) 🇷🇸 Српски 🇸🇮 Slovenščina 🇪🇸 Español 🇺🇦 Українська 🇹🇷 Türkçe

요약

빠른 시작

Drupal 설치

설치
구성
위젯 블록
콘텐츠 유형 필드
싱글 사인온 (SSO)
권한
다국어
EU 데이터 거주지
맞춤 설정
요구 사항

설문

Drupal 사이트에 설문 추가

Drupal 사이트에 실시간 댓글 추가

빠른 시작 Internal Link

이것은 Drupal 지침의 "요약(TL;DR)" 버전입니다.

  1. composer require drupal/fcom로 모듈을 설치하거나 modules/custom/fastcomments/에 넣으세요.
  2. drush en fastcomments로 활성화하거나 관리 UI의 /admin/modules에서 활성화하세요.
  3. Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments)로 이동하세요.
  4. 설정 > API/SSO (EU)에서 Tenant ID와 API Secret을 입력하세요.
  5. 원하는 콘텐츠 유형에 FastComments 필드를 Structure > Content types > [type] > Manage fields에서 추가하세요.

모듈은 drupal.org/project/fcom에 게시되어 있습니다.

설치 Internal Link

FastComments Drupal 모듈은 Drupal의 기본 내장 댓글 기능을 빠르고 실시간으로 작동하는 댓글 시스템으로 대체합니다. 이 모듈은 drupal.org에 게시되어 있으며 Drupal 10 및 11과 호환됩니다.

설치 방법은 두 가지입니다.

Composer로 설치

composer require drupal/fcom
drush en fastcomments

수동 설치

drupal.org/project/fcom에서 모듈을 다운로드한 후, 사이트의 modules/custom/fastcomments/ 디렉터리에 넣습니다. 그런 다음 drush en fastcomments 명령으로 활성화하거나, 관리자 UI의 Extend(/admin/modules)에서 활성화할 수 있습니다.

참고! 이 모듈은 Drupal 코어(user 및 field)에만 의존합니다. 다른 Drupal 모듈이나 라이브러리는 필요하지 않습니다.

모듈을 활성화한 후, Configuration 섹션으로 이동하여 Tenant ID와 API Secret을 설정하세요.

구성 Internal Link

All settings live under Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).

필수

  • Tenant ID - FastComments 테넌트 ID입니다. Settings > API/SSO (EU)에서 찾을 수 있습니다.
  • API Secret - Secure SSO, 웹훅 검증 및 페이지 동기화에 필요합니다. Settings > API/SSO (EU)에서 찾을 수 있습니다.

API Secret 저장

모듈은 값이 있는 다음 소스 중 첫 번째에서 API Secret을 읽습니다:

  1. Key module - Key를 설치하고, Authentication 키를 생성한 뒤 설정 양식의 API Secret key에서 선택합니다. 키는 환경 변수나 웹 루트 외부 파일로 백업될 수 있습니다.
  2. settings.php - settings.php 또는 settings.local.php에 $config['fastcomments.settings']['api_secret'] = 'your-secret';를 추가합니다. 비밀은 내보낸 구성에 절대 포함되지 않습니다.
  3. 설정 양식 - API Secret 필드에 입력합니다. 이 값은 fastcomments.settings에 저장되어 구성 내보내기에 포함됩니다. Drupal 상태 보고서는 이것이 활성 소스일 때 경고합니다.

양식은 어떤 소스가 활성화되어 있는지 표시합니다. 필드를 비워두면 저장된 비밀이 유지됩니다. 비밀을 Key 모듈이나 settings.php로 이동한 후 Remove the API Secret stored in configuration을 선택하면 구성에 저장된 비밀을 삭제합니다.

댓글 스타일

사이트에서 사용자가 대화하는 방식을 가장 잘 반영하는 위젯을 선택하세요.

  • Live Comments - 실시간 스레드형 댓글.
  • Streaming Chat - 실시간 채팅 인터페이스로, 이벤트 및 라이브 스트림에 적합합니다.
  • Collab Chat - 메인 콘텐츠 영역에서 텍스트 선택 주석을 달 수 있습니다. 방문자는 텍스트를 강조하고 해당 맥락에서 토론을 시작합니다.
  • Collab Chat + Comments - 동일 페이지에 협업 채팅과 일반 댓글을 모두 제공합니다.

SSO 모드

  • None - SSO 없음. 사용자는 게스트로 댓글을 달거나 FastComments 계정을 생성합니다.
  • Simple - 서버 측 검증 없이 Drupal 사용자 정보(이름, 이메일, 아바타)를 FastComments에 전달합니다.
  • Secure - HMAC-SHA256을 사용해 Drupal 사용자를 FastComments와 검증합니다. API Secret이 구성된 경우 권장됩니다.

Single Sign-On (SSO) 섹션을 참조하세요.

기타 설정

  • CDN URL - 기본값은 https://cdn.fastcomments.com입니다.
  • Site URL - 기본값은 https://fastcomments.com입니다.
  • Email notifications - 새로운 댓글이 게시될 때 콘텐츠 작성자에게 이메일을 보냅니다.

EU 데이터 거주에 대해서는 EU Data Residency 섹션을 참조하세요.

위젯 블록 Internal Link

이 모듈은 Structure > Block layout (/admin/structure/block)에서 배치할 수 있는 여러 블록을 제공합니다.

  • FastComments Widget - 기본 댓글 위젯입니다. 현재 엔티티를 자동으로 감지합니다. FastComments 필드가 이미 첨부된 엔티티는 건너뛰므로 동일한 페이지에 중복 위젯이 표시되지 않습니다.
  • FastComments Live Chat - 실시간 스트리밍 채팅입니다. 동일한 페이지에서 댓글 필드 옆에 배치할 수 있습니다.
  • FastComments Collab Chat - 텍스트 선택 주석 및 토론 기능입니다.
  • FastComments Image Chat - 이미지에서 좌표 기반 주석입니다. 방문자는 이미지의 특정 위치를 클릭하여 해당 위치에 연결된 댓글을 남깁니다.
  • FastComments Recent Comments - 사이트 전반의 최신 댓글을 표시합니다. 개수는 블록에서 구성할 수 있습니다.
  • FastComments Top Pages - 사이트에서 가장 댓글이 많은 페이지를 표시합니다.

콘텐츠 중심 블록(Live Chat, Collab Chat, Image Chat)은 현재 엔티티를 자동으로 감지하며, 엔티티가 아닌 페이지에서는 경로 기반 식별자로 대체됩니다. 즉, 추가 설정 없이 taxonomy 페이지, views, 커스텀 라우트에서 작동합니다.

콘텐츠 유형 필드 Internal Link

대부분의 사이트에서 댓글을 추가하는 가장 쉬운 방법은 FastComments 필드를 콘텐츠 타입에 연결하는 것입니다. Structure > Content types > [type] > Manage fields로 이동하여 필드를 추가하세요.

이 필드가 있는 각 엔티티는 다음을 얻게 됩니다:

  • 편집자가 엔티티별로 댓글을 켜거나 끌 수 있는 상태 토글.
  • Drupal 엔티티 경로에 종속되지 않는 안정적인 ID를 사용할 수 있는 선택적 사용자 지정 식별자.

기본 FastComments Widget 블록은 이 필드를 인식하며, 이미 필드가 연결된 엔티티는 건너뜁니다. 이를 통해 동일한 페이지에서 위젯이 중복으로 표시되지 않으면서 엔티티별 댓글과 블록을 함께 사용할 수 있습니다.

싱글 사인온 (SSO) Internal Link

FastComments는 SSO를 통해 Drupal의 사용자 시스템과 통합됩니다. 사용자는 Drupal 사이트에 로그인하면 모듈이 자동으로 그들의 신원을 FastComments로 전달합니다. 추가 계정을 만들 필요도, 초기 동기화를 실행할 필요도 없습니다.

The module supports three SSO modes, set under Administration > Configuration > Content > FastComments.

없음

SSO 없음. 사용자는 게스트로 댓글을 달거나 FastComments 계정을 생성합니다. 사이트가 공개적이고 댓글을 Drupal 사용자와 연동할 필요가 없을 때 사용하세요.

간단

서버 측 검증 없이 Drupal 사용자의 이름, 이메일, 아바타를 FastComments로 전달합니다. API Secret이 필요하지 않습니다. 내부용이나 위험이 낮은 사이트에 적합합니다.

보안 (권장)

HMAC-SHA256을 사용하여 각 사용자의 신원을 FastComments와 함께 확인합니다. API Secret이 구성되어 있을 때 이 모드를 사용하면 되며, 방문자가 다른 사용자를 사칭하는 것을 방지하는 유일한 모드입니다.

사용자가 댓글 스레드를 볼 때마다 사용자 신원이 FastComments로 전달됩니다. 실행해야 하는 초기 동기화나 지속적 동기화가 없습니다.

(Optional) 관리자 계정을 Users & Administrators에 추가하고 중재자들을 Comment Moderators에 추가하면 사용성 향상과 중재자 통계 추적 활성화에 도움이 됩니다.

SSO 작동 방식에 대한 자세한 내용은 커스터마이제이션 문서의 SSO 섹션을 참조하세요.

권한 Internal Link

이 모듈은 People > Permissions에서 역할별로 할당할 수 있는 세 가지 Drupal 권한을 추가합니다.

  • Administer FastComments - /admin/config/content/fastcomments에 있는 FastComments 설정 양식에 대한 액세스.
  • View FastComments - 댓글 위젯을 보려면 필요합니다. 이 권한이 없으면 위젯이 렌더링되지 않습니다.
  • Toggle FastComments - 필드 위젯을 사용하여 사용자가 엔터티별로 댓글을 활성화하거나 비활성화할 수 있도록 허용합니다.

기본적으로 administer site configuration 권한을 가진 사용자만 FastComments 설정을 변경할 수 있습니다. 방문자가 위젯을 보게 하려면 익명 사용자 및 인증된 사용자에게 View FastComments 권한을 부여하세요.

다국어 Internal Link

이 모듈은 현재 Drupal 사이트의 언어를 모든 FastComments 위젯에 자동으로 전달합니다. Drupal 사이트가 다국어로 구성된 경우, 댓글 UI는 추가 구성 없이 일치하는 언어로 렌더링됩니다.

이것은 모든 위젯 유형에 적용됩니다: Live Comments, Streaming Chat, Collab Chat, Image Chat, Recent Comments, 그리고 Top Pages.

EU 데이터 거주지 Internal Link

만약 FastComments 계정이 EU에 호스팅되어 있다면, Administration > Configuration > Content > FastComments에서 두 가지 설정을 업데이트하세요:

  • CDN URL - https://cdn-eu.fastcomments.com
  • Site URL - https://eu.fastcomments.com

또한 기본 US 대시보드 대신 EU 대시보드인 eu.fastcomments.com/auth/my-account/api에서 Tenant ID와 API Secret을 가져와야 합니다. 모듈의 다른 모든 부분은 동일하게 작동합니다.

맞춤 설정 Internal Link

FastComments는 귀하의 사이트에 맞게 맞춤화할 수 있도록 설계되었습니다.

맞춤 스타일을 추가하거나 구성을 조정하려면, 맞춤 설정 문서를 확인하여 방법을 알아보세요.

요구 사항 Internal Link

이 모듈은 다른 Drupal 모듈이나 서드파티 라이브러리를 필요로 하지 않습니다. 오직 Drupal 코어 (user, field)에만 의존합니다.

자바스크립트가 없는 방문자를 위해 서버에서 렌더링된 댓글을 제공하는 <noscript> 폴백이 있어 Live Comments와 Streaming Chat이 스크립트가 비활성화된 브라우저에서도 계속 작동합니다.

Drupal 사이트에 설문 추가 Internal Link

FastComments가 Drupal 사이트에 설치되면, 댓글 안에서 실시간 설문조사를 실행할 수 있습니다. 위젯 사용자 정의 설정에서 Enable Polls를 켜면 설문조사 버튼이 댓글 도구 모음에 나타납니다. 설문조사는 2~10개의 옵션을 가질 수 있으며, 결과는 페이지에 있는 모든 사람에게 실시간으로 업데이트되고, 설문조사를 누가 만들 수 있는지와 투표에 로그인 필요 여부를 선택할 수 있습니다. Drupal에 추가로 설치할 것이 없습니다.

Try the Live Polls demo 또는 Polls documentation 를 읽어 설정하세요.

이 가이드에 기여하기