맞춤 설정 및 구성

댓글 위젯이 예를 들어 테넌트 ID가 "demo"인 상태로 사용될 수 있다는 것을 알 수 있습니다:

Demo Tenant ID

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo"

7}];

8</script>

9

이것은 댓글 위젯을 시험해 보거나 가지고 놀아보기 위한 목적일 뿐입니다. 실제 운영 환경에서는 다음과 같이 자신의 테넌트 ID를 전달해야 합니다:

Defining Your Tenant ID

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "aKa2Z4Q="

7}];

8</script>

9

귀하의 테넌트 ID는 계정의 댓글 위젯 코드 스니펫에 이미 적용되어 있습니다.

또한 테넌트 ID를 확인하고 API 키를 관리하려면 API 자격 증명 페이지를 확인하세요.

앞으로는 FastComments에 로그인한 상태라면(https://fastcomments.com에 로그인한 경우) 코드 예제들이 실제 테넌트 ID를 사용합니다.

댓글 스레드를 렌더링하거나 댓글을 작성할 때, FastComments는 해당 댓글들이 어떤 페이지, 아티클, 또는 상품에 속하는지 알아야 합니다.

이를 위해 우리는 "URL ID"라고 부르는 것을 사용합니다. 이는 문자열이나 숫자 같은 식별자이거나 URL입니다.

기본적으로 urlId를 지정하지 않으면 페이지 URL이 사용됩니다. 현재 페이지 URL을 가져와서 일반적인 마케팅 파라미터나 추적 식별자를 제거하도록 정리합니다.

WordPress와 같은 서드파티 통합의 경우, 우리 플러그인은 일반적으로 현재 보고 있는 정보를 나타내는 식별자(예: 아티클/페이지 ID)를 URL ID로 사용합니다.

사용자 정의 URL ID 정의하기

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "urlId": "https://example.com/page"

8}];

9</script>

10

이 문서에서 자주 언급할 것 중 하나는 위젯 커스터마이제이션 UI입니다.

이 UI를 사용하면 코드를 작성하지 않고도 댓글 위젯을 여러 방식으로 변경할 수 있습니다.

커스터마이제이션 규칙을 만들 때는 사이트의 모든 페이지에 적용되기를 원하는 경우가 많습니다. 하지만 특정 페이지의 댓글 위젯을 커스터마이즈하고 싶은 경우도 있습니다. 예를 들어 사용자 정의 스타일을 적용하거나, 해당 페이지의 댓글을 익명으로 만들 수 있습니다. 또한 어떤 페이지에서는 라이브 댓글이 바로 표시되고, 다른 페이지에서는 알림 버튼 아래에 숨겨지도록 설정할 수도 있습니다.

이 모든 것은 이 페이지의 URL ID 입력 필드를 통해 가능하며, 해당 필드는 다음과 같이 생겼습니다:

위젯 커스터마이제이션 페이지의 URL ID 입력란

이 필드의 값은 댓글 위젯에 전달되는 urlId 파라미터와 일치해야 합니다. 커스터마이제이션 규칙이 urlId에 상관없이 적용되기를 원한다면, 이 필드를 비워 두거나 *를 입력하세요.

