Qual é o meu plano?
Suite Growth, Professional, Enterprise ou Enterprise Plus
Support com Qualquer plano do Guide

Você também pode trabalhar em um tema localmente no editor de código da sua preferência e visualizar suas alterações em tempo real em um navegador. Não é necessário carregar os arquivos no Guide toda vez que você deseja visualizar suas alterações. Um processo é executado em segundo plano no seu computador e carrega as alterações sempre que você salva um arquivo localmente.

Exemplo:

Os tópicos abordados neste artigo são:

  • Configuração da visualização local de temas
  • Ativação da visualização local de temas
  • Visualização de alterações

Configuração da visualização local de temas

A configuração da visualização local de temas consiste em baixar arquivos de temas, permitir o acesso à API na sua conta e instalar a interface de linha de comando do Zendesk (ZCLI) no seu computador. A ZCLI permite a visualização local de temas.

Como configurar a visualização local de temas

  1. Baixe e descompacte os arquivos de temas do Guide em uma pasta de trabalho.

    Consulte Download de um tema da central de ajuda.

  2. Se você ainda não fez isso, permita que a API acesse a sua conta do Zendesk.

    Na Central de administração, clique em Aplicativos e integrações na barra lateral e selecione APIs > API do Zendesk.

  3. Instale a ZCLI. Consulte Installing and updating ZCLI (Instalação e uso da ZCLI) na documentação do desenvolvedor da Zendesk.

Ativação da visualização local de temas

Você deve ativar a visualização local de temas antes de começar a trabalhar nos arquivos de temas em seu computador.

Como ativar a visualização local de temas

  1. No terminal da linha de comando do computador, navegue até a pasta que contém os arquivos de temas baixados e descompactados. Exemplo:
    cd guide_themes/newlook_theme
  2. Entre na conta do Zendesk em que você baixou o tema.
    zcli login -i

    Nas solicitações, insira o seu subdomínio, e-mail e token da API. Você não precisa acrescentar "/token" ao seu endereço de e-mail. A ZCLI acrescenta esse sufixo para você.

    Use o subdomínio do Zendesk padrão da sua conta para entrar. Não utilize subdomínios mapeados de host.

  3. Inicie o processo de visualização local em segundo plano:
    zcli themes:preview 

    O comando da ZCLI é iniciado na visualização local e carrega o tema local no modo de pré-visualização na sua central de ajuda. As alterações feitas nos arquivos localmente impactarão o tema no modo de pré-visualização.

  4. Copie e cole a URL de "Ready" em um navegador como o Chrome ou o Firefox.

    O navegador precisa permitir conteúdo misto de HTTP e HTTPS. O Safari não oferece suporte a conteúdo misto nem permite que você visualize os temas localmente.

    A URL de “Ready” tem esse formato https://seusubdominio.zendesk.com/hc/admin/local_preview/start.

Para obter mais informações sobre o comando de pré-visualização da ZCLI, consulte zcli themes no GitHub.

Visualização de alterações

Depois que a ZCLI carrega o seu tema no modo de pré-visualização na central de ajuda, você pode trabalhar nos arquivos do tema localmente usando seu editor de código preferido e visualizar as alterações no navegador. Trabalhe iterativamente para desenvolver e testar seu tema. Por exemplo, faça algumas alterações em um arquivo, salve e confira as alterações no navegador. Corrija quaisquer erros antes de fazer outras alterações.

Como visualizar alterações

  1. Salve os arquivos editados no seu editor de código.
  2. Confira os resultados no tema no modo de pré-visualização no navegador.

O tema é recarregado automaticamente no navegador depois que você salvar um arquivo localmente. Não é necessário recarregar a página.

A ZCLI permite desativar o recarregamento em tempo real. Consulte zcli themes no GitHub.

Ao terminar, você pode interromper a pré-visualização usando um dos métodos a seguir:

  • Na sessão do terminal que está executando a ZCLI, pressione Ctrl+C.
  • Abra https://yoursubdomain.zendesk.com/hc/admin/local_preview/stop no seu navegador, com seu subdomínio atual na URL.
  • Na parte superior da página de visualização do tema do navegador, clique no link Fechar visualização.
Powered by Zendesk