사용자 정의 필드 생성 및 구성

:bookmark: 이 가이드는 Discourse에서 사용자 정의 필드를 생성하고 구성하는 방법을 설명합니다. 가입 양식, 사용자 프로필 및 사용자 디렉터리에 필드를 추가하는 방법도 포함됩니다.

:person_raising_hand: 필요한 사용자 권한: 관리자

사용자 정의 필드를 사용하면 표준 프로필 필드 외에 사용자에게 추가 정보를 수집할 수 있습니다. 이러한 필드는 사용자 카드, 사용자 요약 페이지에 표시될 수 있으며 Data Explorer 플러그인을 통해 조회할 수도 있습니다. 이 가이드에서는 사용자 정의 필드를 생성하고 구성하는 과정을 안내해 드립니다.

사용자 필드 추가

  1. 관리자 > 커뮤니티 > 사용자 필드(discourse.example.com/admin/config/user-fields)로 이동합니다.

  2. 아직 사용자 필드를 생성하지 않았다면 다음 화면이 표시됩니다.

  3. 새 필드를 추가하려면 “사용자 필드 추가” 버튼을 클릭합니다.

필드 유형 선택

필드 유형은 가입 양식에서 사용자가 볼 입력 필드를 결정합니다. 수집하려는 정보의 종류에 따라 선택하세요:

텍스트 필드

  • 가능한 답변이 많은 짧은 질문(예: “어떤 회사에서 일하십니까?”)에 사용합니다.
  • 단일 줄 HTML 텍스트 입력으로 표시됩니다.

텍스트 영역

  • 더 길고 여러 줄의 답변이 필요한 질문(예: “자기소개를 해주세요”)에 사용합니다.
  • 여러 줄 HTML 텍스트 영역 입력으로 표시됩니다.

날짜

  • 날짜 값을 수집할 때(예: “생년월일은 언제입니까?”) 사용합니다.
  • 날짜 선택기 입력으로 표시됩니다.

확인

  • 예/아니오 질문(예: “뉴스레터 구독을 원하십니까?”)에 사용합니다.
  • HTML 체크박스로 표시됩니다.
  • 사용자가 확인해야 하는 중요한 링크를 HTML을 사용하여 추가할 수 있습니다. 예:
    커뮤니티 가이드라인을 읽고 따르겠습니다. <a href="https://meta.discourse.org/guidelines">커뮤니티 가이드라인</a>

드롭다운

  • 가능한 답변이 정해져 있는 질문(예: “성별은 무엇입니까?”)에 사용합니다.
  • HTML select 입력으로 표시됩니다.

드롭다운 필드에 옵션을 추가하려면:

  1. 옵션 입력란을 클릭합니다.
  2. 답변을 입력하고 "생성"을 클릭합니다.
  3. 추가 옵션에 대해 반복합니다.

완료된 옵션은 다음과 유사한 모습을 보여야 합니다:

다중 선택

  • 사용자가 옵션 목록에서 여러 답변을 선택할 수 있는 질문(예: “어떤 주제에 관심이 있습니까?”)에 사용합니다.
  • 다중 선택 입력으로 표시됩니다.
  • 옵션은 드롭다운 필드와 동일한 방식으로 구성됩니다.

필드 이름 및 설명 설정

  • 필드 이름: 가입 양식 및 사용자 프로필에서 입력란 앞에 표시됩니다.
  • 필드 설명: 사용자가 필드를 채우는 데 도움을 주기 위해 입력란 뒤에 표시됩니다.

:information_source: 필드를 저장하려면 필드 이름과 설명 모두 필수입니다.

다음은 가입 양식에 사용자 정의 필드가 표시되는 방법입니다:

사용자 필드 옵션 구성

필드 요구 사항

  • 선택 사항 - 선택 필드는 사용자가 비워 둘 수 있습니다.
  • 모든 사용자 대상 - 필드가 모든 사용자에게 필수로 설정되면, 로그인한 사용자를 포함한 모든 계정에 해당 필드를 채워야 합니다. 이는 서비스 약관(ToS) 준수와 같은 경우에 매우 유용합니다.
  • 가입 시 - 모든 새 계정은 해당 필드를 채워야 합니다.

