감시 단어 참고 가이드

[Discourse]

이는 Watched Words 페이지가 어떻게 작동하는지, 그리고 Discourse 사이트에서 특정 단어를 차단하기 위해 사용할 수 있는 다양한 동작 유형에 대해 설명하는 #참고 가이드입니다.

필요한 사용자 권한: 관리자(Administrator)

Watched Words 이해하기

.../admin/customize/watched_words 경로에서 Watched Words를 설정하여 주제(topic)나 게시물(post)에서 발견된 단어에 기반하여 동작을 취할 수 있습니다.

동작 유형별로 최대 2,000개의 단어를 사용할 수 있습니다.

모든 동작에서 *를 와일드카드로 사용할 수 있으며, 감시 대상 단어(Watched Words)가 대소문자를 구별하는지(case-sensitive) 여부를 선택하는 옵션이 있습니다.

기본적으로 감시 대상 단어는 숨겨져 있습니다. “단어 표시(show words)” 확인란을 선택하면 단어가 표시되어 삭제할 수 있습니다. 검색 필드를 사용하면 일치하는 단어도 표시됩니다.

“파일에서 추가(Add from File)” 버튼을 사용하여 감시 대상 단어 목록을 일괄 업로드할 수 있으며, “다운로드(Download)” 버튼을 사용하여 모든 동작 유형에 대한 감시 대상 단어 목록을 Discourse에서 다운로드할 수 있습니다. 감시 대상 단어를 일괄 업로드할 때 필요한 파일 형식은 CSV입니다.

일괄 업로드용 CSV 형식

CSV 파일은 동작 유형별로 업로드됩니다 — 동작 유형 자체를 나타내는 열은 없습니다. 모든 동작 유형에 대한 형식은 동일하며, 최대 3개의 열을 가집니다.

열	내용	비고
1	단어 또는 문구	모든 동작 유형에 필수
2	치환 값	Replace(치환), Link(링크), **Tag(태그)**에 필수 — 이 값이 없는 행은 건너뜁니다. 기타 모든 동작 유형에서는 무시됩니다.
3	대소문자 구별 여부	모든 동작 유형에서 선택 사항. 정확한 문자열 true는 대소문자 구별을 활성화하며, 다른 값이거나 열이 비어 있는 경우 대소문자를 구별하지 않음을 의미합니다. TRUE와 True도 허용됩니다.

예시:

badword
another bad phrase
*wildcard*
CaseSensitiveWord,,true
oldword,newword
colour,color
DontTouchThis,leave it alone,true

알아두면 좋은 몇 가지 사항:

• “다운로드(Download)” 버튼은 대소문자 구별 설정을 내보내지 않습니다. 목록을 다운로드했다가 다시 업로드하면, 재수입 전에 3열에 true를 수동으로 추가하지 않는 한 모든 단어가 대소문자를 구별하지 않는 상태로 되돌아갑니다.
• 단어와 치환 값은 각각 100자로 제한됩니다.
• 단어 또는 치환 값에 쉼표가 포함된 경우, 이중 따옴표로 묶어야 합니다 — 표준 CSV 인용 규칙이 적용됩니다 (예: "hello, world",replacement).

모든 동작에는 특정 단어 또는 문구에 감시 대상 단어가 포함되는지 테스트할 수 있는 “테스트(Test)” 버튼이 있습니다.

일치하는 감시 대상 단어 문구 예시

일치하는 항목이 없는 문구 예시

동작 유형

Watched Words 페이지에서는 일치하는 단어에 대해 다음 유형의 동작을 수행할 수 있습니다:

감시 대상 단어(Watched Word)는 하나의 동작 유형 목록에만 존재할 수 있습니다. 중복된 단어가 두 번째 목록에 추가되면 이전 목록에서 제거됩니다.

Block(차단)

이러한 단어를 포함하는 주제나 게시물이 제출될 시점에 전체 주제/게시물을 차단하여 게시되지 않도록 합니다. 사용자가 게시물을 제출하려고 하면 오류 메시지가 표시됩니다.

스태프(관리자 및 모더레이터)의 게시물은 감시 대상 단어에 의해 차단되지 않습니다.

Censor(검열)

이러한 단어를 포함하는 게시물은 허용하지만, 검열된 단어를 숨기는 문자로 단어를 대체합니다. 검열된 단어는 블록으로 대체됩니다. (예: ■■■■■■■■)

Require Approval(승인 필요)

이러한 단어를 포함하는 게시물은 스태프의 승인을 받아야만 볼 수 있습니다. 이 동작 유형의 단어가 포함된 게시물을 제출하면, 스태프가 검토할 때까지 게시물이 숨겨집니다.

스태프(관리자 및 모더레이터)의 게시물은 승인 필요 단어로 스캔되지 않습니다.

Flag(플래그)

이러한 단어를 포함하는 게시물은 허용하지만, 모더레이터가 검토할 수 있도록 플래그를 지정합니다. 플래그가 지정된 단어가 포함된 게시물은 정상적으로 보이지만 검토를 위해 제출됩니다. 검토자는 다양한 옵션을 가집니다:

