Cómo configurar el cron job de PrestaShop en cPanel

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

Si alguna vez has visto mensajes de error en tu tienda online como "la URL no es válida" o has notado que los informes de ventas no se generan solos, probablemente necesitas configurar un cron job. Pero, ¿qué es eso exactamente?

Un cron job es una tarea programada que tu servidor ejecuta automáticamente a intervalos regulares. Piensa en ello como un despertador que le dice a tu tienda: "oye, es hora de hacer esto". En el caso de PrestaShop, estas tareas son fundamentales para el mantenimiento de la tienda, la generación de informes, la actualización de divisas, el envío de correos transaccionales o la gestión de carritos abandonados.

Sin un cron job configurado, tendrías que hacer muchas de estas tareas manualmente, lo cual es inviable en un negocio en crecimiento. Además, PrestaShop tareas programadas mal configuradas o inexistentes pueden provocar que tu tienda funcione más lenta o que ciertas funciones simplemente no trabajen.

La buena noticia es que si tu hosting utiliza cPanel, configurar el cron job de PrestaShop es un proceso muy sencillo. En esta guía, te lo explicamos paso a paso, sin tecnicismos innecesarios y con consejos prácticos para que no cometas errores.

Antes de empezar: ¿Qué necesitas tener a mano?

Para configurar el cron job PrestaShop cPanel correctamente, necesitarás tres datos básicos. No te asustes, son fáciles de encontrar:

1. La ruta absoluta de tu tienda: Es la dirección completa en el servidor donde está instalado PrestaShop. Normalmente es algo como /home/tuusuario/public_html.
2. La URL de tu tienda: Por ejemplo, https://tutienda.com.
   3.Acceso a cPanel: Las credenciales te las proporciona tu proveedor de hosting.

Si no sabes cuál es la ruta absoluta de tu instalación, no te preocupes. En el siguiente apartado te enseñamos a encontrarla en menos de un minuto.

Paso 1: Encuentra la ruta absoluta de tu PrestaShop

Este es el primer paso y el más importante. La ruta absoluta es la dirección exacta donde se encuentran los archivos de tu tienda en el servidor.

Opción A: Usando el administrador de archivos de cPanel

1. Inicia sesión en tu cPanel.
2. Busca la sección Archivos y haz clic en Administrador de archivos.
3. Se abrirá una ventana. Asegúrate de que estás en la carpeta public_html (o la carpeta raíz de tu dominio).
4. Dentro de public_html, busca la carpeta donde tienes instalado PrestaShop. Si lo instalaste directamente en la raíz, verás los archivos sueltos (como config, admin, index.php, etc.).
5. En la barra de direcciones superior del administrador de archivos, verás la ruta completa. Por ejemplo: /home/miusuario/public_html.

Anota esa ruta, la necesitarás más adelante. Si tu tienda está en una subcarpeta (por ejemplo, /tienda), la ruta sería /home/miusuario/public_html/tienda.

Opción B: Usando un script PHP (más técnica)

Si te sientes más cómodo, puedes crear un archivo temporal para ver la ruta. Pero no te lo recomiendo si no tienes experiencia, ya que la opción A es mucho más visual y segura.

Paso 2: Localiza el archivo cron.php de PrestaShop

Dentro de la carpeta raíz de tu instalación de PrestaShop, existe un archivo llamado cron.php. Este es el "corazón" de las tareas programadas. Es el archivo que el servidor ejecutará en cada ciclo del cron job.

• Si tu tienda está en la raíz, la ruta completa al archivo sería: /home/miusuario/public_html/cron.php.
• Si está en una subcarpeta: /home/miusuario/public_html/tucarpeta/cron.php.

No necesitas abrirlo ni editarlo. Solo necesitas saber que existe y su ruta exacta. Si no lo encuentras, verifica que no lo hayas borrado accidentalmente o que tu instalación no esté corrupta.

