 |
요약 | Discourse Templates 플러그인은 반복 사용 가능한 콘텐츠 템플릿을 생성할 수 있습니다. 템플릿은 특수 카테고리에 주제(topic)로 저장되며, 필요에 따라 편집하고 논의할 수 있습니다. |
 |
설치 가이드 | 이 플러그인은 Discourse 코어에 번들로 포함되어 있습니다. 플러그인을 별도로 설치할 필요가 없습니다. |
이 플러그인은 Discourse Canned Replies의 새로운 버전과 비슷하지만, 더 유연하고 템플릿을 다른 방식으로 저장합니다.
기능
이 플러그인은 나중에 사용할 템플릿을 저장하기 위해 하나 이상의 카테고리를 사용합니다. 이러한 카테고리 내 각 주제의 첫 번째 게시물이 답변 템플릿으로 사용됩니다.
이 방식은 discourse-canned-replies로 사용 가능했던 것보다 훨씬 더 많은 기능을 제공합니다. 각 템플릿에는 편집 이력이 있고, 관련 태그를 가질 수 있으며, 필요할 경우 후속 게시물을 사용하여 템플릿의 내용을 논의할 수 있습니다.
템플릿으로 사용될 수 있는 것은 표시(visible)되는 주제만이며, 목록에서 제외된(unlisted) 및 아카이브된 주제는 목록에 표시되지 않습니다.
이 플러그인은 카테고리 보안 설정을 활용하여 어떤 사용자가 템플릿을 사용할 수 있는지 확인합니다. 사용자가 해당 카테고리의 주제를 읽을 수 있다면, 작성기(composer)에서 “템플릿 삽입” 옵션이 사용 가능해집니다. 사용자는 액세스 권한이 있는 카테고리에서 템플릿/주제만 볼 수 있습니다.
서로 다른 사용자 그룹에게 다른 템플릿 세트를 제공하거나 템플릿을 정리하기 위해 여러 상위 카테고리 및/또는 하위 카테고리를 사용할 수 있습니다.
개인 템플릿
이 플러그인은 개인 템플릿도 지원합니다. 개인 템플릿은 템플릿으로 태그된 개인 메시지입니다. 이러한 메시지는 오직 메시지 작성자에게만 템플릿으로 사용 가능합니다.
아카이브된 메시지는 템플릿으로 목록에 표시되지 않습니다.
모든 개인 템플릿은 다음 위치에서 찾을 수 있습니다:
/u/{USER-NAME}/messages/tags/{PRIVATE-TEMPLATE-TAG}
설정:
discourse templates enabled: 플러그인을 활성화합니다.discourse templates categories: 템플릿을 저장하는 데 사용되는 카테고리입니다. 이 카테고리 및 그 하위 카테고리 내의 각 주제는 템플릿으로 사용되며, 원본 카테고리에서 해당 주제를 볼 수 있는 사용자에게 사용 가능합니다.discourse templates enable private templates: 개인 템플릿 사용을 활성화합니다.discourse templates groups allowed private templates: 개인 템플릿 사용이 허용된 사용자 그룹입니다.
스태프(관리자)는 항상 사용이 허용됩니다.
discourse templates private templates tags: 개인 메시지를 템플릿으로 표시하는 데 사용되는 태그입니다.
사용 방법
플러그인을 설치한 후, 템플릿을 저장하기 위해 최소한 카테고리를 하나 만들어야 합니다.
이 카테고리의 주제를 읽는 데 액세스 권한이 있는 모든 사용자가 작성기에서 플러그인 기능을 사용할 수 있다는 점에 유의하세요.
새 주제 기본적으로 위키로 만들기를 활성화해야 합니다.
그런 다음, 플러그인 설정에서 해당 카테고리를 지정하세요.
이것으로 끝입니다. 이제 지정된 카테고리에 몇 가지 주제를 만들면 템플릿으로 사용할 수 있습니다.
원하는 경우 템플릿을 더 잘 정리하거나 여러 사용자 그룹에게 서로 다른 답변 세트를 제공하기 위해 하위 카테고리를 만들 수 있습니다.
템플릿을 삽입하려면 먼저 답변 작성기를 열고 추가(extras) 버튼을 클릭한 다음, “템플릿 삽입” 옵션을 선택해야 합니다.
원하는 템플릿을 선택하세요. 텍스트 또는 태그로 검색할 수 있으며 “붙여넣기” 아이콘을 클릭합니다.
키보드 단축키
PC에서는 Ctrl+Shift+I, Mac에서는 ⌘+Shift+I를 사용하여 템플릿을 삽입할 수 있습니다.
개인 템플릿
작동하려면 다음 Discourse 설정을 구성해야 합니다:
tagging enabled: 활성화되어 있어야 합니다.enable personal messages: 비스태프 사용자도 이 기능을 사용할 수 있기를 원한다면 활성화해야 합니다.pm tags allowed for groups: 개인 템플릿을 사용할 그룹이 개인 메시지에 태그를 붙일 수 있도록 허용해야 합니다.
개인 템플릿을 사용하려면 먼저 설정에서 활성화하고, 사용할 수 있는 사용자 그룹을 지정하며, PM을 템플릿으로 표시하기 위해 최소한 하나의 태그를 지정해야 합니다.
개인 템플릿을 생성하려면 사용자는 다음을 수행해야 합니다:
- 플러그인 설정에 구성된 태그 중 하나로 태그를 붙인 비암호화 개인 메시지를 자신에게 전송합니다. 오직 메시지 작성자만 이를 개인 템플릿으로 볼 수 있습니다.
미리 채워진 변수
이 플러그인은 템플릿에서 다음 변수를 지원합니다:
my_usernamemy_nametopic_titletopic_urloriginal_poster_usernameoriginal_poster_namereply_to_usernamereply_to_namelast_poster_usernamereply_to_or_last_poster_username.
위 변수들은 모두 폴백(fallback) 텍스트를 지원하며, 폴백이 지정되지 않고 변수를 대체할 수 없는 경우 변수를 제거합니다.
제목과 본문 모두 변수 대체를 지원합니다.
예시:
Hi %{reply_to_username,fallback:there},
...
Regards,
%{my_name}
reply_to_username이 사용 가능하지 않으면 템플릿은 다음과 같습니다:
Hi there,
...
Regards,
Arpit Jalan
discourse-canned-replies에서 마이그레이션
기존의 canned replies를 템플릿으로 마이그레이션하기 위한 rake 작업이 있습니다:
rake "discourse-templates:migrate-from-canned-replies"
Meta에서 47개의 canned replies를 마이그레이션하는 데 몇 초밖에 걸리지 않았으므로, 엄청난 양의 canned replies가 없는 한 안전하게 사용할 수 있습니다.
TODO
composer 외에 다른 곳으로 기능 확장
템플릿 소스로 여러 상위 카테고리 사용 허용
변경 이력
- 2022-07-14T03:00:00Z: 템플릿 소스로 여러 상위 카테고리 사용 기능 추가
- 2022-07-18T03:00:00Z: 개인 템플릿
- 2022-08-10T03:00:00Z: 전역 키보드 단축키