Configurar Cron Job PrestaShop en cPanel: Guía definitiva

¿Qué es un cron job y por qué PrestaShop lo necesita?

Si has llegado hasta aquí, probablemente ya has visto algún aviso en tu panel de administración de PrestaShop sobre "tareas programadas" o "cron jobs". No te preocupes, no es tan complicado como parece. Vamos a desglosarlo de forma sencilla.

Un cron job es, en esencia, una tarea que tu servidor ejecuta automáticamente a intervalos regulares. Piensa en ello como un despertador: tú le dices al servidor "ejecuta este archivo cada 5 minutos" y el servidor lo hace sin que tú tengas que estar pendiente.

En el contexto de PrestaShop, los cron jobs son fundamentales para que tu tienda funcione correctamente. Se encargan de tareas críticas como:

Sincronizar tus productos con marketplaces o proveedores.
Enviar correos electrónicos de carritos abandonados o newsletters.
Procesar pagos recurrentes o actualizar estados de pedidos.
Generar informes y estadísticas de ventas.
Limpiar archivos temporales y optimizar la base de datos.
Actualizar los precios o el stock desde tus proveedores.

Sin un cron job configurado, muchas de estas funciones se ejecutarán solo cuando un usuario visite tu tienda, lo que puede ralentizar la experiencia de compra o incluso hacer que ciertos procesos fallen. Por eso, configurarlo correctamente en cPanel es esencial para la salud de tu ecommerce.

Antes de empezar: requisitos previos

Antes de lanzarnos a configurar el cron job prestashop, asegúrate de tener lo siguiente:

Acceso a cPanel: Necesitas las credenciales de tu hosting. Normalmente se accede a través de tudominio.com/cpanel.
Ruta absoluta a tu tienda PrestaShop: Saber en qué carpeta está instalado. Por ejemplo, si está en la raíz, será /home/usuario/public_html. Si está en una subcarpeta, será /home/usuario/public_html/tienda.
Datos de acceso a la base de datos: Aunque no siempre es necesario, puede ser útil para verificar que todo funciona.

[INFO] Si tu hosting usa Syspanel (antes conocido como HestiaCP), el acceso se realiza a través del puerto 2106 (por ejemplo: tudominio.com:2106). El proceso es similar al de cPanel, pero si tienes dudas, contacta con tu proveedor de hosting.

Paso 1: Localiza el archivo cron de PrestaShop

PrestaShop incluye un archivo llamado cron.php que se encuentra en la raíz de tu instalación. Este archivo es el que se ejecutará mediante el cron job.

Si tu tienda está en la raíz, la ruta sería algo como:
/home/tuusuario/public_html/cron.php

Si la tienes en una subcarpeta:
/home/tuusuario/public_html/mitienda/cron.php

También puedes usar la URL directa del archivo, pero la ruta del servidor es siempre más fiable porque no depende de DNS ni de redirecciones.

[TIP] Para encontrar la ruta absoluta, ve a tu cPanel, busca el administrador de archivos y navega hasta la carpeta donde está instalado PrestaShop. En la parte superior de la pantalla verás la ruta completa.

Paso 2: Abre la sección Cron Jobs en cPanel

Ahora vamos a trabajar en cPanel. Sigue estos pasos:

Inicia sesión en tu cPanel.
Busca la sección "Tareas programadas" o el icono "Cron Jobs". En la mayoría de los temas de cPanel, está en la categoría "Avanzado".
Haz clic en "Cron Jobs" para abrir la interfaz de configuración.

Verás un formulario con varios campos que pueden resultar un poco intimidantes al principio, pero vamos a explicarlos uno a uno.

Paso 3: Configura el cron job para PrestaShop

3.1. Configura el intervalo de tiempo

Lo primero que verás es la configuración de la frecuencia. Puedes elegir entre los ajustes predefinidos (como "cada 5 minutos", "cada hora", etc.) o configurar uno personalizado.

Para PrestaShop, lo más recomendable es establecer una frecuencia de cada 5 minutos. Esto asegura que las tareas críticas se ejecuten con regularidad sin sobrecargar el servidor.

