comment_area() – Opus Core

Função que exibe no template a área completa de comentários do artigo atual, incluindo o cabeçalho, o formulário e a listagem de comentários.

Para utilizar a área de comentários, o recurso 'comment_area' deve ser registrado pelo template antes da chamada da função:

append_resource( 'comment_area' );

Depois de registrado, a área pode ser exibida no ponto desejado do template através de:

comment_area();

A função deve ser utilizada no contexto de um artigo, arquivo article.php do template.

Parâmetros:
$args array Argumentos opcionais para configurar a apresentação da área de comentários:

'show-title' bool Exibe o título da área de comentários. Padrão: true.
'show-count' bool Exibe a quantidade de comentários do artigo. Padrão: true.
'tag' string Tag HTML utilizada no título. Padrão: strong.
'id' string Atributo id do título. Padrão: comment-title.
'class' string Classe CSS aplicada ao título.
'innerText' string Texto exibido no título. Padrão: Comentar.

As opções 'show-title' e 'show-count' aceitam valores falsy para desativar a respectiva apresentação.

Retorno: void

Notas:

O sistema de comentários atualmente trabalha com usuários autenticados. A edição e a exclusão do próprio comentário pelo usuário ainda não estão disponíveis; essas operações são realizadas pela administração através do painel. Respostas a comentários (parent) também não fazem parte da funcionalidade atual.

Se comment_area() for chamada sem que o recurso 'comment_area' tenha sido registrado, a função não gera um erro fatal. Quando DISPLAY_ERRORS está habilitado, o Opus Core emite um aviso informando que o recurso não foi registrado.

Exemplo de uso:

/* features.php */
append_resource( 'comment_area' );

/* article.php */
comment_area();

Exemplo com opções:

comment_area([
    'show-title' => true,
    'show-count' => false,
    'tag'        => 'h3',
    'id'         => 'comments',
    'class'      => 'comments-title',
    'innerText'  => 'Comentários'
]);