양식 템플릿 만들기

[lindsey (Lindsey Fogle)]

이 가이드는 Discourse에서 콘텐츠 구조화를 위해 폼 템플릿을 사용하는 방법을 설명합니다.

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

폼 템플릿을 사용하면 사용자가 토픽을 생성할 때 채울 수 있는 검증 규칙이 포함된 구조화된 폼을 만들 수 있습니다. 이를 통해 버그 보고서, 기능 요청 등 사용자 지원을 위해 원하거나 필요한 모든 정보가 제공되도록 할 수 있습니다.

참고: 구조화된 폼보다는 가이드라인 역할을 하는 템플릿의 경우 토픽 템플릿 사용을 고려해 보세요.

폼 템플릿 활성화

**예정된 변경 사항**에서 폼 템플릿 활성화를 "모든 사용자"로 설정하여 폼 템플릿을 켤 수 있습니다.

폼 템플릿 생성

관리자 > 외관 > 폼 템플릿(/admin/customize/form-templates)으로 이동하여 폼 템플릿을 생성하고 관리할 수 있습니다.

폼 템플릿을 생성하려면:

1. 새 템플릿을 클릭합니다.

2. 템플릿 이름 필드에 템플릿의 내부 이름을 입력합니다.

3. 페이지 상단의 버튼을 사용하여 폼의 다양한 필드를 추가하고 필드 속성을 업데이트합니다(아래에 자세히 설명됨). 많은 옵션이 표준 폼 필드 유형(예: 체크박스, 짧은 답변, 드롭다운 등)이지만, 몇 가지 특정 필드가 있습니다:

   • 태그 그룹 선택기: 사용자가 특정 그룹에서 하나 이상의 태그를 선택할 수 있습니다.

   • 마크다운 답변: 사용자가 미니 버전의 작성기에 콘텐츠를 직접 추가할 수 있습니다. 이는 구성원이 코드를 직접 입력하거나 리치 에디터가 지원하는 기타 서식이 필요한 경우 이상적입니다.

4. 입력 필드에 원하는 검증을 추가합니다. 키(아래에도 표시됨)에 대해 검증 버튼을 클릭합니다.

5. 모든 것이 올바르게 보이는지 확인하려면 미리보기 버튼을 클릭합니다.

6. 저장을 클릭합니다.

필드 속성

모든 필드 유형에 공통된 속성:

• label: 표시되는 필드 이름
• placeholder: 빈 필드(입력, 텍스트 영역, 드롭다운, 다중 선택)에 표시되는 도움말 텍스트
• description: 필드 아래에 표시되는 추가 컨텍스트 또는 설명.

업로드 전용 속성:

• file_types: 허용되는 파일 확장자의 쉼표로 구분된 목록(예: .jpg, .png, .pdf)
• allow_multiple: 사용자가 여러 파일을 업로드할 수 있는지 여부를 나타내는 불리언 값

드롭다운 및 다중 선택 속성:

• none_label: 옵션이 선택되지 않았을 때 표시되는 텍스트
• choices: 사용 가능한 옵션의 배열

태그 그룹 선택기 속성:

• tag_group: (최상위 필드 속성) 선택 사항을 채울 태그 그룹의 이름
• none_label: 옵션이 선택되지 않았을 때 표시되는 텍스트
• multiple: 사용자가 여러 태그를 선택할 수 있는지 여부를 나타내는 불리언 값(기본 스캐폴딩은 이를 true로 설정)

검증 옵션

키	유형	설명
required	불리언	폼 제출을 위해 필드가 완료되어야 함을 요구합니다.
minimum	정수	텍스트 필드의 경우, 허용되는 최소 문자 수를 지정합니다.
maximum	정수	텍스트 필드의 경우, 허용되는 최대 문자 수를 지정합니다.
pattern	정규식; 문자열	텍스트 필드의 경우, 허용되는 입력을 지정하는 정규식입니다.
type	문자열	입력 필드의 경우, 예상되는 입력 유형(text, email, date, number, url, tel, color, password)을 지정할 수 있습니다.

범주에 폼 템플릿 추가

템플릿을 생성한 후:

1. 템플릿을 사용하려는 범주로 이동합니다.
2. 버튼을 클릭하여 범주를 편집합니다.

3. 고급 설정 버튼을 토글합니다(새 단순화된 범주 디자인을 사용하는 경우).
4. 템플릿 탭으로 이동합니다.
5. 폼 템플릿 토글을 켭니다.
6. 드롭다운 메뉴에서 폼 템플릿을 선택합니다.
7. 범주 저장을 클릭합니다.

여러 템플릿이 하나의 범주에 할당된 경우, 사용자는 토픽을 생성할 때 템플릿 선택기를 봅니다.

사용자 경험

폼 템플릿을 사용한 토픽 생성

사용자가 폼 템플릿이 있는 범주에서 토픽을 생성하면 폼이 작성기에 자동으로 나타납니다. 여러 템플릿이 동일한 범주에 적용된 경우, 사용자는 드롭다운에서 올바른 템플릿을 선택할 수 있습니다. 사용자가 각 필드를 정확하게 채우지 않고 토픽 생성을 시도하면 검증 오류가 표시됩니다.

폼 값 사전 입력

폼 필드는 필드 ID와 일치하는 URL 매개변수를 사용하여 사전 채울 수 있습니다. 예: /new-topic?software-version=2.4.1&severity=Critical

이는 특정 필드가 이미 채워진 상태로 토픽 생성으로 링크하는 데 유용합니다.

[Eingang]

정규식 패턴은 어떤 형태이며, 어떤 종류의 정규식이 기대됩니까? 다음을 시도해 보았는데 모두 통과했지만, 통과할 것이라고 예상하지 못했습니다:

• 2[6-9][0-1][0-9][0-3][0-9] 패턴에 180918 입력;
• /2[6-9][0-1][0-9][0-3][0-9]/ 패턴에 180918 입력;
• /2[6-9][0-1][0-9][0-3][0-9]/ 패턴에 12 입력;