módulo de botão "Contate um especialista"

11/09/2026
v2.1.0

Revisão completa do módulo com foco em dados estruturados, que é a razão de ser da parte EEAT e foi concluída apenas parcialmente.

Dados estruturados (reescritos)

• Agora, todo o JSON-LD é gerado em PHP ( classes/RkrSchema.php ) e aparece como um único @graph por página, em vez de ser escrito manualmente em cada modelo.
• Identidade estável com @id . A mesma pessoa na página da equipe, em seu perfil e na assinatura agora é uma única entidade para o Google. Anteriormente, eram três Person diferentes sem identificadores, e nenhuma delas acumulava o sinal das outras.
• A Organization anônima em todas as páginas foi removida. A barra lateral costumava exibir uma Organization sem name ou url em todos os URLs da loja, o que entrava em conflito com o tema. Agora, ela exibe a lista completa da loja, com o @id compartilhado, e somente onde é necessário: nova opção " Onde exibir a lista da loja " (página inicial e contato por padrão).
• knowsAbout : As especialidades, que foram solicitadas nos bastidores e apenas descritas como etiquetas, são publicadas como parte da experiência.
• worksFor : cada especialista está vinculado à loja.
• hoursAvailable : os horários de funcionamento já armazenados pelo módulo são publicados como OpeningHoursSpecification dentro do ContactPoint .
• Perfil de especialista como ProfilePage com mainEntity → Person , que é o formato documentado pelo Google para páginas de perfil.
• BreadcrumbList na página da equipe e nos cartões, com trilhas de navegação reais (Início › Equipe › Especialista).
• Correção em hasCredential : o número de membro deve ser inserido no identifier com credentialCategory: license , em vez de um nome com uma categoria inventada. As certificações são separadas por vírgulas e cada uma delas é uma credencial.
• alumniOf não converte mais a frase completa da formação acadêmica do ex-aluno no nome da universidade. Digite Título | Institución para declará-la; sem a barra, apenas o título será exibido.
• Os valores de texto são limpos de tags e entidades HTML antes da serialização, e o JSON é escapado com JSON_HEX_TAG para que uma biografia com um Não é possível rasgar a página.
• Os microdados ( itemscope / itemprop ) foram removidos do registro do especialista: eles descreviam a mesma pessoa que o JSON-LD, porém com menos propriedades.

SEO

• As páginas da equipe e dos especialistas são adicionadas ao mapa do site ( gSitemapAppendUrls ).
• URL canônica em ambas as páginas.
• Correção hreflang : cada idioma usa seu próprio slug, em vez de repetir o slug do idioma atual apontando para uma entrada inexistente.
• Um especialista inexistente ou desativado retorna um erro 404 real na sua URL, em vez de um redirecionamento 302 para a página de erro.
• Os links de rede do especialista usam rel="me" em vez de nofollow : eles são a prova de identidade que suporta sameAs .

Segurança

• Envio de imagens. Os três formulários de envio de avatar costumavam obter a extensão do arquivo do navegador e movê-lo para views/img/ , que é servido via web. Agora, a extensão, o tipo de imagem e o tamanho (4 MB) são validados; o nome do arquivo é gerado pelo módulo e arquivos SVG com conteúdo executável são rejeitados.
• As cores de configuração são validadas em hexadecimal ao serem salvas e renderizadas; anteriormente, elas eram inseridas diretamente em um rótulo..
• Escapou das variáveis que estavam faltando nos modelos frontais.
• Os nomes dos arquivos lidos do banco de dados são verificados antes de se construir uma URL com eles.

Corrigido

• Turnos divididos e horários que se estendem além da meia-noite. 09:00 - 14:00, 16:00 - 20:00 reconheciam apenas a primeira parte, e 22:00 - 02:00 era sempre marcado como fechado. A lógica agora reside em classes/RkrSchedule.php e é compartilhada pelo ponto verde e pelo JSON-LD.
• Slugs duplicados. Dois especialistas com o mesmo nome estavam compartilhando um slug, tornando o segundo token inacessível. Agora eles estão numerados e a atualização corrige quaisquer duplicatas.
• Duas posições simultaneamente. Com o bloco ativo na aba e no rodapé, a segunda dica de ferramenta não funcionava: os id se repetiam.
• A desinstalação excluiu 46 das 74 chaves de configuração; as chaves referentes às páginas da equipe e dos especialistas, ao botão extra e ao agendamento sobreviveram e reapareceram após a reinstalação.
• A desinstalação já não exclui as imagens carregadas : o PrestaShop desinstala e reinstala para redefinir um módulo, o que esvazia as páginas de produtos sem aviso prévio.
• O esquema não é mais alterado por getContent() . As colunas são criadas em upgrade/ upgrade-2.1.0.php e upgrade-2.0.2.php é idempotente.
• Duplicar um departamento com idiomas não traduzidos não gera mais avisos do PHP 8.
• Os dados de demonstração baixam avatares com um tempo limite de 5 segundos: em uma loja sem acesso à internet, o painel congelaria por um minuto por especialista.

Desempenho

• O produto, a categoria e o departamento na página são resolvidos uma vez por solicitação. Todos os três hooks estavam carregando repetidamente as mesmas consultas Product e Departamento.
• As instruções SELECT e. , el. para especialistas agora listam suas colunas.
• Novo índice em (slug, id_lang) , a coluna através da qual cada solicitação a um registro de especialista entra.
• O CSS da legenda foi movido para views/css/eeat.css : ele estava em uma tagdentro do gancho e foi repetido para cada assinatura pintada.

Adicionado

• Aba SEO e dados estruturados nas configurações.
• Campo de ordem em cada especialista, para corrigir a ordem da página da equipe.
• Opção para ocultar o widget durante o processo de pagamento (ativada por padrão).
• config.xml , LICENSE.md , README.md e index.php estão presentes em todas as pastas: o módulo passa na auditoria de publicação sem falhas.

Declive conhecido

• O módulo não inclui catálogos de tradução e suas strings de origem estão em espanhol: em uma loja em outro idioma, o painel e a interface são exibidos em espanhol.
• Não é multi-loja: as tabelas não possuem id_shop e a configuração é lida sem o contexto da loja.