2023년부터 위젯 커스터마이제이션의 URL ID 필드는 이제 패턴도 허용합니다! 예를 들어 */blog/*를 사용하여 블로그에 특화된 스타일을, */store/*를 사용하여 스토어에 특화된 스타일을 적용할 수 있으며, 모두 동일한 도메인을 사용하면서 가능합니다.

주의 사항

1. 페이지에 해시 파라미터(예: example.com#page-1)가 있는 경우, 기본적으로 이것이 URL ID의 일부가 됩니다.
2. 마이그레이션 중, 예를 들어 WordPress에서 Gatsby로 이전할 때, 초기 마이그레이션 이후 URL ID 댓글 값을 마이그레이션해야 할 수 있습니다. 이 경우 저희에게 문의해 주세요.

FastComments는 사용자 정의가 가능하도록 설계되었습니다. 보안상의 이유로 댓글 위젯 자체가 iframe 안에서 실행되기 때문에, 맞춤 스타일을 적용하려면 두 가지 방법 중 하나를 따라야 합니다.

첫 번째이자 가장 쉬운 방법은 저희가 권장하는 위젯 커스터마이징 페이지(widget customization page)를 이용하는 것입니다.

위젯 커스터마이징 페이지에서 “고급 옵션 표시” 섹션을 확인하면 “Custom CSS” 라벨이 붙은 영역이 있습니다:

Custom CSS 입력 영역

이 방법의 장점:

1. 입력된 CSS는 사용자에게 전달되기 전에 최소화(minify)되며, 편집 UI에서 포맷이 일관되게 유지됩니다.
2. 위젯 커스터마이징 UI의 모든 이점을 활용할 수 있어, 예를 들어 사이트마다 댓글 위젯을 쉽게 다르게 커스터마이징할 수 있습니다.
3. 저희가 댓글 위젯을 업데이트할 때, 여러분의 맞춤 스타일도 릴리스 프로세스의 일부로 테스트됩니다.

두 번째 방법은 위젯 설정에 customCSS 매개변수를 지정하는 것입니다:

Passing Custom CSS

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "customCSS": "button { background: red; }"

8}];

9</script>

10

하지만 이 방법에는 제한 사항이 있습니다:

1. 헤더 크기 제한으로 인해 서버가 요청을 거부하기 전에 전달할 수 있는 맞춤 CSS 양에 제한이 있습니다.
2. 인프라와 빌드 시스템에서 맞춤 CSS를 직접 관리해야 합니다. 이는 단점이라기보다 장점이 될 수도 있습니다.
3. 이 경우 맞춤 CSS가 네트워크를 통해 두 번 전송되는 추가 오버헤드가 발생합니다(서버로 전송된 뒤 iframe 콘텐츠에 다시 전달). 대부분의 페이로드 크기에서는 눈에 띄지 않습니다.
4. 일반적인 최적화 방법은 CSS를 최소화하여 네트워크 전송 크기를 줄이는 것이지만, 이 방법을 사용할 경우 직접 처리해야 합니다.
5. 저희가 위젯을 업데이트할 때 맞춤 CSS가 테스트되지 않습니다.

외부 CSS 파일

@import를 사용하여 위젯이 외부 파일을 가져오도록 할 수 있습니다!

@import는 커스터마이징 규칙 안에 넣는 것이 권장됩니다. 이렇게 하면 댓글 위젯에 변경이 필요할 때 자동화 도구를 사용해 설정을 검증할 수 있습니다. 예를 들어, 위젯 커스터마이징 UI에서 Custom CSS에 Advanced를 클릭하고 다음과 같이 입력합니다:

@import url(https://example.com/styles.css);

코드 내 - 권장되지 않음

customCSS 속성을 통해 외부 CSS 파일을 로드할 수도 있습니다:

External CSS File

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "customCSS": "@import url(https://example.com/styles.css);"

8}];

9</script>

10

하지만 이렇게 하면 저희가 해당 CSS를 테스트할 수 없다는 점을 기억하세요.

사용자 프로필 모달 스타일링

사용자 프로필 모달도 맞춤 CSS로 스타일링할 수 있습니다. 다만, 사용자 프로필에 맞춤 스타일이 적용되도록 하려면 모든 CSS 선택자 앞에 .user-profile 접두사를 붙여야 합니다. 이 접두사가 없으면 사용자 프로필 모달에 대한 맞춤 스타일이 무시됩니다.

예시:

User Profile CSS

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "customCSS": ".user-profile .profile-name { color: blue; }"

8}];

9</script>

10

이전 버전 호환성

FastComments에서는 고객이 댓글 위젯을 커스터마이징한다는 점을 잘 알고 있습니다. 이는 설계상의 의도이며, 저희 제품이 고객 제품의 디자인 일관성을 해치는 상황을 원치 않습니다.

이 중요한 부분을 위해 저희는 각 릴리스마다 고객별로 댓글 위젯 변경 사항을 검토할 수 있는 빌드 파이프라인을 운영하고 있습니다.

작은 문제가 발견되면 계정을 업데이트하여 릴리스가 원활히 진행되도록 하고, 큰 파괴적 변경이 감지되면 릴리스를 중단할 수 있습니다.

Pro 또는 Enterprise 계정을 보유한 고객에게는 화이트 라벨링이 허용됩니다. 간단히 문의해 주세요 그러면 저희가 기꺼이 도와드리겠습니다.

댓글 위젯에서 저희 로고만 제거하려는 경우, 이는 Flex 및 Pro 요금제에서 자동으로 활성화됩니다.

이 요금제들은 또한 당사 플랫폼에서 발송되는 이메일에 대해서도 동일한 기능을 제공합니다.

초기 페이지 로드 후 다크 모드를 토글할 수 있는 사이트의 경우, 이는 조금 더 복잡합니다.

먼저, Comment 위젯 라이브러리의 현재 모든 버전(React, Vue)은 각 저장소에 다크 모드 토글 예제를 포함하고 있습니다.

VanillaJS 위젯의 경우에는 좀 더 작업이 필요합니다. 먼저, FastCommentsUI는 "destroy"와 "update" 함수를 가진 객체를 반환합니다.

댓글 위젯 구성을 업데이트할 때마다 update 함수를 단순히 호출하면 됩니다. 다음은 VanillaJS 위젯으로 다크 모드를 토글하는 완전한 작동 예제입니다.

다크 모드 토글 전체 예제

Copy Run

1

2<script src="https://fastcomments.com/js/embed-v2.min.js"></script>

3<button id="toggle-dark-mode">Toggle Dark Mode</button>

4<div id="fastcomments-widget"></div>

5<script>

6 (function() {

7 const button = document.getElementById('toggle-dark-mode');

8 const config = {

9 tenantId: 'demo',

10 hasDarkBackground: false

11 };

12 const instance = window.FastCommentsUI(document.getElementById('fastcomments-widget'), config);

13 button.addEventListener('click', function() {

14 config.hasDarkBackground = !config.hasDarkBackground;

15 if (config.hasDarkBackground) {

16 document.body.classList.add('dark');

17 } else {

18 document.body.classList.remove('dark');

19 }

20 instance.update(config);

21 });

22 })();

23</script>

24<style>

25 body.dark {

26 background: #000;

27 color: #fff;

28 }

29</style>

30

FastComments와 함께, 댓글 위젯의 모든 텍스트는 사용자 정의가 가능합니다.

제출 버튼과 같은 단일 텍스트 조각을 재정의하거나, 전체 댓글 위젯의 모든 텍스트를 재정의할 수 있습니다.

기본적으로, 댓글 위젯의 텍스트는 사용자의 로케일에 따라 번역됩니다. 그러나 사용자가 동일한 로케일/언어를 사용하고 있다고 확신하는 경우, 텍스트를 재정의할 수 있습니다. 예를 들어:

맞춤 텍스트

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "translations": {

8 "SUBMIT_REPLY": "Reply"

9 }

10}];

11</script>

12

모든 사용자 정의 가능한 번역은 여기의 "고급 옵션" 탭에서 찾을 수 있습니다.

하지만 위젯 커스터마이징 UI를 통해 더 쉬운 방법이 있습니다. 여기서 우리는 EN_US 로케일의 댓글 위젯에 표시되는 텍스트를 찾아서 교체 텍스트를 지정할 수 있습니다.

맞춤 텍스트

모든 번역 재정의는 현재 모든 로케일에 영향을 미칩니다.

이는 위젯 자체의 텍스트를 다룹니다. 방문자가 작성한 댓글을 번역하려면, Comment Translation 을 참조하십시오.

사용자가 FastComments에 처음 댓글을 달면 우리는 그들의 아바타를 https://gravatar.com/에서 가져오려고 시도합니다.

하지만 아바타를 찾지 못하거나 사용자가 계정에 아바타를 설정하지 않은 경우, 우리는 정적인 기본 아바타 이미지를 표시합니다.

자신만의 정적 아바타 이미지를 지정하려면 defaultAvatarSrc 설정을 사용할 수 있습니다.

기본 아바타 재정의

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultAvatarSrc": "https://example.com/some-image.png"

8}];

9</script>

10

코드를 사용하지 않고도 이 작업을 수행할 수 있습니다. 위젯 사용자 정의 페이지에서 "Default Avatar" 섹션을 확인하세요.

기본 아바타 사용자 정의

SSO와 같이 특정 사용자의 아바타를 정의하는 방법은 별도의 섹션에서 다룹니다.

아바타는 사용자가 자체 아바타를 정의했더라도 댓글 위젯에서 완전히 제거될 수 있습니다.

아바타 숨기기

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "hideAvatars": true

8}];

9</script>

10

코드 없이 위젯 맞춤 설정 페이지에서 이를 사용자 지정할 수 있습니다:

아바타 숨기기

보다 큰 맞춤 스타일링 프로젝트의 경우, 기본 스타일링을 전혀 사용하지 않고 깨끗한 상태에서 시작하는 것이 바람직할 수 있습니다.

다음과 같이 noStyles 매개변수를 true로 설정하면 모든 기본 스타일링을 제거할 수 있습니다:

Disabling All Default Styles

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "noStyles": true

8}];

9</script>

10

코드 없이 위젯 맞춤 설정 페이지의 고급 옵션에서 이를 사용자 지정할 수 있습니다:

모든 기본 스타일 비활성화

기본적으로, 최상위 댓글에 대한 답글이 표시됩니다.

이 설정을 변경하면 사용자가 최상위 댓글에서 "Show Replies"를 클릭해야 자식 댓글을 볼 수 있습니다.

최상위 댓글에 대한 답글 접기

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "collapseReplies": true

8}];

9</script>

10

코드를 사용하지 않고 위젯 맞춤 설정 페이지에서 이 옵션을 사용자 지정할 수 있습니다:

답글 접기

이 설정은 처음 로드되는 최상위 댓글 수에 영향을 주지 않습니다. 최상위 댓글이 하나이고, 자식 댓글이 29개인 경우, 이 설정을 켜면 다음과 같이 표시됩니다:

• 최상위 댓글을 확인합니다.
• 이 댓글 아래에 Show Replies (29)를 확인합니다.

이 옵션과 함께 모든 최상위 댓글을 표시하려면, 시작 페이지를 -1로 설정하십시오.

기본적으로 FastComments의 서식 기능은 텍스트 주변에 <b></b>와 같은 보이는 앵커 태그를 추가하여 수행됩니다. 툴바를 클릭 하거나 단축키를 사용하면 이 작업이 자동으로 이루어집니다. 그러나 일부 커뮤니티에서는 앵커 태그 없이 서식을 사용하도록 선택하고 싶을 수 있습니다. 이를 WYSIWYG(what you see is what you get) 편집기라고 합니다. 이 편집기는 기본 편집기와 정확히 동일하게 보이지만, 추가 코드를 로드하여 사용자가 보이는 앵커 태그 없이도 텍스트를 굵게, 밑줄 등으로 서식 지정할 수 있게 합니다.

WYSIWYG 편집 활성화

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableWYSIWYG": true

8}];

9</script>

10

코드 없이도 이 작업을 수행할 수 있습니다. 위젯 커스터마이징 페이지에서 "Enable Advanced Formatting" 옵션을 확인하십시오.

WYSIWYG 활성화

기본적으로 FastComments는 댓글을 작성할 때 텍스트를 꾸미고 업로드
이미지를 위한 바로 가기를 제공하는 툴바를 표시합니다.

이 툴바는 코드나 커스터마이제이션 UI를 통해 비활성화할 수 있습니다.

Disabling The Toolbar

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableToolbar": true

8}];

9</script>

10

코드 없이도 이 작업을 수행할 수 있습니다. 위젯 커스터마이제이션 페이지에서 "Disable The Reply Toolbar" 옵션을 확인하세요.

툴바 비활성화

기본적으로 FastComments는 사용자가 다른 사용자를 차단할 수 있도록 허용합니다. 사용자를 차단하면 해당 사용자의 댓글이 가려지고, 사용자 간 알림이 차단되는 등 여러 효과가 있습니다.

이 기능을 비활성화하고 싶을 수 있습니다. 다음과 같이 할 수 있습니다:

차단 비활성화

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableBlocking": true

8}];

9</script>

10

코드 없이도 이 작업을 수행할 수 있으며, 이는 적절한 서버 측 검증을 가능하게 합니다. 위젯 맞춤 설정 UI를 통해 수행합니다:

차단 비활성화

기본적으로 로컬화된 상대 날짜가 사용됩니다. 예를 들어, 최근에 남긴 댓글 옆에 "11분 전"이라고 표시될 수 있습니다.

절대 날짜를 사용해야 하거나 원하는 경우, 이 매개변수를 true로 설정합니다.

절대 날짜 사용

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "absoluteDates": true

8}];

9</script>

10

코드를 사용하지 않고도 위젯 맞춤 설정 페이지의 고급 옵션에서 이를 사용자 지정할 수 있습니다:

절대 날짜 사용

기본적으로 로컬화된 상대 날짜가 사용됩니다. 예를 들어, 최근에 남긴 댓글 옆에 "11분 전"과 같은 표시가 보일 수 있습니다.

이 상대 날짜 형식을 유지하면서 전체 날짜를 함께 표시해야 하거나 원하는 경우, 이 매개변수를 true로 설정하면 됩니다.

Use Both Absolute and Relative Dates

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "absoluteAndRelativeDates": true

8}];

9</script>

10

이는 코드를 사용하지 않고 위젯 사용자 정의 페이지의 고급 옵션에서 맞춤 설정할 수 있습니다. UI에서 이 옵션을 보려면 먼저 절대 날짜를 활성화해야 합니다.

절대 날짜와 상대 날짜 모두 사용

일부 텍스트(예: 헤더 또는 메시지)는 댓글 수 아래에, 로그인 상태 텍스트 위에 표시될 수 있습니다.

이를 헤더라고 부르며, 기본적으로는 숨겨져 있습니다.

헤더 HTML 지정

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "headerHTML": "<h1>Leave a Comment!</h1>"

8}];

9</script>

10

코드를 사용하지 않고도 위젯 맞춤 설정 페이지의 고급 옵션 아래에서 이를 사용자 지정할 수 있습니다:

헤더 HTML 지정

기본적으로 FastComments는 다음과 같이 링크를 렌더링합니다: https://exmaple.com - 여기서 링크 URL은 클릭 가능한 HTML 앵커 태그가 됩니다.

일부 사이트는 예를 들어 사기 방지를 위해 이를 비활성화하고 싶을 수 있습니다. 우리는 Comment HTML Rendering Option을 Links as Text로 설정하여 이를 제공합니다.

코드 없이 위젯 커스터마이징 페이지에서 전체 도메인 또는 페이지별로 맞춤 설정할 수 있습니다:

링크를 텍스트로 렌더링

기본적으로 FastComments는 댓글 입력 상자와 댓글 스레드를 동시에 렌더링합니다. 세로 공간을 절약하기 위해 위젯이 상호작용될 때까지 다른 필수 필드들을 숨깁니다.

하지만 예를 들어 댓글 위젯을 버튼 뒤에 숨길 수 있습니다:

댓글 표시 클릭

버튼은 현재 댓글이 표시되는지 여부에 따라 다른 번역 텍스트를 사용합니다. 댓글이 숨겨져 있을 경우 translations.SHOW_COMMENTS_BUTTON_TEXT를 사용하고, 댓글이 표시되어 있을 경우 translations.HIDE_COMMENTS_BUTTON_TEXT를 사용합니다. 번역 문자열에는 [count] 텍스트를 포함할 수 있으며, 이는 현지화된 댓글 수로 대체됩니다.

댓글 표시 또는 숨기기 클릭

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "useShowCommentsToggle": true

8}];

9</script>

10

이는 hideCommentsUnderCountTextFormat 설정을 대체하도록 설계되었습니다.

댓글 수는 댓글 스레드와 실시간으로 업데이트됩니다. 댓글이 없을 경우 버튼이 표시되지 않습니다.

코드를 작성하지 않고도 커스터마이징 규칙을 만들고 "댓글 표시 클릭"을 활성화하면 사용할 수 있습니다:

댓글 표시 클릭 활성화

댓글 위젯 상단에 표시되는 댓글 수는 사용자 정의할 수 있습니다.

이는 원하는 문자열로 교체할 수 있으며, [count] 값은 사용자에게 현지화된 카운트 값으로 대체됩니다.

댓글 수 텍스트 사용자 정의

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "commentCountFormat": "There are [count] comments."

8}];

9</script>

10

코드를 사용하지 않고도 위젯 사용자 정의 페이지에서 맞춤 설정할 수 있습니다:

댓글 수 텍스트 사용자 정의

사용자가 #someexampletag 형태의 해시태그를 입력하면, FastComments는 해당 HashTag를 자동으로 생성하고 댓글에서 강조 표시합니다.

일부 경우에는 이 기능을 비활성화하거나 API를 통해 사용할 수 있는 해시태그를 제어하는 것이 바람직합니다.

이를 위해서는 위젯 커스터마이징 UI에서 Disable Automatic #hashtag Creation을 간단히 활성화하면 됩니다.

자동 HashTag 생성 비활성화

기본적으로 FastComments는 댓글 영역 오른쪽 상단에 알림 벨을 표시합니다.

이 벨은 빨간색으로 변하고 사용자가 받은 알림 수를 표시합니다. 예시 알림은 다음과 같습니다:

• 사용자가 당신에게 답글을 달았습니다.
• 사용자가 당신이 댓글을 단 스레드에 답글을 달았습니다.
• 사용자가 당신의 댓글에 찬성을 표시했습니다.
• 사용자가 당신이 구독한 페이지에 답글을 달았습니다.

알림 벨은 전체 페이지를 구독하는 메커니즘도 제공합니다.

그러나 알림 벨을 완전히 비활성화할 수 있습니다:

Disable Notification Bell

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableNotificationBell": true

8}];

9</script>

10

코드를 사용하지 않고도 할 수 있습니다. 위젯 사용자 정의 페이지에서 "알림 벨 끄기" 섹션을 확인하세요.

알림 벨 끄기

기본적으로 FastComments는 사용자가 아바타를 클릭하면 해당 사용자의 프로필을 표시합니다.

하지만 이 기능을 비활성화할 수 있습니다:

Disable Profiles

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableProfiles": true

8}];

9</script>

10

코드를 사용하지 않고도 이 작업을 수행할 수 있습니다. 위젯 커스터마이징 페이지에서 "Disable Profiles" 섹션을 확인하세요.

프로필 비활성화

기본적으로 FastComments는 사용자 프로필에 "Profile Comments" 탭을 표시하여 방문자가 누군가의 프로필에 댓글을 남길 수 있게 합니다.

하지만 이 탭을 비활성화할 수 있습니다:

프로필 댓글 비활성화

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableProfileComments": true

8}];

9</script>

10

코드 없이도 이 작업을 수행할 수 있습니다. 위젯 맞춤 설정 페이지에서 "프로필 댓글 비활성화" 섹션을 확인하세요.

프로필 댓글 비활성화

기본적으로 FastComments는 사용자 프로필에 "Direct Messages" 탭을 표시하여 방문자가 사용자에게 직접 메시지를 보낼 수 있도록 합니다.

하지만 이 탭을 비활성화할 수 있습니다:

Disable Profile Direct Messages

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableProfileDirectMessages": true

8}];

9</script>

10

코드를 사용하지 않고도 할 수 있습니다. 위젯 맞춤 설정 페이지에서 "Disable Direct Messages" 섹션을 확인하세요.

프로필 직접 메시지 비활성화

기본적으로 FastComments는 댓글을 달면 성공 메시지를 표시합니다. 다음과 같이 비활성화할 수 있습니다:

Disable Success Message

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableSuccessMessage": true

8}];

9</script>

10

코드 없이도 수행할 수 있습니다. 위젯 맞춤 설정 페이지에서:

성공 메시지 비활성화

기본적으로 FastComments 댓글 위젯은 gif rating을 pg로 설정합니다.

사용 가능한 옵션은 g, pg, pg-13, r입니다.

이 설정은 코드에서 또는 UI를 통해 지정할 수 있습니다. 코드에서는 다음과 같이 할 수 있습니다:

Gif 등급 설정

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "gifRating": "pg-13"

8}];

9</script>

10

UI에서는 Disable Image Uploads? 옵션이 선택되지 않은 경우 Gif Picker Rating 아래에서 찾을 수 있습니다.

Gif 등급 설정

기본적으로 FastComments 댓글 위젯은 이미지 콘텐츠 검열이 off 상태로 설정되어 있습니다.

사용 가능한 옵션은 off, low, medium, high입니다.

위젯 커스터마이징 UI에서 Disable Image Uploads? 옵션이 선택되지 않은 경우 Image Content Moderation Level 아래에서 이 설정을 찾을 수 있습니다.

Image Content Moderation Level 설정

기본적으로 FastComments는 투표 옵션을 위쪽 및 아래쪽 화살표로 표시하여 사용자가 댓글에 찬성 또는 반대표를 할 수 있게 합니다.

그러나 투표 도구 모음의 스타일을 변경할 수 있습니다. 현재 옵션은 기본 위/아래 버튼이거나 하트 스타일 투표 메커니즘을 사용하는 것입니다.

다음과 같이 voteStyle 플래그를 사용합니다:

하트 버튼 활성화

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "voteStyle": 1

8}];

9</script>

10

코드 없이 이 작업을 수행하는 것을 강력히 권장합니다. 이렇게 하면 서버 측 검증도 활성화됩니다. 위젯 커스터마이징 페이지에서 "Vote Style" 섹션을 확인하세요.

투표 스타일 변경

투표는 또한 비활성화할 수 있으며, 스타일 옵션 위에 있는 Disable Voting을 참조하십시오.

기본적으로 FastComments는 사용자가 자신의 댓글을 삭제하도록 허용합니다.

하지만 이를 방지할 수 있습니다.

위젯 맞춤 설정 페이지에서 "Disable Deleting" 옵션을 확인하세요.

댓글 삭제 비활성화

• 이는 일반 댓글 작성자에게만 영향을 미치며, 여전히 삭제할 수 있는 중재자나 관리자에게는 영향을 주지 않습니다.
• contextUserId가 전달될 때 API 통합에도 영향을 미칩니다.

기본적으로 FastComments는 사용자가 자신의 댓글을 편집하도록 허용합니다.

하지만 이를 방지할 수도 있습니다.

위젯 사용자 정의 페이지에서 "편집 비활성화" 옵션을 확인하세요.

댓글 편집 비활성화

• 이는 일반 댓글 작성자에게만 영향을 미치며, 여전히 편집할 수 있는 중재자나 관리자에게는 영향을 주지 않습니다.
• contextUserId가 전달될 때 API 통합에도 영향을 미칩니다.

기본적으로 FastComments 페이지 크기는 30입니다. 여기에는 스레드의 답글도 포함됩니다.

페이지 크기는 Widget Configuration UI에서 10부터 200까지 다양한 크기로 사용자 지정할 수 있습니다.

페이지 크기를 변경하면 계정의 모든 댓글 스레드를 다시 계산해야 합니다. 이 작업은 몇 분 정도 걸릴 수 있습니다.

페이지는 서버 측에서 계산되므로 클라이언트 측 위젯에서는 이 설정을 구성할 수 없습니다.

아래에 예시 구성이 표시됩니다:

맞춤 페이지 크기

페이지 크기는 전역적으로, 도메인별로 또는 페이지별로 다양한 사용자 지정 규칙을 만들어 맞춤 설정할 수 있습니다.

이는 플랫폼을 통해 댓글을 표시하는 모든 클라이언트, 통합 및 프레임워크에 영향을 미칩니다.

기본적으로 FastComments는 사용자가 입력한 이름이나 SSO를 통해 전달된 이름을 표시합니다.

하지만 사용자의 이름을 가리거나 다른 방식으로 표시하고 싶을 수도 있습니다. 예를 들어, 사용자의 이름이 Allen Rex인 경우 "Allen R."만 표시하고 싶을 수 있습니다.

이것은 Commenter Name Format이라는 설정 아래 위젯 커스터마이제이션 UI에서 코드를 작성하지 않고도 할 수 있습니다:

이름 형식 변경

사용 가능한 형식은 다음과 같습니다:

• Capitalize (예시 사용자를 Example User로 표시)
• Last Initial (예시 사용자를 Example U.로 표시)
• All Initials (예시 사용자를 E. U.로 표시)
• "Anonymous" 표시

이 설정을 변경하면 효과가 즉시 적용됩니다. 사용자는 댓글 영역 상단에서 자신의 전체 사용자 이름을 볼 수 있지만, 댓글에는 수정된 사용자 이름이 표시됩니다.

사용자 이름은 서버 측에서 마스킹되어 사용자를 보호합니다.

기본적으로 FastComments는 이미지 업로드를 허용합니다. 이 설정은 noImageUploads 플래그를 true로 설정하여 비활성화할 수 있습니다.

이미지 업로드 비활성화

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "noImageUploads": true

8}];

9</script>

10

코드 없이 위젯 커스터마이징 페이지에서 이 설정을 사용자 지정할 수 있습니다:

이미지 업로드 비활성화

기본적으로 FastComments는 댓글에서 iframe을 허용하지 않습니다. 미디어 임베드를 활성화하면 댓글 작성자가 YouTube, Vimeo, SoundCloud, Spotify와 같은 신뢰할 수 있는 제공업체의 임베드 코드(<iframe> 스니펫)를 붙여넣을 수 있으며, 댓글 내에 인라인으로 렌더링됩니다.

보안을 위해 이것은 클라이언트 측 위젯 설정 플래그가 아닙니다. 각 댓글이 저장될 때 검증되는 서버 측 설정이므로, 페이지에서 켤 수 없습니다. 내장된 신뢰할 수 있는 제공업체 목록을 가리키는 iframe만 허용됩니다. 그 외의 iframe은 제거됩니다.

이 작업은 코드 없이 위젯 사용자 지정 페이지에서 수행할 수 있습니다:

미디어 임베드 허용

자체 제공업체 추가하기

내장된 신뢰 목록에 없는 제공업체의 임베드를 허용하려면 같은 페이지의 "추가 임베드 도메인(Additional Embed Domains)" 필드에 해당 호스트명을 추가하세요. 이 호스트명은 내장 제공업체에 추가로 허용됩니다. 매칭은 정확히 일치해야 하므로 전체 호스트명을 포함해야 합니다(예: player.example.com). 목록에 없는 것은 계속 차단됩니다.

일반 댓글 입력창과 WYSIWYG 편집기 모두 임베드 붙여넣기를 지원합니다. WYSIWYG 편집기에서는 임베드가 제거 가능한 블록으로 삽입됩니다.

기본적으로 댓글 위젯에 검색 상자가 표시되지 않습니다.

하지만 enableSearch 플래그를 true로 설정하면 이를 켤 수 있습니다:

검색 활성화

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableSearch": true

8}];

9</script>

10

코드 없이도 이 작업을 수행할 수 있습니다. 위젯 맞춤 설정 페이지에서 "Enable Search Box" 옵션을 확인하세요.

검색 상자 활성화

우리는 enableSpoilers 플래그를 true로 설정하여 스포일러 지원을 활성화할 수 있습니다:

스포일러 활성화

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableSpoilers": true

8}];

9</script>

10

코드를 사용하지 않고도 이 작업을 수행할 수 있습니다. 위젯 커스터마이징 페이지에서 "Enable Spoilers" 옵션을 확인하세요.

스포일러 활성화

텍스트를 강조 표시하고 이제 보이는 SPOILER 버튼을 클릭하면, 텍스트가 마스크 처리되어 사용자가 마우스를 올릴 때까지 숨겨집니다. 다크 모드에서는 동일한 방식을 사용하지만, 다크 모드에 더 잘 맞는 다른 색상을 사용합니다.

이 기능은 WYSIWYG 편집기와도 호환됩니다.

기본적으로 FastComments는 누가 각 댓글을 보았는지 추적하거나 이에 대한 통계를 제공하지 않습니다.

하지만 이 기능을 활성화하면, 사용자가 댓글까지 스크롤할 때마다 시스템이 추적을 시작합니다.

이 경우 각 댓글에 표시되는 눈 아이콘 옆의 카운트가 증가합니다. 카운트는 실시간으로 업데이트되며 사용자의 로케일에 맞게 축약됩니다.

enableViewCounts 플래그를 true로 설정하면 이 기능을 활성화할 수 있습니다:

Enabling Comment View Counts

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableViewCounts": true

8}];

9</script>

10

코드를 사용하지 않고 위젯 사용자 정의 페이지에서 이 설정을 맞춤화할 수 있습니다:

댓글 보기 횟수 활성화

우리는 댓글을 본 사용자 ID*를 일주일 동안 추적합니다. 따라서 일주일 이내에 다시 댓글을 보면 카운트가 증가하지 않습니다. 일주일이 지난 후 다시 댓글을 보면 카운트가 다시 증가합니다.

• *참고: 익명 세션 ID 또는 사용자의 IP를 해시한 값.

기본적으로 실시간 댓글이 활성화됩니다. 이는 댓글이 추가, 삭제, 편집 또는 고정될 경우, 해당 변경 사항이 댓글 스레드를 보고 있는 모든 사용자에게 동시에 표시된다는 의미입니다.

하지만 기본적으로 새 댓글은 "Show 2 New Comments"와 유사한 텍스트가 표시된 동적으로 나타나는 버튼 아래에 표시됩니다.

새 댓글이 페이지에 직접 달린 답글인 경우, 버튼은 댓글 스레드 상단에 표시됩니다. 특정 댓글에 대한 답글인 경우, 버튼은 해당 댓글 아래에 표시됩니다.

이는 페이지 크기가 지속적으로 변하는 것을 방지하여 사용자가 스크롤 바를 잡으려 할 때 발생할 수 있는 불편함을 최소화하기 위함입니다.

실시간 입찰이나 온라인 이벤트와 같은 일부 사용 사례에서는 이러한 동작이 원하지 않을 수 있습니다. 새 댓글이 즉시 표시되는 "채팅" 상자와 같은 형태의 댓글 위젯을 원할 수 있습니다.

따라서 해당 기능을 활성화하는 플래그 이름은 showLiveRightAway 입니다.

다음과 같이 활성화할 수 있습니다:

실시간 댓글 바로 표시

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "showLiveRightAway": true

8}];

9</script>

10

코드 없이 위젯 맞춤 설정 페이지에서 이 설정을 사용자 지정할 수 있습니다:

실시간 댓글 바로 표시

기본적으로 FastComments는 실시간 댓글 기능이 활성화됩니다.

이는 댓글 스레드를 보는 모든 사용자가 동일한 내용을 보게 된다는 의미입니다.

예를 들어, 댓글이 추가되면 해당 댓글이 표시됩니다. 댓글이 편집되거나 삭제되면, 해당 댓글은 스레드를 보는 모든 사용자에게 편집되거나 삭제된 것으로 반영됩니다. 투표 및 모든 관리 작업도 마찬가지입니다.

하지만 이를 비활성화할 수 있습니다:

실시간 댓글 비활성화

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableLiveCommenting": true

8}];

9</script>

10

코드 없이도 할 수 있습니다. 위젯 커스터마이징 페이지에서 "실시간 댓글 비활성화" 섹션을 확인하세요.

실시간 댓글 비활성화

기본적으로 FastComments는 댓글을 "Most Relevant" 정렬 방향으로 정렬합니다.

Most Relevant 정렬은 댓글이 작성된 시간과 투표 수를 고려하여 정렬합니다.

사용자는 댓글 위젯 UI에서 정렬 방향을 Oldest 또는 Newest First 중 하나로 변경할 수 있습니다.

하지만 기본값을 세 가지 중 어느 것이든 변경할 수 있습니다. 예를 들어 가장 오래된 댓글을 먼저 표시하고 싶다면:

Changing The Default Sort To Oldest First

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultSortDirection": "OF"

8}];

9</script>

10

defaultSortDirection 값을 "OF" 로 설정하여 방향을 "OF" 로 지정합니다.

Newest-first 정렬 방향을 위해서는 다음과 같이 합니다:

Changing The Default Sort To Newest First

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultSortDirection": "NF"

8}];

9</script>

10

defaultSortDirection에 대한 유효한 값은 다음과 같습니다:

• MR: "Most Recent"
• NF: "Newest First"
• OF: "Oldest First"

코드 없이도 설정할 수 있습니다. 위젯 커스터마이징 페이지에서 "Default Sort Direction" 섹션을 확인하세요.

기본 정렬 방향 변경

각 정렬 방향에 대한 페이지별 댓글은 미리 계산되므로 모든 정렬 방향이 동일한 성능을 가집니다.

기본적으로 댓글 입력 영역은 앞에 있는 댓글 스레드입니다. 그러나 이 구성 매개변수를 true로 설정하면 뒤로 이동할 수 있습니다.

답글 입력 상자를 하단으로 이동

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "inputAfterComments": true

8}];

9</script>

10

코드를 사용하지 않고 위젯 커스터마이징 페이지에서 이 설정을 맞춤화할 수 있습니다:

답글 입력 상자를 하단으로 이동

댓글 입력 필드에 입력할 수 있는 최대 문자 수는 maxCommentCharacterLength 매개변수로 제한할 수 있습니다.

기본값은 2000입니다.

이미지 URL과 같은 항목은 길이 계산에 포함되지 않습니다.

댓글 길이 제한

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "maxCommentCharacterLength": 500

8}];

9</script>

10

코드를 사용하지 않고 위젯 커스터마이징 페이지에서 이 설정을 맞춤화할 수 있습니다:

댓글 길이 제한

기본적으로 FastComments는 사용자가 원하는 만큼 여러 줄의 댓글을 입력할 수 있도록 허용하며, 기본 문자 제한까지 가능합니다.

그러나 사용자가 한 줄의 텍스트만 입력하도록 제한하는 것이 바람직할 수 있습니다. 예시 사용 사례로는 온라인 입찰이나 실시간 채팅 등이 있으며, FastComments를 사용할 수 있습니다.

다음과 같이 useSingleLineCommentInput 플래그를 활성화합니다:

Enable Single-Line Comment Input

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "useSingleLineCommentInput": true

8}];

9</script>

10

코드를 사용하지 않고도 설정할 수 있습니다. 위젯 맞춤 설정 페이지에서 "Enable Single-Line Comment Input" 섹션을 확인하세요.

단일 줄 댓글 입력 활성화

각 정렬 방향에 대한 페이지별 댓글이 사전 계산되므로, 모든 정렬 방향에서 동일한 성능을 제공합니다.

기본적으로 각 사용자는 동일한 분에 최대 5 comments까지 제출할 수 있습니다.

이는 사용자 ID, 익명 사용자 ID 및 IP 주소(해시됨)로 추적됩니다.

코드를 작성하지 않고도 위젯 사용자 정의 페이지에서 맞춤 설정할 수 있습니다:

사용자당 댓글 양 제한

댓글 생성 API를 사용하는 경우, 사용자 원본 ip 주소를 백엔드에 요청에 포함시켜야 할 수 있습니다. 그 결과 속도 제한이 적용됩니다 사용자별로 적용되고 귀하의 계정 전체에 전역적으로 적용되지 않습니다.

FastComments는 첫 댓글 작성자가 댓글을 제출하기 전에 서비스 약관에 동의하도록 요구할 수 있습니다.

활성화하면:

• 익명 사용자는 댓글을 작성할 때마다 TOS 체크박스가 표시됩니다
• 인증된 사용자는 첫 댓글 작성 시 또는 TOS를 업데이트했을 때만 체크박스가 표시됩니다

설정

위젯 사용자 지정 페이지로 이동하여 "Require Terms of Service acceptance" 체크박스를 활성화하세요. 활성화하면 다음 옵션이 표시됩니다:

서비스 약관 옵션

• TOS 텍스트 모드: 기본적으로 체크박스에는 두 문서에 대한 링크와 함께 "I agree to the Terms of Service and Privacy Policy"가 표시됩니다. "Customize text per locale"을 선택하여 언어별로 사용자 지정 텍스트를 제공할 수 있습니다.
• TOS 마지막 업데이트 날짜: 서비스 약관을 업데이트할 때 이 날짜를 설정하세요. 이 날짜 이전에 동의한 사용자는 다시 동의해야 합니다.

작동 방식

• TOS 동의 타임스탬프는 사용자별 및 댓글별로 저장됩니다
• 사용자가 TOS에 동의하면 해당 날짜가 사용자 프로필(테넌트별)에 기록됩니다
• 사용자의 동의 날짜 이후로 "마지막 업데이트" 날짜를 설정하면 다시 동의해야 합니다
• 추적할 수 없는 익명 사용자의 경우 댓글을 제출할 때마다 체크박스가 표시됩니다

설문조사는 댓글 작성자가 2~10개의 옵션이 있는 질문을 댓글에 첨부할 수 있게 합니다. 페이지에 있는 모든 사용자는 해당 위치에서 투표하고 실시간으로 결과가 업데이트되는 것을 볼 수 있습니다.

설문조사는 기본적으로 비활성화되어 있습니다. 위젯 사용자 정의 설정에서 설문 조사 활성화를 선택하면 댓글 도구 모음에 설문 조사 버튼이 추가됩니다. 그러면 두 가지 설정이 추가로 나타납니다:

• 설문 조사 생성 가능자: 관리자/중재자만 (기본값), 또는 모두.
• 익명 설문 조사 투표 허용: 선택 해제된 경우 (기본값), 로그인한 사용자만 투표할 수 있습니다.

설문 조사 활성화

설문 조사 생성, 투표, 프라이버시 및 설문 조사 알림이 어떻게 작동하는지에 대해서는 설문 조사 가이드를 참조하세요.

FastComments Secure SSO는 SSO를 구현하기 위한 메커니즘으로 HMAC-SHA256 암호화를 사용합니다. 먼저 전체 아키텍처를 살펴본 후, 예제와 상세한 단계를 제공합니다.

또한 유사한 SSO 메커니즘을 가진 다른 공급자로부터 마이그레이션하는 방법과 그 차이점에 대한 문서도 있습니다.

흐름은 다음과 같습니다:

Secure SSO 흐름

Secure SSO는 풀스택 개발이 필요하므로, Java/Spring, NodeJS/Express, 그리고 순수 PHP로 작성된 완전히 동작하는 코드 예제가 현재 GitHub에 있습니다.

NodeJS 예제에서는 ExpressJS를, Java 예제에서는 Spring을 사용하지만, FastComments SSO를 구현하는 데 이러한 런타임에서 프레임워크/라이브러리가 필요하지 않습니다 - 기본 암호화 패키지로 충분합니다.

FastComments SSO를 사용하면 새로운 API 엔드포인트를 작성할 필요가 없습니다. 시크릿 키를 사용하여 사용자 정보를 암호화하고 페이로드를 댓글 위젯에 전달하기만 하면 됩니다.

API 시크릿 키 발급 받기

API 시크릿은 이 페이지에서 확인할 수 있습니다. My Account로 이동하여 API/SSO 타일을 클릭한 다음 "Get API Secret Key"를 클릭해서도 이 페이지를 찾을 수 있습니다.

댓글 위젯 파라미터

댓글 위젯에 대한 상위 수준 API 문서는 여기에서 확인할 수 있습니다.

이러한 파라미터의 의미를 좀 더 자세히 살펴보겠습니다.

댓글 위젯은 설정 객체를 받습니다 - FastComments를 사용하여 고객 ID(tenantId라고 함)를 전달하고 있다면 이미 이 객체를 전달하고 있는 것입니다.

SSO를 활성화하려면 다음 파라미터를 포함해야 하는 새로운 "sso" 객체를 전달합니다. 값은 서버 측에서 생성되어야 합니다.

• userDataJSONBase64: JSON 형식의 사용자 데이터로, Base64로 인코딩됩니다.
• verificationHash: UNIX_TIME_MILLIS + userDataJSONBase64로 생성된 HMAC-SHA256 해시입니다.
• timestamp: 에포크 타임스탬프, 밀리초 단위입니다. 미래 시점이거나 이틀 이상 과거일 수 없습니다.
• loginURL: 댓글 위젯이 사용자 로그인을 위해 표시할 수 있는 URL입니다.
• logoutURL: 댓글 위젯이 사용자 로그아웃을 위해 표시할 수 있는 URL입니다.
• loginCallback: 로그인 URL 대신 제공되는 경우, 로그인 버튼을 클릭할 때 댓글 위젯이 호출할 함수입니다.
• logoutCallback: 로그아웃 URL 대신 제공되는 경우, 로그아웃 버튼을 클릭할 때 댓글 위젯이 호출할 함수입니다.

Secure SSO 클라이언트 코드

Copy

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "sso": {

8 "userDataJSONBase64": "...",

9 "verificationHash": "...",

10 "timestamp": 1794130022554.0,

11 "loginURL": "https://example.com/login",

12 "logoutURL": "https://example.com/logout",

13 "loginCallback": null,

14 "logoutCallback": null

15 }

16}];

17</script>

18

사용자 객체

사용자(User) 객체는 다음 스키마를 포함합니다:

사용자 객체

Copy

1

2interface SSOUser {

3 /** 필수. 최대 1k자. **/

