Como os vídeos aparecem nos cards de produto

Quando um produto tem vídeo cadastrado, o sistema decide se vai mostrar esse vídeo no lugar da foto. Essa decisão segue algumas regras simples:

1. O produto precisa ter o vídeo "ligado"

Cada produto tem uma chave que permite desativar o vídeo especificamente na listagem. Se estiver desativado para aquele produto, o card mostra a foto normalmente.

2. Máximo de 10 vídeos por página

Para não deixar a página lenta, o sistema exibe no máximo 10 vídeos por carregamento. Depois do décimo, todos os outros produtos com vídeo continuam mostrando a foto.

3. No máximo 1 vídeo a cada 5 cards

Esse é o ponto mais importante do comportamento visual. Os cards são agrupados em blocos de 5. Em cada bloco, apenas o primeiro produto com vídeo válido vai exibir o vídeo — os outros 4 do mesmo bloco mostram foto mesmo que também tenham vídeo. No bloco seguinte, a "fila" recomeça.

O objetivo dessa regra é evitar que vários vídeos apareçam seguidos na tela, o que pesaria no carregamento e poluiria visualmente a listagem.

Em resumo: o vídeo substitui a foto no card, mas de forma controlada — espaçado pela página, com limite total, e com a possibilidade de desativar por produto.