Actualizar el editor masivo de WooCommerce de gratis a pro: un cambio limpio

La versión gratuita y la versión completa de BEAR son dos compilaciones del mismo plugin, no un plugin gratuito con un complemento encima. Nada dentro de la copia gratuita se desbloquea: para actualizar el editor masivo de WooCommerce de gratis a pro, sustituyes una compilación por la otra. Las dos no pueden funcionar a la vez. Hecho en el orden correcto, el cambio lleva un minuto y conserva tus ajustes y tu Historial. Hecho en el orden equivocado, acaba en un error fatal No se puede redeclarar (Cannot redeclare), en un Historial vacío o en un editor que sigue comportándose como la versión gratuita.

Cómo se relacionan la versión gratuita y la completa

Ambas compilaciones son el mismo código. Declaran las mismas clases y funciones de PHP (WOOBE, WOOBE_STORAGE, un conjunto de funciones woobe_), leen los mismos ajustes de la base de datos y escriben en las mismas tablas del Historial. La compilación gratuita tiene un interruptor que la limita, y esas limitaciones son también la forma más fácil de saber cuál de las dos se está ejecutando:

• el editor muestra 10 productos por página, diga lo que diga el ajuste;
• la pestaña Ayuda (Help) indica La versión actual del plugin es GRATUITA (Current version of the plugin is FREE), y la cabecera del editor tiene un botón Actualizar (Upgrade);
• la pestaña Historial indica que se pueden revertir las 2 últimas operaciones, y la pestaña Campos meta permite 2 campos meta;
• en la pestaña Edición masiva, muchos campos están en contenedores rojos sin la casilla selecciónalo para usarlo (select it to use); entre las taxonomías solo se pueden editar las categorías, y solo un atributo;
• en la pantalla de Plugins, la fila del plugin tiene un enlace ¡Hazte Pro! (Go Pro!).

Los paquetes actuales de ambas compilaciones usan la misma carpeta de plugin, wp-content/plugins/woo-bulk-editor. Eso es lo que hace posible un reemplazo limpio. Los paquetes antiguos de la versión completa usaban woocommerce-bulk-editor, y así es como muchos sitios acabaron con dos copias instaladas a la vez.

Actualizar el editor masivo de gratis a pro sobre la misma instalación

Esta es la forma recomendada, porque no se elimina nada y no se ejecuta ninguna rutina de desinstalación.

1. Toma el zip del plugin de la versión completa: woo-bulk-editor.zip. Si el archivo que tienes contiene otros archivos y carpetas, descomprímelo y usa el zip que hay dentro. Subir el archivo exterior termina con No se pudo instalar el paquete. No se encontraron plugins válidos. (The package could not be installed. No valid plugins were found.), como se explica en la FAQ sobre el error de instalación.
2. En WordPress ve a Plugins → Añadir nuevo plugin → Subir plugin (Upload Plugin), elige el zip y pulsa Instalar ahora (Install Now). La versión gratuita puede seguir activa.
3. WordPress encuentra la carpeta ya existente y muestra Este plugin ya está instalado. (This plugin is already installed.) con una tabla que compara el plugin actual y el subido. Comprueba el nombre y la versión del subido y pulsa Reemplazar el actual con el subido (Replace current with uploaded).
4. WordPress intercambia los archivos en la misma carpeta. Un plugin activo sigue activo; si estaba inactivo, pulsa Activar plugin (Activate Plugin).
5. Abre Productos → BEAR Bulk Editor y recarga la página una vez.

Los ajustes de columnas y los perfiles, los filtros guardados, los campos meta añadidos, los permisos del gestor de la tienda y las opciones globales se conservan, y también el Historial. Un detalle sobre el Historial: la propia compilación gratuita conserva solo las dos últimas ediciones individuales y las dos últimas operaciones masivas de cada usuario y elimina las filas más antiguas, así que las entradas anteriores ya habían desaparecido antes del cambio. A partir de ahora el Historial lo conserva todo, como se describe en la documentación del Historial.

Eliminar primero la versión gratuita: qué se conserva y qué se pierde

La otra vía habitual es Plugins → Desactivar → Eliminar para la versión gratuita, y luego subir y activar la completa. Funciona, con un coste. Eliminar el plugin desde la pantalla de Plugins ejecuta su rutina de desinstalación, que:

• borra las dos tablas del Historial, de modo que el Historial empieza vacío;
• elimina la memoria de trabajo del editor de cada usuario (el filtro actual y estados similares), de modo que el editor se abre sin filtro.

No toca los ajustes: las columnas, los perfiles, los campos meta, los permisos y las opciones globales se guardan por separado y siguen ahí cuando se activa la versión completa. Si el Historial te importa, usa el reemplazo directo descrito arriba, o elimina la carpeta de la versión gratuita por FTP o desde el administrador de archivos del hosting en lugar de usar eliminar (Delete): eliminar la carpeta no ejecuta la rutina de desinstalación.

