동적 플레이스홀더는 실제 값으로 대체할 수 있는 변수 집합입니다. Freshdesk는 코드 편집기를 사용하여 고객 포털 테마를 사용자 정의할 수 있는 플레이스홀더 세트를 제공합니다. Freshdesk 테마에 대한 일반적인 개요와 사용자 정의 방법에 대해서는 포털 외관 사용자 정의(테마)를 참조하세요.
예를 들어, 포털의 솔루션() 태그에 {{portal.articles_count}}를 사용하여 솔루션 문서의 총 수를 표시할 수 있습니다.
이 문서에는 다음이 포함됩니다:
플레이스홀더 카테고리
Freshdesk는 다음 카테고리에 대한 플레이스홀더를 제공합니다:
전역
지원 포털 또는 헤더 또는 푸터 영역에서 사용할 수 있는 플레이스홀더가 포함됩니다.
플레이스홀더 | 반환 유형 | 의미 |
| portal.name | string | 포털의 이름 또는 제목 |
| portal.language | string | 선택된 언어 (영어, 프랑스어 등) |
| portal.logo.url | url | 포털의 기본 또는 사용자 정의 로고 |
| portal.linkback.url | url | Freshdesk의 링크백 URL |
| portal.contact.info | url | Freshdesk에 지정된 전화번호 |
| portal.login.url | url | 지원 포털의 로그인 URL (익명 사용자에게도 제공됨) |
| portal.logout.url | 지원 포털의 로그아웃 URL (익명 사용자에게도 제공됨) | |
| portal.can.signup.feature | boolean | 가입이 허용되는지 여부에 따라 true 또는 false |
| portal.signup.url | url | 지원 포털의 가입 URL |
| portal.new.ticket.url | url | 새 티켓 생성 페이지로의 URL |
| portal.new.topic.url | url | 새 포럼 주제를 생성하는 URL |
| portal.my.topic.url | 사용자의 선호 주제로의 URL | |
| portal.profile.url | url | 특정 사용자의 프로필로의 URL |
| recent.articles | collection of articles | 포털 전반에 걸쳐 최근에 추가된 문서 목록 |
| language.code | string | 포털에서 선택된 현재 언어 |
| language.name | string | 포털에서 선택된 현재 언어 |
| language list | string | 언어 목록 |
솔루션
고객을 더 잘 돕기 위한 솔루션 문서에 특정한 동적 플레이스홀더가 포함됩니다.
솔루션 카테고리
각 솔루션 카테고리에 특정한 플레이스홀더가 포함됩니다:
플레이스홀더 | 반환 유형 | 의미 |
| category.name | string | 솔루션 카테고리의 이름 |
| category.description | string | 솔루션 카테고리의 설명 |
| category.id | number | 솔루션 카테고리의 고유 ID |
| category.url | url | 솔루션 카테고리를 가리키는 URL |
| category.folders | collection of folders | 가시성에 따라 카테고리 내의 폴더 |
| category.folders_count | number | 가시성에 따라 카테고리 내의 폴더 수 |
솔루션 폴더
솔루션 폴더에 특정한 플레이스홀더가 포함됩니다:
플레이스홀더 | 반환 유형 | 의미 |
| folder.name | string | 솔루션 폴더의 이름 |
| folder.description | string | 솔루션 폴더의 설명 |
| folder.id | number | 솔루션 폴더의 고유 ID |
| folder.url | url | 솔루션 폴더를 가리키는 URL |
| folder.category | solution category | 솔루션 폴더가 포함된 카테고리 |
| folder.articles | collection of articles | 솔루션 폴더 내의 문서 |
| folder.articles_count | number | 솔루션 폴더 내의 문서 수 |
| visibility | number |
솔루션 문서
솔루션 문서에 특정한 플레이스홀더가 포함됩니다:
플레이스홀더 | 반환 유형 | 의미 |
| article.title | string | 솔루션 문서의 제목 |
| article.thumbs_up | number | 솔루션 문서에 대한 좋아요 수 |
| article.thumbs_down | number | 솔루션 문서에 대한 싫어요 수 |
| article.body | html | 형식 및 이미지를 포함한 솔루션 문서의 본문 |
| article.body_plain | string | 평문으로 된 솔루션 문서의 본문 |
| article.modified_on | date/time | 솔루션 문서가 마지막으로 수정된 시간의 타임스탬프 |
| article.created_on | date/time | 솔루션 문서가 처음 생성된 시간의 타임스탬프 |
| article.id | number | 솔루션 문서의 고유 ID |
| article.url | url | 문서를 가리키는 URL |
| article.tags | array of objects | 솔루션 문서에 추가된 검색 태그 |
| article.attachments | attachment | 솔루션 문서에 존재하는 첨부파일 |
| article.cloud_files | array of cloud files | 솔루션 문서에 존재하는 클라우드 파일 첨부파일 |
| article.type | string | 문서의 유형 (영구적 또는 임시 해결책) |
| article.folder | string | 문서가 포함된 폴더 |
| article.category | string | 솔루션 문서가 포함된 카테고리 |
| article.thumbs_up_url | url | 문서의 좋아요 수를 1 증가시키는 URL. 작동하려면 링크에 data-method="put" 속성을 사용해야 합니다. |
| article.thumbs_down_url | url | 문서의 싫어요 수를 1 증가시키는 URL. 작동하려면 링크에 data-method="put" 속성을 사용해야 합니다. |
| portal.recent_articles | collection of articles | 포털 전반에 걸쳐 최근에 추가된 문서 목록 |
| related | collection of articles |
포럼
포럼 섹션을 사용자 정의하는 데 사용할 수 있는 플레이스홀더가 포함됩니다.
포럼 카테고리
플레이스홀더 | 반환 유형 | 의미 |
| forum_category.name | string | 포럼 카테고리의 이름을 반환합니다 |
| forum_category.description | string | 포럼 카테고리의 설명을 반환합니다 |
| forum_category.id | number | 포럼 카테고리의 고유 ID |
| forum_category.url | url | 포럼 카테고리를 가리키는 URL |
| forum_category.forums | collection of forums | 가시성에 따라 카테고리 내의 포럼 |
| forum_category.forums_count | forum | 가시성에 따라 카테고리 내의 포럼 수 |
특정 포럼
플레이스홀더 | 반환 유형 | 의미 |
| forum.name | string | 포럼의 이름 |
| forum.description | string | 포럼의 설명 |
| forum.url | url | 포럼을 가리키는 URL |
| forum.id | number | 포럼의 고유 ID |
| forum.type_name | string | 포럼의 유형 (공지사항, 아이디어, 문제, 질문) |
| filter.list | ||
| forum.current_topic_filter | string | 현재 선택된 포럼 필터. 해당 필터 페이지에서만 작동합니다 |
| forum.allowed_filters | 아래 세부 정보를 포함한 해시를 반환합니다
| |
| forum.forum_category | forum category | 포럼이 위치한 카테고리 |
| forum.topics | list of topics | 포럼 내의 주제 목록 |
| forum.topics_count | number | 포럼 내의 모든 주제 수 |
| forum.planned_topics | topic | "아이디어" 포럼에만 사용 가능한 계획된 주제 |
| forum.popular_topics | topic | 인기 주제 목록 |
| forum.answered_topics | topic | 답변된 주제 목록 |
| forum.unanswered_topics | topic | 답변되지 않은 주제 목록 |
| forum.solved_topics | topic | 해결된 주제 목록 |
| forum.unsolved_topics | topic | 해결되지 않은 주제 목록 |
| forum.implemented_topics | topic | 아이디어 포럼에만 사용 가능한 구현된 주제 |
| forum.nottaken_topics | topic | 아이디어 포럼에만 사용 가능한 미채택 주제 |
| forum.inprogress | topic | 아이디어 포럼에만 사용 가능한 진행 중인 주제 |
| forum.deferred | topic | 아이디어 포럼에만 사용 가능한 연기된 주제 |
특정 주제
| 플레이스홀더 | 반환 유형 | 의미 |
| topic.title | string | 포럼 주제의 제목 |
| topic.id | number | 포럼 주제의 고유 ID |
| topic.stamp | string | 포럼의 스탬프 (계획됨, 진행 중, 연기됨, 구현됨, 미채택) 아이디어 포럼 유형에만 제공됨 |
| topic.user | user | 주제를 생성한 사용자 |
| topic.created_on | date/time | 주제가 생성된 시간을 나타내는 타임스탬프 |
| topic.votes | number | 포럼 주제에 대한 투표 수 ("이 아이디어가 마음에 듭니다", "이 질문이 있습니다" 또는 "이 문제가 있습니다"일 수 있음) |
| topic.views | number | 포럼 주제에 대한 조회 수 |
| merge | boolean | |
| topic.locked | boolean | 주제가 잠겨 있는지 여부에 따라 true 또는 false 반환 |
| topic.sticky | boolean | 주제가 상단에 고정되어 있는지 여부에 따라 true 또는 false 반환 |
| topic.answered | boolean | 주제가 답변되었는지 여부에 따라 true 또는 false 반환 |
| topic.has_comments | boolean | 주제에 댓글이 있는지 여부를 확인하는 데 사용되는 true 또는 false 반환 |
| topic.posts | post | 주제 내의 게시물 목록 |
| topic.comment_count | number | 주제 아래에 생성된 댓글 수 |
| topic.first_post | post | 주제의 첫 번째 게시물, 원래 작성자가 생성한 것 |
| topic.last_post | post | 주제의 마지막 답글, 목록에서 최신 |
| topic.url | url | 포럼의 특정 주제로의 URL |
| topic.forum | forum | 주제가 포함된 포럼 |
| topic.attachments | attachment | 주제에 첨부된 첨부파일 |
| topic.last_post_url | url | 포럼 주제에 대한 마지막 답글로의 URL |
| topic.voted_by_current_user | boolean | 사용자가 투표한 포럼 주제 ("이 아이디어가 마음에 듭니다", "이 질문이 있습니다" 또는 "이 문제가 있습니다"일 수 있음) |
| topic.like_url | url | 특정 주제를 좋아요하는 데 사용되는 URL. 작동하려면 링크에 data-method="put" 속성을 사용해야 합니다. |
| topic.unlike_url | url | 특정 주제를 좋아요 취소하는 데 사용되는 URL. 작동하려면 링크에 data-method="put" 속성을 사용해야 합니다. |
| my_topics | string | 사용자가 생성했거나 현재 팔로우 중인 주제 목록 |
| my_topics_count | number | 사용자가 생성했거나 현재 팔로우 중인 주제 수 |
주제의 특정 게시물
| 플레이스홀더 | 반환 유형 | 의미 |
| post.id | number | 게시물의 고유 ID |
| post.body | string | 게시물의 평문 버전 |
| post.body_html | html | 게시물의 HTML 버전 |
| post.created_on | date/time | 게시물이 원래 생성된 시간을 나타내는 타임스탬프 |
| post.user | user | 게시물을 생성한 사용자에 대한 정보 |
| post.topic | topic | 게시물이 포함된 주제 |
| post.answer | boolean | 게시물에 답변이 가능한지 여부에 따라 true 또는 false 반환 |
| post.attachments | attachment | 게시물에 사용 가능한 첨부파일 |
| post.url | url | 게시물의 고유 URL |
첨부파일
솔루션 및 포럼에서 페이지(및 사용자)가 첨부파일에 액세스하는 방식을 사용자 정의할 수 있습니다. 예를 들어, 솔루션의 개요와 함께 첫 번째 이미지 첨부파일의 썸네일을 자동으로 표시하는 레이아웃을 만들 수 있습니다. 모든 이미지 첨부파일은 자동으로 해당 썸네일을 생성합니다.
플레이스홀더 | 반환 유형 | 의미 |
| attachment.url | url | 첨부파일로의 URL |
| attachment.thumbnail | url | 첨부파일의 미리보기 이미지 |
| attachment.extension | string | 첨부파일의 파일 확장자 (.doc, .jpg 등) |
| attachment.filename | string | 확장자가 없는 첨부파일의 파일 이름 |
| attachment.size | number | 첨부파일의 파일 크기 |
| attachment.is_image | boolean | 첨부파일이 이미지인지 여부에 따라 true 또는 false 반환 |
사용자
사용자 및 포털에 액세스하는 방식과 관련된 모든 것을 정의하는 플레이스홀더를 제공합니다. 사용자란 Freshdesk에서 요청자와 고객 모두를 의미합니다.
플레이스홀더 | 반환 유형 | 의미 |
| portal.user.name | string | 지원 포털을 사용하는 사용자의 전체 이름 |
| portal.user.firstname portal.user.lasttname | string | 각각 사용자의 이름과 성을 반환합니다 |
| portal.user.email | 사용자의 이메일 주소 | |
| portal.user.phone | number | 사용자의 전화번호 |
| portal.user.mobile | number | 사용자의 휴대폰 번호 |
| portal.user.job_title | string | 사용자의 직함 |
| portal.user.time_zone | string | 사용자 프로필에 구성된 시간대 |
| portal.user.profile_url | url | 사용자의 프로필을 가리키는 URL |
| portal.user.id | number | 사용자의 고유 ID |
| portal.user.company_name | string | 사용자 프로필에 지정된 회사 이름 |
| portal.user.is_agent | boolean | 사용자가 상담원인지 여부에 따라 true 또는 false 반환 |
중요한 동작을 위한 스니펫 사용
지원 운영을 향상시키기 위해 준비된 스니펫을 사용할 수 있습니다. 예를 들어, 새 티켓 양식의 레이아웃을 업데이트하는 대신 해당 스니펫을 포함하여 동작을 개선할 수 있습니다.
포털 전역 스니펫
플레이스홀더 | 반환 유형 | 의미 |
| snippet new_ticket_form | html | 새 티켓 양식을 페이지에 포함합니다 |
| snippet new_topic_form | html | 새 주제 양식을 페이지에 포함합니다 |
| snippet signup_form | html | 가입 양식을 페이지에 포함합니다 |
| snippet login_form | html | 언어 전환기용 플레이스홀더 포털에서 사용자는 언어 전환기를 사용하여 지원되는 언어 간에 전환할 수 있습니다. 로그인 양식을 페이지에 포함합니다 |
| snippet forgot_password_form | html | 비밀번호 찾기 양식을 페이지에 포함합니다 |
| snippet search_form | html | 검색 양식을 페이지에 포함합니다 |
주제 세부 페이지 스니펫
플레이스홀더 | 반환 유형 | 의미 |
| snippet topic_reply | html | 주제 답글 양식을 페이지에 포함합니다 |
| snippet topic_vote | html | 투표 버튼을 페이지에 포함합니다 |
다국어 포털
포털에 다국어 지원이 있는 경우, 언어 지원을 위한 추가 동적 플레이스홀더 및 코드 스니펫을 사용할 수 있습니다.
언어 전환기용 플레이스홀더: {{ portal | language_list }}
포털에서 언어 전환기를 생성합니다.
포털이 여러 언어를 지원하도록 구성된 경우, 고객은 고객 포털에서 언어 전환기 옵션을 사용할 수 있습니다. 플레이스홀더는 {{ portal | welcome_navigation }}이 이미 사용 가능한 경우 적절한 스타일과 함께 자동으로 포함됩니다. 사용 가능하지 않은 경우, 언어 전환기를 위한 코드를 수동으로 추가하세요.
참고: 스타일이 브랜드와 일치하도록 하려면, 게시하기 전에 항상 초안 모드에서 변경 사항을 확인하는 것이 좋습니다.
동적 텍스트용 플레이스홀더: {{ portal.current_language.code }} 또는 {{ portal.current_language.name }}
사용자가 선택한 언어에 따라 지원 포털의 페이지 헤더, 제목 또는 푸터와 같은 하드코딩된 텍스트를 번역하는 데 사용합니다.
예를 들어, 포털 헤더 텍스트가 "안녕하세요, 어떻게 도와드릴까요?"인 경우, 현재 포털 언어 선택에 따라 번역된 텍스트를 {{ portal.current_language.code }} 또는 {{ portal.current_language.name }}을 사용하여 추가할 수 있습니다.
포털 사용자 정의 코드에서 사용해야 하는 예제 코드는 다음과 같습니다:
<h1>
{% if portal.current_language.code == "en" %}
We are here to help!
{% elsif portal.current_language.code == "fr" %}
Nous sommes ici pour aider!
{% elsif portal.current_language.code == "de" %}
Wir sind hier um zu helfen!
{% endif %}
</h1>동적 플레이스홀더 보기 및 사용
플레이스홀더에 액세스하고 사용하는 방법.
- 관리 > 포털 로 이동하여 포털 옆의 편집 아이콘을 클릭합니다.
- 외관 탭으로 전환합니다. 현재 라이브 테마와 다른 사용 가능한 테마를 볼 수 있습니다. 테마 편집을 클릭합니다.
- 페이지 탭으로 전환합니다. 코드 편집기에서 다양한 포털 페이지와 해당 CSS 코드를 볼 수 있습니다.
- 추가 사용자 정의를 위해 플레이스홀더를 사용하려면, 코드 편집기 내에서 플레이스홀더 삽입 버튼을 클릭합니다. 다양한 카테고리의 동적 플레이스홀더를 볼 수 있습니다.
- 이를 사용하여 고객 포털을 개인화하세요. 완료한 후 게시를 클릭합니다.