Pular para o conteúdo principal
As imagens da loja (logo, banners, produtos, categorias, imagens do schema) são servidas pela CDN da AllBay. Na grande maioria dos casos elas chegam ao tema como URL pronta: use direto no src, sem filtro.

Regras de ouro

  1. Use a URL como ela vem. Não monte nem altere URLs de imagem.
  2. Sempre teste antes de usar. Uma imagem que não pode ser servida chega vazia ("", null ou ausente) — nunca escreva <img src="">.
  3. cdn_url só para hash. Ele existe apenas para as imagens que chegam como hash (ver abaixo).

Formato

O parâmetro w é a largura entregue — a AllBay já escolhe o tamanho certo para cada campo.

Onde as imagens chegam prontas

  • No card, image, banner, image_url e banner_url são a mesma imagem (o banner do produto, ou a imagem quando não há banner). Na página do produto, image_url é a imagem do produto e images começa pelo banner, seguido da galeria.
  • gallery[] e images[] podem conter vídeos (.mp4). Confira a extensão antes de usar em <img>: {% unless img contains '.mp4' %}…{% endunless %}.
  • O logo vem pequeno. Para um logo grande, crie um campo de imagem no schema.

Quando usar cdn_url

Os resultados destes load trazem as imagens como hash, não como URL:
  • {% load "products" %}
  • {% load "product" %}
  • {% load "categories" %}
Converta com cdn_url, informando o tipo, o id e o campo:
O resultado é uma imagem WebP de 256 px. Imagens de galeria e imagens animadas não são resolvidas por cdn_url.
Prefira {% load "packages" %} a {% load "products" %} quando for mostrar cards: ele já devolve os produtos no formato de card, com as imagens prontas.

Imagens do schema

Os campos image e images do schema guardam a imagem enviada pelo dono e chegam em config/settings já como URL pronta:
Hoje só os campos image/images de primeiro nível do schema viram URL. Um campo image dentro de um item de array chega como hash e não pode ser exibido — evite esse formato por enquanto.