En el campo de configuración personalizada, los números y asteriscos que ves significan:

Minuto: Cuando se ejecuta (0-59). Un * significa "todos los minutos".
Hora: A qué hora (0-23). Un * significa "todas las horas".
Día del mes: Qué día (1-31). Un * significa "todos los días".
Mes: Qué mes (1-12). Un * significa "todos los meses".
Día de la semana: Qué día de la semana (0-7, donde 0 y 7 son domingo). Un * significa "todos los días".

Para ejecutar cada 5 minutos, usa esto:
*/5 * * * *

3.2. Configura el comando

En el campo "Comando" o "Command" debes escribir la ruta al archivo cron.php de PrestaShop. La sintaxis básica es:

php /home/tuusuario/public_html/cron.php

Si tu hosting usa una versión específica de PHP, es posible que necesites especificarla. Por ejemplo:

/usr/local/bin/php7.4 /home/tuusuario/public_html/cron.php

[WARNING] Si utilizas PHP 8 o superior, asegúrate de que tu PrestaShop sea compatible. Las versiones antiguas de PrestaShop (1.6 o anteriores) pueden dar errores con PHP moderno. En ese caso, contacta con tu hosting para saber qué versión de PHP tienes disponible.

3.3. Añade el token de seguridad (opcional pero recomendado)

PrestaShop tiene un parámetro de seguridad llamado "token". Puedes encontrar este token en tu panel de administración:

Ve a Parámetros avanzados > Rendimiento o Configuración avanzada.
Busca la sección "Cron" o "Tareas programadas".
Copia la URL que te muestra. Normalmente tiene un formato similar a:

https://tudominio.com/cron.php?token=ABCDEF123456

Ese token es importante porque evita que personas no autorizadas ejecuten tu cron. Añádelo al comando de cPanel:

php /home/tuusuario/public_html/cron.php?token=ABCDEF123456

[TIP] Puedes usar la URL completa en lugar de la ruta del servidor. Por ejemplo: wget -O /dev/null 'https://tudominio.com/cron.php?token=ABCDEF123456'. Esto simula una visita al navegador y es útil si el servidor bloquea la ejecución directa de PHP.

Paso 4: Guarda y verifica

Una vez configurado, haz clic en "Añadir nueva tarea cron" o "Guardar". Verás que la tarea aparece en la lista de cron jobs existentes.

Para verificar que funciona correctamente:

Accede a tu panel de PrestaShop.
Ve a Parámetros avanzados > Rendimiento o la sección de cron.
Deberías ver la fecha y hora de la última ejecución. Si aparece una fecha reciente, ¡todo está funcionando!

Si no ves la fecha, puede que haya un error. Revisa los logs de cPanel en la sección "Cron Jobs" para ver si hay algún mensaje de error.

Errores comunes y cómo solucionarlos

Error: "No se puede conectar con la base de datos"

Esto suele pasar si el cron se ejecuta con un usuario PHP diferente al de la tienda. Verifica que la ruta del archivo cron.php sea correcta y que los permisos de archivos sean los adecuados (644 o 755).

Error: "Token inválido"

Asegúrate de que el token que has copiado es el correcto y que no tiene espacios adicionales. A veces el token cambia si regeneras la URL en PrestaShop.

Error: "Tiempo de ejecución excedido"

Si tu cron tarda demasiado, puede que el servidor lo detenga. Intenta reducir la frecuencia o contacta con tu hosting para aumentar el límite de tiempo de ejecución.

El cron funciona pero no actualiza el stock

Verifica que el cron de PrestaShop tenga los permisos para ejecutar los módulos de sincronización. A veces es necesario configurar cada módulo por separado para que se conecten al cron.

Tareas programadas PrestaShop: módulos y funciones específicas

El archivo cron.php es el núcleo, pero muchos módulos de PrestaShop tienen sus propios cron jobs. Por ejemplo:

