사용자 정의 및 구성

댓글 위젯이 예를 들어 테넌트 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를 사용합니다.

When rendering a comment thread, or leaving a comment, FastComments needs to know what page, or article, or product those comments belong to.

댓글 스레드를 렌더링하거나 댓글을 남길 때, FastComments는 해당 댓글이 어느 페이지, 기사, 혹은 제품에 속하는지 알아야 합니다.

To do this, we use something we call the "URL ID". It's either an identifier, like a string or a number, or a URL.

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

By default, if you do not specify the urlId, it will become the page URL. We will take the current page URL, and clean it to remove any common marketing parameters or tracking identifiers.

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

In the case of third party integrations, like WordPress, our plugin will usually use the identifier that represents the current information being viewed as the URL ID, for example the article/page id.

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

One thing that we'll often reference in this document is the 위젯 커스터마이징 UI.

This UI can be used to make many changes to the comment widget without using code.

When creating a customization rule, we'll often want it to apply to all pages to our site. However, in some cases we want to customize the comment widget on a particular page, either to apply custom styling, or maybe make comments for that particular page anonymous. You could also, for example, have live comments appear right away on some pages, while hiding them under notification buttons on others.

This is all possible via the URL ID input field on this page, which looks like as follows:

위젯 커스터마이징 페이지의 URL ID 입력

The value in this field should match the urlId parameter passed into the comment widget. If you want your customization rule to be urlId agnostic, leave this field empty or enter *.

이 필드의 값은 댓글 위젯에 전달되는 urlId 매개변수와 일치해야 합니다. 커스터마이징 규칙을 urlId와 무관하게 만들고 싶다면, 이 필드를 비워두거나 *를 입력하세요.

