Biblioteca de Mídia

A biblioteca de mídia guarda todas as imagens que você usa no site. Envie uma vez e depois insira em páginas, posts e blocks a partir do mesmo seletor em todo lugar. Esta página cobre o envio, as variantes automáticas de tamanho, os detalhes editáveis por imagem e como a exclusão se comporta quando o conteúdo faz referência a um arquivo.

Envio (upload)

Na área administrativa de Mídia, escolha Upload e selecione um ou vários arquivos de uma vez (cada um com até 10 MB).
Tipos de imagem aceitos: JPEG, PNG, GIF e WebP. Qualquer outra coisa é rejeitada (documentos como PDFs e arquivos do Office pertencem ao módulo de Documentos; os campos de upload de arquivos de formulários têm seu próprio conjunto de tipos aceitos).
Algumas verificações de segurança rodam em cada upload antes que o arquivo fique visível em qualquer lugar:
- O arquivo precisa ser o que seu tipo declara: o conteúdo é inspecionado, não apenas a extensão declarada. Um arquivo renomeado com conteúdo incompatível é recusado.
- Um arquivo idêntico já presente na biblioteca é recusado com um apontamento para o item existente (“já armazenado como …”), o que evita duplicatas acidentais.
O nome de arquivo armazenado é randomizado no servidor; o nome que você vê na biblioteca é o nome de arquivo original que você enviou, e você pode alterá-lo depois.

O que acontece após o upload

O processamento roda em segundo plano no momento em que o seu upload termina:

As imagens são otimizadas. Os JPEGs são re-comprimidos em uma boa qualidade para web; os PNGs são re-comprimidos com compressão máxima. Isso acontece uma vez, no servidor.
Tamanhos responsivos são criados. Para imagens JPEG e PNG mais largas que 320 px, a biblioteca gera versões de 320, 640 e 1280 pixels: cada uma no formato original e, adicionalmente, em WebP. Os temas as usam para servir imagens de tamanho apropriado a celulares e desktops automaticamente.
As dimensões são registradas (largura/altura em pixels), exibidas nos detalhes do item.
Se uma imagem for extrema em dimensões (mais de 10.000 pixels em qualquer direção), ela é recusada como um possível ataque de descompressão, em vez de derrubar o servidor.
GIFs e WebP são armazenados como estão; nenhuma re-compressão ou variante de tamanho é criada para eles.

A visualização da biblioteca

Pastas permitem organizar: atribua um nome de pasta a qualquer imagem, e a barra lateral lista todas as suas pastas para filtragem rápida.
A busca olha pelo nome de arquivo original, texto alternativo e nome de arquivo armazenado. Ordene por mais recente, nome ou tamanho de arquivo.
A contagem por página é grande (100 itens; 50 quando aberto como seletor a partir do editor).
Aberta como seletor dentro do editor de página/post, a biblioteca se comporta como um seletor de escolha: escolher uma imagem a insere no conteúdo na posição do cursor.

Detalhes editáveis por imagem

Abra um item para editar:

Nome de arquivo (nome de exibição) e texto alternativo: o texto alternativo descreve a imagem para leitores de tela e para SEO; ele assume como padrão o nome de arquivo original no upload e vale a pena preenchê-lo deliberadamente.
Pasta, legenda e crédito: legenda e crédito estão disponíveis para os temas para fins de exibição.
Substituir o arquivo: envie uma nova versão da imagem no lugar. O nome de arquivo permanece o mesmo, então toda página e block que já referencia a imagem continua funcionando, e o pipeline de otimização/variantes roda de novo sobre o novo arquivo. A substituição é limitada a administradores ou à pessoa que enviou a imagem.
Relatório de uso: a página do item mostra todos os lugares em que ele é referenciado pelo seu conteúdo, com links para cada item.
Revisões: alterações de metadados são capturadas em snapshots, então nomes/textos alternativos anteriores podem ser revertidos remotamente como outras revisões de conteúdo.

Exclusão

Excluir move os itens para a lixeira, com um link imediato de desfazer e a restauração pela lixeira depois.
Um arquivo referenciado por páginas, posts ou blocks no ar não pode ser excluído; os erros nomeiam as páginas que o referenciam para que você remova esses usos primeiro. Somente arquivos genuinamente não usados podem ir para a lixeira e depois serem excluídos permanentemente.
Exporte os metadados da biblioteca como um arquivo JSON (útil para um inventário ou como ponto de partida para uma migração), e administradores podem importar metadados desse mesmo formato de volta.

Orientação prática

Preencha o texto alternativo no momento do upload: ele assume como padrão o nome do arquivo, o que raramente é amigável ao leitor.
Prefira enviar a imagem de maior resolução que você tiver (até 10 MB): a biblioteca deriva os tamanhos menores por conta própria, então manter o arquivo grande original como mestre mantém o conjunto responsivo consistente.
Pastas são apenas organizacionais: mover um item para uma pasta não muda sua URL nem nenhuma referência existente.