Copias no actualizadas de algunos archivos de plantilla WooCommerce

[ 22 mayo 2018 ] [ Actualizado: 5 junio 2018 ] [ Autor: Jhon Marreros Guzmán ][ Plugins - Avanzado] [ ]

Si luego de actualizar Woocommerce, te aparece el mensaje: «Tu theme contiene copias no actualizadas de algunos archivos de plantilla WooCommerce», no te preocupes, en este artículo aprenderás cómo solucionar esto a través de un ejemplo práctico.

Generalidades

En un artículo anterior habíamos visto cómo modificar una plantilla de Woocommerce, vimos que si tenemos una carpeta llamada woocommerce como parte de los archivos del theme, es en esta carpeta en donde podemos sobreescribir los archivos de vista de Woocommerce.

Los archivos de vista son archivos .php que al ejecutarse crean el HTML final que se mostrará al usuario

los archivos de vista en Woocommerce se encuentran en la siguiente ruta:
/wp-content/plugins/woocommerce/templates/

Actualizaciones de Woocommerce

Las versiones recientes de Woocommerce validan que la sobreescritura que hacen los themes a los archivos de vista estén acorde con la versión de Woocommerce, si los archivos que el theme sobreescribe no son de la misma versión, aparecerá un mensaje similar a:

mensaje Copias no actualizadas de algunos archivos de plantilla WooCommerce

La sobreescritura de archivos Woocommerce se hace en la siguiente ruta:
/wp-content/themes/TUTHEME/woocommerce/

Es posible que tu theme en el front-end siga funcionando normalmente, esto es debido a la compatibilidad hacia atrás de las modificaciones que hace Woocommerce.

Opción 1 – Actualizar el theme

Esta es la opción más sencilla y más obvia, revisa primero si tu theme WordPress tiene actualizaciones pendientes, ya que es probable que los desarrolladores hayan visto este problema y hayan corregido.

Opción 2 – Modificación de los archivos del theme

En caso tu theme no tenga actualizaciones y quieras solucionar esto, te queda la opción de hacerlo manualmente, modificando los archivos del theme, principalmente los archivos de la carpeta woocommerce.

Para saber qué archivos necesitas modificar, puedes revisar: Woocoomerce > Estado del sistema, al final, en la sección de Anulaciones, verás el reporte de archivos, aparecerá algo similar a la siguiente imagen.

Woocommerce - estado del sistema, archivos obsoletos

En la imagen de ejemplo se muestra el reporte de modificaciones necesarias para una versión antigua del theme epimeteo_wp.

No necesariamente todos los archivos a modificar están dentro de la carpeta woocommece, hay un archivo llamado product-searchform.php que esta fuera de esta carpeta.

Una vez has identificado los archivos a modificar, la idea es compararlos con los archivos vista originales de Woocommerce, es decir, tienes que localizar los archivos originales en : /wp-content/plugins/woocommerce/templates/

Los cambios más comunes que harás al modificar tus archivos son:

El archivo no tiene comentarios de metadata o la metadata esta incompleta o desactualizada, revisa que la metadata de comentarios sea similar a los archivos originales de Woocommerce, especialmente @version
Las funciones usadas han cambiado de nombre, en este caso deberás revisar las funciones equivalentes desde el archivo original y usar las nuevas funciones en los archivos de tu theme
Cambios en la estructura, si ves que la estructura HTML ha cambiado, opcionalmente puedes cambiar la estructura HTML que generan tus archivos.

¿Aún con dudas?, en el siguiente video se muestra un ejemplo de modificación de archivos de un theme WooCommerce.