Pular para o conteúdo principal

list_posts_relateds()

list_posts_relateds( $limit = 6 )

A função list_posts_relateds() é um Bloco de Funcionalidade que gera uma lista de posts relacionados com base nas categorias do post atual.

Parâmetros:
$limit int (opcional)
O número máximo de posts relacionados a serem exibidos. Padrão: 6

Retorno: void
A função imprime o HTML contendo uma lista <ul> de posts relacionados. Se a página atual não for um post único, ela não imprime nada.

Exemplo de uso:

// Uso básico no template (exibe os 6 posts relacionados na parte inferior do post)
<section class="related-content">
    <h3 class="related-title">Leia Também</h3>
    <?php list_posts_relateds() ?>
</section>

// Exibe um limite personalizado de 3 posts
<?php list_posts_relateds(3) ?>

Notas:

  • Condicional: A função executa a listagem somente se a função is_post() retornar verdadeiro (ou seja, se o usuário estiver em uma página de post único). Isso evita erros em outras partes do site.
  • Exclusão Implícita: O post atual é automaticamente excluído da lista de relacionados, já que a busca por posts relacionados é feita pela *categoria*, e o post atual já está na tela.
  • Responsabilidade HTML: O HTML de cada item da lista (<li>) é gerado pelo método, mas wrappers externos (<section>, <h3>) devem ser adicionados no template.
  • O método por trás da função verifica a existência de $show->attachment->small antes de gerar o HTML da miniatura.