1.2 WooCommerce shortcodes

Shortcodes

Pagina Shortcodes (zonder pauzes/spaties)

  • [ woocommerce_cart ] – toont de winkelwagenpagina
  • [ woocommerce_checkout ] – toont de afrekenpagina
  • [ woocommerce_my_account ] – toont de gebruikersaccountpagina
  • [ woocommerce_order_tracking ] – toont het ordertraceringsformulier

In de meeste gevallen zullen deze shortcodes automatisch aan pagina’s worden toegevoegd via onze “onboarding wizard” en hoeven deze niet handmatig te worden ingevoerd.

Winkelwagen

Gebruikt op de winkelwagenpagina, geeft de shortcode van de winkelwagen, de inhoud ervan en interface weer voor couponcodes en dergelijke.

Args: none

[ woocommerce_cart ]

Afrekenen

Gebruikt op de afrekenpagina, toont de afrekeningscode voor het afrekenproces.

Args: none

[ woocommerce_checkout ]

Mijn account

Toont het gedeelte ‘mijn account’ waar de klant eerdere bestellingen kan bekijken en hun informatie kunnen bijwerken. U kunt hier het aantal orders opgeven dat kan worden weergegeven. Standaard is dit ingesteld op 15 (gebruik -1 om alle orders weer te geven.)

Args:

array(
‘current_user’ => ”
)

[ woocommerce_my_account ]

Huidig ​​gebruikersargument wordt automatisch ingesteld met get_user_by (‘id’, get_current_user_id ()).

Ordervolgformulier

Hiermee kan een gebruiker de status van een bestelling zien door zijn bestelgegevens in te voeren.

Args: none

[ woocommerce_order_tracking ]

Producten

De shortcode van het product is een van de meest robuuste shortcodes, die verschillende andere strings kan vervangen welke in eerdere versies van WooCommerce werden gebruikt.

Met de shortcode [producten] kunt u producten weergeven per:

  • post-ID,
  • SKU,
  • categorieën,
  • kenmerken,
  • met ondersteuning voor paginering,
  • willekeurige sortering en
    productlabels(tags),

Hiermee wordt de behoefte aan diverse shortcodes aanzienlijk minder aangezien deze worden vervangen door bijvoorbeeld:

  • [ featured_products ]
  • [ sale_products ]
  • [ best_selling_products ]
  • [ recent_products ]
  • [ product_attribute ]
  • [ top_rated_products ]

Die nog nodig zijn in versies van WooCommerce onder 3.2.

Bekijk de onderstaande voorbeelden.

Beschikbare productattributen

De volgende attributen zijn beschikbaar om te gebruiken in combinatie met de shortcode [producten]. Ze zijn opgesplitst in secties voor primaire functies in het bijzonder voor het gemak van navigatie.

Voorbeelden:

  • Productspecificaties weergeven limiet – Het aantal producten dat moet worden weergegeven. Standaard ingesteld op 12 bij het aanbieden van producten en -1 (alles weergeven) voor categorieën.
  • Kolommen – Het aantal kolommen dat moet worden weergegeven. Standaard is 4.
  • Paginate – Schakelt paginering aan. Gebruik in combinatie met limiet. Standaard ingesteld op false ingesteld op true to paginate. “naar pag 2,3,4,etc”.
  • Orderby – Sorteert de producten die met de ingevoerde optie worden weergegeven. Een of meer opties kunnen worden doorgegeven door beide blokken met een spatie ertussen toe te voegen. Beschikbare opties zijn:
    – Datum; de datum waarop het product is gepubliceerd.
    – Id; Het bericht-ID van het product.
    – Menu_order; De menuvolgorde, indien ingesteld (laagste getallen worden eerst weergegeven).
    – Populariteit; het aantal aankopen.
    – Rand; Willekeurige rangschikking van de producten bij het laden van de pagina (werkt mogelijk niet met sites die cachegeheugen gebruiken, omdat deze een specifieke volgorde kan opslaan).
    – Rating; De gemiddelde productwaardering.
    – Titel; De titel van het product. Dit is de standaard orderby-modus.
  • Skus – door komma’s gescheiden lijst van product-SKU’s.
  • Categorie – door komma’s gescheiden lijst van categorie slakken.
  • Order – Geeft aan of de productbestelling oplopend (ASC) of aflopend is (DESC), met behulp van de methode die in orderby is ingesteld. Standaard op ASC.
  • Class – Voegt een HTML-wrapperklasse toe, zodat u de specifieke uitvoer kunt aanpassen met aangepaste CSS.
  • On_sale – Weergave afgeprijsde producten. Niet gebruiken in combinatie met best_selling of top_rated.
  • Best_selling – Haalt de best verkopende producten op. Niet gebruiken in combinatie met on_sale of top_rated.
  • Top_rated – Weergave top rated(best beoordeelde) producten. Niet te gebruiken in combinatie met on_sale of best_selling.

