Activar URLs amigables en PrestaShop con Syspanel (Apache/Nginx)

¿Qué son las URLs amigables y por qué son esenciales para tu tienda?

Cuando instalas PrestaShop por primera vez, las URLs de tus productos, categorías y páginas tienen un aspecto poco atractivo y difícil de recordar, como por ejemplo: http://tudominio.com/index.php?id_product=42&controller=product.

Estas URLs "feas" no solo son difíciles de leer para tus clientes, sino que también son un lastre para tu posicionamiento en Google. Los buscadores prefieren URLs limpias y descriptivas que indiquen claramente el contenido de la página.

Al activar las URLs amigables de PrestaShop, tus enlaces se transformarán en algo mucho más profesional y optimizado, como: http://tudominio.com/zapatillas-de-running-azules. Esto mejora la experiencia de usuario, aumenta la tasa de clics en los resultados de búsqueda y facilita que los motores como Google indexen correctamente tu catálogo.

En este artículo, te explicaremos paso a paso cómo configurar las URLs amigables en PrestaShop cuando tu tienda está alojada en Syspanel, el panel de control que incluye la gestión de tu servidor. No te preocupes si no eres un experto en tecnología; aquí lo haremos sencillo y directo.

[INFO]: Aunque este proceso se realiza desde el panel de administración de PrestaShop, es muy probable que necesites acceso a Syspanel (recuerda, se accede a través del puerto 2106) para asegurarte de que el servidor tiene la configuración correcta para el rewrite de PrestaShop.

Requisitos previos antes de empezar

Antes de lanzarnos a cambiar la configuración, es importante que verifiques dos cosas para que el proceso sea un éxito:

Acceso al panel de administración de PrestaShop: Necesitas las credenciales de tu back-office (la parte privada de tu tienda, normalmente en /admin o una URL personalizada).
Acceso a Syspanel: Como mencionamos, tu hosting se gestiona desde Syspanel. Asegúrate de tener a mano tu usuario y contraseña. La URL de acceso suele ser https://tu-servidor:2106. Este acceso es fundamental por si necesitamos activar el módulo de reescritura de Apache (mod_rewrite) o modificar el archivo .htaccess.

[WARNING]: Realiza siempre una copia de seguridad de tu tienda y de tu base de datos antes de hacer cambios de configuración importantes. Aunque este proceso es seguro, es mejor prevenir.

Paso 1: Activar las URLs amigables en el Back-Office de PrestaShop

El primer paso se realiza dentro de tu tienda. Sigue esta ruta:

Ve a tu panel de administración de PrestaShop.
En el menú lateral izquierdo, busca el apartado Configuración avanzada.
Dentro de este menú, haz clic en Rendimiento (en versiones antiguas) o SEO y URLs (en versiones más recientes). Normalmente, la opción correcta es SEO y URLs.

Una vez dentro de la página de configuración, verás la sección Configurar URLs amigables.

Marca la casilla Sí para activar las URLs amigables.
PrestaShop te mostrará un mensaje de advertencia indicando que debes guardar los cambios para que se genere el archivo .htaccess. Haz clic en Guardar.

[INFO]: Al guardar, PrestaShop intentará crear automáticamente el archivo .htaccess en la raíz de tu dominio. Este archivo es el que contiene las reglas de rewrite PrestaShop necesarias para que las URLs limpias funcionen. Si el proceso falla, verás un mensaje de error indicando que debes crear el archivo manualmente. No te asustes, lo solucionaremos en el siguiente paso.

Paso 2: Verificar y configurar el "mod_rewrite" en Syspanel

Para que las URLs amigables de PrestaShop funcionen, el servidor web (Apache) debe tener habilitado el módulo mod_rewrite. Sin él, el archivo .htaccess no tendrá ningún efecto.

Aquí es donde entra en juego Syspanel. Sigue estos pasos:

Accede a Syspanel usando tu navegador web favorito. Recuerda que la dirección es https://la-ip-de-tu-servidor:2106. Si no la conoces, pregúntala a tu proveedor de hosting o búscala en el correo de bienvenida.
Introduce tus credenciales de acceso.
Una vez dentro, busca la sección que haga referencia a Servicios o Servidor Web. El nombre exacto puede variar según la versión de Syspanel, pero normalmente encontrarás una opción llamada Apache o Servidor Web.
Dentro de la configuración de Apache, busca la pestaña o sección de Módulos.
Localiza mod_rewrite en la lista y asegúrate de que esté activado (normalmente aparece con una marca de verificación o en color verde). Si no lo está, actívalo y guarda los cambios.

[WARNING]: Si no encuentras la opción de módulos, es posible que tu plan de hosting no te permita activarlos directamente. En ese caso, contacta con el soporte técnico de tu proveedor y diles que necesitas activar mod_rewrite para PrestaShop.

Paso 3: Crear o editar el archivo .htaccess manualmente

Si al guardar en el paso 1 PrestaShop no pudo generar el .htaccess, tendrás que crearlo o editarlo tú mismo. No te preocupes, es un archivo de texto plano.

Accede a Syspanel y navega hasta la sección de Archivos o Administrador de archivos.
Localiza la carpeta que corresponde a tu dominio (normalmente en /home/usuario/web/tudominio/public_html).
Busca un archivo llamado .htaccess.
- Si existe: Haz clic derecho sobre él y selecciona Editar.
- Si no existe: Crea un archivo nuevo y llámalo .htaccess (sin la palabra "nuevo"). Asegúrate de que el nombre empiece con un punto.

