Mi tema de Shopify ha dejado de funcionar tras una actualización: ¿qué debo hacer?

¿Su tema de Shopify ha dejado de funcionar después de una actualización? Descubra cómo funcionan las actualizaciones de temas, por qué se pierden las personalizaciones y cómo restaurar su tienda con seguridad.

Abrir un ticket de soporte

Ha actualizado su tema de Shopify, o alguien lo ha hecho por usted, y ahora algo se ve o funciona de otra manera. Quizá ha desaparecido una sección, el diseño está descolocado, falta una función personalizada o el carrito ya no se comporta como antes.

Entre los síntomas habituales están:

  • faltan secciones o bloques personalizados
  • los colores, las fuentes o los espaciados han cambiado
  • una función añadida por un desarrollador ya no funciona
  • ha desaparecido el widget de una app, como las reseñas o una guía de tallas
  • el carrito o el botón "añadir al carrito" se comporta de forma distinta
  • las páginas se ven bien en ordenador, pero no en el móvil

La buena noticia es que en Shopify una actualización del tema normalmente no destruye el tema anterior. En la mayoría de los casos la versión anterior sigue en su biblioteca de temas, y puede volver a ella mientras averigua qué ha cambiado.

Esta guía explica cómo funcionan en general las actualizaciones de temas, por qué las personalizaciones pueden no trasladarse, cómo restaurar la versión anterior con seguridad y cómo evitar el mismo problema la próxima vez.

¿Cómo funcionan las actualizaciones de temas de Shopify?

Un tema de Shopify es un conjunto de plantillas, secciones, ajustes y código que controla el aspecto y el comportamiento de su tienda.

Cuando un tema de la Shopify Theme Store tiene una nueva versión, Shopify suele permitirle añadir la versión actualizada a su biblioteca de temas en lugar de sobrescribir el tema que está usando. Los pasos exactos pueden variar según el tema y según cómo presente Shopify las actualizaciones en ese momento, pero la idea general es:

  • la actualización llega como una nueva copia del tema
  • los ajustes hechos en el editor de temas por lo general se trasladan cuando es posible
  • los cambios hechos directamente en el código del tema por lo general no se trasladan
  • su tema actual permanece en la biblioteca hasta que lo elimine

Por eso una actualización puede parecer rota aunque no se haya "perdido" nada: la nueva versión simplemente no incluye el código personalizado que se añadió a la anterior.

Los temas comprados en otros sitios, o los temas a medida creados por un desarrollador, pueden no actualizarse así en absoluto. Puede que haya que actualizarlos a mano, archivo por archivo.

¿Por qué ha dejado de funcionar mi tema después de la actualización?

El código personalizado no se ha trasladado

Si un desarrollador, una agencia o una app editó los archivos del tema, esas modificaciones solo existen en la versión anterior. Ejemplos habituales:

  • secciones o snippets personalizados
  • cambios en la página de producto o en el carrito
  • código de seguimiento o de analítica
  • pequeñas correcciones de estilo
  • código añadido por una app durante su instalación

La nueva versión parte del código original del desarrollador del tema, así que faltan estos cambios.

Las secciones y los ajustes han cambiado en la nueva versión

Los desarrolladores de temas a veces renombran, fusionan o eliminan secciones y ajustes entre versiones. Un ajuste del que dependía puede funcionar ahora de otra manera o no existir. El contenido vinculado a una sección eliminada puede no aparecer.

Hay que volver a activar los app embeds y los app blocks

Muchas apps añaden funciones mediante app embeds o app blocks en el editor de temas. En una nueva versión del tema, puede que algunos tengan que volver a activarse o a colocarse en la sección correcta.

Las apps más antiguas que insertaban código directamente en los archivos del tema pueden no aparecer en absoluto en la nueva versión, porque ese código formaba parte del tema anterior.

La actualización se publicó de inmediato

Si el tema actualizado se publicó antes de que nadie lo revisara, los clientes ven los problemas al instante. Es el motivo más habitual por el que una actualización rutinaria se convierte en una urgencia.

Primero, averigüe qué ha cambiado

Antes de cambiar nada más, responda a estas preguntas:

  • ¿Cuándo se actualizó el tema y quién lo hizo?
  • ¿Se publicó la nueva versión o sigue sin publicar?
  • ¿La versión anterior sigue en su biblioteca de temas?
  • ¿Qué es exactamente lo que no funciona: una página, una sección, una función, el carrito?
  • ¿El problema ocurre en ordenador, en el móvil o en ambos?
  • ¿El tema anterior estaba personalizado con código, por un desarrollador o por apps?