4 id: string;

5 /** 필수. 최대 1k자. 참고: 고유해야 합니다. **/

6 email: string;

7 /** 필수. 최대 1k자. 참고: 사용자명은 이메일일 수 없습니다. 고유할 필요는 없습니다. **/

8 username: string;

9 /** 선택 사항. URL의 경우 최대 3k자. 기본값은 이메일 기반 gravatar입니다. 64 인코딩 이미지를 지원하며, 이 경우 제한은 50k자입니다. **/

10 avatar?: string;

11 /** 선택 사항. 기본값 false. **/

12 optedInNotifications?: boolean;

13 /** 선택 사항. 기본값 false. **/

14 optedInSubscriptionNotifications?: boolean;

15 /** 선택 사항. 최대 100자. 이 라벨은 이름 옆에 표시됩니다. 해당되는 경우 기본값은 Administrator/Moderator입니다. **/

16 displayLabel?: string;

17 /** 선택 사항. 최대 500자. 사용자명 대신 표시됩니다. **/

18 displayName?: string;

19 /** 선택 사항. 최대 2k자. 사용자 이름이 이 주소로 링크됩니다. **/

20 websiteUrl?: string;

21 /** 선택 사항. 사용자당 최대 100개 그룹. 그룹 id는 50자를 넘을 수 없습니다. **/

