Gestion des codes courts

Shortcodes inclus avec WooCommerce

WooCommerce est livré avec plusieurs codes courts qui peuvent être utilisés pour insérer du contenu dans des publications et des pages.
Nos blocs WooCommerce sont dĂ©sormais le moyen le plus simple et le plus flexible d’afficher vos produits sur les articles et les pages de votre site WooCommerce. En savoir plus sur tous les blocs WooCommerce disponibles ici .
Aidez-nous Ă  façonner l’avenir chez WooCommerce ! Notre Ă©quipe s’efforce toujours de crĂ©er des outils qui aideront votre entreprise Ă  rĂ©ussir et les commentaires jouent un rĂ´le essentiel dans ce processus. Pour nous assurer que nos produits sont les meilleurs possibles, nous menons rĂ©gulièrement des Ă©tudes de recherche avec nos clients – et nous serions ravis d’ajouter votre voix Ă  la conversation. En savoir plus ici .


Comment utiliser les codes courts

OĂą utiliser

Les shortcodes peuvent ĂŞtre utilisĂ©s sur les pages et les publications de WordPress. Si vous utilisez l’Ă©diteur de blocs, il existe un bloc de shortcode que vous pouvez utiliser pour coller le shortcode .

Si vous utilisez l’Ă©diteur classique, vous pouvez coller le shortcode sur la page ou la publication.

Args (ou arguments)

Plusieurs des shortcodes ci-dessous mentionneront « Args ». Ce sont des moyens de rendre le shortcode plus spécifique. Par exemple, en ajoutant id="99"au shortcode, cela créera un bouton d’ajout au panier pour le produit portant l’ID 99.

Codes courts de page

WooCommerce ne peut pas fonctionner correctement sans que les trois premiers shortcodes se trouvent quelque part sur votre site.

Remarque : Vous pouvez désormais tester les nouveaux blocs de panier et de paiement disponibles dans le plugin WooCommerce Blocks !

woocommerce_cart– affiche la page du panier
woocommerce_checkout– affiche la page de paiement
woocommerce_my_account– ​​affiche la page du compte utilisateur
woocommerce_order_tracking– affiche le formulaire de suivi de commande

Dans la plupart des cas, ces shortcodes seront ajoutĂ©s automatiquement aux pages via notre assistant d’intĂ©gration et n’auront pas besoin d’ĂŞtre utilisĂ©s manuellement.

Chariot

UtilisĂ© sur la page du panier, le shortcode du panier affiche le contenu du panier et l’interface pour les codes de rĂ©duction et autres Ă©lĂ©ments du panier.

Args : aucun

Votre panier est actuellement vide.

Retour Ă  la boutique

VĂ©rifier

Utilisé sur la page de paiement, le shortcode de paiement affiche le processus de paiement.

Args : aucun

Mon compte

Affiche la section « mon compte » où le client peut consulter les commandes passées et mettre à jour ses informations. Vous pouvez spécifier le nombre de commandes à afficher. Par défaut, il est défini sur 15 (utilisez -1 pour afficher toutes les commandes .)

Args :

tableau(
     'utilisateur_actuel' => ''
 )
woocommerce_my_account
L’argument de l’utilisateur actuel est automatiquement dĂ©fini Ă  l’aide de get_user_by( 'id', get_current_user_id() ).

Formulaire de suivi de commande

Permet Ă  un utilisateur de voir le statut d’une commande en saisissant les dĂ©tails de sa commande.

Args : aucun

Pour suivre votre commande veuillez saisir votre ID de commande dans la boite ci-dessous et cliquer le bouton « Suivre ». Il vous a été donné sur votre reçu et dans l’e-mail de confirmation que vous avez du recevoir.

Des produits

Remarque : Depuis la version 3.6, WooCommerce Core comprend plusieurs blocs de produits. Ceux-ci sont plus faciles Ă  configurer que les shortcodes, donc si vous utilisez l’Ă©diteur de blocs WordPress, vous souhaiterez peut-ĂŞtre d’abord en savoir plus sur les blocs WooCommerce .

Le 

