Configurar .htaccess de PrestaShop en Syspanel fácilmente

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

El archivo .htaccess es, en términos sencillos, un archivo de configuración que le dice a tu servidor web (normalmente Apache) cómo debe comportarse cuando alguien visita tu tienda online. En el contexto de PrestaShop, este pequeño archivo de texto es una pieza fundamental, ya que gestiona desde la reescritura de URLs amigables hasta la seguridad básica de tu panel de administración.

Cuando instalas PrestaShop en tu hosting, el sistema genera automáticamente un .htaccess con reglas específicas. Sin embargo, hay momentos en los que necesitas configurar .htaccess PrestaShop manualmente, ya sea para cambiar la estructura de tus URLs, redirigir dominios, mejorar la seguridad o simplemente porque tu tienda no carga correctamente tras una migración.

En este artículo, te voy a guiar paso a paso para que aprendas a editar .htaccess PrestaShop de forma segura y efectiva dentro de Syspanel, el panel de control que utilizamos en nuestros servicios de hosting. No necesitas ser un experto en programación; solo sigue las instrucciones y presta atención a los avisos importantes que te iré dejando.

Antes de empezar: ¿Qué es Syspanel y cómo acceder a él?

Para quienes no lo sepan, Syspanel es el nombre que le damos a nuestro panel de control de hosting (basado en HestiaCP). Es la herramienta desde la cual gestionas tus dominios, bases de datos, cuentas de correo y, por supuesto, los archivos de tu sitio web.

El acceso a Syspanel se realiza a través de una URL específica que incluye el puerto 2106. Por ejemplo, algo así: https://tu-dominio.com:2106.

[TIP]: Si no recuerdas tu contraseña de acceso a Syspanel, puedes solicitarla desde el correo electrónico que registraste al contratar el servicio. O si lo prefieres, contacta con nuestro soporte técnico y te ayudaremos a restablecerla.

Paso 1: Localizar el archivo .htaccess de tu PrestaShop en Syspanel

Lo primero que debes hacer es entrar en Syspanel con tus credenciales. Una vez dentro, sigue esta ruta:

Accede al apartado "Archivos" o "Administrador de archivos". En Syspanel, este suele aparecer en el menú lateral izquierdo.
Navega hasta la carpeta pública de tu dominio. Normalmente, la ruta es /home/nombre-de-usuario/web/nombre-de-tu-dominio/public_html.
Busca el archivo llamado .htaccess. Es importante que actives la opción de "Mostrar archivos ocultos" en el administrador de archivos, ya que por defecto los archivos que empiezan con un punto están ocultos.

[WARNING]: Si no encuentras el archivo .htaccess, no te asustes. Puede que tu PrestaShop no lo haya generado aún. Esto ocurre, por ejemplo, si acabas de instalar la tienda y no has activado las URLs amigables. En ese caso, puedes crear uno nuevo, pero te recomiendo que primero actives las URLs amigables desde el panel de administración de PrestaShop para que el sistema lo genere automáticamente.

Paso 2: Haz una copia de seguridad ANTES de tocar nada

Este es el consejo más valioso que te voy a dar en todo el artículo: nunca edites el .htaccess sin hacer una copia de seguridad previa. Un error en este archivo puede dejar tu tienda completamente inaccesible (error 500, por ejemplo).

Para hacer la copia en Syspanel:

Haz clic derecho sobre el archivo .htaccess.
Selecciona la opción "Descargar" para guardarlo en tu ordenador.
También puedes seleccionar la opción "Copiar" y pegar el archivo en la misma carpeta con otro nombre, por ejemplo, .htaccess.bak.

[INFO]: Si alguna vez tu tienda da error 500 después de editar el archivo, lo único que tienes que hacer es restaurar la copia de seguridad. Es tu salvavidas.

Paso 3: Activar las URLs amigables (la razón más común para configurar .htaccess)

La razón más habitual por la que un usuario busca cómo configurar .htaccess PrestaShop es porque quiere activar las URLs amigables (es decir, que las URLs sean legibles, como tutienda.com/categoria/zapatillas en lugar de tutienda.com/index.php?id_category=3).

PrestaShop intenta modificar el .htaccess automáticamente cuando activas esta opción, pero a veces falla por permisos de escritura o por configuraciones del servidor. Si ese es tu caso, tendrás que hacerlo manualmente.

¿Cómo activar las URLs amigables desde el panel de PrestaShop?

Entra en el panel de administración de tu PrestaShop (normalmente en tudominio.com/admin).
Ve a "Parámetros avanzados" > "Rendimiento".
Busca la sección "URLs amigables" y actívala.
Guarda los cambios.

Si al hacer esto PrestaShop te muestra un mensaje de error indicando que no puede escribir el .htaccess, entonces tendrás que editarlo manualmente desde Syspanel.

¿Qué reglas debe contener tu .htaccess para URLs amigables?

PrestaShop necesita una serie de reglas de reescritura. Aunque el sistema las genera solo, si tienes que escribirlas a mano, un ejemplo básico sería:

# START DISABLE URL REWRITING
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^api/?(.*)$ webservice/dispatcher.php [QSA,L]
RewriteRule ^([a-z0-9]+)\-([a-z0-9]+)(\-[_a-zA-Z0-9-]*)/([_a-zA-Z0-9-]*)\.jpg$ img/p/$1-$2$3.jpg [L]
# ... (muchas más reglas)
</IfModule>
# END DISABLE URL REWRITING

[WARNING]: No copies y pegues reglas de internet sin saber lo que estás haciendo. Cada versión de PrestaShop tiene sus propias reglas. Lo mejor es que generes el .htaccess desde el propio PrestaShop o que contactes con soporte si ves que no se genera bien.

Paso 4: Editar el .htaccess desde Syspanel paso a paso

