Libration Accessibility

El manual del plugin de accesibilidad: desde la instalación y la personalización del widget hasta los informes de auditoría, la declaración y las herramientas de IA. Encontrarás todos los ajustes en WordPress, en Ajustes → Accesibilidad.

Instalación

Selecciona el ZIP del plugin en el backend de WordPress, en Plugins → Añadir nuevo → Subir plugin, e instálalo — o sube la carpeta libration-accessibility a /wp-content/plugins/.
Activa el plugin en la lista de plugins. Allí encontrarás también el enlace directo Ajustes.
Listo — el widget de accesibilidad aparece de inmediato abajo a la derecha en tu web. Todas las correcciones básicas (skip links, indicador de foco, landmarks ARIA) están activas de fábrica.

Las actualizaciones llegan directamente por el sistema de actualizaciones de WordPress — las versiones Pro a través del servidor de actualizaciones de Libration; la versión gratuita, hasta su publicación en wordpress.org, la descargas aquí: libration-accessibility.zip.

Activar la licencia Pro

Encontrarás tu clave de licencia en el correo del pedido y en el área de clientes.

Abre Ajustes → Accesibilidad → Licencia.
Introduce la clave (formato LIB-XXXX-XXXX-XXXX) y haz clic en Activar.
Se muestra el plan (Pro, Pro AI o Agency) y se desbloquean todas las funciones incluidas — una sola clave para todo, también las funciones de IA.

Las licencias Agency se pueden activar en hasta 25 sitios web; la pestaña Licencia y el área de clientes muestran el resumen de los sitios ocupados. Con «Desvincular la licencia de este sitio» liberas de nuevo una plaza — práctico al trasladar proyectos de clientes.

El widget ofrece a los visitantes diez modos de visualización y cuatro controles deslizantes — todos los ajustes se guardan 30 días en el navegador del visitante (sin rastreo, sin transmisión al servidor):

Modos de visualización	Invertir colores · Monocromo · Contraste oscuro · Contraste claro · Saturación baja · Saturación alta · Resaltar enlaces · Resaltar encabezados · Lector de pantalla (lectura por clic/selección) · Modo lectura
Controles	Escalado del contenido · Tamaño de letra · Altura de línea · Espaciado de caracteres (cada uno 80–200 %)
Idiomas	La interfaz sigue el idioma de la web — se incluyen 29 idiomas europeos

En la pestaña Widget puedes desactivar grupos de funciones por separado (p. ej. escala de grises, modos de contraste, controles de texto, subrayado de enlaces) si quieres mantener el panel más ligero.

Todo en la pestaña Widget → Botón flotante:

Posición	Cuatro esquinas: abajo a la derecha (por defecto), abajo a la izquierda, arriba a la derecha, arriba a la izquierda
Margen	8–80 px de distancia al borde de la página
Tamaño	S (48 px) · M (56 px) · L (64 px)
Icono	Persona (por defecto) · Usuario en silla de ruedas · Controles deslizantes — o una imagen propia de la biblioteca de medios (PNG/SVG, se recomienda formato cuadrado)

También puedes desactivar el botón por completo y colocar el panel tú mismo en su lugar — consulta Integración.

Color de acento	Da color al botón, a las casillas activas y a los deslizadores. Con el selector de color (paleta, HEX, RGB) — o como variable CSS, véase más abajo.
Redondeo del panel	Radio de las esquinas del panel, 4–40 px
Tema del panel	Claro (blanco) · Oscuro (antracita) · Variables propias (acoplamiento al diseño)
Marca	Enlace «powered by Libration» en el pie del panel — desactivable desde Pro, white label desde Agency

Acoplamiento al diseño con variables CSS

Para desarrolladores: en lugar de colores fijos, puedes acoplar el widget a las custom properties CSS de tu tema. Así seguirá automáticamente cualquier cambio de diseño — incluido el modo oscuro.

Color de acento

En el campo de color de acento, en lugar de un valor hex, introduce simplemente la variable:

var(--primary)   o abreviado:   --primary

Fondo del panel y color del texto

Pon el tema del panel en Variables propias e introduce los nombres de variable que define tu tema, p. ej.:

