Habilitar URLs amigables en PrestaShop con cPanel

¡Hola! Soy el técnico de soporte de tu hosting. Hoy vamos a resolver una de las dudas más comunes cuando montas una tienda online con PrestaShop: cómo activar las URLs amigables (friendly URLs) desde cPanel.

Si ves que tus productos tienen direcciones como tutienda.com/index.php?id_product=12&controller=product, ¡estás en el lugar correcto! Vamos a transformarlas en algo como tutienda.com/categoria/producto-ejemplo. Esto no solo es más bonito, sino que es clave para tu SEO.

Voy a explicártelo paso a paso, sin tecnicismos raros. Al final, tendrás las URLs amigables PrestaShop funcionando a la perfección.

¿Qué son las URLs amigables y por qué las necesitas?

Las PrestaShop SEO URLs (o URLs amigables) son direcciones web que describen el contenido de la página de forma clara para los humanos y los buscadores.

Ejemplo:

Sin amigable: tutienda.com/index.php?id_category=5&controller=category
Con amigable: tutienda.com/electronica/auriculares

Beneficios principales:

Mejor experiencia de usuario: Tus clientes entienden de qué va la página solo con ver la URL.
Mejor posicionamiento SEO: Google prefiere URLs limpias. Ayudan a tu tienda a aparecer en los primeros resultados.
Evitas enlaces rotos: Si cambias de estructura, las URLs amigables suelen redirigir mejor.

[INFO] Si no activas esto, tu tienda usará URLs con parámetros como ?id=..., que son más difíciles de recordar y compartir.

Requisitos previos antes de empezar

Antes de activar las PrestaShop friendly URLs, necesitas asegurarte de que tu servidor soporta la reescritura de URLs. Esto se hace mediante un archivo llamado .htaccess y el módulo mod_rewrite de Apache.

¿Qué necesitas tener a mano?

Acceso a cPanel (te lo proporciona tu hosting).
Acceso al panel de administración de PrestaShop.
Saber qué versión de PrestaShop usas (1.6, 1.7, 8.x…). No te preocupes, el proceso es muy similar en todas.

[WARNING] Si tu hosting usa Syspanel (antes conocido como HestiaCP), el proceso es diferente. En ese caso, accede a tu panel por el puerto 2106 y busca la sección de "Reescritura de URLs" o "Apache". Pero en este artículo nos centramos en cPanel.

Paso 1: Activar el módulo de reescritura en cPanel

cPanel suele tener mod_rewrite activado por defecto, pero es bueno verificarlo. Si no está activo, las URLs amigables no funcionarán.

¿Cómo verificarlo?

Inicia sesión en tu cPanel (normalmente en tudominio.com/cpanel o tudominio.com:2083).
Busca la sección "Software" o "Avanzado" y haz clic en "Select PHP Version" (o "MultiPHP Manager").
No necesitas cambiar nada aquí, solo confirma que Apache esté funcionando. Si ves opciones como "mod_rewrite" en la lista, está activo.
Si no aparece, contacta con tu proveedor de hosting. En la mayoría de los casos ya lo tienen encendido.

[TIP] Si tu cPanel tiene la herramienta "Apache Handlers" , puedes verificar que mod_rewrite esté habilitado. Si no, pide a soporte que lo activen.

Paso 2: Configurar PrestaShop para URLs amigables

Ahora vamos al panel de administración de tu tienda. Sigue estos pasos:

Ve a Preferencias > SEO y URLs (en PrestaShop 1.7 y 8.x está en Configuración de la tienda > Tráfico y SEO > SEO y URLs).
Busca la opción "URLs amigables" (o "Friendly URLs").
Actívala (ponla en "Sí").
Haz clic en "Guardar".

¿Qué pasa después? PrestaShop intentará generar automáticamente el archivo .htaccess con las reglas de reescritura. Pero a veces da error porque no tiene permisos para escribir el archivo. No te preocupes, lo solucionamos en el siguiente paso.

[INFO] Si ves un mensaje de error como "No se puede escribir el archivo .htaccess", significa que debemos crearlo o editarlo manualmente.

Paso 3: Crear o editar el archivo .htaccess desde cPanel

El archivo .htaccess es el que le dice al servidor cómo reescribir las URLs. Vamos a crearlo o modificarlo.

Acceder al administrador de archivos de cPanel

En cPanel, busca la sección "Archivos" y haz clic en "Administrador de archivos".
Selecciona la carpeta donde está instalada tu tienda (normalmente public_html o una subcarpeta como public_html/tienda).
Busca el archivo llamado .htaccess (puede estar oculto). Si no lo ves, activa la opción "Mostrar archivos ocultos" (en el menú superior del administrador de archivos).

Si el archivo NO existe:

Haz clic en "Nuevo archivo" y nómbralo exactamente .htaccess (con el punto al inicio).
Ábrelo con el editor de texto.

Si el archivo SÍ existe:

Haz clic derecho sobre él y selecciona "Editar".
Te preguntará si quieres codificarlo. Selecciona "UTF-8" y confirma.

Pegar el código correcto

Dentro del archivo, pega el siguiente código. Es el estándar para PrestaShop:

# START PrestaShop friendly URLs
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php [QSA,L]
</IfModule>
# END PrestaShop friendly URLs

