Discourse 환영 모달

noahl · 2월 3, 2026, 11:48오후


	요약	포럼 탐색 및 참여를 시작할 수 있는 실행 가능한 방법을 신규 또는 복귀 커뮤니티 구성원에게 안내하기 위한 환영 모달
	미리보기	Theme Creator (로그인 필요)
	저장소	GitHub - noahLovell/discourse-welcome-modal · GitHub
	설치 가이드	테마 또는 테마 컴포넌트 설치 방법
	Discourse 테마 초보?	Discourse 테마 사용 입문가 가이드

이 테마 컴포넌트 설치

왜 이걸 사용해야 할까요?

많은 커뮤니티는 높은 가입률을 보이지만 “첫날 이탈” 문제로 어려움을 겪고 있습니다. 이 컴포넌트는 명확하고 실행 가능한 경로를 제공하여 인지 부하를 줄여줍니다.

세분화를 지원하여, 신규 가입자와 휴면 후 복귀한 회원에게 서로 다른 콘텐츠를 제공할 수 있습니다.

스크린샷

데스크톱

작동 방식

1. 정의

신규 사용자: feature_enabled_date 이후에 가입한 사용자.
기존 사용자: feature_enabled_date 이전에 가입한 사용자.
참여 사용자: 정기적으로 방문하는 회원. returning_user_inactivity_months보다 오래 부재하지 않는 한 참여 상태로 유지됩니다.
복귀 사용자: 이전에 참여 상태였으나 returning_user_inactivity_months 임계값을 초과할 만큼 오랫동안 부재했던 회원.

2. 로직 흐름

이 컴포넌트는 가장 활동적인 회원들이 번거로움을 느끼지 않도록 하기 위해 다음 우선순위 목록을 따릅니다:

신규 가입자? 즉시 모달을 확인합니다 (card_content가 new_users 또는 both로 지정된 경우 대상이 됨).
유예 기간 (기존 사용자용): "기존 사용자"가 grace_period_months 기간 내에 방문하면, 컴포넌트는 조용히 확인 상태로 표시합니다. 현재 활동 중이므로 환영 메시지가 필요 없다고 판단하여 모달을 표시하지 않습니다.
부재 간격: 사용자가 모달을 "확인"했다고 표시된 후(조용히 또는 수동으로), 컴포넌트는 방문을 로컬에서 추적합니다. 매일 방문하면 참여 상태로 유지되며 다시는 모달을 보지 않습니다. 방문 간격이 returning_user_inactivity_months 설정을 초과할 때만 복귀 사용자로 다시 모달을 확인하게 됩니다.

3. 맞춤형 콘텐츠

displayFor 설정을 사용하여 특정 카드를 특정 그룹에 표적화할 수 있습니다:

new_users: "게시물 작성 방법"이나 "자기소개하기"에 적합합니다.
returning_users: "부재 중 변경된 사항 확인하기"에 적합합니다.
both: 가이드라인이나 FAQ와 같은 필수 링크에 적합합니다.

설정

설정	유형	기본값	설명
`enabled`	`bool`	`false`	컴포넌트 전역 토글.
`feature_enabled_date`	`string`	`"2026-02-06"`	신규 사용자와 기존 사용자를 구분하는 기준선 (YYYY-MM-DD).
`grace_period_months`	`integer`	`3`	이 기간 내에 방문하는 기존 사용자는 조용히 제외됩니다.
`returning_user_inactivity_months`	`integer`	`6`	“부재 임계값.” 사용자가 이 기간보다 오래 부재해야만 모달을 다시 확인합니다.
`card_layout`	`enum`	`"grid"`	카드를 `grid` 또는 `list` 형식으로 표시.
`card_content`	`objects`	`[]`	카드를 정의하고 `displayFor`를 `new_users`, `returning_users`, 또는 `both`로 설정.

설정 테스트

이 URL 매개변수를 사용하여 로직을 우회하고 작업을 미리 볼 수 있습니다:

?show-welcome-modal=true&user-type=new - “신규 사용자” 경험 미리보기.
?show-welcome-modal=true&user-type=returning - “복귀 사용자” 경험 미리보기.

이것은 제 첫 번째 정식 테마 컴포넌트입니다 새로운 세분화 기능에 대한 피드백이나 개선할 수 있는 다른 사항에 대한 의견을 듣고 싶습니다!

marksalter · 2월 5, 2026, 5:01오후

안녕하세요, @noahl

이 기능을 테스트하고 데모 이미지처럼 타일을 확인하는 가장 쉬운 방법이 있을까요? PORD 환경에서 더 광범위하게 배포하기 전에 관리자가 타일을 미리 볼 수 있도록 설정할 수 있는 특정 설정이 있을까요?

noahl · 2월 5, 2026, 5:41오후

hey @marksalter! 당신이 첫 번째 "기능 요청자"입니다

