Como obter a imagem em destaque no WordPress?

Nesta dica rápida, mostrarei como obter a imagem em destaque para um post ou página no WordPress.

O que é uma imagem em destaque?

Uma imagem em destaque no WordPress é a imagem que usamos para representar uma postagem ou página específica do blog. Outro nome para imagens em destaque são miniaturas de postagens.

A seção de imagens em destaque na página de edição de posts do WordPress não está disponível por padrão. O suporte é adicionado a um tema adicionando a seguinte linha ao funções.php Arquivo.

add_theme_support( 'post-thumbnails' );

Se o seu tema suportar imagens em destaque, você verá um Imagem em destaque seção na tela de edição de suas postagens, como mostrado abaixo.

Como obter a imagem em destaque no WordPress?

Digamos que um tema tenha adicionado suporte para a funcionalidade de imagem em destaque. Neste caso, você pode usar o get_the_post_thumbnail() função para recuperar a imagem em destaque do post especificado. Esta função retornará a tag de imagem em miniatura do post. Ele aceita três parâmetros opcionais:

• o ID do post para o qual você deseja obter a imagem
• o tamanho da imagem
• atributos

Se você não fornecer nenhum argumento, a função retornará uma tag de imagem para a imagem em destaque da postagem atual por padrão.

".get_the_title()."";
	echo get_the_post_thumbnail();
	the_content();
}
?>

Outra função que você pode usar é o the_post_thumbnail() função que elimina a necessidade de usar echo para gerar a miniatura da postagem.

Como obter o ID da imagem em destaque no WordPress?

Existe outra função útil chamada get_post_thumbnail_id() que retornará o ID da miniatura da postagem atual. Você também pode passar um ID de postagem como parâmetro para a função para obter a imagem em destaque de uma postagem específica.

E se a postagem atual não tiver uma imagem em destaque? Nesse caso, esta função retornará o valor 0.

Caso você use esta função para obter o ID da imagem em destaque de uma postagem específica e ela não exista, você receberá de volta false como o valor de retorno. Isso garante que uma comparação rigorosa revelará se uma postagem específica não possui uma imagem em destaque ou se a postagem em si não existe.

Thumbnail ID: ".get_post_thumbnail_id()."
";
}
?>

Tente ecoar o ID da miniatura dentro do loop e você verá que ele retorna 0 para postagens em que nenhuma miniatura foi fornecida. Além disso, passar um ID de postagem inexistente retornará false como mostrado abaixo.

Não há postagem com ID 3468 no meu site, então ele retorna false.

Como verificar se uma postagem contém uma imagem em destaque?

Você não precisa confiar no valor de retorno do get_post_thumbnail_id() função para verificar se uma postagem definiu uma imagem em destaque. Você pode fazer o mesmo com outra função chamada has_post_thumbnail(). Esta função aceita um parâmetro de ID de postagem opcional e retorna um valor booleano.

Ele vai voltar true se a postagem tiver uma miniatura anexada e false por outro lado.

".get_the_title()."";

	if(has_post_thumbnail()) {
		echo get_the_post_thumbnail();
	} else {
		// Show Placeholder Image
	}
}
?>

Você pode usar o valor dessa função para tomar decisões relacionadas ao layout ao mostrar uma lista de postagens no frontend.

Pensamentos finais

Nesta dica rápida, mostrei três funções diferentes que você pode usar para obter a imagem em destaque de uma postagem, o ID da imagem em destaque de uma postagem ou verificar se existe uma imagem em destaque.

Existem muitas outras funções relacionadas à miniatura de postagem que você deve ler na documentação do WordPress.