Shortcodes inclus avec WooCommerce
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.
woocommerce_cart
– affiche la page du panierwoocommerce_checkout
– affiche la page de paiementwoocommerce_my_account
– ​​affiche la page du compte utilisateurwoocommerce_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
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
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
Des produits
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Âfalse
dĂ©finie surÂtrue
pour 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Âorderby
mode 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_selling
ou Â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_sale
ou Â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_operator
valeur 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_operator
valeur 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’Âvisibility
option 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_operator
valeur 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 ».
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.
Scénario 2 – Produits en vedette
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).
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" ]
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"]
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"]
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_operator
to 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.
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 warm
et 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"]
Alternativement, si je souhaitais afficher exclusivement des produits pour temps froid, je pourrais ajouter NOT IN
comme monterms_operator
 :
[colonnes de produits = "3" attribut = "saison" termes = "chaud" termes_operator = "NOT IN"]
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
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.
– Affichera les produits dans une catégorie de produits spécifiée.
– Affichera toutes vos catégories de produits.
Attributs de catégorie de produit disponibles
ids
– Spécifiez les identifiants de catégorie spécifiques à répertorier. À utiliser danscategory
– Peut être l’identifiant de la catégorie, le nom ou le slug. À utiliser danslimit
– Le nombre de catégories à affichercolumns
– Le nombre de colonnes à afficher. La valeur par défaut est 4hide_empty
– La valeur par défaut est « 1 », ce qui masquera les catégories vides. Réglez sur « 0 » pour afficher les catégories videsparent
– 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"]
Produits connexes
Répertoriez les produits associés.
Args :
tableau( 'limite' => '12', 'colonnes' => '4', 'orderby' => 'titre' )
Argument limite
Â
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 :
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.