Um site Squarespace se conecta ao Universally com uma tag de script em seu cabeçalho de Injeção de Código de todo o site. A tag renderiza o seletor de idioma e traduz cada página no navegador do visitante, para que seus URLs permaneçam os mesmos em todos os idiomas e não haja DNS para alterar. O modo de serviço JavaScript explica como a tradução funciona e o que ela omite.
Antes de começar
- Um plano Squarespace com Injeção de Código. A Injeção de Código requer planos Core, Plus, Advanced ou um plano legado elegível. As páginas de checkout não suportam código personalizado.
- A função Proprietário ou Administrador em seu espaço de trabalho Universally, para criar o projeto e ver seu snippet. Editores veem "Peça a um administrador do projeto o snippet de instalação deste projeto." em vez da linha.
- Um site público em seu próprio domínio. A verificação de conexão não pode ler páginas privadas ou protegidas por senha.
Criar o projeto
- Inicie um novo projeto. Em Selecione Sua Tecnologia, escolha Squarespace.
- Preencha Domínio, o domínio totalmente qualificado em que seu site está publicado, como
exemplo.com. Se o domínio ainda não for resolvido, você verá um aviso e ainda poderá continuar. - Preencha Nome do Projeto, verifique Idioma de Origem (Inglês (EUA) por padrão) e clique em Avançar.
Projetos Squarespace não têm modo de serviço para escolher, então a próxima tela é Adicionar o snippet. Subdomínios de idioma ainda não estão disponíveis para sites Squarespace: seu site é traduzido pelo snippet, em seus próprios endereços.
Adicionar o snippet
A etapa Adicionar o snippet desenha sua linha dentro de uma página de exemplo. O painel preenche a chave do seu projeto:
<script src="https://scripts.universally.com/p/YOUR_PUBLIC_KEY/s.js" async></script>
- Clique em Copiar linha. Ele copia apenas a tag de script, e o botão muda para Copiado.
- No Squarespace, abra Website › Páginas › Código Personalizado › Injeção de Código › Cabeçalho.
- Cole a linha e salve.
Use o campo Cabeçalho de todo o site para que o script carregue em todas as páginas. Os botões Marcar como concluído na tela são armazenados em seu navegador e não bloqueiam nada.
Publicar e verificar a conexão
- Clique em Salvar e certifique-se de que Disponibilidade do Site esteja como Público no domínio que você inseriu no Universally.
- De volta ao Universally, clique em Verificar conexão.
A verificação carrega sua página inicial e procura pela linha. Encontrado significa que a linha está em seu domínio, pertence a este projeto e não há mais nada a instalar.
Nada muda para seus visitantes ainda. A linha apenas carrega o arquivo Universally, e seu site começa a servir traduções assim que você adicionar idiomas na próxima etapa.
Continuar e Farei isso mais tarde levam para Adicionar idiomas, e nada fica pendente na verificação. A linha permanece na página Configuração do projeto, em A linha que seu site precisa.
Adicionar idiomas
- Em Adicionar idiomas, responda "Quais idiomas você deseja traduzir?" com pelo menos um idioma de destino.
- Clique em Concluir. Ele permanece desativado até que o projeto tenha um idioma.
A caixa de diálogo de idioma ainda mostra Formato do URL, mas o valor não é usado no Squarespace porque seus URLs nunca mudam. Cada linha de idioma em Todos os Idiomas tem um interruptor Ativo. Veja Adicionar e remover idiomas.
Verificar se funcionou
Teste fora do editor do Squarespace, no domínio ativo.
- Abra seu site em uma janela privada. Um visitante de primeira viagem é automaticamente correspondido ao idioma do navegador, então um navegador configurado para um de seus idiomas de destino vê a página traduzida.
- Encontre o seletor de idioma no canto inferior direito, com bandeiras e nomes de idiomas.
- Escolha um idioma. A página é recarregada nele, no mesmo endereço.
Para ver o quanto de uma página foi traduzido, adicione ?uni_debug=1 à sua URL e abra o console do navegador.
Se não funcionar
- Carregamos seu domínio, mas a linha não estava na página: a alteração não foi salva, ou a linha foi para as configurações de uma página em vez do Cabeçalho de todo o site. Corrija e verifique novamente. Uma cópia em cache também pode ocultar a linha por um tempo, e a verificação olha apenas para sua página inicial.
- Não conseguimos carregar seu domínio: o site está offline, atrás de um login, bloqueando a solicitação ou o domínio no projeto está incorreto. Verifique se Disponibilidade do Site está como Público.
- Essa linha pertence a um projeto diferente: a linha de outro projeto está no site. Substitua-a pela linha na página Configuração deste projeto e, em seguida, verifique novamente.
- Nenhum seletor aparece: o projeto ainda não tem um idioma de destino ativo. Adicione um ou ative o interruptor Ativo dele.
- Alguns textos permanecem no idioma de origem: a página está atrás de um login ou senha, ou o JavaScript adiciona o texto após o carregamento da página. Veja O modo de serviço JavaScript.
Mais casos estão em Traduções não estão aparecendo e O seletor não está visível.