Attributen productkenmerken

  • productkenmerken – haalt producten op met behulp van de gespecificeerde attribuut eigenschap (slug= pagina-url)
  • Terms – door komma’s gescheiden lijst van attributen die met attribuut moeten worden gebruikt.
  • Terms_operator – Operator om attributen te vergelijken. Beschikbare opties zijn:
    – AND; geeft producten weer van alle gekozen kenmerken.
    – IN; geeft producten weer met het gekozen kenmerk. Dit is de standaardwaarde van de terms_operator.
    – NOT IN; Zal producten tonen die niet in de gekozen attributen staan.
  • Zichtbaarheid – geeft producten weer op basis van de geselecteerde zichtbaarheid. Beschikbare opties zijn:
    – zichtbaar; producten zichtbaar in winkels en zoekresultaten. Dit is de standaard zichtbaarheidsoptie.
    – catalogus; Producten alleen in de winkel zichtbaar, maar niet in zoekresultaten.
    – zoeken; Producten die alleen in de zoekresultaten zichtbaar zijn, maar niet in de winkel.
    – verborgen; Producten die verborgen zijn voor zowel winkelen als zoeken, alleen toegankelijk via directe URL.
    – featured(uitgelicht); Producten die zijn gemarkeerd als Uitgelichte producten.
  • Category – Retries-producten met de gespecificeerde categorie slug.
  • Cat_operator – Operator om categorietermen te vergelijken. Beschikbare opties zijn:
    – AND; geeft producten weer die horen bij alle gekozen categorieën.
    – IN; Geeft producten weer binnen de gekozen categorie. Dit is de standaard cat_operator-waarde.
    – NIET IN; Geeft producten weer die niet in de gekozen categorie vallen.
  • ID’s – geeft producten weer op basis van een door komma’s gescheiden lijst van bericht-ID’s.
  • Skus – Geeft producten weer op basis van een komma-scheiding

Als een product niet zichtbaar is controleer dan of deze niet staat op “hidden(verborgen)” in de zichtbaarheid in de catalogus.

Om het product Id te vinden ga naar het dasboard “producten”, ga met uw muis over het product het product Id en de verschillende bewerkingsfuncties worden vervolgens zichtbaar.

Vind-Product-ID

Deze kenmerken kunnen niet worden gebruikt met de hierboven vermelde ‘Inhoudsattributen’, omdat ze waarschijnlijk een conflict veroorzaken en niet worden weergegeven. Gebruik alleen een van de volgende speciale kenmerken.

  • best_selling – Geeft uw best verkopende producten weer. Moet op true worden ingesteld.
  • on_sale – Geeft uw on-sale producten weer. Moet op true worden ingesteld.

Product Category shortcodes

Deze twee shortcodes zullen uw productcategorieën op elke pagina weergeven.

[ product_category ] – Geeft producten weer in een specifieke productcategorie.
[ product_categories ] – Geeft al uw productcategorieën weer.

Voorbeelden van productscenario’s
In de volgende scenario’s gebruiken we een voorbeeld van een kledingwinkel.

Scenario 1 – Willekeurige verkoopitems

Ik wil vier willekeurige on-sale producten weergeven.

[ products limit = “4” columns = “4” orderby = “populariteit” class = “quick-sale” on_sale = “true” ]
Deze shortcode explicity vermeldt vier producten met vier kolommen (die één rij zullen zijn), met de meest populaire on-sale items. Het voegt ook een snelle verkoop van CSS-klassen toe, die je in je thema kan wijzigen.

shortcode-sale
shortcode-featured

Scenario 2 – Uitgelichte producten

Ik wil mijn aanbevolen producten weergeven, twee per rij, met een maximum van vier items.

[ products limit = “4” columns = “2” visibility = “featured” ]

Deze shortcode zegt dat maximaal vier producten in twee kolommen kunnen worden geladen en dat ze moeten worden weergegeven. Hoewel niet expliciet vermeld, gebruikt het de standaardinstellingen zoals sorteren op titel (A tot Z).

Scenario 3 – Best verkopende producten

Ik wil mijn drie best verkopende topproducten in één rij weergeven.

[ products limit = “3” columns = “3” best_selling = “true” ]

shortcode-bestselling
shortcodes-newest

Scenario 4 – Nieuwste producten

Ik wil eerst de nieuwste producten weergeven: vier producten in één rij. Om dit te bereiken, gebruiken we de bericht-ID (dat wordt gegenereerd wanneer de productpagina wordt gemaakt), samen met de opdracht Order en “orderby command”. Omdat u de Post-ID niet kunt zien vanaf het frontend, zijn de ID # s over de afbeeldingen heen gelegd.

[ products limit = “4” columns = “4” orderby = “id” order = “DESC” visibility = “visible” ]

Scenario 5 – Specifieke categorieën

Ik wil alleen hoodies en shirts weergeven, maar geen accessoires. Ik gebruik twee rijen van vier.

[ products limit = “8” columns = “4” category = “hoodies, tshirts” cat_operator = “AND” ]

shortcode-categories1
shortcode-categories2

