Documentación Pg Clearcaché

No se han encontrado apartados que coincidan con tu búsqueda.

1. Resumen y Descarga

Sistema - pg_clearcache es un plugin ligero y nativo para Joomla diseñado con la máxima usabilidad en mente. Permite vaciar la memoria caché de tu sitio web en un solo clic —tanto desde la barra superior del administrador como desde la parte pública— mediante peticiones AJAX en segundo plano, sin recargar la página ni interirrumpir tu trabajo.

Ficha técnica de la extensión

Extensión: pg_clearcache Tipo: Plugin de Sistema (system) Autor: Paco Guio Compatibilidad: Joomla 4.x / 5.x / 6.x PHP: 8.1 o superior Licencia: GNU GPL v2 o posterior

Características principales

  • Limpieza instantánea sin recarga (AJAX): Vacía la caché mediante el endpoint nativo com_ajax protegido con token CSRF, conservando intacto el formulario o pantalla donde estés trabajando.
  • Doble alcance (Backend y Frontend): Muestra un botón tipo cápsula verde integrado en la barra superior de la plantilla Atum y, de forma opcional, un botón flotante en la parte pública que puedes activar o desactivar por completo.
  • Control por dispositivos y diseño adaptable: Permite decidir si el botón público se muestra en todos los dispositivos, solo en escritorio y tablet, o únicamente en escritorio, además de incluir modo compacto (solo icono) para pantallas móviles.
  • Botón flotante reposicionable y arrastrable: Ofrece 7 posiciones predefinidas, márgenes personalizables en píxeles y un tirador lateral para moverlo libremente por la pantalla con memoria persistente en el navegador.
  • Control granular por grupos de usuarios: En el frontend solo lo ven los grupos o roles que tú selecciones (por defecto, Super Users).
  • Limpieza profunda diferenciada: En el backend limpia la caché interna de administración; en el frontend limpia tanto la caché de Joomla como la caché pública de páginas y vistas, enviando además cabeceras Clear-Site-Data al navegador.
  • Mantenimiento automático: Incluye limpieza automática al guardar contenidos, atajo de teclado rápido (Alt + C), desbloqueo global de registros (Global Check-in), vaciado seguro de /tmp, limpieza de carpetas personalizadas y URL secreta para tareas Cron.

Descarga y aviso legal

Aviso legal y exención de responsabilidad (GNU GPL v2 o posterior) Esta extensión se distribuye como software libre bajo licencia GNU General Public License v2 o posterior y se entrega «tal cual», sin garantías explícitas ni implícitas de ningún tipo. La instalación, configuración y uso del plugin recaen única y exclusivamente bajo la responsabilidad de quien lo instala. Realiza siempre una copia de seguridad completa (backup) de tus archivos y base de datos antes de instalar o actualizar cualquier extensión en un entorno en producción.

2. Instalación y Actualización

Requisitos previos

  • Joomla 4.2+, 5.x o 6.x instalado y operativo.
  • Versión de PHP 8.1, 8.2 o 8.3.
  • Permisos de administrador con acceso al instalador de extensiones y al gestor de plugins.

Instalación paso a paso

  1. Descarga el paquete instalable plg_system_pg_clearcache.zip desde el botón superior.
  2. Accede al panel de administración de tu Joomla y dirígete a Sistema → Instalar → Extensiones.
  3. En la pestaña Subir paquete de archivo, arrastra o selecciona el archivo .zip descargado.
  4. Al finalizar, verás un aviso verde de confirmación con un enlace directo para abrir la ficha del plugin. Haz clic en ese enlace (o ve a Sistema → Gestionar → Plugins y busca pg_clearcache).
  5. Cambia el estado del plugin de Deshabilitado a Habilitado, revisa las opciones a tu gusto y pulsa Guardar y cerrar.

Actualizar desde una versión anterior

El manifiesto incorpora method="upgrade", por lo que puedes instalar cualquier nueva actualización directamente encima de la anterior sin desinstalar nada; se conservarán todos tus ajustes guardados y el pie de cada pestaña reflejará automáticamente la versión instalada.