Paso 3: Configura el cron job en cPanel

Ahora viene la parte divertida. Vamos a crear la tarea programada. Sigue estos pasos al pie de la letra:

1. En tu cPanel, busca la sección Avanzado y haz clic en Cron Jobs (o Tareas programadas).
2. Verás un formulario con varias casillas. La mayoría de las veces, solo necesitas rellenar los campos de "Comando" y "Configuración de correo electrónico".
3. En el campo Comando, escribe la siguiente línea (reemplaza [RUTA_ABSOLUTA] con la ruta que anotaste en el Paso 1):

php /home/miusuario/public_html/cron.php

Importante: Si tu hosting usa una versión de PHP diferente o tienes problemas, puedes usar php7.4 o php8.1 en lugar de php. Por ejemplo: php8.1 /home/miusuario/public_html/cron.php. Pregunta a tu hosting cuál es la versión recomendada si falla.

4. En el campo Configuración de correo electrónico, escribe tu email. Esto te servirá para recibir un aviso si algo sale mal. Es muy útil para depurar errores al principio. Puedes poner algo como tucorreo@tudominio.com.

5. Ahora, configura la frecuencia de ejecución. Aquí está la parte crítica. No lo configures cada minuto, ya que sobrecargarás el servidor. El valor recomendado por PrestaShop para tareas generales es cada 5 minutos.

   • En el campo de Minuto, escribe */5.
   • En Hora, escribe *.
   • En Día, escribe *.
   • En Mes, escribe *.
   • En Día de la semana, escribe *.

   Esto se traduce como: "ejecutar cada 5 minutos, todos los días, a todas horas". Si tu tienda tiene mucho tráfico, puedes poner */10 o */15 para aligerar la carga.

6. Haz clic en Agregar nueva tarea programada o Guardar.

¡Listo! Ya has creado tu primer cron job de PrestaShop. Pero no te vayas todavía, hay algunos consejos importantes que te evitarán dolores de cabeza.

Paso 4: Verifica que el cron job funcione correctamente

La teoría está bien, pero la práctica es lo que cuenta. Para asegurarte de que todo funciona, tienes dos métodos:

Método 1: El informe de PrestaShop

1. Entra al panel de administración de tu tienda.
2. Ve a Parámetros avanzados > Base de datos o Mantenimiento (según la versión).
3. Busca una sección llamada Información o Configuración. Normalmente hay un apartado que indica la última ejecución del cron o última actualización de los informes.
4. Si ves que la fecha se actualiza sola cada cierto tiempo, ¡perfecto! Está funcionando.

Método 2: Prueba manual (más técnico)

Si quieres asegurarte al 100%, puedes acceder directamente a la URL del cron en tu navegador. Para ello, ve a:

https://tutienda.com/cron.php?token=TU_TOKEN

Pero espera, necesitas el token. PrestaShop genera uno automáticamente. Para encontrarlo:

1. Ve a Parámetros avanzados > Rendimiento.
2. Busca la sección Cron o Tareas programadas.
3. Ahí verás un campo llamado Token del cron. Cópialo.
4. Ahora, en tu navegador, escribe https://tutienda.com/cron.php?token=TU_TOKEN_COPIADO.

Si la página se carga en blanco o muestra "OK", significa que el cron funciona. Si ves un error, anótalo porque te servirá para depurar.

[TIP] Si no encuentras el token, puedes generar uno nuevo desde el mismo panel de administración. No es peligroso, solo es una medida de seguridad para que nadie más ejecute tu cron.

Errores comunes y cómo solucionarlos

No todo es perfecto en el mundo del hosting. Aquí tienes los problemas más habituales y sus soluciones:

Error: "No se pudo conectar a la base de datos"

Esto suele pasar porque el cron job se ejecuta con un usuario de PHP diferente al de tu tienda. La solución más común es asegurarse de que estás usando el comando correcto. Prueba a cambiar php por la versión específica que usa tu hosting (ej: php7.4).

