Modelos próprios para programadores e agências

Em «Domínios e modelos», proprietários e admins podem criar os seus próprios modelos a partir do Creator Pro. São uma estrutura HTML para programadores e agências que querem reutilizar um layout em muitas páginas. Não precisa deles para desenhar uma página.

#Plano e permissões

Proprietários e admins podem criar, editar e eliminar modelos. No Creator Free, o botão «+ Modelo» está bloqueado e aparece «Os modelos do espaço de trabalho estão disponíveis a partir do Creator Pro.»

#Criar um modelo

1. Abra «Domínios e modelos»
2. Clique em «+ Modelo»
3. Preencha os campos e clique em «Criar»

«Chave (a-zA-Z0-9_-)»

2–64 caracteres compostos por letras, dígitos, _ e -. A chave é única no espaço de trabalho e não pode ser alterada mais tarde.

«Nome»

Obrigatório, até 120 caracteres, por exemplo «Lançamento de produto».

«Começar a partir de»

Só ao criar: «Modelo vazio» ou uma cópia de um modelo integrado. Uma cópia herda a estrutura, os marcadores e o aspeto do original e é a forma mais rápida de começar.

«Estado»

Só ao editar: «Ativo» ou «Desativado».

«Conteúdo HTML»

A estrutura HTML, obrigatória. Até 60 000 bytes; letras acentuadas e outros caracteres especiais ocupam mais do que um byte. Se o HTML for maior, o LinkHarbor recusa guardá-lo.

«Esquema (JSON)» e «Valores predefinidos (JSON)»

Descrevem os valores ajustáveis do modelo e as respetivas predefinições. Ambos têm de ser JSON válido e as predefinições têm de corresponder ao esquema. Cada um pode ter no máximo 64 KB, e um texto individual no seu interior no máximo 5000 caracteres.

#Regras para o HTML

O HTML tem de conter um marcador onde aparece o conteúdo da página.

Por razões de segurança, o LinkHarbor limpa o HTML ao guardar:

• São permitidos elementos comuns de texto e layout, como div, section, header, p, a, img ou table. script, iframe e noscript são removidos juntamente com o conteúdo; outros elementos, como form, svg, link ou meta, sem o conteúdo
• Atributos de evento como onclick e links com javascript: são eliminados
• Um bloco style é mantido, mas, tal como o CSS personalizado, não pode carregar nada de outros servidores
• As classes CSS são mantidas se começarem por lh-, existirem nos modelos integrados ou estiverem definidas no bloco style do modelo, por exemplo com .hero { … }; as outras classes são removidas. IDs e atributos data- e aria- são mantidos
• Os estilos inline são permitidos, mas as declarações com url() para outros servidores, @import ou position: fixed são removidas
• Os marcadores no bloco style ou em style="" só inserem valores CSS válidos, como cores do tipo #1a2b3c, tamanhos como 24px ou números como 0.5. Um valor com ; { } aspas ou url() fica vazio. Os campos cujo valor predefinido é uma cor, um tamanho ou um número só aceitam esse tipo de valores quando a página é guardada
• As imagens só são possíveis a partir dos seus ficheiros LinkHarbor ou através de marcadores como {{avatar_url}}

Há dois erros que impedem a gravação: «O CSS do modelo não pode carregar nada de outros servidores …» se o bloco style contiver endereços externos, e «Uma secção no HTML do modelo … não é permitida ou não está bem fechada.» se um {{#if}}, {{#unless}} ou {{#each}} não terminar no mesmo texto, etiqueta ou atributo em que começa, ou estiver em style, href ou src.

Os modelos guardados antes de 1 de novembro de 2026 perderam os estilos e as classes quando foram guardados nessa altura. Se precisar deles, crie-os de novo a partir de uma cópia nova.

#Usar um modelo numa página

Os modelos do espaço de trabalho ativos aparecem ao criar uma página e no Construtor em «Tema» → «Modelo», no grupo «Modelos próprios», com os 17 modelos integrados por cima, em «Modelos integrados». A descrição diz «Modelo do espaço de trabalho, criado em “Domínios e modelos”.» Escolher e mudar funciona como nos modelos integrados, veja Escolher e mudar de modelo.

• Se alterar o modelo, a pré-visualização da página mostra a alteração de imediato. Só fica online quando voltar a publicar a página. Se várias páginas usarem o modelo, volte a publicar cada uma delas
• Ao publicar, o LinkHarbor guarda uma cópia do modelo na versão. Por isso, a página online fica inalterada, mesmo que o modelo seja alterado ou desativado mais tarde
• Na API e para assistentes de IA, um modelo do espaço de trabalho chama-se «ws:» seguido da chave, por exemplo ws:product-launch
• Define as suas próprias posições de imagem através da API (asset_slots), até 32 por modelo

#Editar, desativar e eliminar

A lista mostra nome, chave, estado e data, com os botões «Editar» e «Eliminar».

Desativar

Ao editar, defina «Estado» como «Desativado». As páginas que já usam o modelo mantêm-no. O Construtor mostra então, por exemplo, «Atual: Lançamento de produto (desativado)». O modelo deixa de poder ser selecionado; quem tentar vê «Este modelo do espaço de trabalho está desativado. Ative-o em “Domínios e modelos” para o usar numa página.»

Eliminar

Um modelo eliminado desaparece da lista para sempre e deixa de contar para o limite; pode reutilizar a chave num novo modelo. Enquanto uma página o usar, a eliminação está bloqueada: «Este modelo ainda é usado por {count} página(s). Mude primeiro essas páginas para outro modelo.» Em vez de {count}, aparece o número de páginas.

Os modelos desativados continuam a contar para o limite do seu plano. Se precisar de espaço, elimine-os.

#Em caso de downgrade e upgrade

No Creator Free, todos os modelos do espaço de trabalho ativos são desativados; a lista mostra então «Desativado pelo plano». As páginas publicadas ficam inalteradas, incluindo as que usam um modelo próprio. No Construtor aparece então «(desativado)» ao lado de «Atual:». Depois de um upgrade, exatamente esses modelos voltam a ficar ativos. Os modelos que desativou ou eliminou por si continuam assim.