Por vezes quer um pedaço do seu próprio código nas suas páginas, por exemplo um link para uma folha de estilos ou algumas linhas de CSS. Códigos personalizados guarda estes snippets num só lugar. Adiciona um snippet uma vez, e a plataforma coloca-o nas suas páginas por si, para nunca ter de editar um modelo.
Abrir os códigos personalizados
Antes de começar
Códigos personalizados encontra-se no bloco Integrações e API do menu de configurações. Três coisas decidem se pode trabalhar com ele:
- A sua função precisa de Gerenciar código personalizado além de Atualizar configurações da plataforma. Sem ela, a página não consegue carregar nem guardar snippets.
- Gerenciar código personalizado nunca está disponível para uma função personalizada. As funções integradas Proprietário e Administrador têm-na.
- O seu plano tem de incluir código personalizado. Se não incluir, criar ou guardar um snippet é recusado.
Um snippet é colocado nas suas páginas exatamente como o escreve. Nada verifica nem limpa o código antes, por isso uma tag com erros pode afetar todas as páginas que o carregam.
Adicionar um snippet
Clique em Adicionar código personalizado por cima da lista, ou em Novo enquanto a lista ainda estiver vazia. A janela tem três secções à esquerda: Geral, Código e Consentimento.
- Geral contém o Nome e uma Descrição opcional, cada um com até 255 caracteres. Escolha um nome que reconheça mais tarde, como o serviço a que o snippet pertence.
- Código contém a Posição e o editor de código. O código em si é obrigatório.
- Consentimento contém a Categoria de consentimento, explicada abaixo.
Clique em Criar para guardar. Se faltar um campo obrigatório, um ponto vermelho assinala a secção que precisa da sua atenção.
Head ou body
Posição decide onde fica o snippet:
<head>coloca-o no head da página, onde pertencem as folhas de estilos. Os snippets novos começam com esta opção.<body>acrescenta-o no fim do body da página.
Numa plataforma que usa a predefinição Barra lateral (esquerda) em Design > Esquema > Posição da navegação, os snippets são adicionados às páginas por trás do login. Os membros e a sua equipa carregam-nos da mesma forma, porque ambos trabalham no mesmo esquema. Os snippets são adicionados depois de a página carregar, o que é adequado para HTML e CSS, como um bloco de estilos ou um link para uma folha de estilos.
Categoria de consentimento
A Categoria de consentimento decide se um snippet espera pelo consentimento de cookies. Necessários carrega sem consentimento, e os snippets novos começam aqui. As outras categorias, Estatísticas, Marketing e Preferências, destinam-se a código que precisa de consentimento. As páginas por trás do login não pedem consentimento, e um snippet numa destas categorias não carrega aí, por isso mantenha os snippets de que precisa em Necessários e use-a apenas para código que as suas regras de privacidade permitem sem consentimento.
Encontrar, editar e remover snippets
A lista mostra cada snippet com Nome, Posição e Descrição. Assim que existirem dois snippets, aparece um campo de pesquisa por cima da lista. Este encontra snippets pelo nome ou pela descrição.
Para alterar um snippet, clique nele na lista ou use Editar, o ícone de lápis na sua linha. O título da janela muda para Editar código personalizado, e Salvar fica disponível assim que altera alguma coisa.
Para remover um snippet, use Excluir, o ícone do caixote do lixo na sua linha, ou Excluir na janela aberta, e confirme. O snippet é eliminado definitivamente e deixa de carregar nas suas páginas.