추가로, 생성 양식의 하단에는 다음 설정 체크박스가 있습니다:

  • 가입 후 수정 가능: 사용자가 프로필 페이지에서 필드를 업데이트할 수 있도록 허용합니다.
  • 공개 프로필에 표시: 사용자 요약 페이지에 필드 값을 표시합니다.
  • 사용자 카드에 표시: 사용자 카드에 필드 값을 표시합니다.
  • 검색 가능: 사용자 디렉터리에서 이 필드의 값에 기반하여 사용자를 검색할 수 있도록 활성화합니다.
  • 가입 양식에 표시: 필드가 가입 양식에 표시되는지 여부를 제어합니다. 필드 요구 사항이 “모든 사용자 대상” 또는 "가입 시"이거나, 필드가 가입 후 수정 불가능한 경우 자동으로 활성화되며(비활성화할 수 없음) 유지됩니다.

공개 프로필에 표시

활성화된 경우, 필드 값은 사용자의 프로필 페이지에 표시됩니다:

사용자 카드에 표시

활성화된 경우, 필드 값은 사용자 카드에 표시됩니다:

검색 가능

활성화된 경우, 사용자 정의 필드 값에 기반하여 사용자를 검색할 수 있습니다:

필드 저장 및 편집

  1. "저장"을 클릭하여 사이트를 사용자 필드 목록에 추가합니다.
  2. 필드를 편집하려면 목록에서 해당 필드 옆의 “편집” 버튼을 클릭합니다.
  3. 필드를 삭제하려면 옆의 점 메뉴(⋮)를 클릭하고 "삭제"를 선택합니다.

사용자 디렉터리에 사용자 정의 필드 추가

  1. 사용자 디렉터리로 이동합니다.
  2. 렌치 아이콘을 클릭합니다:

  1. 표시할 사용자 정의 필드를 선택합니다.
  2. "저장"을 클릭합니다.

선택한 사용자 정의 필드는 이제 사용자 디렉터리 테이블에 표시됩니다:

40개의 좋아요
Any Plugins/Easy Mods for an Extended User Profile
Add introductory text for sign-up
Setting Security Parameters: Log-In, Read-Only, Protected Groups
Theme-Component v Plugin: What's the difference
User preference on theme components
Users self-select Category on Registration... is it possible?
Private custom user fields...?
Can we implement a system for user remarks during registration for admin review?
User customizable theme components (how-to)
This freaking software works so well I can’t even
User Field Prompt
New user reviews: admin assignment and logging of progress
Add users to groups on signup
How to add min or max values in custom fields?
Add a custom per-user setting in a plugin
Welcome questions on the first screen for bio
Announcing - Gender Pronouns Userfield on Meta
Grant Custom Badge Upon Reading ToS
If topic info is too long, tags are cut off and create a blank line
Required vs. optional sign-up fields
Terms of Service Checkbox
Hidden User Fields
New user filter by custom field and contact
Social Features
Where in Discourse can users publicly share PII?
Linking "static" information about member to topic posted
Add custom fields to signup and login
Using Discourse as a social media platform
Add users to groups through custom field automation
Custom user post display
Disable account confirm emails when creating users via API
Links in additional fields
Clickable Social Icon Links on Profile
Extend Existing Controller?
Requiring acceptance of terms and conditions
"Fake" OAuth Provider?
Extend Existing Controller?
Allow users to block keywords
Customize Your Site Branding
Restrict the users to post in the groups who haven't uploaded their profile picture
Adding non-visible user custom fields to the API
Seeking Advice: making a discourse forum hyper local
Can add short message to verify? Just input phone number can sign up
Add terms when make new topic
Export custom field for users in discourse hosted forum
Customizing Sign-up and Log in
Grouping poll results by user custom field
Disclaimer for tutorials
How to add custom logic input on the signup page?
Terms of service changes in Discourse platform
Custom user fields not available in api