DF Glossary — Glosario SEO para PrestaShop 8 y 9

Presentación

DF Glossary convierte su vocabulario de sector en un activo SEO. Usted introduce sus términos una sola vez — con una definición corta y otra larga — y el módulo hace tres cosas automáticamente: inyecta un enlace con tooltip en cada aparición del término en sus descripciones de producto, categoría y páginas CMS; publica una página de definición indexable por término; y enlaza cada definición con los productos que usted le asocie.

El resultado es un enlazado interno bidireccional que se construye sin esfuerzo editorial: sus fichas refuerzan sus definiciones, sus definiciones refuerzan sus productos, y sus definiciones se refuerzan entre sí.

Instalación

Requisitos

• PrestaShop 8.0, 8.1, 8.2 o 9.x
• PHP 7.4 a 8.3
• MySQL 5.7 / MariaDB 10.3 o superior
• URLs amigables activadas (Parámetros de la tienda, Tráfico y SEO): imprescindible para las páginas del glosario

Procedimiento

1. En el back office, vaya a Módulos → Gestor de módulos → Subir un módulo.
2. Suba el archivo dfglossary-1.0.0.zip.
3. La instalación crea cuatro tablas SQL, una pestaña de back office y las claves de configuración por defecto.
4. Aparece una nueva pestaña Catálogo → Glosario SEO en el menú. Es donde gestiona sus términos.
5. Haga clic en Configurar desde el gestor de módulos para acceder a los ajustes globales.

Configuración del módulo

El panel de configuración se divide en tres secciones.

Activación y modo de inyección

• Activar la inyección — interruptor maestro. Desactivado, el módulo deja de enriquecer sus contenidos, pero las páginas del glosario siguen en línea e indexadas.
• Modo — tres valores posibles:
  • Enlace + tooltip (por defecto): el término se convierte en enlace hacia su página de definición y muestra el tooltip al pasar el ratón. Es el modo que combina beneficio SEO y beneficio de conversión.
  • Solo enlace: el término se convierte en enlace, sin tooltip. Elíjalo si solo busca el enlazado interno.
  • Solo tooltip: el término muestra la definición al pasar el ratón, sin convertirse en enlace. Elíjalo si quiere pedagogía sin añadir enlaces salientes a sus fichas.

Límites (salvaguardas anti sobreoptimización)

• Ocurrencias máximas por término — 1 por defecto. Aunque una palabra aparezca ocho veces en una descripción, solo la primera se convierte en enlace. Recomendamos encarecidamente mantener este valor: un solo enlace por concepto basta para transmitir la señal semántica, y los siguientes diluyen el PageRank interno sin aportar nada.
• Enlaces máximos por contenido — 10 por defecto, sumando todos los términos. Más allá, el motor se detiene, queden los términos que queden.

Contenidos afectados

Cuatro interruptores independientes determinan dónde se aplica la inyección:

• Descripciones de producto — la descripción larga.
• Incluir la descripción corta — opción aparte. Atención: la descripción corta suele mostrarse en la parte superior de la ficha y en los listados; colocar enlaces ahí puede resultar excesivo.
• Descripciones de categoría — descripción y descripción adicional.
• Páginas CMS y categorías CMS — contenido de las páginas CMS.

Base de URL

El campo Base de URL define el segmento bajo el cual se publican las páginas del glosario. Valor por defecto: glosario, lo que da /glosario para el índice y /glosario/lona-plastificada para una ficha de término. El campo se valida como reescritura de enlace: solo letras, cifras y guiones.

Gestionar los términos

Vaya a Catálogo → Glosario SEO. El listado muestra todos sus términos con su slug, su estado de autoenlazado y su estado de publicación. Puede buscar, ordenar, filtrar, activar o desactivar con un clic, y eliminar de forma masiva.

Crear un término

Haga clic en Añadir un término. El formulario es totalmente multiidioma: cada campo de texto se introduce idioma por idioma.

• Término — el texto exacto buscado en sus contenidos. La coincidencia es insensible a mayúsculas y respeta los límites de palabra.
• Slug — el identificador en la URL. Déjelo vacío para que se genere automáticamente a partir del nombre.
• Sinónimos — lista separada por comas. Plurales, abreviaturas y variantes ortográficas activan el mismo enlace y el mismo tooltip.
• Definición corta — es el texto del tooltip. Se recomienda texto plano. Se trunca a 180 caracteres en la burbuja, pero se muestra íntegra al inicio de la página de definición.
• Definición larga — editor enriquecido. Es el cuerpo de la página de definición, y el contenido que se posicionará en Google.
• Meta title / Meta description — opcionales. Si faltan, el módulo recurre automáticamente al nombre del término y a la definición corta.
• Productos asociados — lista de IDs de producto separados por comas. Sus miniaturas se mostrarán en la página del término.
• Autoenlazado — interruptor individual. Desactivado, el término conserva su página de definición indexada pero nunca se inyecta en los contenidos.
• Activo — desactivado, el término desaparece del glosario y su página devuelve un 404 limpio.

Buenas prácticas editoriales

• Apunte a 20-50 términos. El volumen no es la variable importante: un término merece su lugar si aparece realmente en sus descripciones y responde a una pregunta que se hacen sus clientes.
• Redacte definiciones largas de 150 a 400 palabras. Suficiente para constituir contenido autónomo a ojos de Google, lo bastante corto para producirlo rápido.
• Asocie de 2 a 6 productos por término, no más. Una página de definición que apunta a veinte productos diluye su autoridad.
• Cuide los sinónimos. Es la palanca que multiplica la cobertura: un catálogo redactado durante años por varias personas rara vez expresa un mismo concepto de una sola forma.
• No traduzca los sinónimos palabra por palabra. Cada idioma tiene sus propias variantes; introdúzcalas de forma independiente.