22 groupIds?: string[];

23 /** 선택 사항. 사용자를 관리자로 표시합니다. **/

24 isAdmin?: boolean;

25 /** 선택 사항. 사용자를 중재자로 표시합니다. **/

26 isModerator?: boolean;

27 /** 선택 사항, 기본값 true. 사용자 프로필에서 "activity" 탭을 활성화하려면 false로 설정합니다. **/

28 isProfileActivityPrivate?: boolean;

29 /** 선택 사항, 기본값 false. 프로필 댓글을 비활성화하려면 true로 설정합니다. **/

30 isProfileCommentsPrivate?: boolean;

31 /** 선택 사항, 기본값 false. 이 사용자에게 직접 메시지를 보내는 것을 비활성화하려면 true로 설정합니다. **/

32 isProfileDMDisabled?: boolean;

33 /** 사용자 배지에 대한 선택적 설정. **/

34 badgeConfig?: {

35 /** 할당할 전역 배지 ID 배열. 최대 30개 배지로 제한됩니다. 순서가 유지됩니다. **/

36 badgeIds: string[];

37 /** 현재 페이지(urlId)로 범위가 지정된 배지 ID 배열. 할당된 페이지에만 표시됩니다. **/

38 pageBadgeIds?: string[];

39 /** true인 경우 기존 표시된 배지를 대체합니다. 전역 및 페이지 범위 배지는 독립적으로 재정의됩니다. **/

40 override?: boolean;

41 /** true인 경우 테넌트 설정에서 배지 표시 속성을 업데이트합니다. **/

42 update?: boolean;

43 };

