a21glossary para TYPO3

Quien necesita un glosario suele tener un problema de SEO

Explicar términos especializados en un sitio web parece un servicio al usuario. En realidad, a21glossary resuelve un problema técnico concreto: las páginas TYPO3 con contenido que requiere explicaciones posicionan mejor cuando los términos están enlazados internamente, son indexables como páginas propias y accesibles mediante tooltip. La extensión genera enlaces automáticos en el contenido a partir de una base de datos central de términos, sin que los redactores tengan que colocar cada enlace manualmente.

Para empresas con portales especializados, plataformas de conocimiento o productos que requieren explicación, a21glossary crea exactamente la estructura de enlazado interno que Google valora como autoridad temática. En lugar de ocultar 50 términos en una FAQ, se generan 50 páginas independientes e indexables con potencial de Schema Markup.

Escenarios de uso habituales

Portales especializados con más de 100 términos. Asociaciones sectoriales, universidades y editoriales especializadas mantienen glosarios con cientos de entradas. a21glossary enlaza cada término automáticamente en su primera mención en el texto corrido. En un cliente con 340 entradas de glosario, la densidad de enlazado interno aumentó un 28%, medible a través de Google Search Console.

Páginas de producto con vocabulario técnico. Fabricantes de maquinaria, empresas químicas y fabricantes de tecnología médica utilizan terminología que los compradores y responsables de decisión no siempre conocen. Un tooltip con 2-3 frases de explicación mantiene al lector en la página en lugar de enviarlo a Google. El tiempo de permanencia sube, la tasa de rebote baja.

Plataformas de conocimiento multilingües. En combinación con la gestión de idiomas de TYPO3, se pueden mantener glosarios por idioma. Los términos en alemán enlazan a explicaciones en alemán, los ingleses a explicaciones en inglés. Esto funciona correctamente siempre que la configuración de idiomas en TYPO3 esté bien configurada.

Arquitectura técnica

a21glossary funciona como post-procesador de contenido. Después del renderizado de una página TYPO3, la extensión busca en la salida HTML los términos definidos y los sustituye por variantes enlazadas. Los propios términos se almacenan en una tabla de base de datos propia y se gestionan mediante un módulo de backend.

La extensión se registra a través de un Hook Content Object Post User Func en el proceso de renderizado TypoScript. Esto significa que interviene solo después de que TYPO3 haya renderizado completamente el contenido. Por eso funciona independientemente del tipo de elemento de contenido utilizado, ya sea Textmedia, News o Custom Content Elements.

La presentación del tooltip se realiza mediante un pequeño snippet de JavaScript y CSS. Ambos son personalizables. En configuraciones modernas de TYPO3, se recomienda sustituir el JavaScript estándar por una solución solo CSS para no perjudicar los Core Web Vitals. Con el atributo title y un selector :hover se pueden crear tooltips sencillos sin una sola línea de JavaScript.

Las propias entradas del glosario son configurables mediante TypoScript: qué páginas deben ser analizadas, cuántas veces puede enlazarse un término por página (recomendado: una vez) y qué áreas HTML están excluidas (navegación, footer, otras entradas del glosario).

Problemas frecuentes y soluciones

Caída de rendimiento con glosarios grandes. A partir de aproximadamente 500 términos, el paso de post-procesamiento puede hacerse perceptible, especialmente en páginas con mucho texto. La solución: activar la caché. La caché de páginas de TYPO3 almacena el resultado tras el primer renderizado. Solo al vaciar la caché se vuelve a procesar. Además, ayuda reducir la lista de términos al vocabulario realmente utilizado. 200 términos precisos superan a 800 incluyendo variantes.

Enlaces incorrectos en encabezados y enlaces. a21glossary enlaza por defecto en todas partes, también dentro de etiquetas H2 o hiperenlaces existentes. Esto produce enlaces anidados que son HTML inválido. A través de la configuración TypoScript se pueden excluir etiquetas: excludeTags = h1,h2,h3,a,script. Esta configuración es imprescindible en toda instalación inicial.

Conflictos con RealURL y Routing. En versiones antiguas de TYPO3 (anteriores a v9) surgían problemas cuando las páginas de detalle del glosario se enrutaban a través de RealURL. Con TYPO3 v10+ y el Site Routing nativo, este problema ya no existe. Quien aún use RealURL debería migrar de todos modos.

Migración y compatibilidad de versiones

a21glossary fue desarrollada originalmente para TYPO3 v4.x y se ha actualizado a lo largo de los años. La última versión mantenida activamente en el TER soporta TYPO3 v10 y v11. Para TYPO3 v12 existe un fork comunitario en GitHub que porta la extensión a la nueva estructura TCA y al sistema de Hooks modificado. Para TYPO3 v13 no hay versión oficial disponible en este momento.

La migración de v11 a v12 requiere tres ajustes: primero, el cambio de $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS'] al nuevo sistema Event Dispatcher; segundo, la actualización de las definiciones TCA (configuración de Wizards); y tercero, la adaptación del setup TypoScript a la nueva Site Configuration.

Quien planifique TYPO3 v13 se enfrenta a una decisión: continuar desarrollando el fork comunitario o migrar a una solución alternativa. Como alternativa se ofrece implementar la funcionalidad de glosario directamente como Custom Content Element con DataProcessor. El esfuerzo es de aproximadamente 2-3 días de desarrollo, el resultado es seguro para el futuro e independiente del mantenimiento de terceros. Gosign ha realizado esta migración en varios proyectos y puede estimar de forma realista el esfuerzo real basándose en un análisis de los datos de glosario existentes.