Nota si utilizabas una versión antigua sin prefijo pg_: Si tienes instalada la primera edición inicial bajo el nombre técnico clearcache, desinstálala previamente desde Sistema → Gestionar → Extensiones para evitar duplicar el botón en la barra superior.

3. Configuración del Plugin

Todos los ajustes están organizados en tres pestañas muy claras dentro del plugin, cada una acompañada de su propia guía rápida integrada en pantalla y un pie informativo con el nombre de la extensión, la versión activa y enlace directo a la web del autor.

Pestaña 1: Visibilidad y Posición

Controla dónde aparece el botón verde de limpieza, en qué dispositivos es visible, quién puede usarlo en la web pública y si se habilita el atajo de teclado.

Parámetro Por defecto Descripción y funcionamiento
Mostrar en Backend Sí Muestra el botón verde tipo cápsula en la barra superior de la administración de Joomla (Atum). En móviles se compacta automáticamente a solo icono para no saturar la cabecera.
Mostrar en Frontend Sí Activa o elimina por completo el botón flotante de la parte pública del sitio. Si se marca en No, no se renderiza ningún botón en el frontend.
Dispositivos donde mostrar en Frontend Solo Escritorio y Tablet Permite elegir entre Todos los dispositivos (Escritorio, Tablet y Móvil), Solo Escritorio y Tablet (Ocultar en móvil) o Solo Escritorio (Ocultar en tablet y móvil).
Grupos de usuarios permitidos Super Users Desplegable múltiple donde puedes elegir todos los grupos o roles de usuario que verán el botón en el frontend (Administradores, Editores, Gestores, etc.).
Posición inicial en la pantalla Abajo a la derecha Ofrece 7 ubicaciones iniciales: Abajo a la derecha (recomendado), Abajo a la izquierda, Abajo en el centro, Centro derecha (Lateral), Centro izquierda (Lateral), Arriba a la derecha y Arriba a la izquierda.
Separación horizontal / vertical (px) 20 px / 20 px Distancia en píxeles desde los bordes de la pantalla (entre 0 y 300 px), ideal para evitar solapamientos con avisos de cookies o widgets de chat.
Permitir mover el botón libremente Sí Añade un tirador lateral para arrastrar el botón con el ratón o el dedo a cualquier lugar de la pantalla y recordar esa posición en el navegador. Doble clic en el tirador restablece la posición original.
Modo compacto en móvil (Solo icono) Sí Cuando el botón está habilitado en móviles, oculta el texto y muestra únicamente un botón cuadrado con el icono verde para ocupar el mínimo espacio posible.
Atajo de teclado (Alt + C) Sí Permite lanzar la limpieza de caché pulsando Alt + C en el teclado desde cualquier pantalla donde el usuario tenga permiso.

Pestaña 2: Opciones de Limpieza

Define qué tareas de mantenimiento adicionales se ejecutan junto con el vaciado estándar de la caché.

Parámetro Por defecto Descripción y funcionamiento
Limpiar al guardar contenido Sí Vacía automáticamente la caché cada vez que guardas un artículo, módulo, elemento de menú o categoría en el backend (onContentAfterSave).
Purgar caché caducada Sí Ejecuta el recolector de basura (Garbage Collection) de Joomla para eliminar archivos de caché expirados.
Vaciar carpeta temporal (/tmp) No Elimina restos antiguos de instalaciones en /tmp con más de 1 hora de antigüedad, respetando cualquier subida que esté en curso.
Desbloqueo Global (Global Check-in) No Libera automáticamente los elementos que se hayan quedado bloqueados con candado (checked_out) en la base de datos.
Carpetas adicionales a limpiar Vacío Área de texto para indicar rutas relativas a la raíz de Joomla (una por línea, por ejemplo cache/com_templates) cuyo contenido se vaciará manteniendo intactos index.html y .htaccess.

Pestaña 3: Limpieza Automática (Cron / URL Externa)

Permite vaciar toda la caché sin iniciar sesión en Joomla mediante una URL privada protegida por clave.