Explicación simple:

RewriteEngine On: Activa el motor de reescritura.
RewriteCond: Dice que no apliques la regla si el archivo o carpeta existe realmente (para no romper imágenes, CSS, etc.).
RewriteRule: Redirige todas las peticiones a index.php de PrestaShop.

[WARNING] Si tu tienda está en una subcarpeta (ej: public_html/mitienda), la regla cambia ligeramente. En lugar de RewriteRule ^(.*)$ index.php [QSA,L], usa RewriteRule ^(.*)$ mitienda/index.php [QSA,L].

Guarda los cambios. Si el archivo ya existía, te recomiendo hacer una copia de seguridad antes de modificarlo.

Paso 4: Verificar que las URLs amigables funcionan

Después de guardar el .htaccess, vuelve a tu tienda (la parte pública, no el panel de admin) y haz una prueba.

Ve a una categoría o producto que antes tuviera una URL fea.
Ahora deberías ver algo como tudominio.com/categoria/nombre-producto.
Si ves la página correctamente, ¡felicidades! Ya tienes PrestaShop SEO URLs activadas.

Prueba extra: Intenta acceder a una URL antigua con index.php?id_product=.... Si todo está bien, debería redirigir automáticamente a la nueva URL amigable.

[TIP] Si no ves el cambio, limpia la caché de tu navegador (Ctrl+F5) o prueba en una ventana de incógnito.

Solución de problemas comunes

A veces las cosas no salen a la primera. Aquí tienes los problemas más frecuentes y cómo resolverlos:

Error 404 en todas las páginas (menos la principal)

Causa: El .htaccess no tiene las reglas correctas o mod_rewrite no está activo.
Solución: Verifica que mod_rewrite esté activo en cPanel (Paso 1). También revisa que el código del .htaccess esté bien escrito, sin espacios extra.

Error 500 (Internal Server Error)

Causa: El archivo .htaccess tiene un error de sintaxis.
Solución: Revisa el código. Asegúrate de que no hay líneas en blanco al inicio o al final. Si el error persiste, renombra el archivo a .htaccess_old y crea uno nuevo con el código limpio.

Las URLs siguen siendo feas (con `index.php`)

Causa: El .htaccess no se está leyendo o PrestaShop no lo generó bien.
Solución: Desde el panel de admin de PrestaShop, ve a SEO y URLs y haz clic en "Guardar" de nuevo. Esto fuerza a PrestaShop a intentar regenerar el .htaccess. Si no funciona, edítalo manualmente como te expliqué arriba.

No tengo permisos para editar .htaccess

Causa: El archivo es de solo lectura.
Solución: En cPanel, haz clic derecho sobre el archivo, selecciona "Cambiar permisos" y pon 644 (lectura y escritura para el usuario, solo lectura para el grupo y otros). Luego edítalo.

[INFO] Si después de todo esto no funciona, contacta con tu proveedor de hosting. A veces tienen configuraciones especiales que bloquean la reescritura de URLs.

Preguntas frecuentes (FAQ)

¿Puedo desactivar las URLs amigables si algo sale mal?

Sí. Ve a SEO y URLs en PrestaShop, desactiva la opción y guarda. Luego elimina o renombra el archivo .htaccess para volver a las URLs originales.

¿Afecta esto al rendimiento de mi tienda?

No. De hecho, puede mejorar ligeramente el rendimiento porque el servidor procesa URLs limpias más rápido que las que tienen parámetros.

¿Necesito hacer algo más para el SEO?

Sí, las URLs amigables son solo el primer paso. También deberías:

Configurar los títulos y meta descripciones de cada producto y categoría.
Crear un sitemap (PrestaShop lo genera automáticamente).
Usar redirecciones 301 si cambias URLs antiguas.

¿Y si mi hosting usa Syspanel en lugar de cPanel?

Si tu panel es Syspanel (antes HestiaCP), el proceso es similar pero accedes por el puerto 2106. Busca la sección de "Reescritura de URLs" o "Apache" dentro de Syspanel. El resto de pasos (editar .htaccess) son idénticos.

¿Las URLs amigables funcionan con todas las versiones de PrestaShop?

Sí, desde PrestaShop 1.5 en adelante. En versiones muy antiguas (1.4 o anteriores) puede que necesites un módulo adicional, pero si estás en una versión moderna, no hay problema.

Resumen final

Activar las PrestaShop friendly URLs desde cPanel es un proceso de 4 pasos:

Verifica que mod_rewrite esté activo en cPanel.
Activa la opción en PrestaShop (SEO y URLs).
Crea o edita el archivo .htaccess con el código correcto.
Prueba que todo funcione.

Con esto, tu tienda tendrá URLs amigables PrestaShop que mejorarán tu SEO y la experiencia de tus clientes. Recuerda que si tienes algún problema, el soporte de tu hosting (como yo) está para ayudarte.

[TIP] Guarda siempre una copia de tu .htaccess original antes de modificarlo. Así, si algo falla, puedes restaurarlo fácilmente.

¡Ahora ya puedes presumir de una tienda más profesional y optimizada para buscadores! Si tienes dudas, déjalas en los comentarios. Estoy aquí para echarte una mano.