Instalação do AEM Sidekick
O sidekick AEM fornece aos autores de conteúdo uma barra de ferramentas que oferece opções sensíveis ao contexto para que eles possam editar, visualizar e publicar seu conteúdo diretamente das páginas do seu site.
Este documento explica como instalar e configurar o sidekick.
Opções de instalação
O sidekick está disponível como uma extensão de navegador em navegadores baseados no Chrome e Safari e pode ser instalado de várias maneiras.
- Use o configurador do sidekick.
- Instalar manualmente o sidekick como você faria com qualquer outra extensão
- Se não conseguir instalar uma extensão de navegador, instalar o bookmarklet do sidekick.
Se você já tiver o sidekick instalado e precisar de ajuda para usá-lo, consulte o documento Uso da extensão AEM Sidekick.
Uso do configurador de Sidekick
O configurador detecta seu navegador e o orienta pelo processo de instalação.
- No Safari ou em um navegador com base no Chrome, navegue até o link
https://www.aem.live/tools/sidekick/ - Forneça o URL para o repositório GitHub do seu projeto e, opcionalmente, um nome para o projeto e clique em Ir.
- O sidekick é compatível com vários projetos, e fornecer um nome descritivo ajuda a gerenciar as configurações.
- Na nova seção Instale a extensão Sidekick e adicione este projeto que for exibida, clique na guia Instalar extensão do Sidekick para Chrome ou Instale a extensão Sidekick para o Safari.
- A página abrirá a loja na Web do App Store ou do Chrome conforme apropriado, onde é possível instalar a extensão conforme apropriado para o sistema operacional.
- Retorne à página do configurador e clique em Adicionar projeto.
- O configurador adiciona o projeto à extensão. Agora você está pronto para usar a extensão.
Se tiver problemas ao instalar a extensão, consulte as instruções na seção Instalação manual do Sidekick.
Instalação manual do Sidekick
Cromo
- Navegue até a extensão sidekick no Loja web Chrome.
- Clique em Adicionar ao Chrome botão.
- Clique em Adicionar extensão para confirmar a instalação.
- Clique no novo ícone do Adobe Experience Cloud ao lado da barra de endereços do Chrome e clique no link Fixar para mantê-la visível.
Safari
-
Navegue até a extensão sidekick no App Store.
-
Clique em Instalar botão.
-
Ative a extensão.
-
Desktop Safari
- Abra o Safari.
- Vá para Configurações.
- Clique em Extensões.
- Marque a caixa ao lado da extensão sidekick.
-
Mobile Safari
- Abrir configurações
- Toque no Safari
- Em seguida, toque em Extensões.
- Alterne a extensão do sidekick.
-
-
Verifique se a extensão tem acesso permitido a todos os sites.
-
Se o seu projeto exigir que você faça logon para usar a extensão sidekick, será necessário ativar cookies de terceiros: Safari > Configurações > Privacidade > desmarcar "Impedir rastreamento entre sites"
Adicionar seu projeto
Há várias maneiras de adicionar projetos à extensão sidekick:
1. Configurador de Sidekick
- Consulte a seção Uso do configurador de Sidekick.
2. URL de compartilhamento
- Navegue até um URL de compartilhamento que comece com
https://www.aem.live/tools/sidekick/?... - Clique no azul Adicionar projeto botão.
- Como alternativa, você pode clicar no ícone do Adobe Experience Cloud ao lado da barra de endereços do navegador e selecionar Adicionar projeto no menu de contexto.
- Uma caixa de diálogo será exibida para confirmação. Clique em OK para continuar.
Um colega no projeto pode fornecer um URL de compartilhamento. Consulte o documento Uso da extensão AEM Sidekick para obter detalhes.
3. URL do projeto (somente desktop)
- Navegue até um URL de projeto com um nome de host como este:
https://main–repo–owner.hlx.page/ - Clique no ícone Adobe Experience Cloud ao lado da barra de endereços do navegador e selecione Adicionar projeto no menu de contexto.
- Uma caixa de diálogo será exibida para confirmação. Clique em OK para continuar.
4. URL do repositório GitHub (somente desktop)
- Navegue até um repositório GitHub que comece com
https://github.com/... - Clique no ícone Adobe Experience Cloud ao lado da barra de endereços do navegador e selecione Adicionar projeto no menu de contexto.
- Uma caixa de diálogo será exibida para confirmação. Clique em OK para continuar.
5. Página Opções
A página de opções lista todas as configurações do projeto e permite que você adicione, edite ou exclua elas.
-
Vá para a página de opções:
- Chrome: clique com o botão direito do mouse no ícone do Adobe Experience Cloud ao lado da barra de endereços e selecione Opções no menu de contexto.
- Safari (desktop): clique com o botão direito do mouse no ícone do Adobe Experience Cloud ao lado da barra de endereços e selecione Gerenciar extensão… Na caixa de diálogo de extensões, clique em Preferências.
- Safari (dispositivos móveis): abra Configurações e toque em Safari > Extensões > AEM Sidekick > Configurações de extensão.
-
Adicione uma configuração de projeto usando um dos dois métodos a seguir:
- Adicionar via URL de compartilhamento: a configuração do projeto será recuperada dos parâmetros contidos no URL de compartilhamento.
- Adicionar manualmente: insira o URL do repositório do GitHub e outros parâmetros opcionais para o seu projeto.
Noções básicas sobre configurações de projeto
- Nome do projeto: Especifique o nome do projeto aqui. Isso daria um nome para a configuração do projeto, facilitando a identificação no sidekick. Essa é uma configuração opcional.
- URL do Repositório : Especifique o repositório GitHub do seu projeto aqui. Por exemplo, https://github.com/hlxsites/wknd.
- Dica de Bônus: Você pode especificar sua ramificação de repositório aqui para que o código do projeto seja extraído desta ramificação de repositório ao abri-la no navegador. Por exemplo, https://github.com/hlxsites/wknd/tree/mybranch
- URL de Conteúdo : Especifique a url da pasta raiz do projeto na raiz do Sharepoint/GDrive.
- Nome do Host de Produção: Especifique o URL de produção (sendo o nome de domínio o nome de host público do projeto). Isso garantiria que o sidekick estivesse disponível no navegador ao abrir o site no domínio de produção. Essa é uma configuração opcional.
Configuração avançada
Desenvolver personalizações de Sidekick localmente
- Testar configuração de projeto localmente: Use esta configuração avançada para testar qualquer personalização local no sidekick. Leia mais sobre Personalizações de Sidekick aqui.
- URL de Desenvolvimento Local: Especifique o url do servidor que está sendo executado localmente. O valor padrão é http://localhost:3000
Adicionar autorização personalizada
Para sites protegidos com autenticação ativada .page e .live, é possível adicionar um token de autorização que será adicionado ao HTTP Authorization: cabeçalho.
Isso pode ser usado para testar as chaves de API usadas no CDN e garantir que elas tenham acesso à origem. Essa opção provavelmente só será usada pela equipe administrativa para fins de configuração e depuração.
Instalação do bookmarklet do Sidekick
Se você não conseguir instalar uma extensão em seu navegador, ou se usar um navegador que não seja atualmente compatível com a extensão sidekick, você poderá usar um bookmarklet.
A bookmarklet é um marcador de navegador ou favorito contendo comandos JavaScript que adicionam novos recursos ao navegador. O bookmarklet do sidekick adiciona os recursos do sidekick sem exigir qualquer instalação, que pode ser útil para alguns usuários.
Como a extensão sidekick se lembra se está aberta ou fechada em uma determinada página de conteúdo, o Adobe recomenda instalar a extensão se possível. O bookmarket deve ser sempre aberto e fechado manualmente nas páginas de conteúdo.
Para instalar o bookmarklet:
- No navegador, navegue até o link
https://www.aem.live/tools/sidekick/ - Forneça o URL para o repositório GitHub do seu projeto e, opcionalmente, um nome para o projeto e clique em Ir.
- O sidekick é compatível com vários projetos, e fornecer um nome descritivo ajuda a gerenciar as configurações.
- Uma nova seção chamada Instalar o bookmarklet do Sidekick para este projeto é exibido na página junto com um botão.
- Arraste o botão até os marcadores ou a barra de ferramentas favorita.
- Clique no bookmarklet na barra de ferramentas de marcadores ou favoritos para alterná-lo.
Usar a extensão Sidekick
Consulte o documento Uso do AEM Sidekick para aprender a usar o sidekick.