Comment modifier les textes courants de WooCommerce avec du code

WooCommerce regorge de filtres, de crochets et de fonctions pour vous aider à personnaliser et à utiliser le plugin dans votre thème ou plugin. Voici quelques exemples de code petits mais utiles, des a-ha et des procédures de modifications courantes de différentes sorties de texte.

Modification des textes du bouton "Ajouter au panier"

Il y a deux filtres ; un pour les textes «ajouter au panier» en boucle (woocommerce_product_add_to_cart_text), et un autre pour le bouton en produit unique (woocommerce_product_single_add_to_cart_text) :

// Single product view
add_filter('woocommerce_product_single_add_to_cart_text', function($text) {
    return __('Buy this now', 'txtdomain');
});
 
// Loop
add_filter('woocommerce_product_add_to_cart_text', function($text) {
    return __('Buy this', 'txtdomain');
});

Cependant, gardez à l’esprit que cela remplace tous les textes "Ajouter au panier". Même ceux qui étaient à l’origine «Select options» (produits variables) ou «Read more» (produits non achetables – pas de prix ou en rupture de stock). Si vous souhaitez un réglage plus précis, incluez le deuxième argument à ces filtres ; l’objet produit. Utilisez l’objet produit pour contrôler conditionnellement la sortie. Par exemple, par type de produit ou si le produit peut être acheté ou non :

Modifier la sortie de gamme de prix sur les produits variables et groupés

Par défaut, WooCommerce affichera le prix le plus bas et le prix le plus élevé sur les produits variables et groupés, avec un "-" entre les deux. Vous pouvez très facilement modifier cette plage de sortie. Par exemple, assurez-vous qu’il n’affiche que le prix le plus bas, sous la forme «De: ». WooCommerce a un filtre pour les produits variables et un autre pour les produits groupés, alors regardons-les tous les deux tour à tour.

Le contrôle de la sortie HTML de la gamme de prix pour les produits variables se fait avec le filtre woocommerce_variable_price_html. L’objet produit est fourni en deuxième argument.

À l’intérieur de la fonction, nous devons récupérer tous les prix. WooCommerce offre une fonction pratique sur les objets produits variables, get_variation_prices(). Cela renvoie un tableau de tous les prix des variantes, triés par le plus bas en premier. Tout ce que nous devons faire est de supprimer le premier élément du tableau des prix et de le produire correctement :

Le filtre de sortie HTML de la fourchette de prix pour les produits groupés est très similaire aux produits variables, mais avec une différence ; un tableau de tous les prix des produits « enfants » groupés est inclus comme argument du filtre. Le filtre à utiliser est woocommerce_grouped_price_html:

Modifier la sortie du texte de l’état des stocks

Si vous avez activé l’affichage de l’état du stock dans les paramètres de WooCommerce, il devrait afficher la quantité précise de stock restant dans la vue d’un seul produit (par exemple "42 en stock"). Cependant, vous pouvez modifier la sortie pour afficher à la place une plage plutôt que le montant précis. Ou simplement "En stock" si vous souhaitez masquer le numéro.

Le filtre pour ce faire est woocommerce_get_stock_htmlet si vous incluez le deuxième argument, vous obtenez l’objet produit. Avec l’objet produit, vous pouvez effectuer les opérations nécessaires pour affiner la sortie. Gardez à l’esprit que la sortie filtrable est enveloppée dans un <p>élément, et votre sortie devrait également l’être.

Pour afficher simplement «En stock» ou «Pas en stock », cela suffira :

L’affichage du stock dans les "valeurs de plage" peut être fait comme ceci :

Renommer les statuts des commandes

Parfois, un client souhaite que différentes étiquettes sur les statuts de commande aient plus de sens en fonction de ses pratiques en matière de boutique en ligne. Par exemple, vous voudrez peut-être que "En attente" soit renommé en "Non envoyé" ou que "Terminé" soit renommé "Envoyé". Juste pour mieux comprendre quelles commandes doivent être envoyées et lesquelles ont déjà été envoyées. WooCommerce propose un filtre simple, wc_order_statuses, sur tous les noms de statuts de commande disponibles.

add_filter('wc_order_statuses', function($order_statuses) {
    $order_statuses['wc-on-hold'] = __('Unsent', 'txtdomain');
    $order_statuses['wc-completed'] = __('Sent', 'txtdomain');
    return $order_statuses;
});

Les touches disponibles sont wc-pending, wc-processing, wc-on-hold, wc-completed, wc-cancelled, wc-refundedet wc-failed.