Pular para o conteúdo principal

posts_relateds()

Retorna uma lista HTML com postagens relacionadas ao conteúdo atual.

Parâmetros:
array (opcional)

  • 'scope' string
    Escopo da imagem utilizada no arquivo de mídia da postagem.
  • 'item_title_tag' string (opcional)
    Elemento HTML utilizado no título da postagem. Padrão: 'strong'
  • 'limit' int (opcional)
    Número máximo de postagens relacionadas (LIMIT). Padrão: 4

Retorno: string

Exemplo de uso:

<div id="relateds">
    <h3 class="title">Relacionados:</h3>
    <div class="slider">
        <button class="prev">‹</button>
        <div class="wicket">
            <?php echo 
            posts_relateds([
                'scope'          => 'entry', 
                'item_title_tag' => 'h4', 
                'limit'          => 16
            ]); 
            ?>
        </div>
        <button class="next">›</button>
    </div>
</div>

Exemplo da estrutura HTML interna:

<ul>
    <li>
        <a href="https://dominio.ext/cat-slug/post-slug">
            <img 
                src="https://dominio.ext/uploads/Y/m/post-47-entry.jpg" 
                alt="Título do post" width="600" height="400"
            />
            <strong>Título do post</strong>
        </a>
    </li>
</ul>

Notas:

  • A função utiliza internamente o método relateds() da classe Post.
  • As postagens relacionadas são identificadas através das categorias vinculadas à postagem atual.
  • O sistema considera a hierarquia de categorias durante a busca de relacionados.
  • As dimensões da imagem são obtidas através dos dados armazenados na coluna attachment JSON da tabela medias
  • Se a postagem relacionada não possuir imagem no escopo informado, apenas o título será exibido.