Parámetro Por defecto Descripción y funcionamiento
Clave secreta para Cron / URL Vacío (Desactivado) Contraseña alfanumérica (solo letras y números). Al definirla, cualquier petición a https://tudominio.com/?pg_clearcache_secret=TU_CLAVE vacía toda la caché y devuelve una respuesta JSON.

4. Guía de Uso Diario

Uso en el Panel de Control (Backend)

  1. Verás el botón verde Limpiar Caché integrado en la barra superior de Joomla, junto a la versión del sistema y el menú de usuario.
  2. Cuando edites un artículo, un módulo o ajustes de plantilla, haz clic sobre él (o pulsa Alt + C).
  3. El icono girará brevemente mostrando Limpiando... y aparecerá la notificación nativa verde de Joomla confirmando que la caché está limpia, sin recargar el formulario que tengas abierto.

Uso en la Parte Pública (Frontend)

  1. Inicia sesión en la web con un usuario perteneciente a uno de los grupos autorizados.
  2. En la ubicación y dispositivos configurados aparecerá el botón flotante verde Limpiar Caché.
  3. Si tienes activado el arrastre libre, puedes sujetarlo por el tirador lateral de puntos y colocarlo en cualquier punto de la pantalla; si haces doble clic en ese tirador volverá a su posición configurada.
  4. Al pulsarlo, el plugin limpia tanto la caché de Joomla como la caché de páginas y vistas públicas, envía la cabecera Clear-Site-Data: "cache" al navegador y muestra un aviso flotante de confirmación en la parte inferior.

Cómo programar una Tarea Cron en tu hosting

  1. En la pestaña Limpieza Automática (Cron / URL Externa), escribe una clave segura solo con letras y números (por ejemplo: limpiar2026web) y guarda.
  2. Accede al panel de control de tu alojamiento web (cPanel, Plesk o similar) y entra en Tareas Cron (Cron Jobs).
  3. Configura la frecuencia deseada (por ejemplo, una vez cada madrugada) y añade el siguiente comando sustituyendo tu dominio y tu clave:
    curl -s "https://tudominio.com/?pg_clearcache_secret=limpiar2026web" > /dev/null 2>&1

5. Preguntas Frecuentes (FAQ)

Permisos, dispositivos y visibilidad del botón

¿Los visitantes anónimos de mi web pueden ver el botón flotante en el frontend?

No. El plugin comprueba en el servidor que el usuario haya iniciado sesión y pertenezca a alguno de los grupos seleccionados en Grupos de usuarios permitidos. Para los visitantes públicos ni siquiera se cargan los archivos CSS y JS del plugin, por lo que no afecta en absoluto a la velocidad de carga ni a Core Web Vitals.

¿Cómo oculto el botón en teléfonos móviles o lo elimino por completo del frontend?

En la pestaña Visibilidad y Posición, si pones Mostrar en Frontend en No desaparecerá por completo de la parte pública. Si quieres mantenerlo en ordenadores pero evitar que moleste en móviles, selecciona Solo Escritorio y Tablet (Ocultar en móvil) en Dispositivos donde mostrar en Frontend.

He movido el botón flotante arrastrándolo por la pantalla y quiero devolverlo a su esquina original. ¿Cómo lo hago?

Haz doble clic sobre el tirador lateral de puntos del propio botón flotante y volverá automáticamente a la posición y márgenes definidos en la configuración del plugin.

Seguridad y limpieza de carpetas

¿Es seguro usar el campo «Carpetas adicionales a limpiar»?

Sí. El plugin valida cada ruta para impedir saltos de directorio (..) fuera de la raíz de Joomla (JPATH_ROOT) y protege automáticamente los archivos index.html y .htaccess para no comprometer la seguridad de ningún directorio.

¿Pueden abusar de la URL secreta del Cron para sobrecargar mi servidor?

Si dejas el campo Clave secreta vacío, el endpoint externo permanece completamente desactivado. Cuando defines una clave, el plugin utiliza comparación criptográfica segura (hash_equals) y admite únicamente caracteres alfanuméricos.

6. Historial de Versiones

  • Versión 2.3.1 (16/11/2026): Actualización de paquete y mejoras generales.
logo paco guio