Ahora sí, vamos a la parte práctica. Te voy a enseñar a editar .htaccess PrestaShop desde el editor de archivos de Syspanel.

En el administrador de archivos de Syspanel, localiza el .htaccess.
Haz clic con el botón derecho sobre el archivo y selecciona "Editar" o "Edit".
Se abrirá un editor de texto plano en tu navegador. Aquí es donde puedes modificar el contenido.
Realiza los cambios que necesites. Por ejemplo, añadir una redirección 301 de un dominio a otro, o añadir cabeceras de seguridad.
Una vez terminado, pulsa el botón "Guardar".

Ejemplo práctico: Redirigir de HTTP a HTTPS

Un cambio muy común es forzar a que todos los visitantes usen la versión segura de tu tienda (HTTPS). Para ello, añade este bloque al inicio del archivo .htaccess:

RewriteEngine On
RewriteCond %{HTTPS} off
RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]

Ejemplo práctico: Bloquear el acceso a tu panel de administración por IP

Otra configuración útil es restringir el acceso a la carpeta /admin de PrestaShop. Esto añade una capa extra de seguridad.

<FilesMatch "\.(php)$">
Order Deny,Allow
Deny from all
Allow from 192.168.1.100
</FilesMatch>

Sustituye 192.168.1.100 por tu IP pública. Puedes saber cuál es tu IP pública buscando "cuál es mi IP" en Google.

[TIP]: Añadir cabeceras de seguridad como X-Frame-Options o X-Content-Type-Options también es una buena práctica para proteger tu tienda. Te recomiendo que investigues sobre ello en nuestra base de conocimientos.

Paso 5: ¿Y si algo sale mal? Cómo revertir los cambios

Si después de editar el archivo tu tienda deja de funcionar, no entres en pánico. Aquí tienes el plan de acción:

Vuelve a Syspanel y entra al administrador de archivos.
Si hiciste una copia de seguridad (¡espero que sí!), simplemente sube ese archivo de nuevo o renombra el .htaccess.bak a .htaccess.
Si no hiciste copia de seguridad, puedes eliminar el .htaccess por completo. PrestaShop regenerará uno automáticamente cuando vuelvas a entrar en el panel de administración y guardes la configuración de URLs amigables.

[WARNING]: Eliminar el .htaccess puede hacer que tus URLs dejen de ser amigables temporalmente, pero tu tienda seguirá funcionando. Es una solución de emergencia, no definitiva.

Errores comunes al configurar .htaccess en PrestaShop

Aquí te dejo una lista de los errores más típicos que veo en el soporte técnico, para que los evites:

No guardar el archivo con codificación UTF-8: Asegúrate de que el editor de Syspanel guarde el archivo en UTF-8 sin BOM. Si no, puede dar errores extraños.
Mezclar reglas de versiones antiguas: Si copias un .htaccess de PrestaShop 1.6 y lo usas en un PrestaShop 1.7 o 8, es muy probable que tengas problemas.
Olvidar el espacio después de RewriteRule: Un simple error de sintaxis puede tumbar toda la tienda.
Ignorar los permisos del archivo: El .htaccess debe tener permisos 644 o 664. Si está en 600 o 444, el servidor puede no leerlo correctamente.

[INFO]: Si necesitas cambiar los permisos del archivo, en Syspanel puedes hacerlo con clic derecho sobre el archivo > "Permisos" (o "Chmod").

Preguntas frecuentes (FAQ) sobre .htaccess en PrestaShop y Syspanel

¿Por qué PrestaShop no me deja guardar las URLs amigables?

Esto suele ser porque el archivo .htaccess no tiene permisos de escritura. Ve a Syspanel, verifica que los permisos sean 644 y que el propietario del archivo sea el usuario correcto de tu hosting.

¿Dónde está el archivo .htaccess en mi hosting?

En Syspanel, la ruta típica es /home/usuario/web/dominio/public_html/.htaccess. Recuerda activar la opción de "ver archivos ocultos".

¿Qué hago si mi tienda da error 500 tras editar el .htaccess?

Es un problema de sintaxis. Restaura la copia de seguridad que hiciste (o elimina el archivo) y vuelve a intentarlo con cambios más pequeños.

¿Puedo usar el .htaccess para redirigir mi tienda a otro dominio?

Sí, pero te recomiendo que lo hagas con una redirección 301 para no perder posicionamiento SEO. Puedes añadir un bloque como este:

Redirect 301 / https://nuevo-dominio.com/

¿Syspanel es igual que HestiaCP?

Syspanel es el nombre comercial de nuestro panel, que está basado en HestiaCP. La funcionalidad es la misma, pero nosotros lo personalizamos y lo integramos con nuestro sistema de soporte. Recuerda que el acceso es por el puerto 2106.

Consejos finales para dominar tu .htaccess en PrestaShop

Configurar el archivo .htaccess puede parecer intimidante al principio, pero con práctica y precaución, se convierte en una herramienta muy poderosa. Aquí van mis últimos consejos:

Haz cambios incrementales: No intentes cambiar 10 cosas a la vez. Haz un cambio, comprueba que funciona, y luego sigue.
Prueba siempre desde una ventana de incógnito: Así evitas problemas de caché del navegador y ves los cambios reales.
Consulta la documentación oficial de PrestaShop: Aunque esté en inglés, es la fuente de verdad para las reglas de reescritura.
Y si tienes dudas, contacta con nosotros: Para eso estamos. Nuestro equipo de soporte puede revisar tu .htaccess y ayudarte a configurarlo correctamente.

Espero que esta guía extensa te haya sido de gran ayuda. Recuerda: la clave está en la paciencia y en hacer siempre copias de seguridad. ¡Tu tienda PrestaShop te lo agradecerá!