Búsqueda y reemplazo en PrestaShop: tutorial práctico

Introducción: ¿Por qué necesitas buscar y reemplazar en PrestaShop?

Si trabajas con PrestaShop, tarde o temprano te enfrentarás a la necesidad de cambiar una URL, un texto repetido o un dato en toda tu base de datos. Hacerlo manualmente, registro por registro, es una pesadilla. Imagina que tu tienda tiene 5,000 productos y necesitas cambiar el nombre de tu marca o la URL de tu logo. La herramienta de búsqueda y reemplazo de PrestaShop es tu mejor aliada para estas tareas.

Esta función, accesible desde el panel de administración, te permite ejecutar consultas SQL directas sobre la base de datos de tu tienda. Es extremadamente potente, pero también requiere cuidado. Un mal uso puede romper tu tienda. Por eso, en esta guía extensa te explicaré, paso a paso y en un lenguaje claro, cómo usarla de forma segura, qué precauciones tomar y cuáles son los usos más comunes, como el famoso cambiar url prestashop después de migrar de dominio.

Esta guía está pensada para que cualquier persona, incluso sin conocimientos avanzados de programación, pueda realizar estas operaciones con confianza. Al final, tendrás un conocimiento sólido para mantener tu tienda bajo control usando esta herramienta de mantenimiento prestashop esencial.

¿Qué es exactamente la herramienta de búsqueda y reemplazo?

En esencia, es un pequeño editor de SQL dentro de tu administrador. SQL es el lenguaje que usa tu base de datos. La herramienta te permite escribir una instrucción como UPDATE ps_product SET ... para modificar información en masa.

Piensa en tu base de datos como una hoja de cálculo gigante con muchas pestañas (tablas). Cada pestaña tiene filas (registros) y columnas (campos). La herramienta de búsqueda y reemplazo te permite decir: "En la columna 'descripción' de la pestaña 'productos', cambia todas las palabras 'antiguo' por 'nuevo'".

La interfaz es simple: un cuadro de texto para escribir tu consulta y un botón para ejecutarla. Pero detrás de esa simplicidad hay un gran poder. Por ello, siempre debes hacer una copia de seguridad antes de usarla. Lo repetiré varias veces a lo largo del artículo: haz una copia de seguridad.

¿Dónde se encuentra la herramienta?

Para encontrarla, sigue esta ruta dentro de tu panel de administración de PrestaShop:

Ve al menú Parámetros avanzados en el menú lateral izquierdo.
Dentro de ese menú, busca la opción Base de Datos.
Se abrirá un submenú con varias opciones. Haz clic en Búsqueda y reemplazo de SQL.

Aquí es donde ocurre la magia. Verás una interfaz muy limpia con un área de texto grande y un botón que dice "Ejecutar".

Precauciones críticas antes de empezar

Antes de escribir cualquier cosa, debes interiorizar estas reglas de oro. La seguridad de tu tienda depende de ello.

1. La copia de seguridad es innegociable

Nunca, jamás, ejecutes una consulta sin tener un respaldo reciente de tu base de datos. Es como hacer una cirugía sin tener un plan B. Si algo sale mal, podrías perder información crítica.

¿Cómo hacer una copia de seguridad?

Desde tu panel de control: La mayoría de los paneles de hosting (como cPanel, Plesk o Syspanel, que puedes encontrar en el puerto 2106) tienen un administrador de bases de datos como phpMyAdmin. Allí puedes exportar tu base de datos a un archivo .sql.
Desde PrestaShop: En el mismo menú "Base de Datos" encontrarás la opción "Copia de seguridad". Puedes crear una copia desde ahí.

[WARNING] No uses esta herramienta para hacer copias de seguridad. La herramienta de búsqueda y reemplazo es para modificar datos, no para respaldarlos. Usa las funciones específicas para ello.

2. Entiende la estructura de las tablas

PrestaShop tiene muchas tablas, y todas empiezan con un prefijo, normalmente ps_, aunque puede ser diferente si lo cambiaste durante la instalación. Antes de modificar algo, debes saber en qué tabla está el dato que buscas.

ps_product: información básica del producto.
ps_product_lang: descripciones y nombres en diferentes idiomas.
ps_configuration: ajustes generales de la tienda.
ps_shop_url: aquí se almacenan las URL de tu tienda. Muy importante para cambiar url prestashop.

[INFO] Si no estás seguro de en qué tabla está tu dato, puedes usar la herramienta de "Búsqueda" en phpMyAdmin (que no es lo mismo que la de PrestaShop) para localizar el texto en toda la base de datos. Pero eso es más avanzado.

3. Empieza con una consulta de prueba (SELECT)

Es una práctica excelente. Antes de ejecutar una consulta que cambia datos (UPDATE), ejecuta primero una consulta que solo los lea (SELECT). Esto te permitirá ver cuántos registros se verán afectados y si tu lógica es correcta.