Cómo funciona la inyección

El enriquecimiento se realiza en el servidor, al renderizar la página, mediante los hooks de filtrado de contenido de PrestaShop. Sus descripciones nunca se modifican en la base de datos: si desactiva el módulo, sus contenidos recuperan de inmediato su estado original.

El motor de reemplazo

El contenido se divide en segmentos de etiqueta y segmentos de texto. Solo los segmentos de texto son candidatos al reemplazo. Estas zonas se ignoran sistemáticamente:

• enlaces existentes (ningún riesgo de crear un enlace anidado),
• títulos h1, h2 y h3,
• bloques script, style, code, pre, svg, noscript,
• campos de formulario: textarea, select, option, button,
• iframes.

En los segmentos permitidos, la búsqueda usa límites de palabra Unicode: es imposible transformar un fragmento situado dentro de una palabra o de un identificador. La coincidencia ignora las mayúsculas y tolera espacios múltiples o saltos de línea. Por último, cada enlace inyectado se sustituye temporalmente por un token único durante el procesado, de modo que un término nunca puede volver a enlazarse dentro de un enlace que el propio módulo acaba de crear.

Orden de prioridad de las variantes

Todas las variantes de un término (nombre principal y sinónimos) se fusionan y se ordenan por longitud decreciente. La expresión más larga gana siempre. En concreto, si lona plastificada de PVC y lona plastificada figuran ambas en sus sinónimos, será la primera la que se enlace cuando aparezca completa.

Las páginas del glosario

Página índice

Accesible en /glosario, lista todos los términos activos, agrupados por letra, con navegación alfabética y un extracto por término. Emite un JSON-LD de tipo DefinedTermSet.

Página de definición

Accesible en /glosario/{slug}, cada ficha incluye:

• un título H1 y la definición corta destacada,
• la definición larga en formato enriquecido, en la que los demás términos del glosario se enlazan a su vez automáticamente (el término actual queda excluido, sin autoenlace),
• las miniaturas de los productos asociados,
• una nube de términos relacionados,
• meta title y meta description dedicados, URL canónica, migas de pan,
• un JSON-LD de tipo DefinedTerm.

Si un slug no existe o el término está desactivado, la página devuelve un 404 limpio.

Multiidioma y multitienda

Todos los campos de texto del glosario son multiidioma: nombre, sinónimos, definiciones, slug, meta title y meta description pueden diferir en cada idioma. La búsqueda se realiza siempre en el idioma del contexto actual: una descripción en español nunca se enriquecerá con términos ingleses.

En multitienda, los términos se asocian a las tiendas mediante la tabla de asociación estándar de PrestaShop. Puede tener un glosario técnico denso en una tienda B2B y otro divulgativo en una tienda B2C, en la misma instalación.

Comportamiento en móvil

No hay hover en una pantalla táctil. El módulo carga un mini script que gestiona el toque: el primer toque sobre un término muestra el tooltip y bloquea la navegación, el segundo abre la página de definición. Los demás tooltips abiertos se cierran automáticamente, y un toque fuera del término cierra la burbuja.

Rendimiento

El diccionario de términos se carga una sola vez por petición y se guarda en caché estática: incluso una página de categoría con treinta productos genera una única consulta SQL para el glosario. El reemplazo en sí es una manipulación de cadenas en PHP, del orden del milisegundo. No se carga JavaScript bloqueante, no se hace ninguna llamada de red, y el resultado es totalmente compatible con la caché full-page.

Resolución de problemas

No aparece ningún enlace en mis fichas de producto

• Compruebe que el interruptor maestro Activar la inyección está en Sí.
• Compruebe que Descripciones de producto está activado en los contenidos afectados.
• Compruebe que el término está activo y que su autoenlazado está activado.
• Compruebe que el término está introducido en el idioma de la ficha consultada: un término creado solo en francés nunca se inyectará en una descripción en español.
• Vacíe la caché de PrestaShop (Parámetros avanzados → Rendimiento).

El término aparece en el texto pero no está enlazado

Tres causas posibles. O bien el término ya está dentro de un enlace, de un título h1-h3 o de una zona protegida: es el comportamiento previsto. O bien el límite de ocurrencias por término (1 por defecto) ya se ha alcanzado en ese contenido: las siguientes apariciones quedan como texto plano, es normal. O bien se ha alcanzado el límite global de 10 enlaces por contenido.

Las páginas del glosario devuelven un 404

• Compruebe que las URLs amigables están activadas.
• Regenere el archivo .htaccess (Parámetros de la tienda → Tráfico y SEO → Generar el archivo .htaccess).
• Compruebe que el término está activo y que su slug está relleno en el idioma consultado.

Los tooltips no se muestran

Compruebe que el modo no está ajustado a Solo enlace. Si el modo es correcto, vacíe la caché y compruebe que la hoja de estilos del módulo se carga correctamente (se añade automáticamente en todas las páginas del front).

Desinstalación

La desinstalación elimina las cuatro tablas SQL del módulo, la pestaña del back office y todas las claves de configuración. Sus términos se pierden definitivamente: expórtelos si piensa reinstalar más adelante. En cambio, ninguna descripción de producto, categoría o CMS ha sido modificada nunca en la base de datos: sus contenidos simplemente recuperan su estado original, sin limpieza que realizar.

Limitaciones conocidas

• La unicidad de los slugs no se fuerza por idioma. Si dos términos comparten el mismo slug en el mismo idioma, gana el primero encontrado. Revise sus slugs al introducirlos.
• Las zonas protegidas (enlaces, títulos h1-h3, código, formularios) nunca se enriquecen. Es una decisión de diseño, no una limitación que se pueda eludir.