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 todas sus apariciones 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 como registros en el módulo Lista.

Desde la versión 12.0.0 la extensión se engancha a la salida de la página mediante el evento PSR-14 AfterCacheableContentIsGeneratedEvent; hasta la versión 11, mediante el hook contentPostProc-all. 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 la asume el navegador: a21glossary escribe la explicación como atributo title en etiquetas abbr, acronym o dfn y no incluye JavaScript. Quien quiera dar estilo al tooltip debería recurrir a 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, qué tipos de término se enlazan 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 dentro de enlaces existentes. a21glossary enlaza por defecto también dentro de hiperenlaces existentes; los encabezados h1 a h6 ya vienen excluidos de serie. Esto produce enlaces anidados que son HTML inválido. A través de la configuración TypoScript se puede ampliar la lista estándar con la etiqueta a: excludeTags = acronym,abbr,dfn,h1,h2,h3,h4,h5,h6,input,pre,script,a. 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 3.x y se ha actualizado a lo largo de los años. Sven Wappler (WapplerSystems) mantiene la extensión desde 2017; para TYPO3 v12 el TER ofrece su versión 12.0.1, que porta la extensión a la nueva estructura TCA y al sistema de Hooks modificado. Para TYPO3 v13 existe la versión 13.0.0 vía Composer (Packagist); en el TER todavía no está.

Para el paso de v11 a v12, WapplerSystems adaptó la propia extensión en la versión 12.0.0: primero, el cambio de $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS'] al nuevo sistema Event Dispatcher; segundo, la actualización de las definiciones TCA. El setup TypoScript no cambió; los usuarios solo actualizan la extensión.

Quien planifique TYPO3 v13 se enfrenta a una decisión: instalar a21glossary 13.0.0 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.