[woot]
Shortcode principal du tableau de produits WooCommerce. Il affiche le tableau de produits WooCommerce. Il peut s'utiliser sans attributs, avec les valeurs par défaut. Avec l'attribut 'id' (ID du tableau), il affiche les tableaux créés dans l'administration du plugin. Tous les attributs ont une priorité plus élevée que les réglages de l'administration !
Attributs :
- id: attribut principal, il désigne l'ID d'un tableau créé dans l'administration. Vous pouvez créer un tableau et surcharger certains de ses paramètres avec les attributs ci-dessous.
- columns : définit les colonnes du tableau. Exemple : [woot columns='id,thumbnail,title,price,sku,gallery,add_to_cart']. Vous trouverez toutes les clés de colonnes possibles sur la page d'administration du plugin -> onglet Réglages (Settings) -> bouton « Toutes les clés de colonnes possibles (All possible columns keys) » en bas du tableau des réglages.
- cells_width : définit la largeur des colonnes selon leur ordre dans le tableau : [woot cells_width='1px,200px,20%,auto']
- per_page : définit le nombre de produits par page
- per_page_sel_pp : définit les valeurs proposées pour le nombre de produits par page, exemple : [woot per_page_sel_pp='5,15,25']
- per_page_position : définit la position de la pagination. Exemple : [woot per_page_position='t']
- t - en haut
- b - en bas
- tb - en haut et en bas
- none - ne pas afficher cette liste déroulante
- per_page_sel_position : définit la position de la liste déroulante du nombre de produits par page. Exemple : [woot per_page_sel_position='t']
- t - en haut
- b - en bas
- tb - en haut et en bas
- none - ne pas afficher cette liste déroulante
- order_by : clé selon laquelle les produits sont triés après le chargement de la page. Vous trouverez toutes les clés possibles sur la page d'administration du plugin -> onglet Réglages -> bouton « Clés de tri (Order by keys) » en bas du tableau des réglages, voir « Clés de tri » dans le popup qui s'affiche. Clés pour un shortcode personnalisé :
- popularity - Tri par popularité
- rating - Tri par note moyenne
- date - Tri par nouveautés
- price - Tri par prix : du moins cher au plus cher
- price-desc - Tri par prix : du plus cher au moins cher
- title - Tri par nom de A à Z
- title-desc - Tri par nom de Z à A
- sku - SKU : ordre croissant
- sku-desc - SKU : ordre décroissant
- stock - Quantité en stock : ordre croissant
- stock-desc - Quantité en stock : ordre décroissant
- sales - Ventes totales : ordre croissant
- sales-desc - Ventes totales : ordre décroissant
- comments - Nombre de commentaires : ordre croissant
- comments-desc - Nombre de commentaires : ordre décroissant
- modified - Date de dernière modification : de la plus ancienne à la plus récente
- modified-desc - Date de dernière modification : de la plus récente à la plus ancienne
- menu_order - Tri par ordre du menu
- on_sales - Produits en promotion en premier
- on_stock - Tri par disponibilité
- rand - Tri aléatoire
- id - Tri par ID de produit : ordre croissant
- id-desc - Tri par ID de produit : ordre décroissant
- order : sens du tri des produits, 2 valeurs possibles : asc OU desc
- hide_text_search : chaque shortcode [woot] affiche au-dessus du tableau un champ de recherche par titre de produit ; indiquez 1 pour le masquer si nécessaire
- text_search_min_symbols : permet de définir le nombre minimal de caractères à saisir pour lancer la recherche par titre de produit
- text_search_placeholder : texte indicatif du champ de recherche par titre de produit
- filter_form : ajoute un formulaire de filtre au-dessus du tableau. Exemple : [woot filter_form='price,pa_color']. Vous trouverez toutes les clés possibles sur la page d'administration du plugin -> onglet Réglages -> bouton « Toutes les clés de colonnes possibles » en bas du tableau des réglages, voir « Clés de tri » dans le popup qui s'affiche.
- hide_filter_form : avec la valeur 1, un bouton apparaît à la place du formulaire de filtre ; un clic sur ce bouton affiche le formulaire de filtre
- disable_filter_form : désactive complètement (hide) le formulaire de filtre s'il existe
- use_load_more : avec la valeur 1, un bouton « Load More » (Charger plus) remplace la pagination en bas du tableau.
- table_html_id : Exemple : 'my_great_table' - pour le CSS ou la programmation
- post_status : cet attribut permet d'afficher des produits dont le statut n'est pas seulement 'publish'. Exemple : 'publish,draft'
- orderby_select_fields : si des valeurs sont indiquées ici, une liste déroulante de tri apparaît. Vous trouverez toutes les clés possibles sur la page d'administration du plugin -> onglet Réglages -> bouton « Toutes les clés de colonnes possibles » en bas du tableau des réglages, voir « Clés de tri » dans le popup qui s'affiche.
- compact_view_width : pour les petits appareils mobiles. Vous définissez ici la largeur de fenêtre en dessous de laquelle le tableau s'affiche en mode compact. Exemple : 500
- hide_on_mobile : définit les colonnes que vous souhaitez éventuellement masquer sur les appareils mobiles
- show_cart : avec la valeur 1, le panier est affiché en haut du tableau
- cart_position : 0 - panier à droite, liste déroulante de tri à gauche ; 1 - panier à gauche, liste déroulante de tri à droite
- show_print_btn : affiche le bouton d'impression en haut à gauche du tableau
- display_cell_info : affiche les informations de la cellule au survol de la souris
- skin : thème visuel du tableau en cours, en savoir plus sur les thèmes visuels ici
- current_page : page affichée au chargement du tableau. Exemple : 4
Il est aussi possible de définir le numéro de page par un lien, grâce aux données GET, exemple : https://demo.products-tables.com/?current_page=7 - faites attention au champ 'current_page' du lien - use_flow_header : en-tête flottant lors du défilement du tableau. Activé par défaut.
- predefinition : uniquement au format JSON ; son utilisation directe n'est pas recommandée, car une erreur est possible, mieux vaut passer par les outils du tableau -> onglet « Prédéfinition (Predefinition) », mais c'est faisable, exemple : [woot predefinition='{"ids":"13287,12851,12843", "author":2, "on_sale_only":1, "in_stock_only":1, "featured_only":1, "bestsellers":4, "newest":2, "by_taxonomy":"product_cat:25,26|pa_color:19|rel:AND","sku":"sku-abc,sku-yes,sku-green-l","ids_exclude":"13552","not_by_taxonomy":"pa_color:19|pa_size:21|rel:or"}']
- author : récupère les produits selon l'ID de leur auteur. Utile avec les plugins d'adhésion.
- mode : valeurs possibles - 'ajax', 'to_json', 'json'. Le mode Ajax est toujours actif tant que cet attribut ne le redéfinit pas. Le mode 'to_json' permet de mettre en cache les données des articles à la volée : l'utilisateur navigue alors dans le tableau sans requêtes au serveur, avec une recherche par titre uniquement (les filtres ne fonctionnent qu'avec la base de données) ! Le mode 'json' ne récupère pas les articles par Ajax et affiche sur la page le tableau entièrement mis en cache, dès le chargement de la page. Comme le mode 'json' s'utilise dans l'administration, sur le site public il faut ajouter à ce mode l'attribut de shortcode is_front=1. Avec le mode 'json' ou 'to_json', 'orderby_select_fields' est désactivé ! Voir la démo ici.
- filter_provider : attribut spécial qui permet de synchroniser les requêtes de base de données de WOOT avec différents plugins de filtres de produits pour WooCommerce, par exemple : woof, mdtf. Quelques exemples d'utilisation ici. Consultez les informations pour développeurs ici.
- woot_text_search_by : attribut spécial pour le champ de saisie 'Search by title' (Rechercher par titre), qui par défaut ne recherche les produits que dans leur titre. Cet attribut permet d'étendre la recherche aux champs suivants : post_title (par défaut), post_content, post_excerpt. De plus, si vous utilisez le champ de saisie par titre issu du constructeur de filtres, cet attribut permet aussi d'utiliser la recherche textuelle avec ce seul champ.
- css_classes : toutes classes CSS pour le conteneur du tableau
- no_found_text : texte personnalisé lorsqu'aucun produit n'est trouvé
- table_view : une seule valeur est possible ici - 'separated', qui sépare les cellules du tableau de produits. Voir les pages de démonstration pour comprendre :
- post_title_as_text - désactive/active le lien sur le titre du produit (1/0)
- disable_link_on_thumb - désactive/active le lien sur la miniature du produit (1/0)
Quelques exemples d'utilisation combinée :
- [woot id=25 columns='id,title,product_cat,pa_color,pa_size' cells_width='1,80%,auto,150']
- [woot id=14 columns='id,title' filter_form='price']
- [woot id=13280 table_html_id='tt13280aa' post_status='draft' orderby_select_fields='price,price-desc']
- [woot_upsells id=49 columns='id,title,price,hmeta_1,add_to_cart' compact_view_width=800]
- [woot columns="id,post_title,cars_model" per_page=4 per_page_sel_pp="2,4,6,8" per_page_position='t' per_page_sel_position='t' order_by='post_title' order='asc']