Módulo botón contacta con un experto

v2.1.02026/09/11

Revisión completa del módulo con el foco puesto en los datos estructurados, que son la razón de ser de la parte E-E-A-T y estaban a medias.

Datos estructurados (reescritos)

• Todo el JSON-LD se genera ahora en PHP (classes/RkrSchema.php) y sale como un único @graph por página, en vez de escribirse a mano en cada plantilla.
• Identidad estable con @id. La misma persona en la página de equipo, en su ficha y en un byline es ahora una sola entidad para Google. Antes eran tres Person distintas sin identificador, y ninguna acumulaba la señal de las otras.
• Se acabó la Organization anónima en cada página. El sidebar declaraba un Organization sin name ni url en todas las URLs de la tienda, que competía con la del tema. Ahora emite la ficha completa de la tienda, con el @id compartido, y solo donde toca: nueva opción Dónde declarar la ficha de la tienda (portada y contacto por defecto).
• knowsAbout: las especialidades, que se pedían en el back-office y solo se pintaban como etiquetas, se publican como la propiedad de experiencia.
• worksFor: cada experto queda enlazado con la tienda.
• hoursAvailable: el horario de atención que ya guardaba el módulo se publica como OpeningHoursSpecification dentro del ContactPoint.
• Ficha de experto como ProfilePage con mainEntity → Person, que es la forma documentada por Google para las páginas de perfil.
• BreadcrumbList en la página de equipo y en las fichas, con miga de pan real (Inicio › Equipo › Experto).
• hasCredential corregido: el número de colegiado va en identifier con credentialCategory: license, en lugar de un nombre con una categoría inventada. Las certificaciones se separan por comas y cada una es una credencial.
• alumniOf ya no convierte la frase entera de formación en el nombre de una universidad. Escribe Título | Institución para declararla; sin la barra, solo se publica el título.
• Los valores de texto se limpian de etiquetas y entidades HTML antes de serializarse, y el JSON se escapa con JSON_HEX_TAG para que una biografía con un </script> no pueda romper la página.
• Se han quitado los microdatos (itemscope / itemprop) de la ficha de experto: describían a la misma persona que el JSON-LD, con menos propiedades.

SEO

• Las páginas de equipo y de experto se añaden al sitemap (gSitemapAppendUrls).
• URL canónica en ambas páginas.
• hreflang correcto: cada idioma usa su propio slug, en vez de repetir el del idioma actual apuntando a una ficha inexistente.
• Un experto inexistente o desactivado devuelve un 404 real en su URL, en lugar de una redirección 302 a la página de error.
• Los enlaces a redes del experto llevan rel="me" en vez de nofollow: son la prueba de identidad que respalda el sameAs.

Seguridad

• Subida de imágenes. Los tres formularios que suben avatares tomaban la extensión del nombre enviado por el navegador y movían el fichero a views/img/, que se sirve por web. Ahora se valida extensión, tipo real de imagen y tamaño (4 MB), el nombre lo genera el módulo y los SVG con contenido ejecutable se rechazan.
• Los colores de la configuración se validan como hexadecimal al guardarlos y al pintarlos; antes se inyectaban tal cual dentro de una etiqueta <style>.
• Escapado de las variables que faltaban en las plantillas del front.
• Los nombres de fichero leídos de base de datos se comprueban antes de construir una URL con ellos.

Corregido

• Turnos partidos y horarios que cruzan la medianoche. 09:00 - 14:00, 16:00 - 20:00 solo reconocía el primer tramo y 22:00 - 02:00 daba cerrado siempre. La lógica vive ahora en classes/RkrSchedule.php y la comparten el punto verde y el JSON-LD.
• Slugs duplicados. Dos expertos con el mismo nombre compartían slug y la segunda ficha era inalcanzable. Ahora se numeran, y la actualización arregla los que ya estuvieran duplicados.
• Dos posiciones a la vez. Con el bloque activo en la ficha y en el pie, el segundo tooltip no funcionaba: los id estaban repetidos.
• La desinstalación borraba 46 de las 74 claves de configuración; las de las páginas de equipo y experto, el botón extra y el horario sobrevivían y reaparecían al reinstalar.
• La desinstalación ya no borra las imágenes subidas: PrestaShop desinstala e instala para resetear un módulo, y eso vaciaba las fichas sin avisar.
• El esquema ya no se altera desde getContent(). Las columnas se crean en upgrade/upgrade-2.1.0.php, y upgrade-2.0.2.php es idempotente.
• Duplicar un departamento con idiomas sin traducir ya no lanza avisos de PHP 8.
• Los datos de demostración descargan los avatares con timeout de 5 s: en una tienda sin salida a internet el panel se quedaba colgado un minuto por experto.

Rendimiento

• El producto, la categoría y el departamento de la página se resuelven una vez por petición. Los tres hooks repetían la misma carga de Product y la misma consulta de departamento.
• Los SELECT e., el. de los listados de expertos enumeran ahora sus columnas.
• Nuevo índice sobre (slug, id_lang), la columna por la que entra cada petición a una ficha de experto.
• El CSS del byline se ha movido a views/css/eeat.css: estaba en una etiqueta <style> dentro del hook y se repetía por cada firma pintada.

Añadido

• Pestaña SEO y datos estructurados en la configuración.
• Campo Orden en cada experto, para curar el orden de la página de equipo.
• Opción para ocultar el widget durante el proceso de pago (activada por defecto).
• config.xml, LICENSE.md, README.md e index.php en todas las carpetas: el módulo pasa la auditoría de publicación sin fallos.

Pendiente conocido

• El módulo no trae catálogos de traducción y sus cadenas fuente están en español: en una tienda en otro idioma el panel y el front se ven en español.
• No es multitienda: las tablas no llevan id_shop y la configuración se lee sin contexto de tienda.