Mídia e Documentos (Modelo de Conteúdo)

Dois subsistemas relacionados lidam com arquivos: a biblioteca de mídia para imagens usadas pelo conteúdo, e documents para arquivos para download. Eles se comportam de forma diferente por design. Imagens acompanham as pages, enquanto documents são entregues pelo próprio CMS.

Media

Cada upload vira um registro da biblioteca com metadados: nome original, tipo MIME, tamanho, texto alternativo, legenda, crédito e pasta.
As imagens são processadas no upload. Redimensionadas e com tamanhos derivados gerados; o próprio arquivo mantém seu nome através de substituições, de modo que todas as referências permaneçam válidas quando você trocar uma imagem por uma nova versão.
Cada salvamento cria uma revisão de mídia; verificações de integridade de conteúdo rodam no armazenamento.
A exclusão de mídia é uma exclusão suave para a Lixeira, e o purge periódico remove as linhas cujos arquivos sumiram do disco.

Documents

Documents são arquivos para download (PDFs, ZIPs, etc.) com seu próprio ciclo de vida de publicação:

Título, slug, idioma, descrição, janelas de publicação e organização em pastas.
Metadados extras capturados por tipo de document (número de páginas, autor, data de criação, dimensões, modo de cor: úteis para assets de imagem e relatórios).
Contagem de downloads por document.
Documents carregam seu próprio vocabulário de tags (separado das tags de post, com cores opcionais).
Janelas agendadas de publicação e despublicação funcionam como o agendamento de pages.
Um embed estilo [form:slug] não é como docs aparecem: os links para eles vêm do tipo de block document ou de links diretos no conteúdo do corpo.