Cloverfield Database Clean-Up

CloverDB Cleanup

Módulo de limpieza de la base de datos para PrestaShop 7.x a 9.x, compatible con multistore.

Mantén tu web rápida y limpia.

Instalación

1. Descarga cloverdbcleanup.zip.
2. En el back office, ve a Módulos > Gestor de módulos > Subir un módulo.
3. Sube el zip y haz clic en Instalar.
4. El módulo aparecerá en Parámetros avanzados > CloverDB Cleanup.

Actualización desde la 1.x: sube el nuevo zip sobre el módulo existente. El script de actualización conserva tus ajustes, traslada la opción del menú a Parámetros avanzados y mueve la ubicación de las copias de seguridad a var/modules/cloverdbcleanup/backups/ si todavía se usaba la ubicación predeterminada anterior (/backups/). Las copias antiguas de /backups/ debes moverlas o eliminarlas tú mismo, ya que el módulo no las muestra.

Ayuda

Haz clic en Ayuda en la cabecera del módulo o en la barra de herramientas de la página para acceder a la documentación integrada, disponible en inglés, neerlandés, alemán, francés, español, italiano y polaco. Se abre en el idioma de tu back office y puedes cambiar de idioma en la propia página de ayuda.

Multistore

El módulo sigue el contexto de tienda seleccionado en la parte superior del back office.

1. Todas las tiendas: los ajustes se guardan como valores globales predeterminados y todas las tareas limpian los datos de todas las tiendas.
2. Tienda o grupo de tiendas: los ajustes se guardan para esa selección y la limpieza solo elimina las filas de esas tiendas.
3. Los invitados (ps_guest) y el registro de correos electrónicos (ps_mail) no tienen columna de tienda, por lo que solo se pueden limpiar en el contexto Todas las tiendas.
4. La caché de la búsqueda por facetas y el índice de búsqueda se reconstruyen para todas las tiendas. Son cachés, así que puedes ejecutarlos sin riesgo en cualquier contexto.
5. La ubicación de las copias de seguridad es siempre global.

Ajustes

1. Registros de conexión con más de (por defecto 90 días): ps_connections, _page, _source.
2. Invitados sin visita desde hace (por defecto 90 días): ps_guest, solo visitantes anónimos.
3. Conservar invitados con un carrito más reciente de (por defecto 60 días): se conservan los invitados con un carrito más reciente.
4. Estadísticas de búsqueda con más de (por defecto 90 días): ps_statssearch.
5. Registros 404 con más de (por defecto 90 días): ps_pagenotfound.
6. Registro de correos electrónicos con más de (por defecto 90 días): ps_mail.
7. Ubicación de las copias de seguridad (por defecto var/modules/cloverdbcleanup/backups/): ruta absoluta en el servidor.

Cada valor debe estar entre 1 y 3650 días.

Uso, paso a paso

Paso 1: Crea una copia de seguridad

Haz clic en Crear copia de seguridad. El módulo escribe un volcado SQL de todas las tablas afectadas en la ubicación de las copias de seguridad, comprimido como .sql.gz si zlib está disponible. El nombre del archivo incluye la fecha, la hora y una parte aleatoria, p. ej. cloverdb_backup_2026-09-30_143022_k3J9xQ2m.sql.gz. La carpeta está protegida con un .htaccess y un index.php. En Nginx, asegúrate de que la carpeta no sea pública (la carpeta var/ predeterminada está bloqueada en la configuración estándar de Nginx para PrestaShop).

Paso 2: Revisa la vista previa

La tabla Filas que se eliminarán muestra las cifras según los ajustes actuales y el contexto de tienda. Los números en rojo indican una gran cantidad de filas. Un guion significa que la tabla no existe (por ejemplo, porque el módulo al que pertenece no está instalado) o que no está disponible en el contexto de tienda actual.

Paso 3: Limpia

Selecciona las tareas, haz clic en Iniciar limpieza y confirma. Las filas se eliminan en lotes de 2000, de modo que las tablas grandes no bloquean la tienda.

1. Registros de conexión: elimina las filas antiguas de ps_connections junto con las filas correspondientes de ps_connections_page y ps_connections_source.
2. Invitados antiguos: elimina los invitados anónimos (no vinculados a una cuenta de cliente) sin visita reciente y sin carrito reciente.
3. Caché de la búsqueda por facetas: vacía ps_layered_filter_block, que se reconstruye automáticamente en la siguiente visita a una categoría.
4. Estadísticas de búsqueda: elimina los términos de búsqueda antiguos de ps_statssearch.
5. Registro 404: elimina las entradas antiguas de ps_pagenotfound.
6. Descuentos caducados: elimina las reglas de precio de catálogo caducadas (incluidas sus condiciones y los precios generados) y los precios específicos caducados. Los precios sin fecha de finalización nunca se tocan.
7. Registro de correos electrónicos: elimina las entradas antiguas de ps_mail.

Paso 4: Reconstruye el índice de búsqueda

Haz clic en Reindexar para realizar una reindexación completa mediante el propio indexador de búsqueda de PrestaShop. Con catálogos grandes puede tardar varios minutos.

Restaurar una copia de seguridad

El panel Restaurar una copia de seguridad muestra todas las copias de la ubicación de copias de seguridad con su fecha, tamaño y versión de PrestaShop. Haz clic en Restaurar, lee las advertencias, marca la casilla de confirmación y haz clic en Sí, restaurar.

1. Al restaurar se reemplazan las tablas completas incluidas en la copia, para todas las tiendas. Se perderá todo lo que haya cambiado en esas tablas después de la copia de seguridad.
2. Solo es posible en el contexto Todas las tiendas.
3. Solo se pueden restaurar copias de seguridad creadas con este módulo. El archivo se comprueba por completo antes de modificar nada.
4. Las copias creadas con otra versión de PrestaShop aparecen marcadas. La estructura de las tablas puede ser distinta.
5. Pon la tienda en modo mantenimiento durante la restauración y vacía la caché después.
6. Eliminar borra un archivo de copia de seguridad del servidor.

Conviene saber

MySQL/MariaDB no devuelve el espacio libre al disco después de eliminar filas de tablas InnoDB. Si quieres que los archivos de la base de datos reduzcan su tamaño, ejecuta después OPTIMIZE TABLE en las tablas grandes (por ejemplo, ps_connections) desde phpMyAdmin.

Requisitos

1. PrestaShop 8.0 hasta 9.x inclusive
2. PHP 7.2.5 o superior (PrestaShop 9 requiere PHP 8.1 o superior)
3. MySQL 5.7 / MariaDB 10.3 o superior
4. Permisos de escritura en la ubicación de las copias de seguridad