shortcode est l’un de nos shortcodes les plus robustes, qui peut remplacer diverses autres chaînes utilisées dans les versions antérieures de WooCommerce.

Le 

shortcode vous permet d’afficher les produits par ID de publication, SKU, catĂ©gories, attributs, avec prise en charge de la pagination, du tri alĂ©atoire et des balises de produit, remplaçant ainsi le besoin de plusieurs codes courts tels que  
, 
,  ,  ,  et  , qui sont nécessaires dans les versions de WooCommerce ci-dessous 3.2. Examinez les exemples ci-dessous.

Attributs de produit disponibles

Les attributs suivants peuvent être utilisés conjointement avec le 

shortcode. Ils ont été divisés en sections pour leur fonction principale afin de faciliter la navigation, avec des exemples ci-dessous.

Afficher les attributs du produit

  • limit– Le nombre de produits Ă  afficher. La valeur par dĂ©faut est et -1 (tout afficher) lors de la liste des produits, et -1 (tout afficher) pour les catĂ©gories.
  • columns– Le nombre de colonnes Ă  afficher. La valeur par dĂ©faut est 4.
  • paginate– Active la pagination. Utiliser en conjonction avec limit. La valeur par dĂ©faut est falsedĂ©finie sur truepour paginer .
  • orderby– Trie les produits affichĂ©s par l’option saisie. Une ou plusieurs options peuvent ĂŞtre transmises en ajoutant les deux slugs avec un espace entre eux. Les options disponibles sont :
    • date– La date de publication du produit.
    • id– L’identifiant de poste du produit.
    • menu_order– L’ordre du menu, s’il est dĂ©fini (les chiffres infĂ©rieurs s’affichent en premier).
    • popularity– Le nombre d’achats.
    • rand– Commandez alĂ©atoirement les produits lors du chargement de la page (peut ne pas fonctionner avec les sites qui utilisent la mise en cache, car cela pourrait enregistrer une commande spĂ©cifique).
    • rating– La note moyenne du produit.
    • title– Le titre du produit. C’est le orderbymode par dĂ©faut.
  • skus– Liste des SKU de produits sĂ©parĂ©s par des virgules.
  • category– Liste des slugs de catĂ©gorie sĂ©parĂ©s par des virgules.
  • tag– Liste de slugs de balises sĂ©parĂ©s par des virgules.
  • order– Indique si l’ordre des produits est croissant ( ASC) ou dĂ©croissant ( DESC), en utilisant la mĂ©thode dĂ©finie dans orderby. La valeur par dĂ©faut est ASC.
  • class– Ajoute une classe wrapper HTML afin que vous puissiez modifier la sortie spĂ©cifique avec du CSS personnalisĂ©.
  • on_sale – RĂ©cupĂ©rer les produits en vente. Ne pas utiliser conjointement avec  best_sellingou  top_rated.
  • best_selling– RĂ©cupĂ©rer les produits les plus vendus. Ne pas utiliser conjointement avec  on_sale ou  top_rated.
  • top_rated – RĂ©cupĂ©rer les produits les mieux notĂ©s. Ne pas utiliser conjointement avec  on_saleou  best_selling.