44}

45

중재자 및 관리자

관리자 및 중재자의 경우 SSOUser 객체에 각각 isAdmin 또는 isModerator 플래그를 전달합니다.

알림

알림을 활성화 또는 비활성화하려면 optedInNotifications 값을 각각 true 또는 false로 설정합니다. SSO 페이로드에 이 값이 포함된 상태로 사용자가 처음 페이지를 로드하면 알림 설정이 업데이트됩니다.

또한 사용자가 앱 내 알림뿐만 아니라 구독한 페이지의 활동에 대한 알림 이메일을 받도록 하려면 optedInSubscriptionNotifications를 true로 설정합니다.

VIP 사용자 및 특별 라벨

선택적인 "displayLabel" 필드를 사용하여 사용자 이름 옆에 특별 라벨을 표시할 수 있습니다.

인증되지 않은 사용자

인증되지 않은 사용자를 나타내려면 userDataJSONBase64, verificationHash, timestamp를 채우지 않으면 됩니다. loginURL을 제공합니다.

이러한 사용자는 댓글을 작성할 수 없으며, 대신 로그인 메시지(설정에 따라 메시지, 링크 또는 버튼)가 표시됩니다.

사용자 데이터 직렬화 및 해싱 직접 예제

자세한 내용은 예제로 여기(js), 여기(java), 여기(php)에서 확인할 수 있습니다.