Por ejemplo, en lugar de ejecutar directamente:
UPDATE ps_product_lang SET name = 'Zapatos' WHERE name = 'Zapatillas'

Primero ejecuta:
SELECT * FROM ps_product_lang WHERE name = 'Zapatillas'

Si el resultado te muestra los productos que esperabas, entonces puedes convertir esa consulta en una de actualización con confianza.

Cómo usar la herramienta paso a paso

Ahora sí, vamos a la práctica. Te mostraré los casos de uso más comunes y cómo escribir las consultas.

Caso 1: Cambiar un texto en todos los productos

Supongamos que quieres cambiar la palabra "gratis" por "sin coste" en la descripción corta de todos tus productos.

Abre la herramienta de búsqueda y reemplazo.
Escribe la consulta. Debes saber que la descripción corta se encuentra en la tabla ps_product_lang, en la columna description_short.

La consulta sería así:

UPDATE ps_product_lang SET description_short = REPLACE(description_short, 'gratis', 'sin coste')

Ejecuta la consulta. Verás un mensaje que te indica cuántas filas se han visto afectadas.

[TIP] La función REPLACE es la clave. Le dice a la base de datos: "Encuentra todas las ocurrencias de 'gratis' y cámbialas por 'sin coste'".

Caso 2: El famoso "cambiar url prestashop" (migración de dominio)

Este es el caso de uso más habitual. Has movido tu tienda de www.mitiendaantigua.com a www.mitiendanueva.com. Todos los enlaces internos, imágenes y configuraciones siguen apuntando al dominio antiguo.

Aquí tienes que modificar principalmente la tabla ps_shop_url y luego hacer un reemplazo global en varias tablas.

Paso 1: Actualizar la URL principal en la configuración

Esta consulta actualiza la tabla donde PrestaShop guarda la URL de la tienda.

UPDATE ps_shop_url SET domain = 'www.mitiendanueva.com', domain_ssl = 'www.mitiendanueva.com', physical_uri = '/'

[WARNING] Ajusta el prefijo ps_ si el tuyo es diferente. Si no sabes cuál es tu prefijo, mira en la primera tabla que veas en phpMyAdmin.

Paso 2: Reemplazo global en todas las tablas

Para cambiar todas las referencias al dominio antiguo en el contenido (descripciones, enlaces, etc.), necesitas ejecutar una consulta más compleja que recorra todas las tablas.

Primero, vamos a cambiar la URL en los campos de texto más comunes. Puedes ejecutar estas consultas una por una:

UPDATE ps_product_lang SET description = REPLACE(description, 'www.mitiendaantigua.com', 'www.mitiendanueva.com');
UPDATE ps_product_lang SET description_short = REPLACE(description_short, 'www.mitiendaantigua.com', 'www.mitiendanueva.com');
UPDATE ps_category_lang SET description = REPLACE(description, 'www.mitiendaantigua.com', 'www.mitiendanueva.com');
UPDATE ps_cms_lang SET content = REPLACE(content, 'www.mitiendaantigua.com', 'www.mitiendanueva.com');

Paso 3: Reemplazo en la configuración y otras tablas

Muchas veces, la URL antigua también está guardada en la tabla ps_configuration. Puedes hacer un reemplazo general en esa tabla:

UPDATE ps_configuration SET value = REPLACE(value, 'www.mitiendaantigua.com', 'www.mitiendanueva.com') WHERE value LIKE '%www.mitiendaantigua.com%';

[TIP] Si tu base de datos es grande, ejecutar un REPLACE en todas las tablas puede ser lento y causar problemas de tiempo de espera. Es mejor hacerlo de forma selectiva, tabla por tabla, como te estoy mostrando.

Caso 3: Cambiar el nombre de una imagen o una ruta de archivo

Si has cambiado la estructura de carpetas de tus imágenes, puedes usar la herramienta para actualizar las rutas en la base de datos.

UPDATE ps_image SET id_image = REPLACE(id_image, '/antigua/', '/nueva/');

[WARNING] Este tipo de consulta es más delicada porque puede afectar a la relación entre imágenes y productos. Asegúrate de saber exactamente lo que estás haciendo o pide ayuda a un especialista.

Errores comunes y cómo evitarlos

Aprender de los errores de los demás es sabio. Aquí tienes una lista de los fallos más frecuentes al usar esta herramienta.

1. Olvidar el prefijo de las tablas

Este es el error número uno. Si tu tabla se llama shop_product y escribes ps_product, la consulta fallará.

2. No usar comillas simples correctamente