Attributs du produit de contenu

  • attribute– RĂ©cupère les produits Ă  l’aide du slug d’attribut spĂ©cifiĂ©.
  • terms– Liste de termes d’attribut sĂ©parĂ©s par des virgules Ă  utiliser avec attribute.
  • terms_operator– OpĂ©rateur pour comparer les termes d’attribut. Les options disponibles sont :
    • AND– Affichera les produits de tous les attributs choisis.
    • IN– Affichera les produits avec l’attribut choisi. Ceci est la terms_operatorvaleur par dĂ©fault.
    • NOT IN– Affichera les produits qui ne sont pas dans les attributs choisis.
  • tag_operator– OpĂ©rateur pour comparer les balises. Les options disponibles sont :
    • AND– Affichera les produits de toutes les balises choisies.
    • IN– Affichera les produits avec les balises choisies. Ceci est la tag_operatorvaleur par dĂ©fault.
    • NOT IN– Affichera les produits qui ne sont pas dans les balises choisies.
  • visibility– Affichera les produits en fonction de la visibilitĂ© sĂ©lectionnĂ©e. Les options disponibles sont :
    • visible– Produits visibles sur la boutique et les rĂ©sultats de recherche. Ceci est l’ visibilityoption par dĂ©faut.
    • catalog– Produits visibles sur la boutique uniquement, mais pas dans les rĂ©sultats de recherche.
    • search– Produits visibles dans les rĂ©sultats de recherche uniquement, mais pas sur la boutique.
    • hidden– Produits masquĂ©s Ă  la fois dans la boutique et dans la recherche, accessibles uniquement par URL directe.
    • featured– Produits marquĂ©s comme produits vedettes.
  • category– RĂ©cupère les produits Ă  l’aide du slug de catĂ©gorie spĂ©cifiĂ©.
  • tag– RĂ©cupère les produits Ă  l’aide du slug de balise spĂ©cifiĂ©.
  • cat_operator– OpĂ©rateur pour comparer les termes de catĂ©gorie. Les options disponibles sont :
    • AND– Affichera les produits appartenant Ă  toutes les catĂ©gories choisies.
    • IN– Affichera les produits dans la catĂ©gorie choisie. Ceci est la cat_operatorvaleur par dĂ©fault.
    • NOT IN– Affichera les produits qui ne sont pas dans la catĂ©gorie choisie.
  • ids– Affichera les produits en fonction d’une liste d’identifiants de publication sĂ©parĂ©s par des virgules.
  • skus– Affichera les produits en fonction d’une liste de SKU sĂ©parĂ©s par des virgules.

Si le produit ne s’affiche pas, assurez-vous qu’il n’est pas dĂ©fini sur « Masqué » dans la « VisibilitĂ© du catalogue ».

Pour trouver l’ID du produit, accĂ©dez Ă  l’ Ă©cran Produits , passez la souris sur le produit et l’ID apparaĂ®t comme indiquĂ© ci-dessous.
Trouver l'ID du produit WooCommerce en survolant un produit

Attributs spéciaux du produit

Ces attributs ne peuvent pas ĂŞtre utilisĂ©s avec les « Attributs de contenu » rĂ©pertoriĂ©s ci-dessus, car ils provoqueront probablement un conflit et ne s’afficheront pas. Vous ne devez utiliser qu’un seul des attributs spĂ©ciaux suivants.

  • best_selling– Affichera vos produits les plus vendus. Doit ĂŞtre rĂ©glĂ© sur true.
  • on_sale– Affichera vos produits en vente. Doit ĂŞtre rĂ©glĂ© sur true.

Exemples de scénarios de produits

Dans les scénarios suivants, nous utiliserons un exemple de magasin de vêtements.

Scénario 1 – Articles de vente aléatoire

Je souhaite afficher quatre produits en vente au hasard.

[produits limit="4" columns="4" orderby="popularity" class="quick-sale" on_sale="true" ]

Ce shortcode indique explicitement quatre produits avec quatre colonnes (qui seront une ligne), affichant les articles en vente les plus populaires. Il ajoute également une classe CSS quick-sale, que je peux modifier dans mon thème.

WooCommerce Shortcode - Produits en vente

Je souhaite afficher mes produits phares, deux par ligne, avec un maximum de quatre articles.

[produits limit="4" columns="2" visibilité="featured" ]

Ce shortcode indique que jusqu’Ă  quatre produits seront chargĂ©s dans deux colonnes et qu’ils doivent ĂŞtre prĂ©sentĂ©s. Bien que cela ne soit pas explicitement indiquĂ©, il utilise les valeurs par dĂ©faut telles que le tri par titre (A Ă  Z).

Shortcode WooCommerce - Produits en vedette

Scénario 3 – Produits les plus vendus

Je souhaite afficher mes trois produits les plus vendus sur une seule ligne.

[produits limit="3" columns="3" best_seller="true" ]
WooCommerce Shortcode – Produits les plus vendus

Scénario 4 – Produits les plus récents

