Lo que necesitas
Una cuenta de Ghost con permisos de administrador. Tu tema debe generar en el pie de página el área de Code Injection de Ghost. En Accessonaut, crea primero un proyecto con el dominio real de tu web y abre en el proyecto la página de instalación.
Paso a paso
- En Ghost Admin, abre Settings → Advanced → Code Injection.
- Pega el código de inserción sin cambios en el área Site Footer. Ghost genera este código antes de la etiqueta de cierre body.
- Guarda el cambio. El Code Injection de los ajustes de una sola entrada solo se aplica a esa entrada.
- Abre la web pública en una ventana privada. Revisa la página de inicio, las entradas, las páginas y la vista móvil.
Así es la inserción
Usa el código listo de tu proyecto. El ejemplo necesita tu ID de proyecto real y la dirección del servicio accesible públicamente.
<script src="https://accessonaut.com/widget.js"
data-project-id="TU_ID_DE_PROYECTO"
data-language="es" defer></script>Adapta el diseño a tu web
En tu proyecto de Accessonaut, abre «Widget de ayudas de lectura». Cinco plantillas y una vista previa en directo te ayudan con el diseño: colores, tipografías, ancho del menú, esquinas, sombras, icono o botón de apertura con texto y textos propios. La posición y los márgenes se ajustan por separado para escritorio y smartphone. Al guardar, tu código de inserción actual adopta automáticamente el diseño del proyecto; la configuración pública se guarda en caché hasta un minuto.
En el plugin de WordPress puedes elegir ajustes locales en su lugar. Estos tienen prioridad sobre el diseño del proyecto. El diseño está disponible en todos los planes. En el plan Free, el aviso de Accessonaut sigue visible. Los ajustes de lectura personales de tus visitantes tienen prioridad sobre las indicaciones de diseño.
Ten en cuenta
Los temas propios deben generar {{ghost_foot}} en default.hbs justo antes de la etiqueta de cierre body; si no, falta el código. El widget no llega a los correos de la newsletter. Elimina las inserciones anteriores del tema para que no haya un script duplicado.
Preguntas frecuentes sobre Ghost
¿Se conserva el código al cambiar o actualizar el tema?
Sí, si está en Code Injection. Según Ghost, puedes cambiar de tema sin perder estos fragmentos. En cambio, actualizar un tema oficial sobrescribe los cambios en los archivos del tema. Por eso, no pongas el código de inserción directamente en el tema.
¿Site Header o Site Footer?
Usa Site Footer. Ghost recomienda esta área para JavaScript. Site Header acaba en el head de la página. Los campos de Code Injection de cada entrada solo se aplican a esa entrada.
¿Qué muestra el widget en mi dirección de ghost.io?
El widget solo carga la configuración de tu proyecto en el dominio registrado en él. En cualquier otra dirección aparece con el diseño estándar y el aviso de Accessonaut. Registra tu propio dominio en el proyecto y prueba allí.
¿Funciona el widget con el área de miembros?
Ghost Portal, para iniciar sesión y registrarse, se abre como capa superpuesta sobre la página actual. Revisa con el teclado el inicio de sesión, el registro y las páginas de cuenta, también con el panel del widget abierto.
¿Puedo adaptar un tema propio en Ghost(Pro) Starter?
No. Según Ghost, en el plan Starter solo puedes usar temas oficiales. Por tanto, allí no es posible una inserción mediante archivos de tema propios. Comprueba si tu plan incluye Code Injection.
Si algo no funciona
El código está en Site Footer, pero el widget no aparece.
Causa: Tu tema no genera {{ghost_foot}}.
Solución: Añade {{ghost_foot}} en default.hbs justo antes de la etiqueta de cierre body y vuelve a subir el tema.
El widget solo aparece en una entrada.
Causa: El código está en el Code Injection de esa entrada en lugar de en los ajustes globales.
Solución: Muévelo a Settings → Advanced → Code Injection → Site Footer y borra la entrada de la publicación.
Quieres quitar el widget.
Causa: El código sigue activo en Site Footer.
Solución: Bórralo allí, guarda y elimina los restos en entradas y archivos del tema.
Comprueba la instalación
- Abre la web pública en una ventana privada. El widget se muestra exactamente una vez.
- Llega al botón con el teclado. Abre el panel, cambia el tamaño del texto y vuelve a cerrarlo.
- Revisa la página de inicio, una subpágina, un formulario y la vista móvil. El widget no debe tapar ningún control importante.
- En la pestaña Red, comprueba que widget.js y la configuración del proyecto se cargan desde la dirección de tu servicio. Si hay errores, revisa el dominio, el ID del proyecto y la CSP.
- En los proyectos Free, el aviso visible de Accessonaut sigue formando parte del widget. Los permisos dependen de tu proyecto.
Privacidad y límites
Al cargarse, el navegador del visitante obtiene el script y la configuración del proyecto del servicio de Accessonaut. Con ello se tratan la dirección IP, los datos de la solicitud del navegador y el nombre de host de la web. Las preferencias de visualización se guardan localmente en el navegador. Ten en cuenta la integración en tu política de privacidad y revisa tu configuración concreta.
Las ayudas de lectura no garantizan la conformidad. Revisa además las barreras en el código fuente y los recorridos completos de los usuarios, de forma automática y manual.