Passer l'éditeur en masse WooCommerce de gratuit à pro : une bascule propre

La version gratuite et la version complète de BEAR sont deux builds du même plugin, et non un plugin gratuit complété par un module. Rien n'est déverrouillé à l'intérieur de la copie gratuite : pour passer l'éditeur en masse WooCommerce de la version gratuite à la version pro, vous remplacez un build par l'autre. Les deux ne peuvent pas fonctionner côte à côte. Dans le bon ordre, la bascule prend une minute et conserve vos réglages et votre Historique. Dans le mauvais ordre, elle se termine par une erreur fatale Cannot redeclare, par un Historique vide ou par un éditeur qui se comporte toujours comme la version gratuite.

Le lien entre la version gratuite et la version complète

Les deux builds partagent le même code. Ils déclarent les mêmes classes et fonctions PHP (WOOBE, WOOBE_STORAGE, un ensemble de fonctions woobe_), lisent les mêmes réglages dans la base de données et écrivent dans les mêmes tables d'Historique. Le build gratuit possède un commutateur qui le limite, et ces limites sont aussi le moyen le plus simple de savoir quel build est actif :

• l'éditeur affiche 10 produits par page, quel que soit le réglage ;
• l'onglet Aide (Help) affiche La version actuelle du plugin est GRATUITE (Current version of the plugin is FREE), et l'en-tête de l'éditeur comporte un bouton Mise à niveau (Upgrade) ;
• l'onglet Historique indique que les 2 dernières opérations peuvent être annulées, et l'onglet Champs meta (Meta Fields) autorise 2 champs méta ;
• dans l'onglet Modifier en bloc (Bulk Edit), de nombreux champs se trouvent dans des conteneurs rouges sans la case sélectionnez-le pour l'utiliser (select it to use) ; parmi les taxonomies, seules les catégories et un attribut peuvent être modifiés ;
• sur l'écran Extensions (Plugins), la ligne du plugin comporte un lien Passez à la version Pro ! (Go Pro!).

Les paquets actuels des deux builds utilisent le même dossier de plugin, wp-content/plugins/woo-bulk-editor. C'est ce qui rend possible un remplacement propre. Les anciens paquets de la version complète utilisaient woocommerce-bulk-editor, et c'est ainsi que de nombreux sites se sont retrouvés avec deux copies installées en même temps.

Passer l'éditeur en masse de la version gratuite à la version pro sur place

C'est la méthode recommandée, car rien n'est supprimé et aucune routine de désinstallation ne s'exécute.

1. Prenez le zip du plugin de la version complète : woo-bulk-editor.zip. Si le fichier que vous avez contient d'autres fichiers et dossiers, décompressez-le et utilisez le zip qu'il contient. Téléverser l'archive extérieure se termine par Le paquet n'a pas pu être installé. Aucune extension valide n'a été trouvée. (The package could not be installed. No valid plugins were found.), comme l'explique la FAQ sur l'erreur d'installation.
2. Dans WordPress, allez dans Extensions → Ajouter, choisissez Téléverser une extension (Upload Plugin), sélectionnez le zip et appuyez sur Installer maintenant (Install Now). La version gratuite peut rester active.
3. WordPress trouve le dossier déjà en place et affiche Cette extension est déjà installée. (This plugin is already installed.) avec un tableau comparant l'extension actuelle et celle téléversée. Vérifiez le nom et la version de l'extension téléversée, puis appuyez sur Remplacer la version actuelle par celle téléversée (Replace current with uploaded).
4. WordPress remplace les fichiers dans le même dossier. Un plugin actif reste actif ; s'il était inactif, appuyez sur Activer l'extension (Activate Plugin).
5. Ouvrez Produits → BEAR Bulk Editor et rechargez la page une fois.

Vos réglages de colonnes et vos profils, vos filtres enregistrés, vos champs méta rattachés, les permissions des gestionnaires de boutique et les options globales sont tous conservés, et l'Historique aussi. Un détail sur l'Historique : le build gratuit lui-même ne conserve, pour chaque utilisateur, que les deux dernières modifications isolées et les deux dernières opérations en masse, et supprime les lignes plus anciennes ; les entrées plus anciennes avaient donc déjà disparu avant la bascule. À partir de maintenant, l'Historique conserve tout, comme décrit dans la documentation de l'Historique.

Supprimer d'abord la version gratuite : ce qui est conservé et ce qui est perdu

L'autre voie courante est Extensions → Désactiver → Supprimer pour la version gratuite, puis le téléversement et l'activation de la version complète. Elle fonctionne, mais avec un coût. Supprimer le plugin depuis l'écran Extensions exécute sa routine de désinstallation, qui :

• supprime les deux tables de l'Historique, de sorte que l'Historique repart vide ;
• efface la mémoire de travail de l'éditeur pour chaque utilisateur (le filtre en cours et d'autres états similaires), de sorte que l'éditeur s'ouvre sans filtre.

