WooCommerce Ajout de la description courte du produit aux pages d'archives

Ce que vous allez créer

WooCommerce est fourni avec des pages d'archives et des boucles qui font un excellent travail, mais vous pouvez parfois avoir besoin d'afficher un peu plus d'informations sur votre boutique principale et sur d'autres pages d'archives..

Dans ce tutoriel, je vais vous montrer comment ajouter la brève description du produit à vos pages d'archives et l'afficher sous le titre du produit..

Ce dont vous aurez besoin

Pour suivre, vous aurez besoin de:

  • Une installation de développement de WordPress.
  • Un éditeur de code.
  • WooCommerce installé et activé.
  • Produits ajoutés: j'ai importé les données de produit fictives fournies avec WooCommerce; pour plus de détails sur la procédure à suivre, consultez ce guide.
  • Un thème compatible WooCommerce activé-j'utilise Storefront.

Avant de commencer, assurez-vous que WooCommerce est configuré. Pour ajouter les descriptions courtes du produit, vous devez suivre trois étapes:

  1. Créer un plugin pour la fonction et activer le plugin.
  2. Ajouter une fonction qui produit la description courte du produit.
  3. Identifiez le hook dans WooCommerce auquel nous devons accrocher la fonction et associez-la à ce hook.

Alors commençons!

Créer le plugin

Dans ton wp-content / plugins répertoire, créez un nouveau fichier PHP. J'appelle le mien tutsplus-product-archive-short-descriptions.php.

Ouvrez le fichier dans votre éditeur de code. En haut du fichier, ajoutez ceci:

Cela configure le plugin et donne à WordPress tout ce dont il a besoin pour l'activer..

Allez maintenant au Plugins écran dans votre administrateur WordPress et trouvez le plugin:

Activez-le maintenant.

Au début, cela ne fera aucune différence car vous ne l'avez pas rempli. Voici à quoi ressemble la page principale de la boutique:

Écrire une fonction pour afficher la description courte

La description courte pour les produits dans WooCommerce utilise l'extrait que vous trouverez dans les articles normaux. Par conséquent, pour l'afficher, il vous suffit d'afficher l'extrait du message..

Dans votre fichier plugin, ajoutez le code ci-dessous:

fonction tutsplus_excerpt_in_product_archives () the_excerpt (); 

C'est aussi simple que ça! Mais maintenant, vous devez associer votre fonction à la bonne action, de sorte qu'elle soit affichée au bon endroit dans vos pages d'archive..

Accrocher la fonction à l'action correcte

Jetons un coup d'oeil au fichier dans WooCommerce qui affiche le contenu de la boucle sur les pages d'archives. Ce fichier est content-product.php, et vous le trouverez dans le des modèles dossier dans le plugin WooCommerce.

Le fichier comprend un certain nombre de points d’action, tous utilisés par WooCommerce pour générer un contenu différent..

Comme nous voulons afficher notre extrait sous le titre du produit, le crochet que nous devons utiliser est woocommerce_after_shop_loop_item_title. Comme vous pouvez le voir sur le content-product.php fichier, il a déjà deux fonctions attachées, woocommerce_template_loop_rating () et woocommerce_template_loop_price (), qui ont des priorités de 5 et dix respectivement. Nous devons donc associer notre fonction à un numéro de priorité plus élevé, afin de nous assurer qu'elle se déclenche après celles-ci. Je vais laisser une marge de manœuvre et utiliser 40 comme priorité.

Sous votre fonction, ajoutez ceci:

add_action ('woocommerce_after_shop_loop_item_title', 'tutsplus_excerpt_in_product_archives', 40);

Enregistrez maintenant votre fichier de plug-in et actualisez la page de la boutique dans votre navigateur. Vous verrez maintenant les brèves descriptions de produits sous les noms de produits:

Ces descriptions (fournies par les données factices) sont un peu longues: personnellement, j'utiliserais des descriptions plus courtes sur un site actif. Mais vous pouvez voir clairement les descriptions affichées dans les pages d'archives.

Résumé

Comme WooCommerce génère presque tout son contenu à l'aide de crochets d'action, il est simple d'ajouter plus de contenu en écrivant des fonctions et en les attachant à ces crochets. Dans ce didacticiel, vous avez appris comment ajouter de brèves descriptions de produits à vos archives de produits. Si vous souhaitez aller plus loin, vous pouvez inclure une ou plusieurs balises conditionnelles dans votre fonction pour le faire sur des pages d'archives spécifiques..