게시물을 숨기면, 여전히 볼 수는 있지만 다음과 같은 모양을 띱니다:

‘무시된 콘텐츠 보기(View ignored content)’ 링크를 클릭하면 전체 내용이 표시되지만, 여전히 ‘게시물 숨김(post-hidden)’ 상태입니다.

'게시물 유지(Keep Post)'를 선택하거나 옵션에서 '불일치(Disagree)'를 선택하면, 게시물은 다음과 같은 모양을 띱니다:

스태프(관리자 및 모더레이터)의 게시물은 플래그 지정된 단어로 스캔되지 않습니다.

Flag Post on Words Automation을 사용하여 특정 단어가 포함된 경우 주제 생성/수정 시 플래그를 지정할 수도 있습니다.

Link(링크)

게시물 내의 단어를 링크로 대체합니다. 단어를 검열하는 대신, 일반적으로 사용되는 단어를 특정 주제나 외부 URL로 링크하는 데 더 자주 사용됩니다.

이 유형의 동작에 단어를 추가할 때 링크 URL을 선택하지 않으면, Discourse 사이트의 홈페이지가 자동으로 단어 대체 링크로 사용됩니다.

Replace(치환)

게시물 내의 단어를 다른 단어로 대체합니다.

이 동작에 단어를 추가할 때 치환 단어를 선택하지 않으면, 단어는 게시물에서 제거되지만 대체 단어가 그 자리를 차지하지 않습니다 - 단어는 게시물에서 사라지고, 게시물은 제출을 허용받습니다 (권장하지 않음).

치환(Replace) 동작 유형에는 Outputs HTML in the replacement(치환에 HTML 출력) 확인란 옵션이 있습니다.

이 기능을 사용하면 관리자가 치환 텍스트를 설정할 때 HTML 포맷을 사용할 수 있으며, 이는 링크 생성 및 자동 치환된 텍스트에 스타일 강조를 추가하는 데 특히 유용할 수 있습니다.

감시 대상 단어를 사용하여 링크를 재매핑하는 것은 권장되지 않으며, 의도하지 않은 문제를 더 많이 일으킬 수 있습니다. 따라서 감시 대상 단어 → Replace 설정을 사용하여 링크를 재매핑하는 기능은 의도적으로 비활성화되어 있으며, 감시 대상 단어 설정과 관계없이 주제나 게시물에서 링크는 재매핑되지 않습니다.

Tag(태그)

주제의 첫 번째 게시물을 기반으로 이러한 단어로 주제를 자동으로 태그합니다. 이 동작에 포함된 각 단어에 대해 하나 이상의 태그를 추가할 수 있습니다.

이 유형의 동작으로 단어를 제출할 때 태그가 반드시 포함되어야 하며, 그렇지 않으면 오류가 발생합니다.

또한 감시 대상 단어로 주제를 태그할 때, 주제가 올바르게 태그되려면 주제가 게시될 시점에 해당 단어가 주제에 포함되어야 한다는 점에 유의하세요. 태그를 위한 감시 대상 단어가 포함된 주제가 생성된 후 주제를 편집해도 주제에 태그가 추가되지 않습니다.

Silence(무음)

이러한 단어를 포함하는 사용자의 첫 번째 게시물은 스태프의 승인을 받아야만 볼 수 있으며, 사용자는 자동으로 무음(silenced) 상태가 됩니다. 첫 번째 게시물에서 “silence” 단어를 사용하는 사용자는 무음 처리되고, 게시물은 모더레이션 큐로 전송됩니다.

정규식(Regex Expressions)

Watched Words와 함께 정규식을 사용하는 방법에 대한 정보는 다음을 참조하세요:

Regex를 사용하여 감시 단어 설정하기

This topic explains how to effectively use regular expressions (regex) within Discourse’s Watched Words feature. For sites on our hosting, these settings are hidden. Customers on paid hosting plans may contact our support team at team@discourse.org, to request regex with Watched Words. Note: This feature is not available on our Free hosting plan. Regular expressions (regex) are a powerful tool for defining search patterns. You can use regex in the Watched Words featur…

Watched Words와 AI Triage

수동으로 Watched Words를 통해 동작을 설정하는 것 외에도, Discourse는 AI 도구와 통합하여 커뮤니티의 모더레이션 노력을 자동화하고 최적화하는 데 도움을 줄 수 있습니다. Discourse AI - AI triage 기능을 사용하면 독성 콘텐츠 감지(Toxicity Detection) 및 NSFW 감지를 설정하여 문제 있는 콘텐츠를 효과적으로 식별하고 처리하는 능력을 강화할 수 있습니다.

전체 설정 지침은 다음을 방문하여 확인할 수 있습니다:

• 커뮤니티에서 독성 콘텐츠 감지 설정
• 커뮤니티에서 NSFW 감지 설정

개인 메시지(PM)에서의 Watched Words