모든 통합이 복잡하고 어려운 과정이 될 수 있다는 것을 우리는 이해하고 있습니다. 담당자에게 문의하거나 지원 페이지를 이용하는 것을 주저하지 마세요.

Simple SSO를 사용하면, 사용자가 댓글을 달기 위해 사용자 이름이나 이메일을 입력할 필요 없이 댓글 위젯에 사용자 정보를 제공할 수 있습니다.

Simple SSO는 다음과 같이 구성할 수 있습니다:

Simple SSO

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "simpleSSO": {

8 "username": "Bob",

9 "email": "bob@example.com",

10 "avatar": "https://example.com/bob.png",

11 "websiteUrl": "https://example.com/profiles/bob",

12 "displayName": "Bob's Name",

13 "displayLabel": "VIP User",

14 "loginURL": "https://example.com/login",

15 "logoutURL": "https://example.com/logout",

16 "badgeConfig": {

17 "badgeIds": [

18 "badge-id-1",

19 "badge-id-2"

20 ],

21 "pageBadgeIds": [

22 "badge-id-3"

23 ],

24 "override": false

25 }

26 }

27}];

28</script>

29

사용자는 로그인된 상태가 되며, 백그라운드에서 SSO 사용자가 생성됩니다. API에서 가져온 경우 사용자는 createdFromSimpleSSO가 true로 설정됩니다.

참고:

• 이메일은 Simple SSO의 고유 식별자입니다.
• Simple SSO에 이메일을 제공하는 것은 필수가 아니지만, 기본적으로 해당 사용자의 댓글은 "Unverified"로 표시됩니다. 이메일이 제공되지 않으면 사용자를 완전히 인증할 수 없습니다.
• NEW 2022년 1월 이후: 사용자 이름은 fastcomments.com 전체에서 고유할 필요가 없습니다.
• Simple SSO는 이메일이 제공되고 사용자가 원래 Secure SSO에서 생성되지 않은 경우 SSO 사용자를 자동으로 생성 및 업데이트할 수 있습니다. Simple SSO 페이로드가 Secure SSO 또는 API에 의해 생성된 사용자를 지정하면 해당 사용자는 그대로 유지되고 방문자는 별도의 사용자를 얻게 됩니다.
• 사용자에게 배지를 지정하려면 badgeConfig 속성을 사용할 수 있습니다. badgeIds 배열은 사용자와 연결할 전역 배지 ID를 포함합니다. pageBadgeIds 배열은 현재 페이지(urlId)에 한정된 배지 ID를 포함하며, 이러한 배지는 할당된 페이지에서만 표시됩니다. override가 true로 설정되면 기존에 표시된 배지를 교체합니다(전역 및 페이지 범위 배지는 독립적으로 교체됨). false인 경우 기존 배지에 추가됩니다.

Simple SSO 설정

Simple SSO는 항상 사용할 수 있습니다. 두 가지 설정이 FastComments가 이를 얼마나 신뢰할지 제어합니다. 커스터마이징 규칙에서 SSO를 검색하면 찾을 수 있습니다. 두 설정 모두 기본적으로 비활성화되어 있으며, "Require SSO To View Comments"가 켜져 있든 꺼져 있든 적용됩니다.

이 설정이 추가될 때 이미 Simple SSO를 사용하고 있던 계정은 두 설정이 모두 켜져 있었으므로 해당 계정에는 변화가 없습니다.

페이지와 가장 잘 일치하는 커스터마이징 규칙만 적용되므로, 규칙이 여러 개 있는 경우 각각에 이 설정을 적용해야 합니다. 다른 규칙 중 하나에 이 설정이 켜져 있으면 새 규칙도 기본적으로 켜진 상태로 시작합니다.

Simple SSO를 통한 자동 댓글 인증

이 옵션이 켜져 있으면 Simple SSO 사용자의 댓글이 즉시 인증됩니다.

이 옵션이 꺼져 있으면 Simple SSO 사용자의 댓글은 Simple SSO 페이로드에 있는 주소로 이메일을 보내고 사용자가 해당 링크를 클릭할 때까지 "Unverified"로 표시됩니다. 인증된 댓글만 자동 승인하도록 설정한 경우에도 해당 링크를 기다리게 됩니다. 페이로드에 이메일이 없으면 댓글은 계속 미확인 상태로 유지됩니다.

이 설정은 댓글에만 영향을 미칩니다. Simple SSO 사용자의 투표는 항상 즉시 집계됩니다.

Simple SSO 관리자 허용

이 옵션이 켜져 있으면 Simple SSO 사용자가 계정의 관리자 또는 중재자가 될 수 있습니다:

• 관리자 또는 중재자 권한을 가진 Simple SSO 사용자는 해당 권한을 유지합니다.
• 관리자 또는 중재자 중 하나와 동일한 이메일을 가진 Simple SSO 사용자는 해당 권한을 획득합니다.

이 옵션이 꺼져 있으면 Simple SSO는 이러한 권한을 부여하지 않습니다. 해당 권한을 가진 사용자를 지정하는 Simple SSO 페이로드는 권한이 없는 별도의 사용자를 생성하며, 원래 사용자는 그대로 유지됩니다.

Simple SSO 페이로드는 서명되지 않으므로, 이 옵션이 켜져 있으면 관리자의 이메일이나 사용자 ID를 아는 누구든지 해당 관리자로 가장할 수 있습니다. 사이트에서 이것이 문제가 된다면 이 옵션을 끄고 관리자는 Secure SSO를 사용하십시오.

Secure SSO 또는 API에 의해 생성된 사용자는 Simple SSO가 접근할 수 없으며, 이 옵션이 켜져 있든 꺼져 있든 마찬가지입니다.

FastComments SSO (자세히 보기)는 사용자가 다른 플랫폼에 로그인하지 않고도 댓글을 달 수 있는 방법을 제공합니다.

하지만 이것만으로는 댓글 스레드를 보호하지 못합니다. 기본적으로 댓글 데이터는 공개 정보이므로 페이지를 볼 수 있는 사람은 누구든지 댓글을 볼 수 있습니다.

설정을 변경하면 관리자가 아니거나 유효한 SSO 사용자가 아닌 경우 댓글을 가져오는 것을 제한할 수 있습니다.

코드 없이 설정

SSO가 설정된 경우 맞춤 규칙을 생성하여 댓글 스레드의 조회 및 상호작용을 방지할 수 있습니다.

이때 SSO를 검색하면 다음 옵션을 찾을 수 있습니다:

댓글 보기를 위한 SSO 요구

이를 활성화하고 맞춤 규칙을 저장합니다.

특정 도메인 또는 페이지만 보호하기

특정 도메인이나 페이지만 보호하려면 맞춤 규칙을 해당하도록 구성하면 됩니다.

맞춤 UI 상단에 도메인과 URL ID 두 개의 입력란이 있습니다.

특정 도메인만 보호하려면 해당 도메인을 "domain" 필드에 입력합니다.

특정 페이지를 보호하려면 "URL ID" 필드에 페이지 URL을 입력합니다. FastComments와 맞춤형 통합을 사용 중이라면 URL 대신 ID 유형을 입력할 수 있습니다.

보안 수준

SSO를 요구할 때 Simple SSO와 Secure SSO 중 어떤 것을 요구할지 결정해야 합니다. Simple SSO를 요구하면 두 가지 모두 허용되지만, Secure SSO를 요구하면 콘텐츠를 보기 위해 API 키로 해시된 Secure SSO 페이로드를 사용해 가져와야 합니다.

