20:36フォローするヘルプセンターのテーマはすべて、編集可能なページテンプレートのコレクションです。ヘルプセンターの「Curlybars」テンプレート言語を使用してヘルプセンターデータにアクセスし、ページ内のコンテンツを編集することもできます。この記事では、使用できるコードスニペット付きのレシピのリストを提供します。ここで紹介するレシピの一部の機能は、標準テーマとカスタムテーマのどちらを使用しているか、またヘルプセンターを導入した日付に応じて、ヘルプセンターに既に搭載されていることがあります。ProfessionalプランおよびEnterpriseプランです。ProfessionalまたはEnterpriseプランをお選びにならなかった場合、コード編集オプションは利用できなくなります。この記事では、次のトピックについて説明します。Enterprise)検索結果ページに複数のヘルプセンター用のサイドバーフィルターと結果を追加するCurlybarsテンプレート言語についてヘルプセンターは、テーマフレームワークに基づいて作成されており、このフレームワークには高度なカスタマイズのための専用テンプレート言語が含まれています。ヘルプセンターのテーマは、編集可能なページテンプレートの集まりです。テンプレートとは、ヘルプセンター内の各種ページタイプのレイアウトを定義するものです。ナレッジベースの記事用のテンプレートや、リクエストのリスト用のテンプレートなどがあります。テンプレートは、ユーザーが表示した場合にHTMLページとして描画される、シンプルなテキストファイルです。各テンプレートは、HTMLマークアップと、テンプレート内で二重の波かっこで囲んで表される式(例:{{post.title}})で構成されます。テンプレート化言語はCurlybarsと呼ばれ、Handlebars言語の大部分を実装しています。クライアント側でレンダリングを行うHandlebarsとは異なり、Curlybarsはサーバー側でレンダリングを行います。ヘルプセンターのテンプレート言語を使用してヘルプセンターデータにアクセスし、ページ内のコンテンツを操作することもできます。次の例では、ヘルプセンターのページにコメントを残したすべてのメンバーの名前とアバターのリストが表示されます。</li>{{/each}}以前は、コンポーネントを使ってヘルプセンターをカスタマイズしていましたが、Javascriptによる操作を除き、コンポーネント自体をカスタマイズすることはできませんでした。Curlybarsでは、以前はコンポーネントの中に隠されていたHTMLにアクセスし、編集することができます。詳細については、以下のトピックを参照してください。ヘルプセンターのテンプレート言語リファレンスヘルプセンターテンプレート言語の使用Curlybarsを使用してコンテンツをカスタマイズする特定のカテゴリ、セクション、記事についてページテンプレートをカスタマイズする特定のカテゴリ、セクション、記事に合わせて、「カテゴリ」、「セクション」、「記事」のテンプレートをカスタマイズできます。適用可能なテンプレートカテゴリセクション記事レシピisブロックで、カテゴリ、セクション、または記事IDを指定します。言語セレクタの言語名をカスタマイズするヘルプセンターのすべてのページの言語セレクタで、言語名をカスタマイズできます。(U.S.)」のように言語バリアントであることを個別に示す場合に便利です。alternative_locales}}...{{/if}}レシピ{{current_locale.name}}式を、次の条件式に置き換えます。{{current_locale.name}}{{/is}}また、代替ロケール{{name}}式を、次の条件式に置き換えます。言語セレクタで1つ以上の言語を非表示にする特定の言語だけを言語セレクタで非表示にする機能は、その言語のコンテンツがリリースに間に合わない場合に便利です。</a>式を、次の条件式に置き換えます。日付順または投票数順に、ユーザーが記事のコメントを並べ替えられるようにするデフォルトでは、記事のコメントは、最新のものから日付順に並んでいます。日付リンクと投票数リンクを追加して、それぞれのリンクをユーザーがクリックすると、コメントが日付順または投票数順に並べ替えられるようにできます。2015年11月30日の新しいコミュニティのリリース以降、日付と投票の並べ替えリンクは標準テーマと、カスタマイズされたテーマにデフォルトで提供されています。'comments'}}</h2>の後に挿入します。comments}}式の後に挿入すると、コメントを誰も投稿していない場合にソーターが表示されないようにできます。...参照情報comment_sortersプロパティ書式ツールバーを記事のコメントエディタに追加する書式ツールバーを、記事のコメント用のエディタに追加できます。ユーザーが、太字や斜体、記号付きリストや番号付きリスト、画像、リンクを追加できるようになります。2015年11月30日の新しいコミュニティのリリース以降、書式ツールバーは標準テーマと、カスタマイズされたテーマにデフォルトで提供されています。'body'}}で置き換えます。記事のコメントにユーザーが投票できるようにするデフォルトで、ユーザーは記事に投票できます。記事のコメントへの投票もできます。2015年11月30日の新しいコミュニティのリリース以降、投票リンクは標準テーマと、カスタマイズされたテーマにデフォルトで搭載されています。id="{{anchor}}">タグの後に次のdivタグを挿入します。selected_class="vote-voted"}}</div>上述のvoteヘルパーが、記事の投票用にCSSクラスを借用して、コメントの投票リンクのスタイルを設定します。独自のクラスを定義して、コメントの投票のスタイルを設定することもできます。簡易検索(自動補完)の結果をヘルプセンターのカスタムテーマに追加するカスタムテーマに簡易検索を追加すると、ユーザーが検索ボックスに入力したときにおすすめの記事へのリンクを表示できます。2016年7月5日のリリース以降、簡易検索は標準テーマと、カスタマイズされたテーマにデフォルトで提供されています。標準テーマでは、必要に応じて簡易検索を無効にすることができます。簡易検索が有効になっている場合、ユーザーが検索ボックスに検索語を入力すると、最大6つのおすすめの記事が表示されます。記事のタイトルのみに基づいて、一致した記事が簡易検索に表示されます。ユーザーは検索内容と一致した記事を、検索結果ページに移動せずに検索ボックスから直接選択できます。適用可能なテンプレート検索式が含まれているテンプレートすべて(多くの場合、ヘッダーテンプレートまたはホームページテンプレート)適用可能な式{{search}}レシピ検索式に、instant=trueを追加します。instant=true}}</div>「マイアクティビティ」の「フォロー中」ページでサブスクリプションタイプ別の並べ替えを追加する「マイアクティビティ」>「フォロー中」ページで、ユーザーがサブスクリプションをタイプ別に並べ替えられるようにすることで、契約をわかりやすく表示できるようになります。適用可能なテンプレートフォローしているページレシピ<nav>タグの後に、次のコードを挿入します。</span></div>「マイアクティビティ」のリクエスト用に「作成日時」と「更新日時」の並べ替えオプションを追加する「マイアクティビティ」のエンドユーザーのリクエストページに「作成日時」と「更新日時」の並べ替えオプションを追加できます。「更新日時」の並べ替えオプションは標準テーマと、カスタマイズされたテーマにデフォルトで提供されています。'created'}}を次のコードで置き換えます。'last_activity'}}を次のコードで置き換えます。共有化が行われている組織のユーザーのために「フォローする/フォローを止める」ボタンを追加する共有化が行われている組織でリクエストが作成または更新されたときに、ユーザーにメール通知で知らせることができます。{{subscribe}}ヘルパーを使って「フォローする」ボタンを挿入します。ユーザーはこのボタンをクリックして、組織内でリクエストが作成または更新されたときにメール通知を受け取ることができます。更新を受け取る必要がなくなったら、ユーザーはフォローを解除することができます。2016年1月23日以降、「フォローする」ボタンは標準テーマおよびカスタマイズされたテーマにデフォルトで提供されています。'requests_filter'}}...{{/form}}レシピ{{subscribe}}ヘルパーをformオブジェクトに追加します。</div>{{/form}}参照情報subscribeヘルパーサポートリクエストでログインユーザーがほかのユーザーをCCに含められるようにするヘルプセンターの新規や既存のサポートリクエストに、ログインしたユーザーがCCを追加する機能を有効にできます。サポートリクエストにCCを追加した場合、CCに含められたユーザーはチケットの更新時にメール通知を受け取ります。2015年12月14日以降、サポートリクエストのCCオプションは標準テーマと、カスタマイズされたテーマにデフォルトで提供されています。コードをカスタムテーマに追加した後、機能を有効にする必要があります(「CCのアクセス許可を設定する」を参照)。class='comment-form'}}...{{/form}}レシピ次のスニペットをコメントフォーム内に挿入します。{{/if}}補足リクエストに元リクエストへのリンクを追加する補足リクエストに元リクエストへのリンクを追加できます。2016年8月以降、補足リクエスト内の元リクエストへのリンクは標準テーマと、カスタマイズされたテーマにデフォルトで提供されています。適用可能なテンプレートリクエストページレシピ次のスニペットを、元チケットへのリンクを表示させるリクエストページテンプレートに追加します(元チケットが存在する場合)。新規リクエストページ記事に投票ボタンを追加する記事に表示される投票ボタンは、ヘルプセンターの標準のCopenhagenテーマの要素です。記事への投票オプションが表示されない場合、テーマからボタンを削除している可能性があります。投票ボタンを追加するコードはテーマごとに異なりますが、ここでは必要な場合に備えて、標準のCopenhagenテーマ用のコードを提供します。適用可能なテンプレート記事レシピ記事ページテンプレートに、次のコードを追加します。</div>{{/with}}ヘルプセンターのユーザープロフィールをユーザーが参照できるようにするこのセクションでは、ヘルプセンターのユーザーが作成者名またはアバターをクリックしてユーザープロフィールを閲覧できるように、必要なテンプレートを更新する方法について説明します。2016年6月20日以降、ユーザープロフィールは標準テーマと、カスタマイズされたテーマにデフォルトで提供されています。このセクションで説明する解決策は、Curlybarsテンプレート言語のlinkヘルパーを使用して(テンプレートのドキュメントのlinkヘルパーを参照)、以下のテンプレートを更新する作業を含みます。記事ページテンプレートに、次の更新を適用します。{{article.author.name}}{{/if}}次のlinkヘルパーで置き換えます。{{author.name}}{{/if}}次のlinkヘルパーで置き換えます。alt="Avatar"/>次のlinkヘルパーで置き換えます。/>{{/link}}コミュニティの投稿コミュニティの投稿ページテンプレートに、次の更新を適用します。{{post.author.name}}{{/if}}次のlinkヘルパーで置き換えます。{{author.name}}{{/if}}次のlinkヘルパーで置き換えます。alt="Avatar"/>次のlinkヘルパーで置き換えます。alt="Avatar"/>次のlinkヘルパーで置き換えます。テンプレートに、次の更新を適用します。{{author.name}}{{/if}}次のlinkヘルパーで置き換えます。{{author.name}}{{/if}}次のlinkヘルパーで置き換えます。{{author.name}}{{/link}}古いテーマ内の検索結果を更新する古いテーマを使用している場合、検索結果で{{meta}}ヘルパーが使用されている場合があります。その場合、このセクションで説明するコードを使用して、作成者名をヘルプセンター内のプロフィールページにリンクすることができます。統一感を持たせるには、検索結果ページのCSSスタイルを更新する必要があります。class="search-result-description">{{text}}</div>次のタグに置き換えます。</li>{{/each}}結果の投稿の作成者名を更新する以下を追加します。Enterpriseでは、ヘルプセンターのナレッジベースにサブセクションを追加して、コンテンツをさらに細かく階層化することができます。2019年3月29日以前にカスタマイズしたテーマを使用している場合、サブセクションを有効化するには、ヘルプセンターのテーマにコードを追加する必要があります。Enterpriseの場合、2019年3月29日より後にカスタマイズしたテーマと標準のテーマでは、サブセクションはデフォルトで有効です。適用可能なテンプレートセクション適用可能なオブジェクトsection.sectionsレシピ次のスニペットを、Zendeskセクションページテンプレートの、サブセクションのリストを表示したい場所に挿入します。{{/each}}</div>{{/if}}検索結果ページに複数のヘルプセンター用のサイドバーフィルターと結果を追加するヘルプセンター検索では、複数のヘルプセンターがある場合にすべてのヘルプセンターを横断して検索でき、ヘルプセンターとナレッジベースとコミュニティからの検索結果を、検索結果ページのフィルター機能を備えた統合フィードに表示できます。2019年3月29日より前にカスタマイズされたテーマを使用している場合、統合された検索結果および複数のヘルプセンターでの検索を使用するには、ヘルプセンターのカスタムテーマにコードを追加する必要があります。複数のヘルプセンターがある場合は、ヘルプセンターごとにテーマを更新する必要があります。統合された検索結果と複数のヘルプセンターを横断する検索は、標準のテーマおよび2019年9月25日以降にカスタマイズされたテーマでは、デフォルトでサポートされています。必要な変更をテーマに反映する最速の方法は、統合された検索結果に対応しているCopenhagenテーマの最新バージョンをインポートすることです。詳しい手順については、「Guideへのヘルプセンターテーマの追加」を参照してください。このセクションでは、既存のカスタムテーマを更新する場合に、行なう必要のあるすべての変更の概要を示します。Gist」に、必要なすべてのコードスニペットが用意されています。このセクションで説明するソリューションでは、Curlybarsテンプレート言語のhelp_center_filters、filters、およびsubfiltersの各ヘルパーを使用して、次のファイルを更新します。検索結果CSSJavaScript検索結果テンプレートを更新してサイドバーフィルターを追加する検索結果テンプレートを更新して、サイドバーフィルターを追加し、結果を何度も繰り返す必要があります。サイドバーフィルターを追加するこのスニペットは、新しいフィルターヘルパーを使用して、検索結果ページのサイドバーに検索ファセットを実装する方法の例です。class="search-results">に挿入します。</section>結果を何度も繰り返すこのスニペットは、{{results}}ヘルパーを使用して統合された検索結果を何度も繰り返す方法の例です。{{article_results}}ヘルパーと{{post_results}}ヘルパーの両方と、関連する検索結果の小見出しH3を検索結果テンプレート内で次のように置き換えます。{{/if}}検索結果ページのサイドバーフィルターのCSSスタイルを更新するサイドバーフィルターにCSSスタイルを追加できます。次の例は、Copenhagenテーマに基づいています。次のCSSルールがstyle.cssファイルに含まれていることを確認してください。bold;}検索結果ページの折りたたみ可能なサイドバーのJavaScriptを更新する検索結果ページの折りたたみ可能なサイドバーにJavaScriptを追加できます。次の例は、Copenhagenテーマに基づいています。!isExpanded);});});次のコードスニペットで置き換えます。