Errores fatales «Cannot redeclare» y «Cannot declare class»

Mensajes como estos significan todos lo mismo: hay dos copias de BEAR instaladas en carpetas distintas, y PHP encontró dos veces la misma función o clase.

Fatal error: Cannot redeclare woobe_init_translates() (previously declared in .../plugins/woo-bulk-editor/index.php...)
Fatal error: Cannot redeclare function woobe_uninstall_cleanup() (previously declared in ...)
Fatal error: Cannot declare class WOOBE_STORAGE, because the name is already in use in .../lib/storage.php

El nombre que aparece en el mensaje depende de las versiones de las dos copias (las más antiguas fallan en woobe_init_translates, las actuales en woobe_uninstall_cleanup), no de nada que puedas configurar. La solución es siempre quedarse con una sola copia.

No se pudo activar la versión completa

Si WordPress dice El plugin no pudo activarse porque provocó un error fatal (Plugin could not be activated because it triggered a fatal error), todavía no se ha roto nada: WordPress probó el plugin y lo rechazó. Ve a la pantalla de Plugins, donde BEAR aparece ahora dos veces, y quédate solo con la copia que acabas de subir:

1. Desactiva todas las copias de BEAR.
2. Elimina la otra copia: borra su carpeta por FTP o desde el administrador de archivos para conservar el Historial, o pulsa eliminar en la pantalla de Plugins si el Historial no importa (consulta la sección anterior).
3. Activa la copia que queda.

Todo el sitio muestra «There has been a critical error»

Esto ocurre cuando ambas copias se activaron de una forma que WordPress no pudo probar, por ejemplo después de actualizar una de ellas. WordPress envía por correo al administrador del sitio un enlace al modo de recuperación, donde la pantalla de Plugins vuelve a funcionar. Sin ese correo, abre wp-content/plugins por FTP o desde el administrador de archivos del hosting y cambia el nombre de la carpeta de la copia que no quieres, por ejemplo a woocommerce-bulk-editor-off. El sitio vuelve a cargar, y la pantalla de Plugins informa de que el plugin se desactivó porque su archivo no existe. Después elimina esa copia como se describió antes.

La versión gratuita sigue apareciendo después del cambio

Comprueba las señales de la primera sección. Si el editor sigue mostrando 10 filas por página y la pestaña Ayuda sigue diciendo GRATUITA, el código que se ejecuta sigue siendo el de la versión gratuita. Las razones habituales:

• El reemplazo no se hizo. Se pulsó Cancelar y volver (Cancel and go back) en la pantalla de comparación, o el zip subido era otra vez la compilación gratuita. La tabla de comparación muestra el nombre y la versión de ambos; sube el zip correcto y elige Reemplazar el actual con el subido.
• Hay dos copias instaladas y se ejecuta la gratuita. La pantalla de Plugins lista BEAR dos veces, o un aviso de administración que empieza por Hola, parece que compraste e instalaste la versión premium de BEAR (Hello, looks like you bought and installed premium version of BEAR) te pide que desactives la versión gratuita. Cuando hay dos copias activas y ningún error fatal las detiene, se ejecuta la copia que se carga primero y la otra se retira con ese aviso. Quédate solo con la copia completa, como se describió antes.
• El navegador muestra una página antigua. Recarga el editor forzando la actualización; restablecer la caché de página en el navegador enumera las teclas de cada navegador.
• El servidor ejecuta archivos PHP antiguos. Algunos hostings mantienen PHP compilado en memoria sin comprobar si los archivos han cambiado. Si los archivos en disco son nuevos pero el comportamiento es antiguo, limpia la caché de PHP (OPcache) en el panel del hosting o pide al proveedor que reinicie PHP.

Actualizaciones posteriores y una lista de comprobación breve

Las versiones posteriores de la compilación completa se instalan de la misma forma: sube el nuevo woo-bulk-editor.zip y elige Reemplazar el actual con el subido. La tabla de comparación es una buena última comprobación de que estás sustituyendo la versión instalada por una compilación completa más reciente y no por la gratuita.

• Una sola entrada de BEAR en la pantalla de Plugins, activa, sin enlace ¡Hazte Pro!.
• El editor pagina más de 10 productos cuando pides más, y la pestaña Ayuda ya no dice GRATUITA.
• Tus columnas, filtros y campos meta están donde los dejaste.
• El Historial muestra tus operaciones anteriores si reemplazaste sobre la misma instalación, o empieza vacío si eliminaste antes la versión gratuita.

Si el cambio sigue sin funcionar, abre un tema en el foro de soporte de BEAR con el mensaje de error exacto, la lista de carpetas de BEAR en wp-content/plugins y las versiones que aparecen en la pantalla de Plugins.