As of 2023 the URL ID field in widget customization now also takes patterns! For example you may have */blog/* to add styling specific to your blog and */store/* to have styling specific to your store, all while using the same domain.

2023년 현재 위젯 커스터마이징의 URL ID 필드는 이제 패턴도 지원합니다! 예를 들어 */blog/*를 사용해 블로그에 특화된 스타일을 적용하고, */store/*를 사용해 스토어에 특화된 스타일을 적용할 수 있으며, 모두 동일한 도메인을 사용합니다.

주의사항

1. If your page has hash parameters (like example.com#page-1) - this will become part of the URL ID, by default.
2. 페이지에 해시 파라미터가 있는 경우(예: example.com#page-1) - 기본적으로 이것이 URL ID의 일부가 됩니다.
3. During migrations, for example from WordPress to Gatsby, you may have to migrate the URL ID comment values after the initial migration. For that, reach out to us.
4. 마이그레이션 중, 예를 들어 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 로케일의 댓글 위젯에 표시되는 텍스트를 찾아 교체 텍스트를 지정할 수 있습니다.

맞춤 텍스트

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

사용자가 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

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

이미지 업로드 비활성화

By default FastComments does not allow iframes in comments. When you enable media embeds, commenters can paste the embed code (the <iframe> snippet) from trusted providers like YouTube, Vimeo, SoundCloud, and Spotify, and it will render inline in the comment.

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

For security, this is not a client-side widget config flag. It is a server-side setting, validated when each comment is saved, so it cannot be turned on from the page. Only iframes pointing at a built-in list of trusted providers are allowed. Any other iframe is removed.

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

This is done without code, on the widget customization page:

미디어 임베드 허용

자체 제공업체 추가

If you want to allow embeds from a provider that is not on the built-in trusted list, add its hostname in the "Additional Embed Domains" field on the same page. These hostnames are allowed in addition to the built-in providers. Matching is exact, so include the full hostname (for example, player.example.com). Anything you do not list stays blocked.

내장된 신뢰 목록에 없는 제공업체의 임베드를 허용하려면, 같은 페이지의 "Additional Embed Domains" 필드에 해당 호스트명을 추가하십시오. 이러한 호스트명은 내장된 제공업체에 추가로 허용됩니다. 일치 여부는 정확히 비교되므로 전체 호스트명(예: player.example.com)을 포함해야 합니다. 목록에 포함되지 않은 모든 항목은 차단됩니다.

Both the plain comment box and the WYSIWYG editor support pasting an embed. In the WYSIWYG editor the embed is inserted as a removable block.

일반 댓글 입력 상자와 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*를 추적하므로, 같은 댓글을 다시 보면 카운트가 증가하지 않습니다. 두 년 후에 다시 보면 카운트가 증가합니다.

• *Note: 익명 세션 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는 처음 댓글을 다는 사용자가 댓글을 제출하기 전에 서비스 약관에 동의하도록 요구할 수 있게 합니다.

활성화된 경우:

• Anonymous users will see a TOS checkbox every time they comment
• Authenticated users will see the checkbox only on their first comment, or when you update your TOS

Configuration

Navigate to the widget customization page and enable the "Require Terms of Service acceptance" checkbox. Once enabled, you'll see the following options:

서비스 약관 옵션

• TOS Text Mode: 기본적으로 체크박스는 "I agree to the Terms of Service and Privacy Policy" 라는 문구와 두 문서에 대한 링크를 표시합니다. "Customize text per locale"을 선택하면 각 언어에 대한 자체 텍스트를 제공할 수 있습니다.
• TOS Last Updated Date: 서비스 약관을 업데이트할 때 이 날짜를 설정합니다. 이 날짜 이전에 동의한 사용자는 다시 동의해야 합니다.

How It Works

• The TOS acceptance timestamp is stored per-user and per-comment
• When a user accepts the TOS, the date is recorded on their user profile (per-tenant)
• If you set a "Last Updated" date that is after the user's acceptance date, they will need to re-accept
• For anonymous users who cannot be tracked, the checkbox appears on every comment submission

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

유사한 SSO 메커니즘을 사용하는 다른 제공업체에서 마이그레이션하는 방법 및 차이점에 관한 문서도 있습니다.

The flow looks like this:

Secure SSO Flow

Secure SSO는 풀스택 개발을 포함하므로 Java/Spring, NodeJS/Express, 그리고 순수 PHP의 전체 동작 코드 예제가 현재 on GitHub.

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

FastComments SSO로 새로운 API 엔드포인트를 작성할 필요가 없습니다. 단순히 비밀 키로 사용자의 정보를 암호화하고 페이로드를 댓글 위젯에 전달하면 됩니다.

API 시크릿 키 받기

Your API Secret can be retrieved from this page. 이 페이지는 내 계정(My Account)에서 API/SSO 타일을 클릭한 다음 "API 시크릿 키 받기"를 클릭해서도 찾을 수 있습니다.

댓글 위젯 매개변수

댓글 위젯에 대한 상위 수준 API 문서는 here에서 찾을 수 있습니다.

이제 이 매개변수들이 무엇을 의미하는지 자세히 살펴보겠습니다.

댓글 위젯은 구성 객체를 사용합니다 - FastComments를 사용하여 고객 id(tenantId)를 전달하고 있다면 이미 이 객체를 전달하고 있는 것입니다.

SSO를 활성화하려면 새로운 "sso" 객체를 전달하세요. 이 객체는 다음 매개변수를 포함해야 합니다. 값들은 서버 측에서 생성되어야 합니다.

• userDataJSONBase64: 사용자의 데이터(JSON 형식)를 Base64로 인코딩한 값.
• verificationHash: UNIX_TIME_MILLIS + userDataJSONBase64로 생성된 HMAC-SHA256 해시.
• timestamp: Epoch 타임스탬프, 밀리초 단위. 미래여서는 안 되며, 과거 2일을 초과해서는 안 됩니다.
• loginURL: 댓글 위젯이 사용자 로그인을 위해 표시할 수 있는 URL.
• logoutURL: 댓글 위젯이 사용자 로그아웃을 위해 표시할 수 있는 URL.
• loginCallback: 로그인 URL 대신 제공될 경우, 댓글 위젯이 로그인 버튼을 클릭할 때 호출할 함수.
• logoutCallback: 로그아웃 URL 대신 제공될 경우, 댓글 위젯이 로그아웃 버튼을 클릭할 때 호출할 함수.

Secure SSO Client Code

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": 1787115343147.0,

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

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

13 "loginCallback": null,

14 "logoutCallback": null

15 }

16}];

17</script>

18

사용자 객체

사용자 객체

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자. 이 라벨은 이름 옆에 표시됩니다. 해당되는 경우 기본값은 관리자/모더레이터입니다. **/

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. false로 설정하면 사용자 프로필의 "activity" 탭을 활성화합니다. **/

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

