Drupal 사이트에 실시간 댓글 추가
빠른 시작 
이것은 Drupal 지침의 "요약(TL;DR)" 버전입니다.
composer require drupal/fcom로 모듈을 설치하거나modules/custom/fastcomments/에 넣으세요.drush en fastcomments로 활성화하거나 관리 UI의/admin/modules에서 활성화하세요.Administration > Configuration > Content > FastComments(/admin/config/content/fastcomments)로 이동하세요.- 설정 > API/SSO (EU)에서 Tenant ID와 API Secret을 입력하세요.
- 원하는 콘텐츠 유형에
FastComments필드를Structure > Content types > [type] > Manage fields에서 추가하세요.
모듈은 drupal.org/project/fcom에 게시되어 있습니다.
설치
FastComments Drupal 모듈은 Drupal의 기본 댓글 기능을 빠르고 실시간 댓글 시스템으로 대체합니다. 이 모듈은 drupal.org에 게시됨이며 Drupal 10 및 11에서 작동합니다.
설치 방법은 두 가지가 있습니다.
Composer로 설치
composer require drupal/fcom
drush en fastcomments수동 설치
Download the module from drupal.org/project/fcom and place it in your site's modules/custom/fastcomments/ directory. Then enable it with drush en fastcomments, or from the admin UI at Extend (/admin/modules).
참고! 이 모듈은 Drupal 코어 (user and field). 다른 Drupal 모듈이나 라이브러리는 필요하지 않습니다.
모듈이 활성화되면 Configuration 섹션으로 이동하여 Tenant ID와 API Secret을 설정하세요.
구성
All settings live under Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).
필수
- Tenant ID - 귀하의 FastComments Tenant ID. 다음 위치에서 찾을 수 있습니다: 설정 > API/SSO (EU).
- API Secret - Secure SSO, 웹훅 검증, 페이지 동기화에 필요합니다. 설정 > API/SSO (EU)에서 찾을 수 있습니다.
댓글 스타일
사이트에서 사람들이 대화하는 방식에 맞는 위젯을 선택하세요.
- Live Comments - 실시간 스레드형 댓글입니다.
- Streaming Chat - 라이브 채팅 인터페이스로 이벤트 및 라이브스트림에 적합합니다.
- Collab Chat - 메인 콘텐츠 영역에서 텍스트 선택 주석 기능입니다. 방문자가 텍스트를 강조 표시하고 맥락에서 토론을 시작합니다.
- Collab Chat + Comments - 동일한 페이지에서 collab chat과 표준 댓글을 모두 표시합니다.
SSO Mode
- 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 섹션을 참조하세요.
위젯 블록
이 모듈은 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, 커스텀 라우트에서 작동합니다.
콘텐츠 유형 필드
대부분의 사이트에서 댓글을 추가하는 가장 쉬운 방법은 FastComments 필드를 콘텐츠 유형에 추가하는 것입니다. Structure > Content types > [type] > Manage fields로 이동하여 필드를 추가하세요.
Each entity that has the field gets:
- 편집자가 각 엔티티에서 댓글 기능을 켜거나 끌 수 있는 상태 토글.
- 선택적 사용자 지정 식별자로, Drupal 엔티티 경로에 묶여 있지 않은 안정적인 ID를 사용할 수 있습니다.
The main FastComments Widget block knows about this field, and will skip entities that already have it attached. That way you can mix per-entity comments with the block without seeing the widget twice on the same page.
싱글 사인온(SSO)
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 섹션을 참조하세요.
권한
이 모듈은 People > Permissions에서 역할별로 할당할 수 있는 세 가지 Drupal 권한을 추가합니다.
- Administer FastComments -
/admin/config/content/fastcomments에 있는 FastComments 설정 양식에 대한 액세스. - View FastComments - 댓글 위젯을 보려면 필요합니다. 이 권한이 없으면 위젯이 렌더링되지 않습니다.
- Toggle FastComments - 필드 위젯을 사용하여 사용자가 엔터티별로 댓글을 활성화하거나 비활성화할 수 있도록 허용합니다.
기본적으로 administer site configuration 권한을 가진 사용자만 FastComments 설정을 변경할 수 있습니다. 방문자가 위젯을 보게 하려면 익명 사용자 및 인증된 사용자에게 View FastComments 권한을 부여하세요.
다국어
이 모듈은 현재 Drupal 사이트의 언어를 모든 FastComments 위젯에 자동으로 전달합니다. Drupal 사이트가 다국어로 구성된 경우, 댓글 UI는 추가 구성 없이 일치하는 언어로 렌더링됩니다.
이것은 모든 위젯 유형에 적용됩니다: Live Comments, Streaming Chat, Collab Chat, Image Chat, Recent Comments, 그리고 Top Pages.
EU 데이터 저장 위치
If your FastComments account is hosted in the EU, update two settings at Administration > Configuration > Content > FastComments:
- CDN URL -
https://cdn-eu.fastcomments.com - Site URL -
https://eu.fastcomments.com
You'll also want to pull your Tenant ID and API Secret from the EU dashboard at eu.fastcomments.com/auth/my-account/api instead of the default US dashboard. Everything else in the module works the same.
맞춤화
요구 사항
- Drupal 10 또는 11
- PHP 8.1 이상
- FastComments 계정
이 모듈은 다른 Drupal 모듈이나 서드파티 라이브러리를 필요로 하지 않습니다. 오직 Drupal 코어 (user, field)에만 의존합니다.
자바스크립트가 없는 방문자를 위해 서버에서 렌더링된 댓글을 제공하는 <noscript> 폴백이 있어 Live Comments와 Streaming Chat이 스크립트가 비활성화된 브라우저에서도 계속 작동합니다.