Documentação - Validar o Plugin
1 - Desative plugins relacionados ao schema.org
Vá até Extensões → Plugins e desative qualquer plugin que trabalhe com schema.org (inclusive os nativos do Joomla).
Desabilite marcações em outras extensões
Se você usa ferramentas como 4SEO, Routa 66 ou similares, desative a opção de marcação de dados estruturados nessas extensões.
Verifique o template
Alguns templates oferecem recursos próprios de dados estruturados. Certifique-se de desativá-los também.
O PSA Schema precisa ser a única extensão responsável por gerar dados estruturados. Caso contrário, podem ocorrer conflitos que impedem o funcionamento correto e até causar problemas temporários no frontend do site.
2 - Instale o PSA Schema. Em seguida, vá até "Plugins", pesquise por "psa" e clique para abrir o plugin.
3 - Preencha com o serial recebido por e-mail, insira a URL cadastrada. na aba "Author", você pode inserir qualquer nome inicial para ativação.
Na aba "Author", você pode inserir qualquer nome inicial para ativação.
Após ativar, recomenda-se limpar o cache do Joomla. Se houver algum bloqueio, clique para desbloquear(Global Check-in).
Você só precisa configurar uma vez. Organization e Autor aparecerão automaticamente em todas as páginas do seu site.
O PSA Schema foi desenvolvido para automatizar os dados estruturados e ajudar os mecanismos de busca a entenderem melhor o conteúdo dos seus artigos.
Após a ativação, recomenda-se preencher os dados da Organization e, em seguida, os do Autor. Caso haja múltiplos autores, siga este tutorial.
Se o site representa um local físico, é recomendado preencher todos os campos. Em caso de dúvidas, siga os exemplos do schema.org e do Google, pois isso é muito importante para o SEO local.
Se não for um local físico, recomenda-se preencher apenas o básico e testar sempre no validador do schema.org e do Google. Caso apareçam erros não críticos, corrija e refaça o teste.
❗Aviso sobre privacidade: caso o site não represente um estabelecimento comercial com atendimento ao público, não é necessário informar um endereço físico.
A proteção de dados pessoais e a segurança do responsável pelo site devem ser priorizadas. Em situações em que o preenchimento do endereço for exigido por questões técnicas, recomenda-se utilizar um endereço genérico, como uma via pública com numeração aleatória, sem vínculo direto com a localização real do responsável.❗
Schema.org vs Google
Valide primeiro em schema.org para checar a estrutura, depois no Google Rich Results para ver o que pode gerar destaque na busca.
O Google às vezes exibe erros não críticos mesmo com tudo certo no schema.org. Pode causar dúvida, mas lembre: o Google interpreta o schema.org, não o contrário — ele pode exigir mais do que o padrão.
O PSA Schema foi desenvolvido para funcionar com ambos. Basta adicionar o schema correto que ele cuida do resto.
Exemplo para um site que não representa um local físico (sem LocalBusiness), como o vitapotentia.com:
O endereço utilizado é fictício. A latitude e a longitude foram obtidas pelo Google Maps, apenas para garantir um preenchimento técnico correto.
No plugin, na opção Redes Sociais, preencha os links separados por vírgula, exatamente assim:
https://www.facebook.com/vitapotentia,https://www.youtube.com/@vitapotentia
Isso será convertido automaticamente para o formato abaixo:
"sameAs": [
"https://www.facebook.com/vitapotentia",
"https://www.youtube.com/@vitapotentia"
]
Você pode adicionar quantas redes sociais quiser — basta separar cada uma com uma vírgula, e o código será gerado corretamente.
Se você preencher algum campo incorretamente, é só editar e salvar novamente.
Na parte de Autor único, os campos são semelhantes aos da Organization. No entanto, não é necessário preencher todos — para a maioria dos sites, isso pode soar como excesso de informação (quase um spam). Preencha apenas o que realmente for relevante sobre o autor.
Dependendo do tipo de site, use o SEO de forma estratégica, com a ajuda de IAs como o ChatGPT e outras.
Se o objetivo for ranqueamento, é fundamental entender o conceito de E-E-A-T, que significa: Experience, Expertise, Authoritativeness e Trustworthiness.
Sobre o campo Autor:
Se o site tiver apenas um autor, todas as páginas exibirão automaticamente os dados que você inserir no plugin.
Agora, se o site tiver múltiplos autores, o PSA Schema funciona a partir do HTML de cada autor dentro do artigo.
A forma mais prática de lidar com isso é criando um módulo HTML personalizado para cada autor e inserindo manualmente dentro do artigo.
⚠️ Importante:
O módulo do autor deve ser inserido diretamente no artigo. Inserir por categoria, por posição do template ou em outro lugar não funciona — o schema não será aplicado corretamente.
Se o site tiver milhares de artigos, cabe a cada equipe editorial avaliar se esse processo manual é viável. O plugin não oferece suporte para essa automação.
Uma possível solução seria desenvolver um script (como um Python) que insere autores por categoria, mas isso é algo externo ao PSA Schema.
Por fim, vale lembrar: o plugin foi inicialmente desenvolvido para sites com apenas um autor, por isso, não há suporte nativo para automatização em múltiplos autores.
Escolha:
Na aba Generator, clique no botão para acessar os geradores de schemas e selecione Author.
Esse gerador contém todos os campos disponíveis também no modo Autor único — e você só precisa configurá-lo uma única vez.
Preencha corretamente, observando algo importante:
Imagem do Autor (URL) e URL do Autor:
Não insira a URL completa do site.
Para imagens, se o caminho for https://site.com/images/suaimagem.webp, insira apenas:
/images/suaimagem.webp
Para a página do autor, se o endereço for https://site.com/authors/joao-pedro/, insira apenas:
/authors/joao-pedro/
O PHP completa automaticamente com o domínio do site. Assim, se você mudar a URL base no futuro, os caminhos continuarão funcionando corretamente.
❗Atenção❗
Respeite o padrão da URL canônica do seu site:
Se a canônica tem barra no final, mantenha a barra (ex: /autores/joao-pedro/)
Se não tem barra, não adicione (ex: /autores/joao-pedro)
Isso evita problemas de indexação ou conteúdo duplicado.
Preencher o que precisa
Após preenchido, clique no botão Gerar Schema
Copiar
É necessário primeiro deixar como no Default Editor em nenhum(para não ter erro).
Cole no módulo HTML
Coloque conforme achar melhor o nome do módulo, nesse exemplo eu coloquei "Author jp" e Salvar.
No artigo, clique no ícone do Joomla e selecione Módulo.
Coloque o nome do módulo, pesquise e insira na página.
Está praticamente pronto. Salve o artigo, limpe o cache e, se necessário, desbloqueie.
Acesse a página, verifique o código-fonte ou, se estiver usando o SEO Bisbi, confira se o campo "author" foi inserido corretamente.
"author": {
"@type": "Person",
"name": "João Pedro",
"image": {
"@type": "ImageObject",
"url": "https://joomla4.vitapotentia.com/images/suaimagem.webp"
},
"jobTitle": "Joomleiro",
"sameAs": [
"https://www.facebook.com/vitapotentia",
"https://www.youtube.com/@vitapotentia"
],
"description": "Exemplo para criar um autor",
"email": "
"knowsAbout": [
"Joomla",
"CMS",
"PHP"
]
},
Cada um tem sua maneira de lidar com módulos. No caso de múltiplos autores, cada autor deverá inserir seu próprio módulo no artigo — seja da forma que foi mostrada ou colando diretamente o código do módulo nas páginas.
No meu caso, em sites com vários autores, prefiro apenas anotar o ID do módulo e colar no artigo. Por exemplo, no subdomínio de testes foi gerado o seguinte código:
Mas fique à vontade para usar o método que preferir.
Página de exemplo com múltiplos autores (ver código html)
Concluindo:
Seguindo esses passos, você ativará o plugin e configurará corretamente os dados de Organization e Autor.
Apenas em sites com mais de um autor será necessário inserir o módulo do autor manualmente. A geração dos schemas ocorrerá em todas as páginas do tipo Article ou BlogPosting.
Para evitar erros, leia toda a documentação.
Títulos, descrições dos artigos, imagem principal, uso correto das tags h2 e h3, palavras-chave (keywords) e a URL canônica foram cuidadosamente estudados e testados para que usuários do Joomla obtenham melhores classificações nos mecanismos de busca como Google, Bing e outros que priorizam o uso de schemas.
Transformando páginas em dados estruturados
Português (Brasil) 
English (United States)