Blog & artigos

Quando usar Publications

Use Publications sempre que o conteúdo for recorrente, organizado em séries/categorias e potencialmente restrito por papel. Casos típicos:

• Blog corporativo — posts diários/semanais sobre o nicho da empresa
• News / portal de notícias — matérias categorizadas por editoria
• Knowledge base — artigos organizados em "Categoria → Subcategoria → Artigo"
• Guias e tutoriais técnicos — TechArticle com hierarquia por tema
• Conteúdo gated — artigos premium para assinantes / membros
• Receitas, eventos, vagas — qualquer conteúdo "tipo lista" recorrente

Pages vs Publications

Os dois purposes compartilham os 11 schema types do CONTENT_OPTIONS — mas se comportam de forma muito diferente:

Hierarquia: coleções aninhadas

A maior diferença prática de Publications é a hierarquia. Você cria coleções (pastas), pode aninhar quantas precisar e cada nível vira um segmento da URL:

Regras importantes

• Sem maxDepth — você pode aninhar quantos níveis quiser, mas 3 níveis é o sweet spot recomendado para SEO (Categoria → Subcategoria → Artigo)
• Coleção é página também — vira CollectionPage automática listando filhos
• Schema herda — se a coleção raiz é Article, os filhos default são Article (mas pode trocar individualmente)
• Bulk move existe — reorganize o blog inteiro selecionando docs e usando "Mover entre coleções"

Schemas mais usados em Publications

Os 11 schemas do CONTENT_OPTIONS estão todos disponíveis (mesmo conjunto de Pages — vale revisar a página de Páginas). Mas em blog corporativo, os 5 protagonistas são:

Cada schema tem tags Schema.org específicas (datePublished, author, headline, articleBody…). Quando você escolhe um schema "editorial" como esses, o autor é obrigatório — a plataforma força preenchimento na etapa 3 do wizard.

Wizard de criação

O wizard é o mesmo de 4 etapas usado em Pages (Tipo, Básico, Metadados, Mídia). As únicas diferenças visíveis em Publications:

• Etapa 1 — Tipo mostra um toggle "Sub-coleção" vs "Publicação" quando você está dentro de uma coleção, em vez de criar sempre como leaf como em Pages
• Etapa 1 — Tipo herda o schema da coleção pai automaticamente ("Subtipo herdado: BlogPosting")
• Etapa 2 — Básico não tem toggle "Página inicial" (não aplicável)
• Etapa 3 — Metadados mostra papéis liberados (Entitlements) — escondido em Pages

Para detalhes de cada etapa em si, veja a documentação do wizard em Páginas.

Estrutura editorial (campos do artigo)

Cada artigo de Publications tem campos editoriais que vão muito além do título:

Acesso restrito (Entitlements)

Diferente de Pages, Publications permite controle de acesso por papel (entitlement). Cada artigo pode ter regras diferentes — ou em massa via Bulk Entitlements. São 3 níveis de acesso:

Como aplicar entitlements

1. Crie os papéis em Membros & permissões

   Os papéis personalizados (ex.: "Assinante", "Aluno Premium") viram entitlements disponíveis para selecionar.

2. Marque na publicação

   Na etapa "Metadados" do wizard (ou no editor depois), escolha quais papéis liberam o conteúdo.

3. Defina o nível de acesso

   Para cada papel: full, preview ou restricted.

4. Use bulk para massa

   Selecione 50 artigos premium e use a ação Definir acesso para aplicar a regra de uma vez.

CollectionPage automática

Toda coleção em Publications gera automaticamente uma página de listagem com schema CollectionPage. Acessível no permalink da coleção.

O que aparece na CollectionPage:

• Título e descrição — vindos da própria coleção
• Lista dos filhos publicados — em ordem de publishedAt (mais recente primeiro), com paginação
• Filtros opcionais — por sub-coleção, autor, tag
• Featured image de cada artigo — como thumbnail da listagem
• Excerpt (descrição) — texto curto antes do título

O layout da CollectionPage é definido no Page Builder ou template aplicado à coleção. Você não precisa criar a página manualmente — ela existe assim que a coleção tem filhos publicados.

Permalink construído pela hierarquia

Diferente de Pages (que ficam na raiz por padrão), Publications constrói o permalink juntando o caminho da coleção com o slug do artigo:

• Coleção raiz — /blog
• Sub-coleção — /blog/marketing-digital
• Artigo final — /blog/marketing-digital/seo/medir-trafego

Você pode customizar o permalink de qualquer artigo (override manual no PermalinkBuilder), mas o padrão segue a hierarquia. Ao mover o artigo entre coleções, o permalink atualiza e a plataforma cria redirect 301 do antigo para o novo.

Bulk actions úteis para blog

Todas as 8 ações em massa funcionam, mas as mais usadas em Publications são:

Import (WordPress, Markdown, JSON)

Em /documents/$purpose/import, você importa em massa. Para Publications, os formatos comuns:

• WordPress XML (WXR) — exporta direto do WP via Tools → Export. Mantém categorias (viram coleções), tags, autores, datas e featured image
• Markdown (frontmatter) — útil para migrar de Hugo, Jekyll, Astro, Next.js MDX. O frontmatter (title, date, tags, author) é mapeado automaticamente
• JSON — formato livre, com mapping de campos (você define qual campo do JSON vira qual campo do documento)
• CSV — para listas mais simples (título, slug, descrição, conteúdo, status)

Exemplos práticos