동적 자리 표시자는 실제 값으로 바꿀 수 있는 변수 집합입니다. Freshdesk는 코드 편집기를 사용하여 고객 포털 테마를 사용자 지정하는 데 사용할 수 있는 플레이스홀더 집합을 제공합니다. Freshdesk 테마에 대한 일반적인 개요와 사용자 지정하는 방법에 대해서는 포털 모양(테마) 사용자 지정하기를 참조하세요.
예를 들어 {{portal.articles_count}}를 솔루션 () 태그에 사용하여 포털의 총 솔루션 문서 수를 표시할 수 있습니다.
플레이스홀더 카테고리
Freshdesk는 다음 카테고리에 대한 플레이스홀더를 제공합니다:
글로벌
지원 포털이나 머리글 또는 바닥글 영역에 사용할 수 있는 자리 표시자가 포함되어 있습니다.
| portal.name | string | Name or Title of the portal |
| portal.language | string | Selected language (English, French etc.) |
| portal.logo.url | url | Default or Custom logo from the portal |
| portal.linkback.url | url | Linkback URL from Freshdesk |
| portal.contact.info | url | Phone number specified in Freshdesk |
| portal.login.url | url | Login URL of the support portal (also available to anonymous users) |
| portal.logout.url | Logout URL of the support portal (also available to anonymous users) | |
| portal.can.signup.feature | boolean | True or false based on whether signups are allowed or not |
| portal.signup.url | url | Signup URL of the support portal |
| portal.new.ticket.url | url | URL to the new ticket creation page |
| portal.new.topic.url | url | URL to create a new forum topic |
| portal.my.topic.url | URL to the user's preferred topic | |
| portal.profile.url | url | URL to the profile of a specific user |
| recent.articles | collection of articles | list of recently added articles across the portal |
| language.code | string | Current language selected on the portal |
| language.name | string | Current language selected on the portal |
| language list | string | List of lang |
솔루션
고객을 더 잘 돕기 위해 솔루션 문서 전용 동적 자리 표시자가 포함되어 있습니다.
솔루션 카테고리
각 솔루션 카테고리별 플레이스홀더가 포함되어 있습니다:
Placeholder | Return Type | What they mean |
| category.name | string | Name of the solution category |
| category.description | string | Description of the solution category |
| category.id | number | Unique ID of the solution category |
| category.url | url | URL pointing to the solution category |
| category.folders | collection of folders | Folders in the category based on visibility |
| category.folders_count | number | Folders count in the category based on visibility |
솔루션 폴더
솔루션 폴더 전용 플레이스홀더를 포함합니다:
Placeholder | Return Type | What they mean |
| folder.name | string | Name of the solution folder |
| folder.description | string | Description of the solution folder |
| folder.id | number | Unique ID of the solution folder |
| folder.url | url | URL pointing to the solution folder |
| folder.category | solution category | Category in which the solution folder is contained |
| folder.articles | collection of articles | Articles inside the solution folder |
| folder.articles_count | number | Count of articles inside the solution folder |
| visibility | number |
솔루션 문서
솔루션 문서 전용 플레이스 홀더 포함입니다:
Placeholder | Return Type | What they mean |
| article.title | string | Title of the solution article |
| article.thumbs_up | number | No of thumbs ups for a solution article |
| article.thumbs_down | number | No of thumbs downs for a solution article |
| article.body | html | The body of the solution article including any formatting and images |
| article.body_plain | string | The body of the solution article in plain text |
| article.modified_on | date/time | The time stamp pointing to when the solution article was last modified |
| article.created_on | date/time | The time stamp pointing to when the solution article was originally created |
| article.id | number | The Unique ID of the solution article |
| article.url | url | The URL pointing to the article |
| article.tags | array of objects | The search tags that have been added to the solution article |
| article.attachments | attachment | The attachment(s) that are present in the solution article |
| article.cloud_files | array of cloud files | The cloud file attachment(s) that are present in the solution article |
| article.type | string | The type of the article (Permanent or Workaround) |
| article.folder | string | The folder in which the article is contained |
| article.category | string | The category in which the solution article is contained |
| article.thumbs_up_url | url | The URL which will increase the thumbs up of the article by one. Need to use a data-method=”put” attribute in the link to work. |
| article.thumbs_down_url | url | The URL which will increase the thumbs down of the article by one. Need to use a data-method=”put” attribute in the link to work. |
| portal.recent_articles | collection of articles | The list of recently added articles from across the portal |
| related | collection of articles |
포럼
포럼 섹션을 사용자 지정하는 데 사용할 수 있는 플레이스홀더를 포함하고 있습니다.
포럼 카테고리
Placeholder | Return Type | What they mean |
| forum_category.name | string | Returns the name of forum categories |
| forum_category.description | string | Returns the description of forum categories |
| forum_category.id | number | Unique ID of the forum category |
| forum_category.url | url | URL pointing to a forum category |
| forum_category.forums | collection of forums | Forums in the category based on visibility |
| forum_category.forums_count | forum | Forums count in the category based on visibility |
특정 포럼
Placeholder | Return Type | What they mean |
| forum.name | string | Name of the forum |
| forum.description | string | Description of the forum |
| forum.url | url | URL pointing to the forum |
| forum.id | number | Unique ID of the forum |
| forum.type_name | string | Type of the forum (announcement, ideas, problems, questions) |
| filter.list | ||
| forum.current_topic_filter | string | Currently selected forum filter. Will work only in the respective filters page |
| forum.allowed_filters | Will return a hash with the below details
| |
| forum.forum_category | forum category | Category in which the forum is present |
| forum.topics | list of topics | List of topics in the forum |
| forum.topics_count | number | Count of all topics in the forum |
| forum.planned_topics | topic | Planned topics that are available only for the "ideas" forum |
| forum.popular_topics | topic | List of popular topics |
| forum.answered_topics | topic | List of answered topics |
| forum.unanswered_topics | topic | List of unanswered topics |
| forum.solved_topics | topic | List of solved |
| forum.unsolved_topics | topic | List of unsolved topics |
| forum.implemented_topics | topic | Implemented topics that are available only for a ideas forum |
| forum.nottaken_topics | topic | Not taken topics that are available only for a ideas forum |
| forum.inprogress | topic | In progress topics that are available only for a ideas forum |
| forum.deferred | topic | Deferred topics that are available only for a ideas forum |
특정 주제
| Placeholder | Return Type | What they mean |
| topic.title | string | Title of the forum topic |
| topic.id | number | Unique ID of the forum topic |
| topic.stamp | string | Stamp of the forum (planned, inprogress, deferred, implemented, not taken) comes only for forum type as ideas |
| topic.user | user | User who created the topic |
| topic.created_on | date/time | The timestamp denoting when the topic was created |
| topic.votes | number | No. of votes on a forum topic (can be “I like this idea”, “I have this question” or “I have this problem”) |
| topic.views | number | No. of views on a forum topic |
| merge | boolean | |
| topic.locked | boolean | Returns true or false based on whether the topic is locked or not |
| topic.sticky | boolean | Returns true or false based on whether the topic is a sticky (that will appear on the top) |
| topic.answered | boolean | Returns true or false based on whether the topic has been answered to or not |
| topic.has_comments | boolean | Returns true or false, used to check if the topic has any comments or not |
| topic.posts | post | List of posts inside the topic |
| topic.comment_count | number | Number of comments that have been created under a topic |
| topic.first_post | post | The first post in the topic, which was created by the original creator |
| topic.last_post | post | The last reply of the topic which is the latest in the list |
| topic.url | url | URL to a particular topic in the forum |
| topic.forum | forum | The forum in which a topic is contained |
| topic.attachments | attachment | The attachments that have been made to a topic |
| topic.last_post_url | url | URL to the last reply made to the forum topic |
| topic.voted_by_current_user | boolean | Forum topics in which users have voted (can be “I like this idea”, “I have this question” or “I have this problem”) |
| topic.like_url | url | The URL used to like a particular topic. Need to use a data-method=”put” attribute in the link to work. |
| topic.unlike_url | url | The URL used to unlike a particular topic. Need to use a data-method=”put” attribute in the link to work. |
| my_topics | string | List of topics that have been created or currently being followed by the user |
| my_topics_count | number | Number of topics that have been created or currently being followed by the user |
주제에 대한 특정 글
| Placeholder | Return Type | What they mean |
| post.id | number | Unique ID of the post |
| post.body | string | Plain text version of the post |
| post.body_html | html | Html version of the post |
| post.created_on | date/time | Time stamp referring to when the post was originally created |
| post.user | user | Information about the user who created the post |
| post.topic | topic | The topic in which the post is contained |
| post.answer | boolean | Returns true or false based on whether there can be answers on the post or not |
| post.attachments | attachment | The attachment(s) that are available in the post |
| post.url | url | The unique URL of the post |
첨부파일
솔루션 및 포럼에서 페이지(및 사용자)가 첨부파일에 액세스하는 방식을 사용자 지정할 수 있습니다. 예를 들어 솔루션의 개요와 함께 첫 번째 이미지 첨부 파일의 썸네일을 자동으로 표시하는 레이아웃을 만들 수 있습니다. 모든 이미지 첨부 파일은 해당 섬네일도 자동으로 만들어집니다.
Placeholder | Return Type | What they mean |
| attachment.url | url | URL to the attachment |
| attachment.thumbnail | url | Preview image of the attachment file |
| attachment.extension | string | The file extension of the attachment (.doc, .jpg etc) |
| attachment.filename | string | The filename of the attachment without the extension |
| attachment.size | number | File size of the attachment |
| attachment.is_image | boolean | Returns true or false based on whether the attachment is an image or not |
사용자
사용자와 포털 액세스 방법에 관한 사항을 정의하기 위한 자리 표시자를 제공합니다. 사용자는 Freshdesk에서 요청자뿐만 아니라 고객도 모두 지칭한다는 점을 기억하세요.
Placeholder | Return Type | What they mean |
| portal.user.name | string | Full Name of the user using the support portal |
| portal.user.firstname portal.user.lasttname | string | Returns the first name and last name of the user respectively |
| portal.user.email | Email address of the user | |
| portal.user.phone | number | Phone number of the user |
| portal.user.mobile | number | Mobile Number of the user |
| portal.user.job_title | string | Job title of the user |
| portal.user.time_zone | string | The time zone that has been configured in the user’s profile |
| portal.user.profile_url | url | The URL pointing to the profile of the user |
| portal.user.id | number | Unique ID of the user |
| portal.user.company_name | string | Company name that has been specified in the user’s profile |
| portal.user.is_agent | boolean | Returns true or false based on whether the user is an agent or not |
중요한 동작에 코드 조각 사용하기
이미 만들어진 코드 조각을 사용하여 지원 작업을 개선할 수 있습니다. 예를 들어 새 티켓 양식의 레이아웃을 업데이트하는 대신 해당 스니펫을 포함하여 동작을 개선할 수 있습니다.
포털 와이드 스니펫
Placeholder | Return Type | What they mean |
| snippet new_ticket_form | html | Includes the new ticket form into the page |
| snippet new_topic_form | html | Includes the new topic form into the page |
| snippet signup_form | html | Includes the signup form into the page |
| snippet login_form | html | Placeholder for Language Switcher In the portal, users have the option to switch between the supported languages by using the language switcher. Includes the login form into the page |
| snippet forgot_password_form | html | Includes the forgot password form into the page |
| snippet search_form | html | Includes the search from into the page |
토픽 상세 페이지 스니펫
Placeholder | Return Type | What they mean |
| snippet topic_reply | html | Includes the topic reply form into the page |
| snippet topic_vote | html | Includes the voting buttons into the page |
다국어 포털
포털에서 다국어 지원을 위해 다음의 추가 동적 자리 표시자와 코드 스니펫을 사용할 수 있습니다.
Placeholder for Language Switcher: {{ portal | language_list }}
포털에 언어 전환기를 생성합니다.
포털이 여러 언어를 지원하도록 구성된 경우 고객은 고객 포털에서 언어 전환기 옵션을 사용할 수 있습니다. {{ portal | welcome_navigation }}을 이미 사용할 수 있는 경우 플레이스홀더가 적절한 스타일과 함께 자동으로 포함됩니다. 사용할 수 없는 경우 언어 전환기에 코드를 수동으로 추가하세요.
주: 스타일이 브랜드와 일치하는지 확인하려면 게시하기 전에 항상 초안 모드에서 변경 사항을 확인하는 것이 좋습니다.
이를 사용하여 사용자가 선택한 언어를 기준으로 페이지 헤더, 제목, 바닥글 등 지원 포털의 하드코딩된 텍스트를 번역할 수 있습니다.
예를 들어 포털 헤더 텍스트가 "안녕하세요, 무엇을 도와드릴까요?"인 경우 현재 포털 언어 선택에 따라 {{ 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 vous aidons!
{% elsif portal.current_language.code == "de" %}
Wir helfen Ihnen!
{% endif %}
</h1>동적 자리 표시자 보기 및 사용
자리 표시자에 액세스하고 사용하려면 다음을 수행합니다.
- 관리 포털로 이동하여 포털 옆에 있는 수정 아이콘을 클릭합니다.
- 표시 탭으로 전환합니다. 현재 라이브 테마 및 사용 가능한 다른 테마가 표시됩니다. 테마 편집을 클릭합니다.
- 페이지 탭으로 전환합니다. 코드 편집기에서 다양한 포털 페이지와 해당 CSS 코드를 볼 수 있습니다.
- 추가 사용자 지정을 위해 플레이스홀더를 사용하려면 코드 편집기에서 플레이스홀더 삽입 버튼을 클릭합니다. 동적 플레이스홀더의 다양한 카테고리를 확인할 수 있습니다.
- 이를 사용하여 고객 포털을 사용자 정의할 수 있습니다. 작업를 완료했으면 게시를 클릭합니다.
아티클이 유용했나요?
훌륭합니다!
피드백을 제공해 주셔서 감사합니다.
도움이 되지 못해 죄송합니다!
피드백을 제공해 주셔서 감사합니다.
피드백 전송
소중한 의견을 수렴하여 아티클을 개선하도록 노력하겠습니다.