‘Flag’ 유형의 Watched Words는 개인 메시지(PM)에서도 트리거됩니다. 그 작동 방식에 대한 자세한 내용은 해당 섹션을 참조하세요.

Discourse Chat과 함께 사용하는 Watched Words

Discourse Chat이 활성화되면 일부 Watched Word 유형은 채팅 채널에서도 작동합니다. 각 유형의 채팅 호환성은 다음과 같습니다:

Watched Word 유형	채팅에서 작동?
Block
Censor
Require Approval
Flag
Link
Replace
Tag
Silence

이러한 Watched Words는 채널이든 사용자 간의 직접 메시지든 채팅의 모든 메시지에 적용됩니다.

[JammyDodger]

Making a note here to update the guide with the new ‘Outputs HTML in the replacement’ option, which allows some nifty formatting for Replace and some things like <abbr> for Link.

[henvo]

It would be really nice if,

1. the linkified words had a CSS class attached to them so they could be targeted for different layout (impossible to tell difference between user derived links and auto linked words)
2. there was an option to only link the first instance of the word, instead of every instance in the post

[JammyDodger]

It may also be worth mentioning that some Watched Word types also work in chat.

I think these are the ones:

Watched Word Type	Works in chat?
Block
Censor
Require Approval
Flag
Link
Replace
Tag
Silence

[ganncamp (G Ann Campbell)]

There’s an Add button, but I can’t seem to use it

Why?

I was able to remove a single watched word (quickbooks) from the UI. Why can’t I put it back?

[Moin]

Did you enter the word into the “words or phrases” field?
I am sometimes confused because I forget that this is the field where I need to add the word to activate the add button.

[ganncamp (G Ann Campbell)]

I didn’t realize the “Has words or phrases” input was a text input. The fact that it’s (apparently) pre-filled with “words or phrases” and the + on the end threw me off entirely.

Thanks @Moin!

[Moin]

이것이 입력 필드라는 걸 모르는 사람이 나뿐이 아니라서 다행이에요. @moderators 중 한 분이 이 내용을 Contribute > UX 주제로 옮겨 주실 수 있을까요?

[cuo_wu (James)]

I found an issue with the Watched Words feature.

For example, if I add test as a watched word:

• The phrase hello test world will be matched
• The phrase 你 test 好 will also be matched
• But the phrase 你test好 will not be matched

It seems that Watched Words only works when the keyword is separated by spaces or punctuation. This makes it fail in cases where the keyword is adjacent to other characters, which is very common in languages like Chinese or Japanese (where words are not separated by spaces).

Could you please confirm if this is a bug? If so, it would be great to improve Watched Words so that it matches even when the word is directly next to other characters.

Thanks!

[Moin]

I don’t think it’s a bug. Everything seems to be working as expected. If spaces were ignored by default and ass was a watched word, passkey would trigger that. I think you can use *test* instead as the watched words, and it will work for all three of your examples.

[singi2016cn (Singi Qin)]

Why, after I added the attention word “trash talk” which requires approval, is my post still not being reviewed? Are there other requirements I need to meet?

[Moin]

Does testing the watched word with the text you tried to post work? Maybe you need to add asterisks around your words in case there are no spaces around it as discussed above your post.

Who posted this? Did you use an admin or moderator account for testing? Posts written by staff aren’t queued for approval because they can approve their own posts anyway.

[Welsh_Selkie (Ceri)]

Hi all,

I’m running into an issue with Watched Words (Replace) on our health forum and wondering if anyone has found a solution.

The problem: We use Watched Words to automatically expand medical abbreviations for accessibility (e.g., MGUS → Monoclonal gammopathy of unknown significance (MGUS)). This works perfectly on the initial post, but when anyone edits that post later, the replacement runs again and creates nested recursion like this:

Monoclonal gammopathy of unknown significance (Monoclonal gammopathy of unknown significance (MGUS))

Each subsequent edit adds another layer

What I’ve tried:

• Adding single quotes around the abbreviation: (term) → ('term') - still recurses

• Using HTML entities with “Outputs HTML in replacement” enabled - text disappears entirely on edit

• HTML span tags - displays as literal code and still recurses

I know I could just remove the abbreviation from the replacement text, but it’s important for both internal forum search and external SEO that the abbreviation remains visible in posts. The abbreviations are how most people actually talk about these conditions, and if we only show the expanded term, those searches won’t surface the relevant discussions..

So, I guess my question is whether there’s a way to expand abbreviations that survives post edits without recursion, while keeping the abbreviation visible for searchability?

[zogstrip]

Looks like a bug in the rich text editor, which should be fixed by

FIX: Exclude watched-words and censored from ProseMirror markdown-it engine (#37687)

[Welsh_Selkie (Ceri)]

Thanks @zogstrip - do I need to do anything to update this? As it’s still happening on our Forum, unfortunately

[zogstrip]

Can you try again, I just deployed your instance to have the latest version.

[Welsh_Selkie (Ceri)]

@zogstrip, thank you! That seems to have fixed it - superb. That’s been bugging me for far too long