Als alternatief wil ik alleen producten weergeven die niet in die categorieën voorkomen. Alles wat ik moet veranderen is de cat_operator naar NOT IN.

[ products limit = “8” columns = “4” category = “hoodies, tshirts” cat_operator = “NOT IN” ]

Houd er rekening mee dat, hoewel de limiet is ingesteld op 8, er slechts vier producten zijn die aan die criteria voldoen, zodat er vier producten worden weergegeven.

Scenario 6 – Kenmerkweergave

Elk van de kledingartikelen heeft een kenmerk, ofwel “Lente / Zomer” ofwel “Herfst / Winter”, afhankelijk van het juiste seizoen. Sommige accessoires hebben beide omdat ze het hele jaar door gedragen kunnen worden. In dit voorbeeld wil ik drie producten per rij, met alle items van ‘Lente / Zomer’. Deze attribuut slug(url) is seizoen, en de attributen zijn warm en koud. Ik wil ook dat ze worden gesorteerd van de nieuwste producten tot de oudste.

[ products columns = “3” attribute = “season” terms = “warm” orderby = “date” ]

shortcode-attribute1
shortcode-attribute2

Als alternatief, als ik uitsluitend producten met koud weer zou willen weergeven, zou ik NOT IN als my terms_operator kunnen toevoegen:

[ products columns = “3” attribute = “season” terms = “warm” terms_operator = “NOT IN” ]

Let op: door NOT IN te gebruiken, sluit ik producten uit die zowel in “Lente / Zomer” als “Herfst / Winter” staan. Als ik alle voor het koude weer geschikte uitrusting inclusief deze gedeelde accessoires wilde laten zien, zou ik de term van warm naar koud veranderen.

Scenario 7 – Alleen categorieën op hoogste niveau weergeven

Stel je voor dat je alleen topniveaucategorieën op een pagina wilde tonen en de subcategorieën uitsluit, nou het is mogelijk met de volgende shortcode.

[ product_categories number = “0” parent = “0” ]

woocommerce-shortcodes-top-level-categories-only
Tag hoodie

Scenario 8 – Toon alleen producten met tag “hoodie”

[ products tag = “hoodie” ]

Producten sorteren op aangepaste metavelden

Wanneer u de shortcode voor producten gebruikt, kunt u ervoor kiezen producten te bestellen op basis van de vooraf gedefinieerde waarden hierboven. U kunt producten ook sorteren op aangepaste metavelden met behulp van de onderstaande code (in dit voorbeeld bestellen we producten op prijs):

add_filter ( ‘woocommerce_shortcode_products_query’, ‘woocommerce_shortcode_products_orderby’ );

functie 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’;
}

$ args teruggeven;
}

U moet dit fragment in functions.php in uw themamap plaatsen en vervolgens aanpassen door de meta_key te bewerken.

Opmerking: we kunnen geen ondersteuning bieden voor “eigen”aanpassingen.

Product pagina

Toon een volledige enkel product op 1 pagina op basis van ID of SKU.

[ product_page id = “99” ]

[ product_page sku = “FOO” ]

Gerelateerde Producten

Lijst van gerelateerde producten
Args:

array(
‘limit’ => ’12’,
‘columns’ => ‘4’,
‘orderby’ => ‘title’
)

[ related_products limit=”12″ ]

“Limit” argument

Opmerking: het korte-codeargument ‘limit’ bepaalt hoeveel producten op een pagina worden weergegeven. Dit voegt geen paginering toe aan de shortcode.

Add to cart

Opmerking: het korte-codeargument ‘limit’ bepaalt hoeveel producten op een pagina worden weergegeven. Dit voegt geen paginering toe aan de shortcode.
Args:

array(
‘id’ => ’99’,
‘style’ => ‘border:4px solid #ccc; padding: 12px;’,
‘sku’ => ‘FOO’
‘show_price’ => ‘TRUE’
‘class’ => ‘CSS-CLASS’
‘quantity’ => ‘1’;
)
[ add_to_cart id=”99″ ]

Add to cart url

“Echo” de URL op de knop Toevoegen aan winkelwagen van een enkel product op Id basis.
Args:

array(
‘id’ => ’99’,
‘sku’ => ‘FOO’
)
[ add_to_cart_url id=”99″ ]

WooCommerce-meldingen op niet-WooCommerce-pagina’s weergeven

[ shop_messages ] stelt in staat WooCommerce-meldingen weergeven (zoals ‘Het product is aan winkelwagen toegevoegd’) op niet-WooCommerce-pagina’s. Handig wanneer u andere shortcodes gebruikt, zoals [ add_to_cart ] en wilt dat de gebruikers feedback krijgen over hun acties.

Trouble shooting shortcodes

Als u uw shortcodes correct hebt geplakt maar het er niet correct uitziet, bekijk dan of u de shortcode niet tussen
< pre > -tags hebt ingesloten. Dit is een veel voorkomend probleem. Als u deze tags wilt verwijderen, bewerkt u de pagina en klikt u op het tabblad Tekst

WooCommerce-Shortcode-Pre-Tags