Documentación de Pg Floating, el módulo de menú lateral e índice configurable

No se encontraron coincidencias para tu búsqueda. Prueba con otros términos (por ejemplo: acordeón, ancho, scroll o color).

1. Visión general y ficha técnica

PG - Índice y Menú Flotante de Contenidos (mod_pg_floating_toc) es un módulo nativo para Joomla que escanea automáticamente los encabezados (<h2> y <h3>) de cualquier artículo o página y construye al instante un menú lateral flotante o un índice desplegable tipo acordeón, personalizable al 100 % desde parámetros visuales sin necesidad de escribir CSS.

Tipo: Módulo de sitio (mod_pg_floating_toc) Autor: Paco Guio Joomla 4.x / 5.x / 6.x PHP 8.0+ | Sin jQuery Licencia: GNU GPL v2+

Ventajas principales y doble modo de funcionamiento

  • Dos extensiones en una: Puedes usarlo como menú lateral flotante en guías y documentaciones técnicas, o como tabla de contenidos en acordeón (recogida o desplegada al inicio) dentro de las entradas de un blog.
  • Generación automática de anclas: No requiere editar el HTML del artículo ni añadir identificadores manuales; el script detecta los títulos H2 y H3 en el navegador, crea sus anclas limpias al vuelo y construye la jerarquía navegable.
  • Submenús dinámicos por sección activa: En modo lateral permite mantener ocultos los subapartados H3 y desplegar únicamente los de la sección que el lector está viendo en pantalla.
  • Personalización visual sin tocar código: Incluye 8 selectores de color, ajuste de ancho en porcentaje o píxeles (100%, 30%, 450px, etc.), alineación, redondeo de esquinas, sombras y buscador instantáneo en vivo.

Requisitos previos

  • Instalación operativa de Joomla 4.x, 5.x o 6.x ejecutándose bajo PHP 8.0 o superior.
  • Compatible con artículos nativos de Joomla (com_content), páginas creadas con SP Page Builder y cualquier plantilla basada en Bootstrap 5 (Cassiopeia, Helix Ultimate o Astroid).

Licencia, exención de responsabilidad y descarga

Aviso legal y exención de responsabilidad (Licencia GNU GPL v2 o posterior) Este software se distribuye gratuitamente bajo licencia GNU GPL v2 o posterior (archivo LICENSE.txt incluido en el paquete) «tal cual», sin garantía explícita ni implícita de ningún tipo. La responsabilidad de instalar, configurar y utilizar esta extensión recae exclusivamente sobre la persona que la instala. Se recomienda encarecidamente realizar una copia de seguridad (backup) completa de los archivos y de la base de datos del sitio web antes de instalar esta o cualquier otra extensión.

2. Instalación y actualización

El módulo utiliza el sistema moderno de gestión de activos de Joomla (WebAssetManager), cargando su CSS y JavaScript diferido únicamente en las páginas donde el módulo está publicado.

Pasos de instalación

  1. Descarga el paquete instalable .zip desde el botón superior.
  2. Accede al panel de administración de Joomla y dirígete a Sistema > Instalar > Extensiones.
  3. Sube el archivo .zip en la pestaña Subir archivo del paquete.
  4. Una vez instalado, ve a Contenido > Módulos del sitio, haz clic en Nuevo (o edita el módulo PG - Índice y Menú Flotante de Contenidos), asígnale una posición de plantilla o déjalo sin posición para insertarlo dentro de artículos y publícalo.

3. Referencia de configuración del módulo

Todos los parámetros funcionales y visuales se organizan en tres pestañas dentro de la pantalla de edición del módulo:

Pestaña A: Modo y Comportamiento

Parámetro Nombre técnico Valor por defecto Descripción y función
Modo de visualización display_mode sidebar Selector principal entre Menú lateral flotante (Sidebar) e Índice de artículo / Blog (Acordeón).
Comportamiento al hacer scroll scroll_behavior follow (Visible en modo Sidebar) Permite elegir entre Seguir al bajar (Flotante) mediante aceleración GPU o Dejarlo fijo arriba (Estático).
Despliegue de submenús (H3) submenu_behavior active_only (Visible en modo Sidebar) Define si los subtítulos H3 se despliegan Solo en la sección activa o permanecen Siempre abiertos.
Distancia superior al flotar (px) top_gap 100 Separación en píxeles respecto al borde superior de la ventana mientras el menú flota (para no solaparse con menús superiores fijos).
Estado inicial del acordeón accordion_state collapsed (Visible en modo Acordeón) Elige si el índice arranca Recogido (Cerrado al inicio) o Desplegado (Abierto al inicio).
Título del índice toc_title Índice de contenidos Encabezado superior del índice o texto de la barra clicable en modo acordeón.
Numeración automática auto_numbering No Añade numeración jerárquica automática (1., 1.1, 2.) delante de cada enlace del índice.
Mostrar buscador instantáneo show_search Sí Activa o desactiva la caja de filtrado en vivo dentro del índice, junto con su etiqueta (search_title) y texto interior (search_placeholder).
Niveles de encabezados a indexar heading_levels h2_h3 Permite indexar H2 + H3 (Con submenús) o Solo H2 (Un nivel).
Compensación al hacer clic (px) scroll_offset 115 Margen superior en píxeles al desplazarse hasta un encabezado tras hacer clic, evitando que la cabecera fija de la plantilla tape el título.
Selector CSS del contenido content_selector Vacío (Auto) Opcional. Si se deja vacío detecta automáticamente artículos de Joomla y SP Page Builder; permite indicar un contenedor específico (ej. .mi-guia).

