Skip to main content

Blog e artigo

Uma listagem mostra os artigos de um blog. A página de artigo mostra um texto. Os dois usam o contexto da página atual, não uma chamada manual à API. Índice: Cookbooks. Campos do objeto: Blog. Menus e preview: Menus e blog.

O que você precisa

  • Templates templates/blog.json e templates/article.json. O validador os trata como recomendados (page, blog, article, 404), não como os cinco obrigatórios.
  • Uma seção com enabledOn em blog ou article.
  • usePage de @corvex/theme-sdk.
O runtime carrega o blog pelo parâmetro ?blog= ou pelo primeiro blog da loja. Na listagem, a plataforma pede até 12 artigos. Esse número não vem de um setting do tema.

Listagem

usePage ignora o texto do argumento e devolve o contexto da página aberta. No template blog, leia blog e articles.
A listagem não traz bodyHtml. Cada item é um resumo: title, excerpt, url, featuredImageUrl, publishedAt.

Artigo

No template article, leia article e blog. Se a URL tiver ?article=, o runtime devolve o artigo e não a lista.
bodyHtml é o HTML que a API envia (bodyHtml ou contentHtml no payload). O mapper não sanitiza esse HTML. Se a seção injetar o valor, o tema assume o conteúdo da plataforma. Não foi verificado se a API já filtra o HTML.

Preview

Rotas que o mapper monta: /blogs/{handle} e /blogs/{blog}/articles/{artigo}. Esta página não confirma que a loja publicada serve essas rotas.

Checklist

  • Templates blog.json e article.json existem se a loja usa blog
  • A listagem usa articles?.nodes e não espera bodyHtml
  • A página de artigo trata article ausente
  • corvex validate .

Veja também