Si la actualización la hizo otra persona, pregúntele qué versión instaló y si sabía que había código personalizado en el tema anterior.

¿Qué puede probar con seguridad?

Vaya a su biblioteca de temas

Vaya a Online Store → Themes (Tienda online → Temas). Verá su tema actual (publicado) y una biblioteca de otros temas. Busque la versión anterior: a menudo tiene el mismo nombre con un número de versión o una fecha distintos.

Previsualice la versión anterior

Previsualice la versión anterior antes de hacer nada. La vista previa no cambia lo que ven los clientes. Compruebe que sigue viéndose y funcionando como espera, incluido el carrito.

Publique la versión anterior si es necesario

Si la tienda está claramente rota y la versión anterior funciona, publicarla suele ser la forma más rápida de restablecer la tienda para los clientes. Después puede trabajar con calma en la nueva versión, sin publicar.

Antes de publicar, piense en todo lo que haya cambiado en la nueva versión desde la actualización, como contenido nuevo en las secciones o ajustes nuevos. Esos cambios pueden no existir en la versión anterior. Anótelos para poder volver a aplicarlos más adelante.

Revise los app embeds y los bloques

Abra el editor de temas del tema al que le falta una función de una app y revise la sección de app embeds. Si el embed de una app está desactivado, activarlo puede recuperar la función. Algunas apps también necesitan que su bloque se vuelva a colocar en una sección concreta.

Conserve ambas versiones

No elimine la versión anterior. Contiene el código personalizado que hay que trasladar a la nueva versión. Manténgala en la biblioteca hasta que la nueva versión esté completa y probada.

¿Qué debe evitar?

Evite:

  • eliminar el tema anterior de la biblioteca
  • editar el código del tema publicado sin un duplicado
  • instalar otra actualización encima de una que no funciona
  • desinstalar apps para "hacer limpieza" antes de saber qué hacen
  • copiar archivos del tema anterior al nuevo sin entenderlos
  • dar por hecho que la versión anterior se volverá a actualizar sola más adelante

Cambie una sola cosa cada vez y previsualice cada cambio antes de publicar.

¿Cómo evitarlo la próxima vez?

Una actualización del tema debe tratarse como cualquier otro cambio en una tienda en producción:

  1. Duplique primero. Antes de editar código o aplicar una actualización, haga un duplicado del tema publicado. No cuesta nada y le da una alternativa limpia a la que volver.
  2. Lleve un registro del código personalizado. Una breve lista de qué se ha cambiado, dónde y por qué facilita mucho las actualizaciones.
  3. Actualice en la biblioteca, no en el tema publicado. Añada la nueva versión, déjela sin publicar y revísela con atención.
  4. Vuelva a aplicar las personalizaciones en la nueva versión antes de publicarla.
  5. Pruebe los recorridos importantes: página de inicio, colección, página de producto, carrito, inicio del checkout, vista móvil.
  6. Publique en un momento tranquilo y conserve la versión anterior durante un tiempo por si la necesita.

¿Cuándo debe pedir soporte técnico?

Es buena idea pedir ayuda cuando:

  • el tema anterior contiene código personalizado y no sabe qué hace
  • se ven afectados el carrito, el inicio del checkout o las opciones de producto
  • las apps que antes funcionaban ya no aparecen
  • la versión anterior no está en la biblioteca
  • necesita las funciones de la nueva versión pero también sus antiguas personalizaciones
  • el tema está hecho a medida o no procede de la Theme Store
  • ya ha probado algunos cambios y no sabe en qué estado se encuentra el tema

No necesita saber exactamente qué ha fallado antes de pedir ayuda.

¿Qué información debe reunir?

Resultan útiles los siguientes datos:

  • la URL de su tienda
  • el nombre del tema y los números de la versión anterior y de la nueva
  • cuándo se hizo la actualización y quién la hizo
  • si la nueva versión está publicada
  • qué no funciona, con capturas de pantalla
  • una lista de las personalizaciones conocidas y de las apps que interactúan con el tema

Si alguien tiene que trabajar en su tema, añádalo como miembro del personal o como colaborador desde el panel de administración de Shopify. No envíe la contraseña de administrador por email.

Cómo puede ayudarle D4Hub

D4Hub puede ayudarle a:

  • identificar la última versión que funcionaba y restaurarla con seguridad
  • comparar la versión anterior y la nueva del tema para encontrar el código personalizado
  • trasladar las personalizaciones a la nueva versión
  • volver a activar y colocar los app embeds y los bloques
  • probar la página de producto, el carrito y el inicio del checkout en la nueva versión
  • documentar sus personalizaciones para facilitar las futuras actualizaciones
  • establecer un proceso más seguro para las actualizaciones del tema

