Links de pré-visualização do conteúdo
Os links de pré-visualização permitem abrir a entrada atual no frontend em modo rascunho antes de publicá-la. O Contismo monta a URL a partir de um modelo que você configura em cada modelo de conteúdo; o site valida a solicitação e carrega o conteúdo em rascunho a partir da API GraphQL.
Configurar uma URL de pré-visualização no modelo
Seção intitulada “Configurar uma URL de pré-visualização no modelo”Cada modelo de conteúdo aceita um modelo de URL de pré-visualização (uma URL completa, não só um caminho).
- Vá em Modelos → Modelos de conteúdo e abra o modelo.
- Na seção URL de pré-visualização, digite um padrão de URL completo.
- Use tokens para os segmentos dinâmicos (veja a tabela de referência dessa seção, ou a de baixo).
- Salve o modelo (use a ação de salvar do editor do modelo para que o modelo de URL seja armazenado).
Modelo de exemplo:
https://staging.example.com/api/draft?secret=YOUR_SECRET&redirect=/blog/{field.slug}Staging e produção em geral usam ambientes diferentes no Contismo, cada um com o próprio modelo de URL apontando para o host correspondente.
Tokens disponíveis
Seção intitulada “Tokens disponíveis”| Token | Valor |
|---|---|
{entryId} |
ID da entrada |
{locale} |
ID de API da localidade |
{model} |
ID de API do modelo de conteúdo (singular) |
{modelPlural} |
ID de API do modelo de conteúdo (plural) |
{status} |
Status da entrada (DRAFT, PUBLISHED, …) |
{environment} |
ID de API do ambiente |
{field.<apiId>} |
Valor do campo pelo ID de API do campo (por exemplo, {field.slug}) |
Os valores dos tokens são codificados para URL quando o link é montado a partir dos dados salvos. A pré-visualização só está disponível para entradas existentes. Se um token obrigatório estiver ausente na entrada salva, o controle permanece desativado até você salvar com esse campo preenchido.
Abrir a pré-visualização a partir do editor de entradas
Seção intitulada “Abrir a pré-visualização a partir do editor de entradas”Quando um modelo de URL está configurado, a barra de ferramentas do editor de entradas (topo da página) mostra um controle de botão de Pré-visualização:
- Abrir pré-visualização: abre a URL resolvida em uma nova aba
- Copiar (ícone da área de transferência): copia a URL resolvida
Se faltarem tokens obrigatórios, o controle permanece desativado e uma dica explica o que é necessário (por exemplo, salvar a entrada primeiro quando o modelo usa {entryId}).
O link usa os dados salvos da entrada (a última versão armazenada no Contismo). Salve a entrada primeiro se você a está criando ou se alterou campos que aparecem na URL (por exemplo, {field.slug}).