Módulos de envío: Sincronizan los estados de envío con las agencias de transporte.
Módulos de pago: Verifican pagos pendientes o actualizan transacciones.
Módulos de marketing: Envían campañas de correo programadas.
Módulos de importación: Actualizan catálogos desde archivos CSV o XML.

Cada módulo te dirá si necesita una URL específica. Normalmente puedes encontrarla en la configuración del módulo, en una sección llamada "Cron" o "Tareas programadas". Deberás añadir esas URLs también en cPanel como cron jobs adicionales.

[INFO] No es necesario que configures cada módulo individualmente si tu PrestaShop es reciente y ya usa el cron central. Sin embargo, si algún módulo específico te lo pide, sigue las instrucciones del fabricante.

Consejos para optimizar el cron job PrestaShop

Para que tu cron prestashop funcione de manera eficiente, ten en cuenta estos consejos:

No lo ejecutes cada minuto: A menos que sea estrictamente necesario, cada 5 minutos es suficiente. Ejecutarlo más seguido puede sobrecargar el servidor.
Usa la ruta del servidor y no la URL: Las URLs pueden ser bloqueadas por firewalls o CDNs. La ruta del servidor es directa y más rápida.
Programa tareas pesadas en horas de baja afluencia: Si tienes que importar muchos productos o generar informes grandes, hazlo de madrugada.
Revisa los logs periódicamente: En cPanel puedes ver el historial de ejecución. Si ves errores recurrentes, es mejor solucionarlos pronto.
No desactives el cron sin más: Si lo desactivas, tu tienda puede volverse lenta o dejar de enviar correos automáticos.

Preguntas frecuentes (FAQ)

¿Puedo usar el cron job de PrestaShop sin cPanel?

Sí. Si tu hosting no tiene cPanel, puedes configurar el cron desde otros paneles como Syspanel (HestiaCP). En ese caso, el acceso es a través del puerto 2106 y el proceso es similar: busca la sección de Cron Jobs o Tareas Programadas.

¿Qué pasa si mi hosting no permite cron jobs?

La mayoría de los hostings compartidos lo permiten, pero si el tuyo no lo permite, contacta con el soporte. Si no, puedes usar un servicio externo como cron-job.org que ejecuta la URL de tu cron remotamente.

¿El cron job afecta al rendimiento de mi tienda?

Si está bien configurado, no debería afectar significativamente. Los cron jobs se ejecutan en segundo plano y no interfieren con la experiencia de compra de tus clientes.

¿Cómo sé si el cron job se está ejecutando?

En PrestaShop, ve a la sección de cron en el panel de administración. Verás la fecha y hora de la última ejecución. Si es reciente, todo está bien.

¿Puedo configurar varios cron jobs para diferentes funciones?

Sí, puedes añadir tantos como necesites. Solo asegúrate de no duplicar tareas o sobrecargar el servidor.

Conclusión y próximos pasos

Configurar el cron job prestashop en cPanel es un proceso sencillo una vez que entiendes los conceptos básicos. Recuerda que la clave está en:

Usar la ruta correcta al archivo cron.php.
Configurar un intervalo razonable (cada 5 minutos).
Añadir el token de seguridad.
Verificar que se ejecuta correctamente.

Con esto, tu tienda funcionará de manera más eficiente, enviará correos automáticos, mantendrá el stock actualizado y procesará pagos sin que tú tengas que intervenir manualmente.

Si tienes algún problema, no dudes en consultar la documentación oficial de PrestaShop o contactar con tu proveedor de hosting. La mayoría de los problemas se solucionan con un ajuste en la ruta o en los permisos de archivos.

[TIP] Guarda esta guía en tus favoritos. Cada vez que cambies de servidor o migres tu tienda, tendrás que volver a configurar los cron jobs. Tener una referencia rápida te ahorrará tiempo y dolores de cabeza.

¡Mucha suerte con tu tienda online! Los cron jobs son como el sistema nervioso de tu ecommerce: invisibles pero absolutamente esenciales. Ahora ya sabes cómo mantenerlos en forma.