Pular para o conteúdo principal

Imagens Destacadas

O sistema de mídias do Opus Core permite gerar, organizar e exibir imagens destacadas para diferentes entidades do sistema.

As imagens são processadas automaticamente em múltiplos tamanhos (escopos), possibilitando utilizar versões específicas conforme a necessidade do site.

O sistema suporta imagens para:

  • Postagens
  • Páginas
  • Categorias
  • Usuários

Configuração de tamanhos

Os tamanhos das imagens podem ser configurados diretamente no Painel de Admin: 

Dashboard → Configurações → Mídias

Cada entidade possui seus próprios escopos de imagem e dimensões independentes.

Para desabilitar um escopo basta definir largura ou altura com valor 0.

Escopos padrões

Entidade Escopos
Postagens wide, larger, minor, thumb
Páginas wide, larger, minor
Categorias plain, thumb
Usuários profile, avatar

Métodos da classe Image

A classe Image possui métodos auxiliares para exibição de imagens destacadas fora do loop do subsistema Seek.

Método Descrição
Image::featured() Exibe diretamente o elemento <img>.
Image::get_featured() Retorna o elemento <img> como string.
Image::featured_url() Exibe diretamente a URL da imagem destacada.
Image::get_featured_url() Retorna a URL da imagem destacada.

Exemplo de uso

Image::featured([ 'scope' => 'minor' ]);

Image::featured([
    'scope' => 'wide',
    'class' => 'featured-image',
    'alt'   => 'Prefixo: ' . page_title()
]);
Exemplo de saída: 
<img 
    src="https://dominio.ext/uploads/2026/05/post-wide.webp"
    alt="Prefixo: Título da página"
    width="1600"
    height="550"
    class="featured-image"
/>
Se não passado nenhum escopo para qualquer método da classe Image, ela vai procurar pelo padrão, se não encontrar não exibe nada:
  • Para posts páginas: 'larger'
  • Categorias: 'plain'
  • Usuários: 'profile'

Funções do loop Seek

Durante a iteração de registros no subsistema Seek, funções auxiliares podem ser utilizadas para exibir imagens destacadas da entidade atual. 

while( row_exists() ) : show_row();

    echo get_featured_image();

endwhile;
Funções relacionadas:

Notas

  • O sistema adiciona automaticamente os atributos HTML width e height com base nos dados da imagem. O atributo alt utiliza por padrão o título ou nome da entidade relacionada.
  • As informações das imagens são armazenadas em formato JSON na tabela medias.
  • Os métodos da classe Image funcionam independentemente do loop do subsistema Seek.
  • A manipulação e processamento físico das imagens é realizada pela classe ImageHandler. E escopos personalizados podem ser registrados através dela pelo método ImageHandler::append_scope()
  • O sistema utiliza automaticamente a extensão Imagick quando disponível no servidor, utilizando GD como fallback.