:root { --site-bg: #ffffff; --site-text: #1d1d1f; }
@media (prefers-color-scheme: dark) {
  :root { --site-bg: #1c1b22; --site-text: #f4f4f5; }
}

El widget adopta background: var(--site-bg) y color: var(--site-text) y deriva automáticamente todos los colores secundarios (fondos de las casillas, separadores, bordes) mediante color-mix(). Si la web cambia a oscuro por media query o por clase, el widget la sigue sin configuración adicional.

Los fallbacks están integrados: si una variable no está definida en la página, el widget usa blanco/antracita.

Bloque de Gutenberg

Busca en el editor de bloques «Panel de accesibilidad» (categoría Widgets). El bloque renderiza el mismo panel que el botón flotante — ideal para el footer, popups o una página propia de «Accesibilidad». En la barra lateral del bloque configuras el título, la visibilidad del título y el botón de restablecer.

Shortcode

El panel en cualquier lugar — también en archivos del tema mediante do_shortcode():

[libration_accessibility]

[libration_accessibility title="Ayuda para la navegación" show_title="1" show_reset="0"]

Atributo	Valores	Significado
`title`	Texto	Título del panel (por defecto: «Accesibilidad»)
`show_title`	`1` / `0`	Mostrar el título
`show_reset`	`1` / `0`	Mostrar el botón de restablecer

Elementor

Si Elementor está activo, el widget «Libration Accessibility – Accesibilidad» aparece automáticamente en el panel de Elementor (categoría General, palabras de búsqueda «accessibility», «accesibilidad»). Colócalo con arrastrar y soltar; el título, la visibilidad del título y el botón de restablecer se configuran directamente en las opciones del widget.

WPBakery

Si WPBakery (Visual Composer) está activo, encontrarás el elemento «Libration Accessibility – Accesibilidad» en el catálogo de elementos, en Contenido — con las mismas tres opciones que el bloque y el shortcode.

Declaración de accesibilidad Pro

La pestaña Declaración genera una declaración de accesibilidad lista según el EAA (BFSG) como página de WordPress:

Introduce la organización, el correo de contacto y, opcionalmente, el teléfono.
Elige el estado de conformidad — parcialmente conforme es el estado habitual y honesto.
Añade las limitaciones conocidas (p. ej. «Los documentos PDF antiguos todavía no son accesibles»).
Elige el idioma — están disponibles los 29 idiomas del plugin (alemán e inglés con revisión editorial; los demás irán llegando).
Crear página — la declaración aparece como página publicada; si haces cambios, guarda de nuevo y la página se actualiza.

Enlaza la declaración en el footer de tu web — es lo que esperan los usuarios y la vigilancia del mercado. La declaración no sustituye el asesoramiento jurídico.

Informe de auditoría y PDF

La pestaña Informe de auditoría reúne tres herramientas:

Resumen — estadística de imágenes sin texto alternativo, progreso de la lista de verificación y estado general. Aquí también inicias el informe de auditoría en PDF Pro: una documentación justificativa optimizada para impresión (resumen, medidas activas, lista de verificación completa, lista de imágenes) que guardas como PDF desde el diálogo de impresión.
Análisis de imágenes — lista detallada de todas las imágenes sin texto alternativo, con vista previa, ubicaciones y enlace directo para editarlas. Free muestra las primeras 50 imágenes; Pro analiza sin límite y exporta como CSV.
Lista de verificación EAA — 27 criterios según WCAG 2.1 AA en cinco categorías, con barra de progreso y función de guardado. La autoevaluación se incorpora al informe PDF.

Funciones de IA Pro AI

Las funciones de IA se ejecutan en los servidores de Libration en Alemania y se desbloquean con tu licencia. Encontrarás las cuotas de cada plan en Planes.

Textos alternativos automáticos

Al subir: interruptor «Textos alternativos automáticos al subir» — las imágenes nuevas se describen de forma asíncrona.
Completar lo existente: «Analizar la biblioteca de medios» cuenta las imágenes sin texto alternativo; «Generar ahora» las procesa con indicador de progreso. Los textos alternativos existentes no se tocan.
Idioma: sigue el idioma de la web; se puede cambiar en la pestaña IA.

Lectura fácil y lectura en voz alta con IA

Ambas funciones forman parte del plan Pro AI y se desbloquean automáticamente con tu licencia en cuanto están disponibles para tu cuenta — verás el estado en la pestaña IA.

Opciones del backend

Widget del escritorio	Resumen de estado en el escritorio de WP — desactivable en General → Integración en el backend
Barra de administración	Acceso rápido «Accesibilidad» en la barra superior — también desactivable
Visualizador de tabulación	Muestra a los administradores el orden de tabulación con números directamente en el frontend (pestaña Orden de tabulación)
Avisos por correo	Notificación opcional cuando se sube una imagen sin texto alternativo

Planes de un vistazo

	Free	Pro	Pro AI	Agency
Widget + correcciones básicas + lista de verificación	✓	✓	✓	✓
Comprobación de textos alternativos	50 imágenes	ilimitada + CSV	ilimitada + CSV	ilimitada + CSV
Declaración de accesibilidad + informe PDF	—	✓	✓	✓
IA: textos alternativos / lectura fácil / lectura en voz alta	—	—	✓	✓ (compartido)
Sitios web	∞	1	1	hasta 25
Marca desactivable / white label	—	✓ / —	✓ / —	✓ / ✓

Precios y compra: libration.io/#pricing · Gestión: área de clientes

Solución de problemas

Los tropiezos más frecuentes y sus soluciones — la mayoría de los problemas se resuelven en pocos minutos.

El widget no aparece en el frontend

Comprueba primero que el plugin está realmente activado en la lista de plugins y que el botón flotante está encendido en la pestaña Widget. Después, la causa suele ser un plugin de caché o de optimización: vacía la caché (p. ej. WP Rocket, LiteSpeed Cache, Cloudflare) y recarga la página en una ventana de incógnito. Si el widget sigue sin aparecer, excluye los archivos de Libration Access de la optimización — lo explicamos con detalle en Plugins de caché y optimización. Comprueba también si hay reglas de exclusión activas (páginas o tipos de contenido concretos).

La clave de licencia no se acepta

La clave tiene el formato LIB-XXXX-XXXX-XXXX — cuidado con los espacios al principio o al final al copiarla del correo del pedido. Si se ha alcanzado el límite de sitios de tu plan, el servidor rechaza la activación: abre el área de clientes y libera una plaza con «Desvincular la licencia de este sitio». Si la activación falla con un error de conexión, tu servidor no llega a libration.io — pide a tu hosting que permita conexiones HTTPS salientes a libration.io (cortafuegos, archivo hosts).

Las funciones de IA no devuelven resultados

Causa más frecuente: la cuota mensual está agotada — la pestaña IA muestra el consumo y recibes un correo de aviso al 80 % y al 100 %. Puedes comprar cuota adicional en el área de clientes. Comprueba además si tu plan incluye IA (Pro AI o Agency — véase Planes). Si las peticiones se quedan del todo sin respuesta, puede que tu servidor bloquee las conexiones HTTPS salientes hacia el proxy de Libration — en caso de duda, pregunta a tu hosting.

La lectura en voz alta usa la voz del sistema en lugar de la voz de IA

La voz de IA requiere una licencia Pro AI (o Agency) activa y cuota disponible — si falta una de las dos cosas, el widget recurre automáticamente a la voz del sistema del navegador. Comprueba la licencia y el consumo en la pestaña IA. La primera lectura de una página tarda además un momento: el audio se genera en el servidor y luego se guarda en caché — a partir de la segunda reproducción arranca al instante.

El widget no encaja visualmente con el tema

La posición, el tamaño, el color de acento y el tema del panel se configuran en Ajustes → Accesibilidad → Widget. Si quieres que el widget siga automáticamente los colores de tu tema — incluido el modo oscuro —, acóplalo a tu diseño con variables CSS: consulta Acoplamiento al diseño. Así se mantiene coherente incluso tras un cambio de tema, sin retocar colores a mano.

Plugins de caché y optimización: excluir Libration Accessibility correctamente

Si falta el widget, el panel se abre sin estilos o el botón no reacciona, casi siempre hay detrás un plugin de optimización: combina el JavaScript, lo minifica o retrasa su ejecución («Delay JavaScript», «Defer»). La solución es siempre la misma — excluir Libration Access de la optimización. Solo cambia la forma de escribirlo: a algunos plugins les basta la palabra clave libration-accessibility, otros exigen la ruta completa de cada archivo JavaScript.

Estos son los archivos en cuestión — todos están en la carpeta del plugin:

/wp-content/plugins/libration-accessibility/assets/frontend.js
/wp-content/plugins/libration-accessibility/assets/frontend.css
/wp-content/plugins/libration-accessibility/assets/libration-tts.js
/wp-content/plugins/libration-accessibility/assets/libration-easy-lang.js

libration-tts.js y libration-easy-lang.js solo se cargan cuando la lectura en voz alta con IA o la lectura fácil están activas. Si tu plugin pide handles de WordPress en lugar de rutas (una lista de selección en vez de un campo de texto), son libration-frontend, libration-tts y libration-easy-lang.

Importante: frontend.js depende de dos cosas que WordPress imprime justo antes — jQuery y un pequeño bloque de configuración (libration_ajax). Si un optimizador mueve el script del widget pero deja la configuración donde está (o empuja jQuery al final de la página), el widget se rompe. Por eso, excluye también jQuery siempre que excluyas Libration Access de «delay» o «defer».

Dónde va la entrada en cada caso (los nombres de los menús cambian ligeramente entre versiones, el sitio sigue siendo el mismo):

WP Rocket	Optimización de archivos → «Archivos JavaScript excluidos» y además «Retrasar la ejecución de JavaScript → Archivos excluidos». Entrada: `libration-accessibility` (un patrón por línea) y `jquery`.
LiteSpeed Cache	Optimización de páginas → Ajustes JS → «JS Excludes» y «JS Deferred Excludes». Entrada: `libration-accessibility`.
Autoptimize	JS, CSS & More → «Excluir scripts de Autoptimize» — una lista separada por comas. Añade: `libration-accessibility/assets/`.
W3 Total Cache	Minify → «Never minify the following JS files». Aquí no basta la palabra clave — escribe la ruta sin el dominio: `wp-content/plugins/accessibility/assets/frontend.js` (una línea por archivo).
SiteGround Optimizer	Frontend → JavaScript → «Excluir archivos JS de combinar/aplazar». La selección es por handle: `libration-frontend`, `libration-tts`, `libration-easy-lang`.
Perfmatters	Assets → JavaScript → exclusiones de «Delay JavaScript» o Script Manager. Entrada: `libration-accessibility`.
Jetpack Boost / NitroPack	Lista de exclusión de la optimización de JavaScript. Entrada: `libration-accessibility`.
Cloudflare Rocket Loader	No tiene lista de exclusión. Si el widget solo falla con Rocket Loader activo, desactívalo o excluye las páginas afectadas mediante una regla.

Un método fiable cuando no sabes qué ajuste tiene la culpa: desactiva por completo «combinar JavaScript» y «retrasar la ejecución de JavaScript», vacía la caché y comprueba la página en incógnito. Si entonces el widget funciona, vuelve a activar las opciones de una en una — con las exclusiones de arriba. En dos o tres rondas habrás identificado la opción responsable sin renunciar a la optimización de todo tu sitio.

Renunciar aquí no te cuesta prácticamente nada: los recursos de Libration Access ya vienen minificados y agrupados — una minificación adicional ahorra unos pocos kilobytes.

El escaneo externo indica «cuota alcanzada» o un error

El escaneo tiene límites mensuales por plan: Free 2, Pro 20, Agency 100 escaneos — el contador se reinicia con el cambio de mes. Además, el escáner solo puede analizar páginas accesibles públicamente: el modo mantenimiento, la protección con contraseña basic-auth o un entorno de desarrollo local impiden el acceso y provocan un error. Desactiva la protección un momento o escanea la web en producción.

No se muestra una actualización disponible

WordPress solo comprueba las actualizaciones aproximadamente cada doce horas. Lanza la comprobación manualmente: Escritorio → Actualizaciones → «Comprobar de nuevo» — esto vacía el transient de actualizaciones. Si la actualización Pro sigue sin aparecer, revisa tu licencia: si ha caducado, el servidor de actualizaciones solo entrega actualizaciones de la versión gratuita; tras renovarla en el área de clientes, las actualizaciones Pro vuelven a estar disponibles de inmediato.

¿Tu problema no está en la lista? Escríbenos — todos los detalles en Soporte. La licencia, las facturas y las cuotas las gestionas en el área de clientes.

Soporte

¿Preguntas, errores, sugerencias? Escribe a support@librationtools.io — a los clientes Pro les respondemos con prioridad. Nos ayuda conocer tu versión de WordPress y del plugin (véase la lista de plugins) y una breve descripción de lo que esperabas y lo que viste en su lugar.