Receita: schema de autor e revisor
Marque em JSON-LD quem escreveu e quem revisou cada artigo, usando só funções oficiais do WordPress.
Neste texto
Que problema esta receita resolve?
Um artigo técnico ou de saúde, finanças ou direito costuma ter duas pessoas por trás: quem escreveu e quem conferiu. Quando a página só mostra "Admin" ou um nome sem link, o leitor e os sistemas que leem a marcação não conseguem ligar o texto a uma pessoa real com histórico. A receita resolve isso: cada post passa a declarar o autor e, quando existe, o revisor, em dados estruturados coerentes com o que está visível.
A lógica vem de um conjunto de plugins de autoria e revisão que Camillo Dantas desenvolveu. Esses plugins não são vendidos; esta receita entrega o raciocínio e o código para você implementar por conta própria.
Antes do código, um limite: marcação não cria credibilidade. Ela só descreve o que já está na página. Se a página não mostra quem escreveu, quem revisou e por quê, o JSON-LD não compensa a ausência. Pela documentação do Google, a propriedade author.name deve levar apenas o nome da pessoa, sem cargo nem "por", e o author.url deve apontar para uma página que identifique o autor.
Quando usar e quando não usar
Use quando o site publica conteúdo em que a competência de quem escreve importa para o leitor: tutoriais técnicos, análises, conteúdo de saúde ou finanças, guias com decisões de dinheiro.
Não use quando:
- o texto é institucional, sem autor individual (use Organization como autora, e não invente uma pessoa);
- ninguém revisou de verdade:
reviewedBysem revisão real é afirmação falsa; - o nome do autor não aparece visível na página, porque a marcação deve refletir o conteúdo exibido;
- o site já usa um plugin de SEO que gera Article e Person. Nesse caso, estenda a saída dele em vez de imprimir um segundo bloco, para não duplicar entidades.
Pré-requisitos
- WordPress com tema que chame
wp_head()(todo tema correto chama). - Acesso para criar um plugin próprio ou um mu-plugin; evite colar no
functions.phpde um tema que será trocado. - Uma página de perfil por autor (o arquivo de autor do WordPress,
/author/nome/, já serve) com biografia preenchida. - Nível: intermediário. Você precisa ler PHP e editar arquivos do servidor.
Passo a passo
- 01Preencha o perfil de cada autor em Usuários, Biografia e site. Esse é o texto e o link que o JSON-LD vai apontar.
- 02Registre dois campos de post para o revisor: nome e URL do perfil.
- 03Mostre, no template do artigo, uma linha visível: "Escrito por X. Revisado por Y."
- 04Imprima o JSON-LD com o código abaixo.
- 05Teste, publique e acompanhe os relatórios de dados estruturados no Search Console.
Passo 1 e 2: campos do revisor
Crie o arquivo wp-content/mu-plugins/schema-autor-revisor.php. Os campos são registrados com register_post_meta(), que expõe o dado ao editor de blocos:
<?php
/**
* Plugin Name: Schema de autor e revisor (receita)
*/
add_action( 'init', function () {
foreach ( array( 'revisor_nome', 'revisor_url' ) as $chave ) {
register_post_meta( 'post', $chave, array(
'type' => 'string',
'single' => true,
'show_in_rest' => true,
'sanitize_callback' => ( 'revisor_url' === $chave ) ? 'esc_url_raw' : 'sanitize_text_field',
'auth_callback' => function () {
return current_user_can( 'edit_posts' );
},
) );
}
} );
No editor, o painel "Campos personalizados" (ativável em Opções) permite preencher revisor_nome e revisor_url. Se preferir uma caixa própria, use add_meta_box(); a lógica de gravação é a mesma.
Passo 4: o JSON-LD
O Google documenta reviewedBy apenas no tipo WebPage do schema.org, cujo valor esperado é Person ou Organization. Por isso o grafo tem dois nós ligados por @id:
add_action( 'wp_head', function () {
if ( ! is_singular( 'post' ) ) {
return;
}
$post = get_queried_object();
$autor_id = (int) $post->post_author;
$url = get_permalink( $post );
$artigo = array(
'@type' => 'Article',
'@id' => $url . '#artigo',
'headline' => get_the_title( $post ),
'datePublished' => get_post_time( 'c', true, $post ),
'dateModified' => get_post_modified_time( 'c', true, $post ),
'author' => array(
'@type' => 'Person',
'name' => get_the_author_meta( 'display_name', $autor_id ),
'url' => get_author_posts_url( $autor_id ),
),
'mainEntityOfPage' => $url,
);
$pagina = array(
'@type' => 'WebPage',
'@id' => $url,
'url' => $url,
'mainEntity' => array( '@id' => $url . '#artigo' ),
);
$rev_nome = get_post_meta( $post->ID, 'revisor_nome', true );
$rev_url = get_post_meta( $post->ID, 'revisor_url', true );
if ( $rev_nome ) {
$revisor = array( '@type' => 'Person', 'name' => $rev_nome );
if ( $rev_url ) {
$revisor['url'] = $rev_url;
}
$pagina['reviewedBy'] = $revisor;
}
$grafo = array(
'@context' => 'https://schema.org',
'@graph' => array( $pagina, $artigo ),
);
echo '<script type="application/ld+json">' .
wp_json_encode( $grafo, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_HEX_TAG ) .
'</script>' . "\n";
}, 20 );
Pontos que importam no código:
get_post_time( 'c', true, $post )devolve a data em ISO 8601 no fuso UTC. O Google recomenda incluir fuso nas datas; sem ele, usa o fuso do Googlebot.JSON_HEX_TAGescapa<e>e impede que um título malicioso feche o blocoscript.- Mais de um autor: transforme
authorem lista, um objeto por pessoa visível na página. - Nenhuma chave, token ou segredo entra neste código.
Passo 3: a linha visível
No template do tema (single.php ou parte de bloco), imprima algo como:
<p class="creditos">
Escrito por <a href="<?php echo esc_url( get_author_posts_url( get_the_author_meta( 'ID' ) ) ); ?>"><?php the_author(); ?></a>.
<?php
$rev = get_post_meta( get_the_ID(), 'revisor_nome', true );
if ( $rev ) {
echo 'Revisado por ' . esc_html( $rev ) . '.';
}
?>
</p>
Como testar
Critério de sucesso: o Rich Results Test (ou o validador de marcação do schema.org) lê o Article sem erro, o autor aparece como Person com url, o revisor aparece em WebPage e os nomes coincidem com o texto visível.
- Abra o Rich Results Test, cole a URL de um post com revisor e rode.
- Veja "Artigo" detectado e confira os campos
authoredatePublished. - No validador do schema.org, cole a URL e confirme que
reviewedByfoi reconhecido em WebPage. - Abra o código-fonte (Ctrl+U) e procure por
application/ld+json: deve haver um só bloco de Article por página. Dois blocos indicam conflito com outro plugin. - Em produção, acompanhe o relatório de dados estruturados no Search Console por algumas semanas.
Erros comuns e como desfazer
| Erro | Efeito | Correção |
|---|---|---|
Cargo ou "por" dentro de author.name | dado sujo | deixe só o nome; cargo vai em jobTitle |
| Revisor marcado sem revisão real | afirmação falsa | remova o campo do post |
| Dois Article na mesma página | validadores reclamam, dados conflitantes | desligue a saída duplicada em um dos lados |
author.url apontando para a home | autoria sem identificação | use o arquivo do autor ou uma página de perfil |
| Data sem fuso | Google assume o fuso do Googlebot | use get_post_time( 'c', true ) |
Para desfazer tudo, apague o arquivo do mu-plugin. Os campos gravados ficam no banco sem efeito visível; se quiser limpá-los, rode wp post meta delete --all revisor_nome e o equivalente para revisor_url no WP-CLI.
Checklist final
- Perfil de cada autor tem biografia e URL pública.
- A página mostra autor e revisor em texto.
- O JSON-LD tem
authorcomo Person ereviewedByapenas em WebPage. - Datas em ISO 8601 com fuso.
- Um único bloco de Article por página.
- Rich Results Test sem erro; revisão registrada com data.
Para aprofundar
Quem quer treinar a marcação com exercícios guiados encontra o conteúdo no mini-curso Schemas com IA. A lógica de credibilidade de autor está no mini-curso E-E-A-T para redatores. Para dados locais de empresa, veja a receita de schema de SEO local. Definições de termos ficam no glossário do seogeo.site: JSON-LD e Person schema. O catálogo de plugins do autor está em camillodantas.com.br/plugins.
Fontes
- Article structured data, Google Search Central (2026-09-08)
- Profile page structured data, Google Search Central (2026-09-08)
- reviewedBy, schema.org (2026-10-14)
- register_post_meta(), WordPress Developer Resources (2026-10-14)
- wp_json_encode(), WordPress Developer Resources (2026-10-14)
Não sabe por onde começar?
Compare as opções e escolha a trilha pelo seu objetivo.