Je souhaite afficher en premier les produits les plus rĂ©cents – quatre produits sur une seule ligne. Pour ce faire, nous utiliserons le Post ID (qui est gĂ©nĂ©rĂ© lors de la crĂ©ation de la page produit), ainsi que les commandes order et orderby. Comme vous ne pouvez pas voir l’ID de publication depuis le frontend, les numĂ©ros d’identification ont Ă©tĂ© superposĂ©s sur les images.

[produits limit="4" columns="4" orderby="id" order="DESC" visibilité="visible"]
Codes courts WooCommerce - Les plus récents

Scénario 5 – Catégories spécifiques

Je souhaite uniquement exposer des sweats Ă  capuche et des chemises, mais pas d’accessoires. J’utiliserai deux rangĂ©es de quatre.

[produits limit="8" columns="4"category="sweats Ă  capuche, t-shirts" cat_operator="AND"]
Shortcode WooCommerce – Produits par catégorie

Alternativement, je souhaite uniquement afficher des produits qui ne appartiennent pas Ă  ces catĂ©gories. Tout ce que j’ai besoin de changer, c’est le cat_operatorto NOT IN.

Notez que même si la limite est définie sur 8, seuls quatre produits répondent à ces critères. Quatre produits sont donc affichés.

Shortcode WooCommerce – Produits par catégorie

Scénario 6 – Affichage des attributs

Chacun des vĂŞtements possède un attribut, soit « Printemps/ÉtĂ© » ou « Automne/Hiver » selon la saison appropriĂ©e, certains accessoires ayant les deux puisqu’ils peuvent ĂŞtre portĂ©s toute l’annĂ©e. Dans cet exemple, je veux trois produits par ligne, affichant tous les articles « Printemps/ÉtĂ© ». Ce slug d’attribut est season, et les attributs sont warmet cold. Je souhaite Ă©galement qu’ils soient triĂ©s des produits les plus rĂ©cents aux plus anciens.

[colonnes de produits = "3" attribut = "saison" termes = "chaud" orderby = "date"]
WooCommerce Shortcode - Produits par attribut

Alternativement, si je souhaitais afficher exclusivement des produits pour temps froid, je pourrais ajouter NOT INcomme monterms_operator :

[colonnes de produits = "3" attribut = "saison" termes = "chaud" termes_operator = "NOT IN"]
WooCommerce Shortcode - Produits par attribut


Notez qu’en utilisant NOT IN, j’exclus les produits qui sont Ă  la fois en « Printemps/ÉtĂ© » et « Automne/Hiver ». Si je voulais montrer tous les Ă©quipements adaptĂ©s au temps froid, y compris ces accessoires partagĂ©s, je changerais le terme de warmà cold.

Scénario 7 – Afficher uniquement les produits avec la balise « sweat à capuche »

[Ă©tiquette produits = "sweat Ă  capuche"]

Trier les produits par champs méta personnalisés

Remarque : Nous ne sommes pas en mesure de fournir une assistance pour les personnalisations dans le cadre de notre politique d’assistance . Si vous n’ĂŞtes pas familier avec le code/les modèles et la rĂ©solution de conflits potentiels, vous pouvez contacter un  WooExpert .

Lorsque vous utilisez le shortcode Produits, vous pouvez choisir de commander les produits selon les valeurs prédéfinies ci-dessus. Vous pouvez également trier les produits par champs méta personnalisés en utilisant le code ci-dessous (dans cet exemple, nous classons les produits par prix) :

add_filter( 'woocommerce_shortcode_products_query', 'woocommerce_shortcode_products_orderby' );

fonction woocommerce_shortcode_products_orderby( $args ) {

    $standard_array = array('menu_order','title','date','rand','id');

    if( isset( $args['orderby'] ) && !in_array( $args['orderby'], $standard_array ) ) {
        $args['meta_key'] = $args['orderby'];
        $args['orderby'] = 'meta_value_num';
    }

    renvoie $args ;
}

Vous devez placer cet extrait dans Functions.php dans votre dossier de thème, puis le personnaliser en modifiant la méta_key.