Pestaña B: Diseño y Colores

Todos los colores se inyectan como variables CSS propias por instancia (#pg-toc-module-ID), permitiendo tener varios módulos con distinta estética en la misma web:

Parámetro Variable CSS Valor por defecto Elemento al que afecta
Color principal (Acento) --pg-toc-accent #e65c2e Borde izquierdo activo, viñetas activas, flecha del acordeón y foco del buscador.
Color de texto del ítem activo --pg-toc-active-text #c9481d Texto en negrita de la sección principal activa.
Color de fondo del ítem activo --pg-toc-active-bg #fdeee9 Fondo de resaltado suave de la sección principal activa.
Color de fondo del contenedor --pg-toc-bg #f8f9fa Fondo general de la tarjeta del módulo.
Color del borde --pg-toc-border #dee2e6 Contorno exterior, borde del buscador y separador del acordeón.
Color de texto principal (H2) --pg-toc-text #212529 Enlaces principales en reposo y título del acordeón.
Color de submenús y etiquetas (H3) --pg-toc-subtext #5c636a Enlaces secundarios H3 y etiquetas superiores.
Color de fondo al pasar el ratón --pg-toc-hover-bg #e9ecef Resaltado al situar el cursor sobre un enlace o cabecera clicable.

Pestaña C: Dimensiones, Geometría y Tipografía

Parámetro Nombre técnico Opciones disponibles Descripción y función
Ancho del bloque del índice box_width / box_width_custom 100%, 75%, 50%, 40%, 30%, 320px, 450px o personalizada Controla el ancho del índice (en móvil pasa automáticamente al 100 % para mantener legibilidad).
Alineación horizontal box_align Izquierda, Centrado, Derecha Disponible cuando el ancho elegido es inferior al 100%.
Redondeo de esquinas border_radius Sin redondeo (0px), Suave (6px), Medio (10px), Muy redondeado (16px) Curvatura proporcional aplicada a la caja, el buscador y los enlaces activos.
Sombra del contenedor box_shadow Sin sombra, Sutil, Media, Pronunciada Nivel de elevación de la tarjeta.
Espaciado interno (Padding) box_padding Compacto, Normal, Amplio Márgenes interiores del contenedor.
Tamaño de fuente font_size_scale Pequeño, Normal, Grande Escala tipográfica proporcional para títulos y subtítulos.

4. Manual de uso práctico

Caso 1: Configurarlo como menú lateral flotante en documentaciones

  1. En Contenido > Módulos del sitio, abre el módulo y selecciona Modo de visualización: Menú lateral flotante (Sidebar).
  2. Elige Comportamiento al hacer scroll: Seguir al bajar (Flotante) (o Dejarlo fijo arriba si prefieres que no se desplace) y Despliegue de submenús: Solo en la sección activa.
  3. Asígnalo a la posición lateral de tu plantilla (por ejemplo sidebar-left o left) y vincúlalo en la pestaña Asignación de menú a tus páginas de documentación.

Caso 2: Configurarlo como índice desplegable en artículos del blog

  1. Crea o duplica una instancia del módulo y selecciona Modo de visualización: Índice de artículo / Blog (Acordeón).
  2. Selecciona Estado inicial del acordeón: Recogido (Cerrado al inicio) para que aparezca como una sola barra compacta desplegable al inicio del artículo, y ajusta el Ancho del bloque (por ejemplo 100%, 50% o 450px).
  3. Guarda el módulo sin asignarle posición de plantilla (o asígnale una posición propia como indice-blog) e insértalo en cualquier artículo mediante el botón Contenido CMS > Módulo del editor ({loadmoduleid ID}).

5. Solución de problemas habituales (FAQ)

El módulo está publicado pero no aparece en una página concreta

Por diseño, el módulo oculta su contenedor automáticamente cuando el artículo o página actual no contiene ningún encabezado <h2> dentro del cuerpo principal, evitando así mostrar una caja vacía en listados de blog o páginas cortas.

Al hacer clic en un enlace del índice, la barra superior fija de mi plantilla tapa el título

Abre los ajustes del módulo, ve a Modo y Comportamiento > Compensación al hacer clic (px) y aumenta el valor (por ejemplo de 115 a 140) hasta que el título quede perfectamente visible debajo de tu barra de navegación.

He cambiado un color o el ancho y no veo el cambio reflejado al instante

Comprueba en la pestaña Avanzado del módulo que la opción Caché esté configurada en Sin caché y limpia la caché de Joomla desde Sistema > Limpiar caché si tienes activada la caché global del sistema.

6. Historial de versiones (Changelog)

  • v1.1.1 (13/11/2026): Incorporación de viñetas circulares indicadoras en los ítems principales (H2) con transición de color activa para mejorar la jerarquía visual de títulos largos.
  • v1.1.0: Inyección directa de variables CSS por instancia para compatibilidad inmediata con todas las plantillas, caché de módulo desactivada por defecto y nuevos selectores de ancho (100%, 75%, 50%, 40%, 30%, 320px, 450px o personalizado) y alineación horizontal.
  • v1.0.0: Lanzamiento inicial con modo doble (Menú lateral flotante / estático e Índice de artículo en acordeón), escaneo automático de encabezados H2 y H3, buscador instantáneo en vivo y 8 selectores visuales de color.
Tags
logo paco guio