list_posts_relateds( array $args = [] ): void
Exibe uma lista HTML de postagens relacionadas ao conteúdo atual.
Parâmetros:
$args array (opcional)
Argumentos disponíveis:
-
'item_title_tag'string
Elemento HTML utilizado no título de uma postagem relacionada.
Padrão:'strong' -
'list_class'string
Classe CSS adicionada na tag<ul>. -
'limit'int
Número máximo de postagens relacionadas. Padrão:6
Retorno: void
Imprime diretamente a estrutura HTML da listagem.
Exemplo de uso:
<section class="list-related">
<h3>Leia também</h3>
<?php list_posts_relateds() ?>
</section>
// Exemplo personalizado
<?php
list_posts_relateds([
'item_title_tag' => 'h4',
'list_class' => 'related-posts',
'limit' => 4
]);
?>
Estrutura HTML interna:
<ul class="related-posts">
<li>
<span class="thumbnail">
<img src="https://dominio.ext/uploads/thumb.jpg" alt="Título do post">
</span>
<strong class="r-title">Título do post</strong>
<a href="https://dominio.ext/catslug/post-slug"></a>
</li>
</ul>
Notas:
- A função executa a listagem apenas quando
is_post()retornartrue. - As postagens relacionadas são obtidas através do método
relateds()da classePost. - A postagem atual é automaticamente excluída da listagem.
- As miniaturas são exibidas apenas quando existir um arquivo de mídia no escopo
thumb. - As dimensões da imagem são obtidas automaticamente através dos dados armazenados no arquivo JSON da mídia.