catégorie de produit

Ces deux shortcodes afficheront vos catégories de produits sur n’importe quelle page.

Attributs de catégorie de produit disponibles

  • ids– SpĂ©cifiez les identifiants de catĂ©gorie spĂ©cifiques Ă  rĂ©pertorier. À utiliser dans
  • category– Peut ĂŞtre l’identifiant de la catĂ©gorie, le nom ou le slug. À utiliser dans
  • limit– Le nombre de catĂ©gories Ă  afficher
  • columns– Le nombre de colonnes Ă  afficher. La valeur par dĂ©faut est 4
  • hide_empty– La valeur par dĂ©faut est « 1 », ce qui masquera les catĂ©gories vides. RĂ©glez sur « 0 » pour afficher les catĂ©gories vides
  • parent– DĂ©finissez un ID de catĂ©gorie spĂ©cifique si vous souhaitez afficher toutes les catĂ©gories enfants. Vous pouvez Ă©galement dĂ©finir sur « 0 » (comme dans l’exemple ci-dessous) pour afficher uniquement les catĂ©gories de niveau supĂ©rieur.
  • orderby– La valeur par dĂ©faut est de trier par « nom », peut ĂŞtre dĂ©fini sur « id », « slug » ou « menu_order ». Si vous souhaitez commander selon les identifiants que vous avez spĂ©cifiĂ©s, vous pouvez utiliserorderby="include"
  • order– Indique si l’ordre des catĂ©gories est croissant ( ASC) ou dĂ©croissant ( DESC), en utilisant la mĂ©thode dĂ©finie dans orderby. La valeur par dĂ©faut est ASC.

Exemples de scénarios de catégories de produits

Scénario 8 – Afficher uniquement les catégories de niveau supérieur

Imaginez que vous vouliez uniquement afficher les catĂ©gories de niveau supĂ©rieur sur une page et exclure les sous-catĂ©gories, et bien c’est possible avec le shortcode suivant.

Page produit

Afficher une page produit unique complète par ID ou SKU.

[id_page_produit="99"]

Répertoriez les produits associés.

Args :

tableau(
     'limite' => '12',
     'colonnes' => '4',
     'orderby' => 'titre'
 )

Argument limite

Remarque : l’argument du shortcode « limite » dĂ©terminera le nombre de produits affichĂ©s sur une page. Cela n’ajoutera pas de pagination au shortcode.

 

Ajouter au panier

Afficher le prix et le bouton Ajouter au panier d’un seul produit par ID.

Args :

tableau(
      'identifiant' => '99',
      'style' => 'border:4px solid #ccc; remplissage : 12 px ;',
      'sku' => 'FOO'
      'show_price' => 'VRAI'
      'class' => 'CLASSE CSS'
      'quantité' => '1';
 )

Ajouter au panier URL

Affichez l’URL sur le bouton Ajouter au panier d’un seul produit par ID.

Args :

tableau(
      'identifiant' => '99',
      'sku' => 'FOO'
 )

Afficher les notifications WooCommerce sur les pages qui ne sont pas WooCommerce

 vous permet d’afficher des notifications WooCommerce (comme « Le produit a Ă©tĂ© ajoutĂ© au panier ») sur des pages non WooCommerce. Utile lorsque vous utilisez d’autres codes courts, comme  , et que vous souhaitez que les utilisateurs obtiennent des commentaires sur leurs actions.

DĂ©pannage des codes courts

Si vous avez correctement collĂ© vos shortcodes et que l’affichage semble incorrect, assurez-vous de ne pas avoir intĂ©grĂ© le shortcode entre les balises <pre> . Il s’agit d’un problème courant. Pour supprimer ces balises, modifiez la page et cliquez sur l’onglet Texte :

Supprimer les balises pré du shortcode

Un autre problème courant est que les guillemets droits ( ") sont affichés sous forme de guillemets courbés ( “). Pour que les shortcodes fonctionnent correctement, vous avez besoin de guillemets droits.

 

Source : woocommerce.com
Article ajouté au panier
0 Produit - 0,00