"댓글 보기를 위한 SSO 요구"를 선택하면 보안 수준 옵션이 표시되며, 해당 옵션이 켜져 있는 동안에만 적용됩니다.

Simple SSO를 통한 자동 댓글 검증 및 Simple SSO 관리자 허용 설정은 별도로 존재하며, 이 옵션의 켜짐 여부와 관계없이 적용됩니다.

읽기 이상의 보호

이 옵션을 활성화하면 사용자가 SSO를 통해 로그인하지 않는 한 해당 페이지나 도메인에 댓글을 달 수 없게 보호합니다.

주의사항

SSO 통합 이전에 댓글을 만든 사용자는 SSO 통합을 통해 로그인하지 않으면 해당 댓글을 볼 수 없습니다.

기본적으로 FastComments는 댓글을 달기 위해 이메일을 요구합니다. 이메일이 유효할 필요는 없지만, 사용자가 전송된 링크를 클릭할 때까지 해당 댓글은 "Unverified Comment" 라벨이 표시됩니다.

하지만 이메일 요구 사항을 제거할 수 있습니다. 이메일 입력 필드는 여전히 표시되지만 더 이상 필수는 아닙니다.

이 설정은 위젯 사용자 정의 UI를 통해 구성할 수 있습니다:

익명 댓글 활성화

사용자 이름은 여전히 필요합니다. 이 단계도 제거하려면, 모든 사용자가 공유하는 기본 사용자 이름 설정 를 설정하거나, FastComments가 각 방문자를 위해 고유 사용자 이름 생성 하도록 할 수 있습니다.

FastComments는 원하는 일수 이후에 확인되지 않은 댓글을 삭제하도록 구성할 수 있습니다. 이는 스팸 방지에 도움이 됩니다.

기본 설정에서는 삭제되지 않습니다.

이는 조정 설정 페이지를 통해 구성하거나 비활성화할 수 있습니다.

조정 설정

사용자가 댓글을 달고 로그인하지 않은 경우, 이메일을 제공하라는 요청을 받게 됩니다.

이렇게 하면 해당 사용자에 대해 "검증되지 않은 세션"이 생성되며, 이메일을 통해 해당 세션을 검증하도록 요청합니다.

일부 사이트나 애플리케이션에서는 댓글이나 투표 시 사용자에게 이메일을 요청하지 않는 것이 바람직합니다.

익명 댓글을 활성화하면 이메일 입력 필드가 선택 사항이 됩니다. 그러나 이를 완전히 비활성화할 수도 있습니다. 먼저 익명 댓글을 활성화하고, 그러면 이메일 입력 필드를 비활성화하는 옵션이 나타납니다.

이메일 입력 비활성화

이 옵션을 켜면 모든 댓글 제품에서 이메일 필드가 전혀 표시되지 않습니다.

이 설정에서는 사용자가 계정을 만들고 https://fastcomments.com 에 로그인하지 않는 한 모든 댓글이 검증되지 않은 상태가 됩니다.

검증되지 않은 라벨 비활성화를 고려해 볼 수 있습니다.

기본적으로 FastComments는 확인되지 않은 브라우저 세션을 가진 사용자에게 남겨진 댓글에 대해 "Unverified Comment" 라벨을 표시합니다.
확인되지 않은 댓글에 대해 자세히 알아보려면 여기를 참조하세요.

Disable The Unverified Label

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableUnverifiedLabel": true

8}];

9</script>

10

또한, 이 기능은 코드를 작성하지 않고도 커스터마이제이션 UI에서 사용할 수 있습니다:

확인되지 않은 라벨 비활성화

사용자가 댓글에 투표하려고 시도하고 로그인하지 않은 경우, 사용자 이름과 이메일을 제공하라는 요청을 받게 됩니다.

이 요구 사항을 제거하여, 누구든지 정보를 남기지 않고 댓글에 투표할 수 있도록 할 수 있습니다.

익명 투표 허용

사용자가 댓글을 작성하거나 투표할 때 로그인하지 않은 상태라면 이메일과 사용자 이름을 입력하라는 안내가 표시됩니다.

익명 댓글 작성의 경우, 댓글 작성 시의 마찰을 줄이기 위해 기본 사용자 이름을 정의하는 것이 바람직할 때가 있습니다. 이는 Customization UI에서 설정할 수 있습니다. 먼저 익명 댓글 작성(Anonymous Commenting)이 활성화되어 있어야 합니다.

기본 사용자 이름 설정

기본 사용자 이름 공유

기본 사용자 이름은 공유되는 표시 이름이지, 신원(identity)이 아닙니다. 기본값을 그대로 사용하고 이메일을 입력한 방문자는 자신만의 계정을 갖게 되며, 기본 사용자 이름이 공개 이름으로 표시됩니다. 여러 방문자가 동일한 기본값을 사용할 수 있으므로 "Anonymous"가 이미 사용 중이라고 표시되는 일은 없습니다.

방문자가 직접 입력한 사용자 이름은 여전히 고유해야 합니다.

방문자가 직접 이름을 고민하지 않고도 각자 고유한 이름을 갖게 하고 싶다면 사용자 이름 자동 생성 문서를 참고하세요.

사용자가 로그인하지 않은 상태에서 댓글을 작성하거나 투표하면 이메일과 사용자 이름을 입력하라는 안내가 표시됩니다.

일부 사이트에서는 방문자에게 고유한 사용자 이름을 직접 만들도록 요구하는 것이, 특히 모바일에서는 진입 장벽이 될 수 있습니다. FastComments는 새 방문자마다 중립적인 사용자 이름을 생성하여 사용자 이름 필드에 미리 채워 넣을 수 있습니다. 예: BraveOtter4172.

방문자는 그대로 사용하거나 원하는 이름으로 바꿀 수 있습니다.

이 기능은 Customization UI에서 Generate Usernames Automatically 설정을 통해 활성화할 수 있습니다:

Generate Usernames Automatically

동작 방식

• 생성되는 각 이름은 고유합니다. 기존 계정과 대조하여 확인되며 해당 방문자의 브라우저 세션에 예약되므로, 두 방문자에게 동일한 이름이 제안되지 않습니다.
• 이름은 아직 이름이 없는 방문자에게만 생성됩니다. 로그인한 사용자, SSO 사용자, 이미 댓글을 작성한 방문자는 기존 이름을 유지합니다.
• 익명 댓글이 켜져 있든 꺼져 있든 작동합니다. 익명 댓글이 꺼져 있으면 방문자는 여전히 이메일을 입력하지만, 사용자 이름을 고민할 필요는 없습니다.
• 이전에 사용한 적 있는 이메일을 입력한 재방문자는 기존 계정과 매칭되며, 해당 계정의 이름을 유지합니다.
• 기본 사용자 이름도 설정되어 있는 경우, 생성된 이름이 우선 적용됩니다.

기본적으로 FastComments는 사용자의 시스템과 브라우저에 의해 결정된 로캘에 따라 댓글 위젯을 렌더링합니다.

사용자가 댓글을 작성하거나 로그인하면, 마지막으로 사용한 로캘을 업데이트하여 이메일 발송 등에도 이를 사용합니다.

이는 사용자에게 댓글 위젯이 번역되는 방식에 영향을 미칩니다. 로캘은 사용자의 언어와 지역으로 구성되므로, 로캘을 설정하면 일반적으로 사용자에게 표시되는 텍스트의 언어가 변경됩니다.

UI를 통해

위젯 사용자 지정 UI를 사용하여 이를 정의할 수 있습니다. "Locale / Language" 옵션을 참조하세요:

로캘 / 언어 변경

코드를 통해

원하는 로캘로 재정의할 수 있습니다.

사용자의 로캘 수동 정의

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "locale": "ru_ru"

8}];

9</script>

10

지원되는 언어 및 로캘 코드

지원되는 언어 및 해당 로캘 코드의 전체 목록은 여기에서 확인할 수 있습니다.

SSO 참고 사항

SSO를 사용하는 경우, 이메일 및 기타 항목이 사용자에게 올바르게 현지화되도록 사용자 객체에 사용자의 로캘을 전달하는 것이 좋습니다.

기본적으로 FastComments는 댓글에 사용되는 언어를 제한하지 않습니다.

커뮤니티에서 사용하는 언어를 제한하는 것이 바람직할 수 있습니다.

코드 없이 위젯 사용자 정의 페이지에서 구성할 수 있습니다:

허용된 언어

시스템은 댓글을 분석하여 언어를 판단한 다음 허용된 목록과 일치시킵니다.

댓글이 허용되지 않은 언어로 작성된 경우, 현지화된 오류 메시지가 표시됩니다.

기본적으로 FastComments는 위젯 자체 인터페이스(버튼, 레이블, 오류 메시지)를 뷰어의 언어로 번역하지만, 댓글은 작성된 그대로 표시됩니다.

Comment Translation은 댓글 자체의 번역을 추가하여, 여러 언어로 작성하는 커뮤니티가 모든 댓글을 자신의 언어로 읽을 수 있게 합니다.

두 가지 모드가 있습니다:

• Automatic: 위젯 언어와 다른 언어로 작성된 댓글은 번역되어 표시됩니다. 댓글 아래에 "Translated from Spanish"와 같은 문구가 나타나며, Show original 링크를 통해 번역된 텍스트와 원본 텍스트를 전환할 수 있습니다.
• Manual: 모든 댓글에 Translate 링크가 표시됩니다. 이를 클릭하면 해당 댓글이 뷰어의 언어로 번역되며, 이후 동일한 Show original 토글이 제공됩니다. 이미 뷰어 언어로 된 댓글은 대신 해당 언어임을 표시합니다.