Moderators and Administrators

관리자 및 모더레이터의 경우, SSOUser 객체에 각각 isAdmin 또는 isModerator 플래그를 전달하세요.

알림

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

또한, 사용자가 구독한 페이지에서의 활동에 대해 (인앱 알림뿐만 아니라) 이메일 알림을 받게 하려면 optedInSubscriptionNotifications를 true로 설정하세요.

VIP 사용자 및 특수 라벨

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

인증되지 않은 사용자

인증되지 않은 사용자를 나타내려면 userDataJSONBase64, verificationHash, 또는 timestamp를 채우지 마세요. loginURL을 제공하세요.

이 사용자들은 댓글을 달 수 없으며, 대신 로그인 메시지(구성에 따라 메시지, 링크 또는 버튼)가 표시됩니다.

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

자세한 예제는 여기 (js), 여기 (java) 및 여기 (php)를 참조하세요.

어떤 통합 작업도 복잡하고 어려울 수 있다는 것을 이해합니다. 담당자에게 문의하거나 support page를 이용하는 것을 주저하지 마세요.

FastComments SSO (자세히 보기) provides your users with a way to comment without having to log in to another platform.

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

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

코드 없이 설정

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

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

댓글 보기를 위한 SSO 요구

이를 활성화하고 맞춤 규칙을 저장하십시오.

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

특정 도메인 또는 페이지만 보호하려면 맞춤 규칙을 간단히 구성하면 됩니다.

맞춤 UI 상단에서 두 개의 입력란, Domain과 URL ID를 찾을 수 있습니다.

특정 도메인만 보호하려면 해당 도메인을 "domain" 필드에 입력하십시오.

특정 페이지를 보호하려면 "URL ID" 필드에 페이지 URL을 입력하십시오. FastComments와 맞춤형 통합이 있는 경우 URL 대신 ID 유형을 입력할 수 있습니다.

보안 수준

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

"댓글 보기를 위한 SSO 요구"를 선택하면 보안 수준 옵션이 표시됩니다.

읽기 이상의 보호

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

주의사항

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

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

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

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

익명 댓글 활성화

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에서 사용할 수 있습니다:

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

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

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

익명 투표 허용

사용자가 댓글을 달거나 투표할 때, 로그인하지 않은 경우 이메일과 사용자 이름을 제공하라는 요청을 받게 됩니다.

익명 댓글의 경우, 댓글 작성 시 마찰을 줄이기 위해 기본 사용자 이름을 정의하고 싶을 때가 있습니다. 이는 커스터마이제이션 UI에서 설정할 수 있습니다. 익명 댓글 기능을 먼저 활성화해야 합니다.

기본 사용자 이름 설정

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

사용자가 댓글을 달거나 로그인하면 마지막으로 사용한 로케일을 업데이트하고 이를 이메일 발송에도 사용합니다.

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

Via The UI

위젯 커스터마이징 UI를 사용하여 정의할 수 있습니다. "Locale / Language" 옵션을 확인하세요:

로케일 / 언어 변경

Via Code

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

Manually Defining the User's Locale

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

Supported Languages and Locale Codes

지원되는 언어와 해당 로케일 코드를 전체 목록을 여기에서 확인하세요.

SSO Note

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

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

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

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

허용된 언어

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

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

댓글 작성을 잠글 수 있어, 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초 정도 지연될 수 있습니다.