# admin/customize/email\_templates 페이지에 해당 템플릿에 대한 간단한 문서가 포함되어야 합니다

**URL:** <https://meta.discourse.org/t/admin-customize-email-templates-page-should-include-brief-documentation-of-those-templates/270949>\
**Category:** Feature\
**Created:** [7월 8, 2023, 12:29오전 UTC](https://meta.discourse.org/t/admin-customize-email-templates-page-should-include-brief-documentation-of-those-templates/270949 "2023-07-08T00:29:26Z")\
**Posts on this page:** 1\
**Showing post:** 1

<div class="post-metadata">

**Author:** ![jessicest](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jessicest/32/314092_2.png) [@jessicest](https://meta.discourse.org/u/jessicest)\
**Post date:** [7월 8, 2023, 12:29오전 UTC](https://meta.discourse.org/t/admin-customize-email-templates-page-should-include-brief-documentation-of-those-templates/270949/1 "2023-07-08T00:29:26Z")

</div>

# 요청 사항:

이메일 템플릿을 사용자 정의할 수 있는 관리 페이지에는 다음이 포함되어야 합니다:

- 현재 선택된 템플릿이 사용자에게 언제 이메일로 전송되는지에 대한 한 문장 설명
- 현재 템플릿에서 사용할 수 있는 각 [보간 키](https://meta.discourse.org/t/interpolation-keys-for-customizing-text-and-email-templates/264604)에 대한 한 문장 설명

# 근거:

이 페이지에서 저는 주로 두 가지 문제에 부딪힙니다:

## 1: 템플릿이 전송되는 트리거를 이해하지 못하는 것

템플릿 이름만으로는 이메일 템플릿이 언제 전송되는지 이해하기 어렵습니다. 좋은 예시는 다음과 같습니다:

- Custom Invite Forum Mailer
- Custom Invite Mailer
- Invite Forum Mailer
- Invite Mailer

이 이름들은 그들 사이의 차이를 이해한 **이후** 에야 비로소 의미가 있습니다. 따라서 이 템플릿들(그리고 모든 템플릿)에 대해 페이지에 한 문장 정도의 설명을 추가하여 관리자가 해당 템플릿의 용도를 알 수 있도록 하는 것이 좋겠습니다.

영어 로케ализации의 경우 콘텐츠가 이미 작성되어 있으므로, [이 포럼의 유용한 안내 게시글](https://meta.discourse.org/t/customize-specific-email-templates/88323#available-email-templates-4)의 텍스트를 그대로 사용할 수 있습니다.

## 2: 어떤 보간 키가 사용 가능한지 또는 그들이 무엇을 하는지 모르는 것

예를 들어, `User Replied` 템플릿은 다음과 같습니다:

```plaintext
%{header_instructions}

%{message}

%{context}

%{respond_instructions}

```

여기서 문제는 다음과 같습니다:

1. `%{context}`가 무엇을 의미하는지 모릅니다.
2. 이 키들을 삭제하면 다시 복구하기가 어려울 수 있습니다.

따라서 각 이메일 템플릿에서 사용 가능한 각 키에 대한 한 문장 설명이 있는 것도 좋겠습니다. 페이지에서 확장/숨길 수 있는 목록 형식으로 제공하면 어떨까요?

참고로, 이 정보를 찾는 게시글을 몇 개 첨부합니다: [첫 번째](https://meta.discourse.org/t/available-email-template-variables/235400), [두 번째](https://meta.discourse.org/t/find-allowed-interpolation-keys-for-email-template/149532)

---

_[View the full topic](https://meta.discourse.org/t/admin-customize-email-templates-page-should-include-brief-documentation-of-those-templates/270949)._