대상 언어는 위젯의 언어입니다: 동일한 커스터마이징 규칙에 설정된 로케일 / 언어 설정이 있으면 그 값을 사용하고, 없으면 방문자의 브라우저 언어를 사용합니다. 방문자에게 별도의 계정, 확장 프로그램 또는 추가 소프트웨어가 필요하지 않으며, 임베드된 위젯과 독립형 댓글 페이지 모두에서 동일하게 작동합니다.

이 기능은 커스터마이징 규칙당 활성화되므로 전체 사이트, 하나의 도메인 또는 단일 페이지에 적용할 수 있습니다. 기본적으로 비활성화되어 있습니다.

댓글 번역

번역은 서버 측 설정입니다. 위젯의 JavaScript 구성에 commentTranslation을 전달해도 활성화되지 않으며, 해당 규칙이 이를 활성화합니다.

각 댓글은 대상 언어당 최대 한 번만 번역되며, 결과는 댓글과 함께 저장됩니다. 따라서 천 명의 스페인어 사용자가 읽는 댓글도 한 번만 번역됩니다. 작성자나 모더레이터가 댓글을 편집하면 저장된 번역이 폐기되고 다음 조회 시 다시 번역됩니다. 번역된 텍스트는 원본 댓글과 동일한 정화 및 링크 규칙을 적용받습니다. 너무 길거나 언어를 감지할 수 없는 댓글은 번역되지 않은 상태로 표시됩니다.

사용량은 AI 에이전트와 동일한 요율로 LLM 토큰으로 청구되며, 청구 상세 내 동일한 위치에 표시됩니다.

댓글 작성을 잠글 수 있어, readonly 플래그를 true로 설정하면 새로운 댓글이나 투표를 남길 수 없습니다.

댓글은 편집하거나 삭제할 수도 없습니다.

Making The Comment Thread Readonly

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "readonly": true

8}];

9</script>

10

코드를 사용하지 않고 위젯 커스터마이징 페이지에서 전체 도메인이나 페이지에 대해 맞춤 설정할 수 있습니다:

댓글 스레드 읽기 전용으로 만들기

Update!

2022년 11월부터, 스레드는 답글 영역 위의 점 세 개 메뉴를 통해 관리자와 모더레이터가 실시간으로 잠그거나 잠금 해제할 수 있습니다.

이렇게 하면 새로운 댓글을 방지하면서도 투표는 허용하고, 사용자가 원한다면 자신의 댓글을 삭제할 수 있게 됩니다. 반면 readonly는 이러한 기능을 허용하지 않습니다.

이는 Page API의 isClosed 필드에 해당합니다.

기본적으로 FastComments는 모든 외부 사이트에 대한 링크를 허용합니다.

이는 원하는 사이트 또는 도메인 목록으로 제한할 수 있습니다. 정의된 목록에 없는 사이트 또는 도메인에 대한 링크를 게시하려고 하면 사용자에게 오류가 표시됩니다.

이 검증은 Comment Widget 및 API에만 적용됩니다. 가져오기는 영향을 받지 않습니다.

이는 위젯 맞춤 설정 페이지에서 코드를 사용하지 않고 수행됩니다:

외부 링크 도메인 제한

기본적으로 FastComments는 사용자에게 댓글, 사용자 이름 및 이메일만 요청합니다.

하지만 경우에 따라 사용자가 자신의 블로그나 웹사이트 링크를 남기도록 할 수 있습니다.

enableCommenterLinks 플래그를 true로 설정하면 사용자의 웹사이트 URL을 입력할 수 있는 추가 입력 필드를 표시하도록 활성화할 수 있습니다:

Enabling Commenter Links

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableCommenterLinks": true

8}];

9</script>

10

해당 URL이 제공되면 사용자의 계정이 업데이트되고 과거 및 미래의 모든 댓글에서 사용자 이름이 이 URL에 연결됩니다.

이는 코드 없이 위젯 맞춤 설정 페이지에서 사용자 지정할 수 있습니다:

댓글자 링크 활성화

이 목록은 모더레이션 그룹 페이지에서 생성된 ID들의 목록입니다.

지정하면, 해당 설정을 사용하여 남긴 댓글에는 동일한 moderationGroupIds 세트가 포함됩니다.

만약 Moderator가 하나 이상의 모더레이션 그룹 을 정의해 둔 경우, 그들은 자신의 그룹과 연관된 댓글만 Moderate Comments 페이지에서 보게 됩니다.

Specify Moderation Groups

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "moderationGroupIds": [

8 "mxZAhjzdb",

9 "FT19nXbqA"

10 ]

11}];

12</script>

13

인증을 위해 FastComments는 브라우저에서 제3자 쿠키가 활성화되어 있어야 합니다. 쿠키가 없으면 사용자는 항상 이메일을 입력해야 댓글을 달 수 있습니다(이메일 입력 필드가 숨겨져 있지 않은 경우), 그리고 기본적으로 댓글이 확인되지 않은 상태로 표시됩니다.

이를 해결하려면 제3자 쿠키 우회를 활성화할 수 있습니다.

이 설정을 활성화하면 사용자가 로그인 중임을 알리는 메시지가 표시되는 작은 팝업이 나타납니다. 이 팝업은 사용자가 댓글 위젯과 상호작용할 때마다 표시됩니다; 예를 들어, 댓글을 남길 때.

코드에서 enableThirdPartyCookieBypass 플래그를 true로 설정하여 이 작업을 수행할 수 있습니다:

제3자 쿠키 우회 활성화

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableThirdPartyCookieBypass": true

8}];

9</script>

10

위젯 커스터마이징 UI에서 Enable Third-Party Cookie Popup 아래에 이 설정을 할 수도 있습니다:

제3자 쿠키 우회 활성화

기본적으로 사용자는 자신의 댓글을 삭제할 수 있습니다. 또한, 댓글을 삭제하면 해당 스레드의 모든 하위 및 일시적인 댓글이 자동으로 삭제됩니다. 이 동작은 실시간으로 적용됩니다.

다음과 같은 방법으로 이를 제한할 수 있습니다:

• 대신, 삭제된 댓글을 익명 처리합니다 (이름과 텍스트를 [deleted] 또는 사용자 정의 값으로 설정).
• 답글이 있는 경우 댓글 삭제를 허용하지 않습니다. 사용자 정의 가능한 오류 메시지가 표시됩니다.
• 댓글에 답글이 있을 때 삭제를 관리자와 중재자에게만 제한합니다.

이는 위젯 맞춤 UI의 Comment Thread Deletion 섹션을 통해 구성할 수 있습니다.

답글에 대한 삭제 동작 맞춤 설정

기본적으로 FastComments는 댓글 스레드 내에서 사용자의 댓글에만 배지를 표시합니다.

하지만 위젯 커스터마이징 페이지에서 이 기능을 활성화하면 댓글 양식 위에 이름 옆에 사용자 배지를 표시할 수 있습니다:

상단 바에 배지 표시 옵션

이렇게 하면 상단 바 영역에 사용자의 이름 옆에 배지가 표시되어, 댓글을 작성할 때 사용자의 업적과 상태가 더 눈에 띄게 됩니다.

이 기능이 작동하려면 위젯 커스터마이징 UI에서 반드시 활성화되어야 합니다. 서버 수준에서 켜져 있더라도 코드 구성에서 showBadgesInTopBar 플래그를 false로 설정하여 선택적으로 비활성화할 수 있습니다:

Disable Show Badges in Top Bar

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "showBadgesInTopBar": false

8}];

9</script>

10

기본적으로 FastComments는 페이지에 사용자 목록을 표시하지 않습니다.

현재 페이지를 보고 있는 사람들의 목록을 댓글 위젯과 함께 렌더링할 수 있습니다. 사용자가 입장하거나 퇴장할 때 목록이 실시간으로 업데이트되며, 이름, 아바타 및 온라인 표시기가 표시됩니다.

다음 세 가지 레이아웃 옵션이 있습니다:

• 1 - Top: 댓글 위에 렌더링되는 겹치는 아바타들의 가로 행.
• 2 - Left: 위젯 왼쪽에 렌더링되는 이름과 온라인 점이 있는 사이드바.
• 3 - Right: 위젯 오른쪽에 렌더링되는 동일한 사이드바.

usersListLocation 플래그를 설정하여 기능을 활성화합니다:

오른쪽에 사용자 목록 표시

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "usersListLocation": 3

8}];

9</script>

10

기본적으로 목록은 현재 온라인인 사용자만 표시합니다. 과거에 페이지에 댓글을 달았지만 현재 보고 있지 않은 사람들을 포함하려면 usersListIncludeOffline을 true로 설정합니다:

과거 댓글 작성자 포함

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "usersListLocation": 3,

8 "usersListIncludeOffline": true

9}];

10</script>

11

과거 댓글 작성자는 녹색 온라인 점 없이 렌더링되어 현재 누가 있는지 명확히 표시됩니다.

비공개 프로필을 가진 사용자는 일반 아바타와 "Private Profile" 라벨로 표시되어, 신원을 밝히지 않으면서도 카운트가 정확하게 유지됩니다.

코드 없이도 설정할 수 있습니다. 위젯 커스터마이징 페이지에서 "Users List Location" 옵션을 확인하세요. 위치가 Off가 아닌 값으로 설정되면, 아래에 "Include past commenters" 체크박스가 나타납니다.

사용자 목록 설정

지난 500명의 실시간 사용자에 대해, 목록은 최대 30초 정도 지연될 수 있습니다.