Error: "URL no válida" en los informes

Esto es un clásico. Significa que tu tienda no tiene configurada correctamente la URL en los parámetros de PrestaShop. Ve a Parámetros avanzados > General y verifica que la URL de tu tienda es correcta, sin espacios ni caracteres raros.

El cron se ejecuta pero no hace nada

Si el cron se ejecuta pero no ves cambios en los informes, puede ser que la frecuencia sea demasiado baja o que el archivo cron.php esté dañado. Prueba a subir una copia limpia del archivo desde la instalación original de PrestaShop.

Recibo muchos correos de error

Si configuraste el email en el cron job y recibes correos cada 5 minutos, es porque está fallando. Revisa el contenido del correo, suele indicar el error exacto. Una vez que lo arregles, puedes dejar el email vacío para no recibir notificaciones.

Preguntas frecuentes (FAQ) sobre cron job PrestaShop cPanel

¿Puedo configurar el cron job desde Syspanel?

Si tu hosting usa Syspanel (antes conocido como HestiaCP), el proceso es similar pero la interfaz cambia. Recuerda que el acceso a Syspanel se realiza a través del puerto 2106 (por ejemplo, https://tudominio.com:2106). Dentro, busca la sección Cron Jobs o Tareas Programadas. El comando será el mismo que te hemos explicado.

¿Cuál es la frecuencia ideal para el cron job de PrestaShop?

Para la mayoría de tiendas, cada 5 minutos es perfecto. Si tu tienda es muy pequeña o con poco tráfico, puedes poner */15 (cada 15 minutos). Si es una tienda grande con muchas operaciones, quizás quieras */2 (cada 2 minutos), pero esto aumentará la carga del servidor. Empieza con 5 minutos y ajusta según el rendimiento.

¿Necesito configurar más de un cron job?

PrestaShop solo necesita un cron job para las tareas generales. Sin embargo, si usas módulos específicos (como envíos o sincronización con marketplaces), es posible que te pidan configurar un cron job adicional con su propia URL. Consulta la documentación del módulo en cuestión.

¿Qué pasa si mi hosting no tiene cPanel?

Si tu hosting usa un panel diferente (como Plesk o Syspanel), el concepto es el mismo. Busca la sección de "Cron Jobs" o "Tareas Programadas" en tu panel. Si no la encuentras, contacta con tu proveedor de hosting y pídeles que te configuren el cron job ellos mismos. Es un proceso estándar y deberían poder hacerlo sin problema.

¿El cron job afecta al rendimiento de mi tienda?

Un cron job bien configurado no debería afectar al rendimiento. De hecho, lo mejora, ya que automatiza tareas que de otro modo consumirían recursos cuando tú las ejecutas manualmente. Eso sí, una frecuencia demasiado alta (cada minuto) puede saturar el servidor. Usa el sentido común.

Consejos finales para mantener tu PrestaShop saludable

Configurar el cron job es solo el primer paso. Aquí tienes algunos consejos extra:

1. Actualiza PrestaShop regularmente: Las versiones antiguas tienen errores que pueden afectar al cron job.
2. Revisa los logs de tu servidor una vez al mes para asegurarte de que no hay errores recurrentes.
3. No uses módulos de terceros desactualizados: Algunos módulos añaden sus propias tareas programadas y pueden entrar en conflicto con la tuya.
4. Haz copias de seguridad antes de modificar cualquier configuración del servidor.

Y recuerda: si en algún momento te sientes perdido, tu proveedor de hosting está para ayudarte. No tengas miedo de contactar con ellos si el cron job de PrestaShop te da problemas. Es una tarea rutinaria para ellos y te la pueden configurar en minutos.

Ahora que ya sabes cómo configurar el cron job PrestaShop cPanel, tu tienda funcionará como un reloj suizo. ¡Nos vemos en el siguiente tutorial!