Pular para o conteúdo principal

posts_relateds()

posts_relateds( string $scope, string $h = 'strong', int $limit = 4 ): string

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

Parâmetros:

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

Retorno: string
Retorna uma estrutura HTML contendo a lista de postagens relacionadas.

Exemplo de uso:

<?= posts_relateds('thumbnail') ?>
<?= posts_relateds( 'thumbnail', 'h3', 6 ) ?>

Estrutura HTML:

<ul>
    <li>
        <a href="https://dominio.ext/post-slug">
            <img src="https://dominio.ext/upload/image.webp" 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.