방금 enable 설정과 모달을 강제로 표시하는 쿼리 파라미터 ?show-welcome-modal=true를 추가했습니다.

이 두 가지를 함께 사용하면 사용자에게 활성화하기 전에 Admin으로 테스트할 수 있습니다

예를 들어, enabled를 off로 설정하면(누구에게도 표시되지 않음) 쿼리 파라미터를 사용해 강제로 볼 수 있습니다.

marksalter · 2월 5, 2026, 5:44오후

완벽하게 작동합니다! 확인해 주셔서 감사합니다.

marksalter · 2월 5, 2026, 6:00오후

다음 개발 라운드를 위한 아이디어 하나입니다.

활성화 유예 기간 동안 활동하지 않은 기존 사용자와 신규 사용자에게 각각 어떤 메시지를 표시할지 구분할 수 있으면 좋겠습니다.

즉, 신규 사용자에게는 환영 메시지(시작 가이드로 이동)를, 기존 사용자에게는 신규 기능 안내 메시지(새로운 기능/카테고리 등을 확인하세요)를 보내는 방식이죠.

jordan.vidrine · 2월 6, 2026, 10:51오전

정말 좋습니다! 잘하셨습니다

푸터를 제거하는 것에 대해 어떻게 생각하시나요? CTA와 닫기 버튼이 이미 있는 상황에서 Done 버튼은 다소 불필요해 보이는데, 어떻게 생각하시는지 궁금합니다?

github.com/noahLovell/discourse-welcome-modal

javascripts/discourse/components/welcome-modal.gjs

44add6a42


      
          <:footer>
              <DButton
                  @translatedLabel={{this.modalCloseBtn}}
                  @action={{this.dismissModal}}
                  class="btn-transparent close-button"
              />
          </:footer>

noahl · 2월 6, 2026, 1:43오후

이 아이디어 정말 좋습니다! 첫 번째 버전에서는 고려해 봤지만, 초기 릴리스를 단순하게 유지하기로 결정했었습니다.

어쨌든, 이 세분화를 구현한 업데이트를 방금 푸시했습니다! 다양한 사용자 상태를 구별하도록 로직을 약간 변경하여, 사용자를 거슬리지 않으면서 콘텐츠를 맞춤 설정할 수 있게 되었습니다.

현재 작동 방식:

1. 정의

신규 사용자: feature_enabled_date 이후에 가입한 사용자.
기존 사용자: 해당 날짜 이전에 가입한 사용자.
활동적 사용자: 정기적으로 방문하는 멤버(비활성화 기간 내).
복귀 사용자: 비활성화 임계값을 초과할 정도로 오랫동안 자리를 비웠던 이전의 활동적 멤버.

2. 로직 흐름 가장 활동적인 멤버들을 거슬리지 않도록 하기 위해, 컴포넌트는 특정 우선순위를 따릅니다:

신규 가입: 즉시 모달을 확인합니다(new_users 또는 both로 표시된 카드로 타겟팅).
그레이스 기간: '기존 사용자’가 그레이스 기간 동안 방문하면, 컴포넌트가 조용히 확인된 것으로 표시하여 방해하지 않습니다.
비활성화 기간: 사용자가 '확인됨’으로 표시되면, 컴포넌트는 로컬에서 방문을 추적합니다. 매일 방문하면 활동적 상태를 유지하며 다시는 보지 않습니다. 방문 간격이 returning_user_inactivity_months 설정값(새로운 설정입니다 )을 초과할 때만 (복귀 사용자로) 다시 확인하게 됩니다.

3. 맞춤형 콘텐츠 이제 각 카드에서 displayFor 설정을 사용할 수 있습니다:

new_users: '게시하는 법’이나 '자기소개’에 적합합니다.
returning_users: '부재 중에 무엇이 바뀌었는지 확인해 보세요.'에 적합합니다.
both: 가이드라인이나 FAQ와 같은 필수 링크에 적합합니다.

이 플로우를 쉽게 테스트할 수 있도록 미리보기 매개변수도 추가했습니다: ?show-welcome-modal=true&user-type=new 또는 &user-type=returning.

다시 한번 조언해 주셔서 감사합니다!

marksalter · 2월 6, 2026, 3:00오후

@noahl 정말 멋지네요!

오늘 늦거나 월요일에 한번 살펴보고 어떻게 되는지 알려드릴게요.

글		댓글	조회수
Call to action - encourage new users to participate UX	25	763	12월 17, 2024
New user alerts Community Building	17	1453	9월 28, 2023
Welcome screen for new users? Community Building	11	510	6월 26, 2025
Reply reminder - Remind users to reply to new users topics with zero replies Feature pr-welcome	55	10937	8월 6, 2020
How to inspire visitors to make the first post? Community Building	23	3829	12월 28, 2019