Ocultar seletivamente componentes da Central de Ajuda usando Curlybars

Com a adição da nossalinguagem de modelosCurlybars da Central de Ajuda , foi revelada a capacidade de adicionar instruções condicionais, o que permite impactar dinamicamente a renderização das páginas da sua Central de Ajuda. Usando declarações condicionais, podemos marcar o número de ID exclusivo de uma categoria, seção, artigo, tópico ou publicação e ocultar aquele item enquanto continua mostrando outros.

Se você precisa encontrar a ID do item que gostaria de ocultar, vá até a página para o item e veja a URL. Você deve encontrar algo como/hc/en-us/categories/200420805-General. O200420805 é a ID da minha categoria.

Eis uma pequena animação para destacar o que estou tentando alcançar quando oculto uma categoria na página inicial da Central de Ajuda (assista à seção “Categoria 1”):

O código

Vou cobrir alguns cenários aqui para elaborar como esses podem ser usados. Nestes exemplos, vou usar o código padrão encontrado no tema Copenhagen da Central de Ajuda. Usarei principalmente oisnt auxiliar, pois a ideia básica é que, se o valor não corresponder, renderize o código exibido, ocultando (ou não renderizando) o item identificado. Você pode ver que quero excluir uma categoria específica na página inicial, por isso passei por isnt :

Eu anexei todo o código do template da homepage a partir deste exemplo aqui. Você pode alterar a ID de categoria para a sua própria, e depois conseguirá ocultar as categorias.

Ocultar vários itens

Esconder múltiplos itens adiciona um pouco mais de linhas de código, pois não podemos passar vários números de id em uma única declaração condicional. Em vez disso, vamos querer reunir as declarações condicionais para que elas possam ser analisadas adequadamente. Eis um exemplo:

Se você quiser baixar o código para ocultar várias categorias, esse código pode ser encontrado aqui.

Outro exemplo com artigos

Sei que tenho falado bastante sobre categorias; por isso, queria mostrar como implementar isso em outro espaço. Meu cenário é que quero reduzir a exposição de um determinado artigo, mas, torná-lo acessível via Pesquisa ou link direto para meus clientes. Eu escolhi a página de artigo no tema Copenhagen, onde outros artigos na mesma seção que o artigo atual aparecem em uma barra lateral como essa:

Você pode ter escondido seu artigo já no nível da seção, mas também vamos querer marcar o artigo aqui:

E, novamente, esteé o código, se você quiser experimentá-lo em seu modelo de artigo.

Alguns comentários técnicos sobre essa funcionalidade

Você deve ter notado um padrão aqui de que o código estava sendo implementado no {{#each}} que itera pela matriz de itens específicos que estão sendo solicitados. O each helper é nativo para handlebars.js, e você pode ler mais sobre isso na documentação aqui. Na última imagem acima, você pode ver o {{#each section.articles}} no código que renderiza os artigos da seção atual, mas quando o artigo é encontrado com a ID219527708,, em vez disso, esse código é ignorado e a renderização passa para o próximo artigo.

Pode haver outras maneiras de obter um comportamento semelhante, portanto, sinta-se à vontade para experimentaroutros auxiliares condicionais, mas isso deve ser um bom começo.

Aviso sobre a tradução: este artigo foi traduzido por um software de tradução automática para oferecer a você uma compreensão básica do conteúdo. Medidas razoáveis foram tomadas para fornecer uma tradução precisa, no entanto, a Zendesk não garante a precisão da tradução.

Em caso de dúvidas relacionadas à precisão das informações contidas no artigo traduzido, consulte a versão oficial do artigo em inglês.