Puede solicitar ayuda en cualquier momento, tanto si solo necesita encontrar la versión correcta como si quiere que nos encarguemos de toda la actualización.

Abrir un ticket de soporte

Para usuarios con experiencia técnica: comparar y restaurar versiones del tema

Estos pasos son para usuarios que se manejan con el editor de temas y el editor de código de Shopify. Trabaje siempre en un duplicado, nunca en el tema publicado, y conserve la versión anterior hasta que la nueva esté completamente probada.

Duplique antes que nada

En Online Store → Themes (Tienda online → Temas), use el menú de acciones de su tema publicado para duplicarlo. Haga lo mismo con cualquier versión que vaya a editar. Un duplicado es su red de seguridad.

También puede descargar una copia de los archivos de un tema desde el menú de acciones del tema. Shopify envía el archivo por email a la cuenta, así tendrá una copia sin conexión.

Encuentre el código personalizado en la versión anterior

Abra el editor de código de la versión anterior (en el menú de acciones del tema, elija editar el código). Busque:

  • archivos que no existen en la nueva versión, a menudo en las carpetas sections y snippets
  • archivos cuyo nombre hace referencia a una app o a una función personalizada
  • cambios recientes: el editor de código le permite ver versiones anteriores de un archivo, lo que ayuda a detectar qué se ha editado

Haga una lista de los archivos y cambios que encuentre antes de mover nada.

Compare los archivos entre versiones

Para una comparación más fiable, descargue ambas versiones y compare los archivos en su ordenador con una herramienta de comparación de archivos. Los desarrolladores que usan Shopify CLI pueden descargar cada tema en local para compararlos. Las diferencias en los archivos que sabe que se personalizaron son las que hay que trasladar.

No copie archivos completos de la versión anterior a la nueva. Un archivo también puede contener cambios del desarrollador del tema de los que depende la nueva versión. Copie solo las partes personalizadas y previsualice después de cada cambio.

Revise los app embeds y los bloques

En la nueva versión, abra el editor de temas y:

  1. Revise la sección de app embeds y active los embeds que necesitan sus apps.
  2. Revise las secciones donde antes aparecían app blocks y vuelva a añadirlos donde haga falta.
  3. Previsualice la página de producto, el carrito y cualquier página en la que las apps muestren contenido.

Pruebe antes de publicar

Previsualice la nueva versión y pruebe:

  • la página de inicio, una página de colección y una página de producto
  • las opciones y variantes de producto
  • añadir al carrito, la página o el panel lateral del carrito y el inicio del checkout
  • móvil y ordenador
  • cualquier función que dependiera de código personalizado o de apps

Publique solo cuando todo esto funcione. Conserve la versión anterior en la biblioteca durante un tiempo después.

Preguntas frecuentes

¿La actualización ha borrado mi tema anterior?

Normalmente no. En los temas de la Shopify Theme Store, la actualización suele añadirse como una versión independiente en su biblioteca de temas, y la versión anterior permanece ahí salvo que alguien la elimine.

¿Por qué faltan mis personalizaciones?

Los cambios hechos directamente en el código del tema por lo general no se trasladan a una nueva versión del tema. Los ajustes hechos en el editor de temas normalmente sí, siempre que la nueva versión los admita.

¿Puedo simplemente volver a la versión anterior?

En la mayoría de los casos, sí. Previsualice la versión anterior, compruebe que funciona y publíquela. Antes, anote los cambios que haya hecho en la nueva versión, porque pueden no existir en la anterior.

¿Tengo que actualizar mi tema?

Las actualizaciones pueden aportar correcciones, nuevas funciones y compatibilidad con los cambios de Shopify, así que conviene mantener los temas razonablemente al día. Lo más seguro es actualizar en la biblioteca, volver a aplicar las personalizaciones y probar antes de publicar.

El widget de mi app ha desaparecido después de la actualización. ¿Está rota la app?

Probablemente no. Revise los app embeds y los app blocks en el editor de temas de la nueva versión. Algunas apps necesitan volver a activarse o colocarse después de un cambio de tema.

¿Puede D4Hub actualizar mi tema sin perder las personalizaciones?

D4Hub puede comparar las versiones, trasladar su código personalizado y probar la nueva versión antes de que se publique. El objetivo es que los clientes vean el tema actualizado solo cuando funcione como se espera.