Para que PrestaShop funcione correctamente, el contenido del archivo .htaccess debe ser el que la propia plataforma genera. La forma más segura de obtenerlo es desde el back-office.

Método alternativo para generar el .htaccess desde PrestaShop:

Vuelve a tu back-office de PrestaShop.
Ve de nuevo a Configuración avanzada > SEO y URLs.
En la parte superior, verás un enlace o botón que dice Generar / regenerar el archivo .htaccess. Haz clic en él.
PrestaShop te mostrará el contenido del archivo en una ventana o te dará la opción de descargarlo. Copia todo el contenido.

Ahora, pega este contenido en el archivo .htaccess que abriste en Syspanel y guárdalo.

[TIP]: A veces, el simple hecho de hacer clic en "Guardar" en la página de SEO y URLs de PrestaShop, después de haber activado mod_rewrite en Syspanel, es suficiente para que el archivo .htaccess se genere solo. Prueba esto antes de crear el archivo manualmente.

Paso 4: Comprobar que todo funciona correctamente

Una vez que hayas completado los pasos anteriores, es hora de la prueba de fuego.

Abre una página de tu tienda que antes tuviera una URL fea. Por ejemplo, entra en el front-office (la parte pública de tu tienda) y navega a una categoría o producto.
Observa la barra de direcciones de tu navegador. Si todo ha ido bien, deberías ver una URL limpia y descriptiva, como tudominio.com/categoria/ropa-de-mujer o tudominio.com/zapatos/tenis-blancos.
Si las URLs se ven limpias, ¡enhorabuena! Has configurado correctamente las URLs amigables de PrestaShop.

Solución de problemas comunes (FAQ)

Aquí te dejamos las dudas más frecuentes que suelen tener los usuarios al realizar esta configuración.

¿Por qué veo un error 404 en todas mis páginas después de activar las URLs amigables?

Este es el problema más común. El error 404 significa que el servidor no encuentra la página. Las causas suelen ser:

El archivo .htaccess no se ha generado o está vacío: Verifica que el archivo existe en la raíz de tu dominio y que contiene las reglas de rewrite PrestaShop.
El módulo mod_rewrite no está activado: Revisa en Syspanel que el módulo esté habilitado.
Permisos incorrectos: El archivo .htaccess debe tener permisos de lectura (644 normalmente). Puedes cambiarlo desde el administrador de archivos de Syspanel.

¿Qué es el archivo .htaccess y por qué es tan importante?

El .htaccess es un archivo de configuración del servidor Apache. En el caso de PrestaShop, contiene las reglas que le dicen al servidor cómo interpretar las URLs limpias. Sin él, el servidor no sabría que tudominio.com/mi-producto debe mostrar el producto con ID 42. Es el corazón del rewrite de PrestaShop.

¿Puedo desactivar las URLs amigables si algo sale mal?

Sí, puedes revertir el cambio en cualquier momento. Solo tienes que ir a Configuración avanzada > SEO y URLs en tu back-office, seleccionar "No" en la opción de URLs amigables y guardar. PrestaShop regenerará el .htaccess para que las URLs vuelvan a ser las originales.

¿Necesito tocar algo más en Syspanel, como la configuración de PHP?

Normalmente no. La configuración de PHP no afecta directamente a las URLs amigables. Sin embargo, es recomendable tener una versión de PHP actualizada (8.0 o superior) para el correcto funcionamiento general de PrestaShop.

¿Qué hago si no encuentro la opción "SEO y URLs" en mi PrestaShop?

Dependiendo de la versión de PrestaShop que uses, la ruta puede variar ligeramente. En versiones más antiguas, esta opción se encontraba dentro de Preferencias > SEO y URLs. En versiones más modernas, está en Configuración avanzada > SEO y URLs. Si no la encuentras, utiliza el buscador del menú de administración.

Consejos finales para un mejor SEO

Configurar las URLs amigables es solo el primer paso. Para sacar el máximo partido a tu tienda, te recomendamos:

Personaliza tus URLs: En la misma página de "SEO y URLs", puedes editar cada producto, categoría o página para personalizar su URL. Usa palabras clave relevantes y separa las palabras con guiones.
Evita URLs demasiado largas: Una URL corta y concisa es mejor para el SEO y para que los usuarios la recuerden.
Configura las redirecciones: Si cambias la URL de una página antigua, asegúrate de configurar una redirección 301 desde la URL antigua a la nueva para no perder posicionamiento. PrestaShop suele hacer esto automáticamente si editas la URL desde el back-office, pero es bueno saberlo.

[TIP]: Después de activar las URLs amigables, es recomendable que te registres en Google Search Console (si no lo has hecho) y solicites la indexación de tu dominio. Esto ayudará a que Google rastree tu sitio con las nuevas URLs mucho más rápido.

Conclusión

Configurar las URLs amigables de PrestaShop en Syspanel es un proceso sencillo si sigues estos pasos. La clave está en la combinación de la configuración del back-office de PrestaShop y la activación del módulo mod_rewrite en tu servidor.

No solo mejorarás la estética de tus enlaces, sino que darás un gran paso adelante en la optimización para motores de búsqueda de tu tienda online. Esperamos que esta guía te haya sido de gran ayuda. Si tienes más dudas, no dudes en consultar la documentación oficial de PrestaShop o contactar con tu soporte técnico. ¡Mucha suerte con tu tienda!