receita

Receita: schema de autor e revisor

Marque em JSON-LD quem escreveu e quem revisou cada artigo, usando só funções oficiais do WordPress.

resposta curtaPara marcar autor e revisor em WordPress sem plugin, grave o revisor em campos personalizados do post, monte um grafo JSON-LD com Article (autor como Person) e WebPage (propriedade reviewedBy) e imprima no wp_head com wp_json_encode. Valide no Rich Results Test e confira se o nome marcado aparece visível na página.
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: reviewedBy sem 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.php de 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

  1. 01Preencha o perfil de cada autor em Usuários, Biografia e site. Esse é o texto e o link que o JSON-LD vai apontar.
  2. 02Registre dois campos de post para o revisor: nome e URL do perfil.
  3. 03Mostre, no template do artigo, uma linha visível: "Escrito por X. Revisado por Y."
  4. 04Imprima o JSON-LD com o código abaixo.
  5. 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_TAG escapa < e > e impede que um título malicioso feche o bloco script.
  • Mais de um autor: transforme author em 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.

  1. Abra o Rich Results Test, cole a URL de um post com revisor e rode.
  2. Veja "Artigo" detectado e confira os campos author e datePublished.
  3. No validador do schema.org, cole a URL e confirme que reviewedBy foi reconhecido em WebPage.
  4. 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.
  5. Em produção, acompanhe o relatório de dados estruturados no Search Console por algumas semanas.

Erros comuns e como desfazer

ErroEfeitoCorreção
Cargo ou "por" dentro de author.namedado sujodeixe só o nome; cargo vai em jobTitle
Revisor marcado sem revisão realafirmação falsaremova o campo do post
Dois Article na mesma páginavalidadores reclamam, dados conflitantesdesligue a saída duplicada em um dos lados
author.url apontando para a homeautoria sem identificaçãouse o arquivo do autor ou uma página de perfil
Data sem fusoGoogle assume o fuso do Googlebotuse 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 author como Person e reviewedBy apenas 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

  1. Article structured data, Google Search Central (2026-09-08)
  2. Profile page structured data, Google Search Central (2026-09-08)
  3. reviewedBy, schema.org (2026-10-14)
  4. register_post_meta(), WordPress Developer Resources (2026-10-14)
  5. 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.