Elle ne touche pas aux réglages : les colonnes, les profils, les champs méta, les permissions et les options globales sont stockés séparément et sont en place à l'activation de la version complète. Si l'Historique compte pour vous, utilisez le remplacement sur place décrit plus haut, ou supprimez le dossier de la version gratuite par FTP ou depuis le gestionnaire de fichiers de l'hébergeur au lieu d'utiliser supprimer (Delete) : supprimer le dossier n'exécute pas la routine de désinstallation.

Erreurs fatales « Cannot redeclare » et « Cannot declare class »

Des messages comme ceux-ci signifient tous la même chose : deux copies de BEAR sont installées dans des dossiers différents, et PHP a rencontré deux fois la même fonction ou la même classe.

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

Le nom dans le message dépend des versions des deux copies (les plus anciennes échouent sur woobe_init_translates, les actuelles sur woobe_uninstall_cleanup), et non d'un réglage que vous pourriez modifier. La solution est toujours de ne garder qu'une seule copie.

La version complète n'a pas pu être activée

Si WordPress affiche L'extension n'a pas pu être activée car elle a déclenché une erreur fatale (Plugin could not be activated because it triggered a fatal error), rien n'est encore cassé : WordPress a testé le plugin et l'a refusé. Allez sur l'écran Extensions, où BEAR est maintenant listé deux fois, et ne gardez que la copie que vous venez de téléverser :

1. Désactivez toutes les copies de BEAR.
2. Supprimez l'autre copie : effacez son dossier par FTP ou depuis le gestionnaire de fichiers pour conserver l'Historique, ou appuyez sur supprimer (Delete) sur l'écran Extensions si l'Historique n'a pas d'importance (voir la section précédente).
3. Activez la copie restante.

Tout le site affiche « Une erreur critique est survenue (There has been a critical error) »

Cela arrive lorsque les deux copies sont devenues actives d'une manière que WordPress n'a pas pu tester, par exemple après la mise à jour de l'une d'elles. WordPress envoie à l'administrateur du site un e-mail avec un lien vers le mode de récupération, où l'écran Extensions fonctionne de nouveau. Sans cet e-mail, ouvrez wp-content/plugins par FTP ou depuis le gestionnaire de fichiers de l'hébergeur et renommez le dossier de la copie dont vous ne voulez pas, par exemple en woocommerce-bulk-editor-off. Le site se recharge, et l'écran Extensions indique que le plugin a été désactivé car son fichier n'existe pas. Supprimez ensuite cette copie comme décrit plus haut.

La version gratuite continue de s'afficher après la bascule

Vérifiez les signes de la première section. Si l'éditeur affiche toujours 10 lignes par page et que l'onglet Aide (Help) indique toujours GRATUITE, c'est que le code gratuit est toujours celui qui s'exécute. Les raisons habituelles :

• Le remplacement n'a pas eu lieu. Annuler et retourner (Cancel and go back) a été pressé sur l'écran de comparaison, ou le zip téléversé était de nouveau le build gratuit. Le tableau de comparaison montre le nom et la version des deux ; téléversez le bon zip et choisissez Remplacer la version actuelle par celle téléversée (Replace current with uploaded).
• Deux copies sont installées et la gratuite s'exécute. L'écran Extensions liste BEAR deux fois, ou un avis d'administration commençant par Bonjour, il semble que vous ayez acheté et installé la version premium de BEAR (Hello, looks like you bought and installed premium version of BEAR) vous demande de désactiver la version gratuite. Lorsque deux copies sont actives et qu'aucune erreur fatale ne les arrête, la copie chargée en premier s'exécute et l'autre s'efface avec cet avis. Ne gardez que la copie complète, comme décrit plus haut.
• Le navigateur affiche une ancienne page. Rechargez l'éditeur par une actualisation forcée ; réinitialiser le cache des pages dans le navigateur liste les touches pour chaque navigateur.
• Le serveur exécute d'anciens fichiers PHP. Certains hébergeurs gardent du PHP compilé en mémoire sans vérifier si les fichiers ont changé. Si les fichiers sur le disque sont récents mais que le comportement est ancien, videz le cache PHP (OPcache) dans le panneau de l'hébergeur ou demandez à l'hébergeur de redémarrer PHP.

Mises à jour ultérieures et courte liste de contrôle

Les versions ultérieures du build complet s'installent de la même façon : téléversez le nouveau woo-bulk-editor.zip et choisissez Remplacer la version actuelle par celle téléversée (Replace current with uploaded). Le tableau de comparaison est un dernier contrôle utile pour vérifier que vous remplacez la version installée par un build complet plus récent et non par le build gratuit.

• Une seule entrée BEAR sur l'écran Extensions, active, sans lien Passez à la version Pro ! (Go Pro!).
• L'éditeur affiche plus de 10 produits lorsque vous en demandez davantage, et l'onglet Aide (Help) n'indique plus GRATUITE.
• Vos colonnes, vos filtres et vos champs méta sont là où vous les avez laissés.
• L'Historique montre vos opérations antérieures si vous avez remplacé sur place, ou repart vide si vous avez d'abord supprimé la version gratuite.

Si la bascule ne passe toujours pas, ouvrez un sujet sur le forum d'assistance de BEAR avec le message d'erreur exact, la liste des dossiers BEAR dans wp-content/plugins et les versions affichées sur l'écran Extensions.