Pular para o conteúdo principal

list_posts_relateds()

list_posts_relateds( array $args = [] ): void

Exibe uma lista HTML de postagens relacionadas ao conteúdo atual.

Parâmetros:
$args array (opcional)

Argumentos utilizados para personalização da listagem.

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() retornar true.
  • As postagens relacionadas são obtidas através do método relateds() da classe Post.
  • 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.