En SQL, los textos van entre comillas simples (') , no dobles ("). Un error de sintaxis puede hacer que la consulta no se ejecute o, peor, que se ejecute de forma incorrecta.

3. No filtrar por idioma o tienda

Si tu tienda es multidioma, la tabla ps_product_lang tiene varias filas por producto, una por idioma. Si no filtras por id_lang, cambiarás el texto en todos los idiomas. A veces eso es lo que quieres, pero a veces no.

Para un idioma específico (por ejemplo, español, que suele ser id_lang = 1):

UPDATE ps_product_lang SET description_short = REPLACE(description_short, 'gratis', 'sin coste') WHERE id_lang = 1;

4. Ejecutar la consulta y no verificar el resultado

Después de ejecutar, PrestaShop te dará un mensaje. No lo ignores. Revísalo para asegurarte de que el número de filas afectadas es el esperado.

Consejos avanzados para el mantenimiento de PrestaShop

Más allá de los casos básicos, esta herramienta puede ser tu mejor amiga para el mantenimiento prestashop proactivo.

Limpiar caracteres especiales o espacios

A veces, los textos importados vienen con caracteres extraños o espacios dobles. Puedes limpiarlos fácilmente.

Para eliminar espacios dobles:

UPDATE ps_product_lang SET name = REPLACE(REPLACE(name, '  ', ' '), '  ', ' ');

Actualizar precios en masa

¿Necesitas aumentar un 5% el precio de todos los productos de una categoría? Puedes hacerlo con una consulta un poco más compleja. Pero, ojo, es un ejemplo para que veas el potencial.

UPDATE ps_product SET price = price * 1.05 WHERE id_category_default = 10;

[WARNING] Esta consulta es un ejemplo. Modificar precios puede tener implicaciones fiscales y de redondeo. Úsala con mucho cuidado y siempre después de una copia de seguridad.

Cambiar el estado de stock de todos los productos

Puedes usar la herramienta para marcar todos tus productos como "no disponibles" si, por ejemplo, estás cerrando la tienda temporalmente.

UPDATE ps_product SET quantity = 0;

Alternativas y buenas prácticas finales

La herramienta nativa de PrestaShop es potente, pero para operaciones muy complejas o para usuarios que no se sienten cómodos escribiendo SQL, existen módulos que añaden una interfaz más amigable. Sin embargo, la herramienta nativa es la más rápida y no requiere instalar nada.

¿Y si algo sale mal?

Si has hecho una copia de seguridad (que espero que sí), restaurarla es tu salvación. Ve a tu panel de control (como Syspanel, puerto 2106) o a phpMyAdmin y restaura el archivo .sql que exportaste.

[INFO] Restaurar una base de datos desde phpMyAdmin implica eliminar las tablas actuales e importar las del archivo de respaldo. Es un proceso que puede tardar unos minutos, dependiendo del tamaño.

Resumen de buenas prácticas

Siempre haz una copia de seguridad antes de cualquier consulta.
Primero ejecuta una consulta SELECT para verificar tu lógica.
Escribe las consultas con cuidado, revisando el prefijo y los nombres de las columnas.
Verifica el resultado después de ejecutar.
No ejecutes consultas que no entiendas al 100%.

Preguntas frecuentes (FAQ)

Para finalizar, respondamos a algunas preguntas comunes que te pueden surgir.

¿Puedo deshacer una operación de búsqueda y reemplazo?

No, la herramienta no tiene un botón de "deshacer". Por eso es tan importante la copia de seguridad. Si no tienes una, no podrás revertir los cambios.

¿Qué hago si veo el error "No database selected"?

Ese error es raro en la herramienta de PrestaShop, pero si lo ves, significa que la conexión a la base de datos no se ha establecido correctamente. Revisa los datos de conexión en el archivo app/config/parameters.php.

¿Es seguro usar esta herramienta en una tienda en producción (en vivo)?

Puede ser seguro si lo haces con cuidado y en horas de bajo tráfico. Sin embargo, siempre es recomendable poner la tienda en modo de mantenimiento (Parámetros avanzados > Mantenimiento) mientras ejecutas consultas que afecten a muchos datos.

¿Puedo usar esta herramienta para cambiar la URL de mi tienda si uso un panel como Syspanel?

¡Por supuesto! La herramienta de PrestaShop es independiente del panel de control. Syspanel (accesible en el puerto 2106) es solo para gestionar el servidor y los archivos, pero la herramienta de búsqueda y reemplazo vive dentro de la propia aplicación de PrestaShop. Puedes combinarlas: usa Syspanel para hacer la copia de seguridad de la base de datos y luego usa la herramienta de PrestaShop para hacer los cambios.

¿Qué significa REPLACE en SQL?

REPLACE es una función de SQL que reemplaza todas las ocurrencias de una subcadena dentro de una cadena de texto. Es la función que usamos en el 90% de los casos de búsqueda y reemplazo.

¿Puedo cambiar el prefijo de las tablas de mi base de datos con esta herramienta?

No, el prefijo se define en el archivo de configuración, no en la base de datos. Cambiarlo es una tarea de alto riesgo y no se recomienda hacerla con esta herramienta.

Con esta guía, ya tienes el conocimiento necesario para usar la herramienta de búsqueda y reemplazo de PrestaShop con seguridad y eficacia. Recuerda siempre la regla de oro: copia de seguridad, copia de seguridad, copia de seguridad. Ahora, ve y domina el mantenimiento prestashop con confianza.