Pular para o conteúdo

Galerias pelo painel

Pelo painel você cria galerias, envia arquivos arrastando-os para a tela, copia a URL pronta e apaga o que não quer mais. O que o painel faz é o mesmo que a API de galerias, com as mesmas regras de varredura e de limites. Para automatizar, veja Galerias e arquivos.

  • Você precisa ser membro do time (ou ter papel acima) para criar galerias e enviar arquivos. Quem só visualiza vê a lista, mas não vê os botões de criar e enviar.
  • Excluir uma galeria exige papel de administrador e confirmação de identidade.
  • O item Galerias só aparece quando o recurso está ligado na plataforma. Se aparecer “Galerias não estão disponíveis”, ele ainda não foi ligado.
  1. No menu do time, abra Galerias.
  2. Clique em Nova galeria (ou em Criar a primeira galeria, se a lista estiver vazia).
  3. Em Nome, escreva até 80 caracteres.
  4. Se quiser, escolha um Projeto (opcional). Isso só organiza a lista por projeto e não muda as URLs.
  5. Clique em Criar galeria.

A galeria ganha uma chave pública (por exemplo marcas-k7p2) que vai nas URLs. Você pode mudar o nome depois em Renomear / mover, mas a chave nunca muda.

No alto da lista, o cartão Uso da cota mostra duas barras: Armazenamento e Arquivos. A cota é do time, somando todas as galerias dele. Com 80% de uso aparece um aviso. Com a cota cheia, aparece “Cota cheia: novos envios serão recusados até liberar espaço.” e você precisa apagar arquivos antes de enviar novos.

Os valores padrão e outros limites estão em Limites e cotas. Os números exatos do seu time são os que as barras mostram.

  1. Clique em Abrir na galeria.
  2. Arraste arquivos para a área Arraste arquivos aqui ou clique para escolher, ou clique nela para escolher no computador. Pode enviar vários de uma vez.
  3. Para enviar um arquivo com outro nome, preencha antes Nome do arquivo (opcional, para envio de um arquivo só), com até 120 caracteres. Sem isso, vale o nome do arquivo, normalizado.
  4. Acompanhe a Fila de envio: Na fila, Enviando e Enviado · em análise. Clique em Limpar lista para esvaziar a fila.

Limites do envio pelo painel: 25 MB por arquivo, qualquer tipo, e imagens de até 40 megapixels. Todo arquivo passa por varredura de segurança antes de ser publicado.

O nome pode ter pastas separadas por / (por exemplo logos/acme.png) e é único dentro da galeria. Se você enviar outro arquivo com o mesmo nome, nasce uma nova versão e a URL alias passa a apontar para ela. Enviar o mesmo conteúdo no mesmo nome não cria versão nova.

A Nebular guarda as 5 versões mais recentes de cada arquivo; versões mais antigas só são removidas depois de 30 dias. A versão atual nunca é removida. Por isso, não dependa de uma URL fixa muito antiga: use a URL fixa de uma versão que você ainda considera atual.

Cada arquivo tem dois botões de cópia:

Botão O que copia Quando usar
Copiar URL O alias, que sempre aponta para a versão atual. Cache de 60 segundos. Em sites: trocar a imagem não exige trocar o endereço.
Copiar URL fixa O endereço com o hash da versão. O conteúdo não muda, cache de 1 ano. Quando algo não pode mudar sozinho, como um e-mail já enviado.

Clique em Detalhes para ver o Histórico de versões: a URL alias, a URL fixa de cada versão, as dimensões e o hash. Mais sobre o cache em Cache e purge.

Cada arquivo mostra um selo. O painel consulta sozinho os arquivos em análise por até 2 minutos.

Selo Significado O que fazer
Verificado Passou na varredura e está publicado. Copie a URL e use.
Em análise Ainda não foi publicado, o URL ainda não existe. Espere. Não envie de novo. Se aparecer “Ainda em análise; volte mais tarde.”, reabra a galeria depois.
Recusado A varredura detectou problema. O selo mostra o motivo. Veja Classes de arquivo e varredura. Em SVG, reexporte como SVG estático.
Em quarentena Estava publicado, mas uma nova varredura diária o detectou. Saiu do ar (a CDN responde 451). Não insista. Se for falso positivo, avise o suporte.
Mensagem (resumo) O que fazer
Passa do tamanho máximo por arquivo (25 MB) Comprima ou divida o arquivo.
A cota de armazenamento do time acabou Apague arquivos que não usa.
Tipo não aceito, extensão diferente do conteúdo, classe não permitida Confira se a extensão corresponde ao conteúdo real.
Detecção de ameaça (com o nome da assinatura) Verifique o arquivo. Pode ser falso positivo.
SVG recusado Siga a tabela em Classes de arquivo e varredura.
Compactado com senha, ou formato 7z, rar, xz, bzip2 Envie uma versão sem senha, em .zip ou .tar.gz.
Muitas requisições Espere um instante e tente de novo.
Varredura temporariamente indisponível É seguro tentar de novo em alguns minutos.
  • Arquivo: em Excluir, confirme em Excluir arquivo. O arquivo e todas as versões saem do ar, as URLs deixam de funcionar e o cache da CDN é limpo. Quem tem papel de membro pode apagar arquivos.
  • Galeria: em Excluir, na galeria, que precisa estar vazia. Só administradores, com confirmação de identidade. Se ainda houver arquivos, aparece “Essa galeria ainda tem arquivos” e você deve apagá-los primeiro.

Para enviar arquivos por script ou por um agente, crie um token em Configurações do time, Tokens de API, com as permissões Ler arquivos (assets:read), Enviar e excluir arquivos (assets:write) e Gerenciar galerias (galleries:manage). Você pode restringir o token a galerias específicas; um token restrito não cria galerias novas. Detalhes em Tokens e escopos.

Sintoma O que fazer
Não vejo Nova galeria Seu papel é de visualização. Peça a um membro ou administrador.
O selo fica em Em análise O scanner pode estar ocupado. Não reenvie; volte mais tarde.
A URL copiada ainda mostra a imagem antiga Cache de 60 s do alias. Use a URL fixa da nova versão.
Não consigo excluir a galeria Apague os arquivos dela primeiro.