A WooCommerce programban szereplő rövid kódok (shortcodes)
A cikk utóljára frissítve: 2021. január 5th 11:15 de.
A WooCommerce számos olyan rövid kódot tartalmaz, amelyekkel a tartalmak beillesztése a bejegyzésekbe és az oldalakba.
Oldalkódok
- [woocommerce_cart] – a kosár oldalát mutatja
- [woocommerce_checkout] – megmutatja a fizetési oldalt
- [woocommerce_my_account] – a felhasználói fiók oldalát mutatja
- [woocommerce_order_tracking] – a rendeléskövetési űrlapot mutatja
A legtöbb esetben ezek a rövid kódok automatikusan hozzáadódnak az oldalakhoz az onboarding varázslón keresztül, és nem kell manuálisan használni.
kosár
A kocsioldalon használva a kosár rövidítése megjeleníti a kosár tartalmát és az interfészet a kuponkódokhoz és más kosárdobozokhoz.
Args: nincs
[Woocommerce_cart]
Fizetés
A fizetési oldalon használt pénztárkód jelzi a fizetési folyamatot.
Args: nincs
[Woocommerce_checkout]
Számlám
Megmutatja a „fiókom” részt, ahol az ügyfél megtekintheti a múltbeli megbízásokat és frissítheti az információkat. Megadhatja a megjelenítendő rendelések számát. Alapértelmezés szerint ez 15-re van állítva (a -1- et használja az összes megrendelés megjelenítéséhez .)
paraméterek:
array( 'current_user' => '' )
[Woocommerce_my_account]
Rendeléskövetési űrlap
Lehetővé teszi, hogy a felhasználó megnézze a megrendelés állapotát a megrendelési adatok megadásával.
Args: nincs
[Woocommerce_order_tracking]
Termékek
A termékek rövid kódja az egyik legerősebb rövid kódja, amely helyettesítheti a WooCommerce korábbi verzióiban használt más karakterláncokat. A WooCommerce 3.1-es vagy annál alacsonyabb verziója esetén használja ezt a dokumentumot .
A [products]
érvényesítőkód segítségével megjeleníteni termékek postai azonosítóját, SKU, kategória, jellemzők, támogatja a oldalszámozás, véletlenszerű válogatás és termék címkék helyett az igény többszöröse shortcodes mint: ,
[featured_products]
, [sale_products]
, [best_selling_products]
, [recent_products]
, [product_attribute]
, és [top_rated_products]
, amelyek szükségesek a változatok a WooCommerce alatt 3.2. Tekintse át az alábbi példákat.
Elérhető termékjellemzők
Az alábbi attribútumok a [products]
rövid kóddal együtt használhatók . A navigáció megkönnyítése érdekében az elsődleges funkciókhoz szekciókat osztottak szét, az alábbi példákkal.
A termék tulajdonságainak megjelenítése
limit
– A megjelenítendő termékek száma. Alapértelmezés szerint a-1
( és az összes megjelenítése) a termékek listázásakor, és-1
(összes megjelenítése) kategóriákra.columns
– A megjelenítendő oszlopok száma. Alapértelmezés szerint4
.paginate
– A lapozás bekapcsolása. Használja együttlimit
. Az alapértelmezettfalse
beállításoktrue
a lapozáshoz.orderby
– Rendezi a bevitt opció által megjelenített termékeket. Egy vagy több opciót át lehet adni mindkét csúszkával, köztük egy szóközzel. A rendelkezésre álló lehetőségek:date
– A termék közzétételének dátuma.id
– A termék azonosítója.menu_order
– A menü sorrendje, ha be van állítva (először az alacsonyabb számok megjelenítése).popularity
– A vásárlások száma.rand
– Véletlenszerűen rendelje meg a termékeket az oldalterhelésen (előfordulhat, hogy nem működik a gyorsítótárazást használó webhelyeken, mivel egy meghatározott sorrendet menthet).rating
– Az átlagos termékminősítés.title
– A termék címe. Ez az alapértelmezettorderby
mód.
skus
– A termék SKU-k vesszővel elválasztott listája.category
– vesszővel elválasztott lista a csúszkákról.order
– Megadja, hogy a termék megrendelése növekvő (ASC
) vagy csökkenő (DESC
) értékű , az itt megadott módszerrelorderby
. Alapértelmezés szerintASC
.class
– Hozzáad egy HTML burkolóosztályt, így módosíthatja az egyedi kimenetet az egyéni CSS segítségével.on_sale
– Eladni a termékeket. Nem használható együttbest_selling
vagytop_rated
.best_selling
– A legjobban értékesített termékek letöltése. Nem használható együtton_sale
vagytop_rated
.top_rated
– A legmagasabb minősítésű termékek letöltése. Nem használható együtton_sale
vagybest_selling
.
Tartalmi termékjellemzők
attribute
– A megadott attribútumcsúszkát használó termékek lekérése.terms
– A vesszővel elválasztott attribútum-kifejezések listájaattribute
.terms_operator
– Az üzemeltető az attribútum-kifejezések összehasonlítására. A rendelkezésre álló lehetőségek:AND
– Megjeleníti a termékeket a kiválasztott tulajdonságok közül.IN
– Megjeleníti a kiválasztott attribútummal rendelkező termékeket. Ez az alapértelmezettterms_operator
érték.NOT IN
– Olyan termékeket jelenít meg, amelyek nem szerepelnek a kiválasztott attribútumokban.
visibility
– Megjeleníti a termékeket a kiválasztott láthatóság alapján. A rendelkezésre álló lehetőségek:visible
– A boltban és a keresési eredményeken látható termékek. Ez az alapértelmezettvisibility
beállítás.catalog
– Csak a boltban látható termékek, de nem a keresési eredmények.search
– Csak a keresési eredményeken látható termékek, de nem a boltban.hidden
– Olyan termékek, amelyek mind az üzletben, mind a keresésben rejtve vannak, és csak közvetlen URL-címen érhetők el.featured
– Kiemelt termékekként megjelölt termékek.
category
– Megismétli a termékeket a megadott kategória slug használatával.cat_operator
– Az üzemeltető a kategóriafogalmak összehasonlításához. A rendelkezésre álló lehetőségek:AND
– Megjeleníti az összes kiválasztott kategóriába tartozó termékeket.IN
– Megjeleníti a kiválasztott kategóriába tartozó termékeket. Ez az alapértelmezettcat_operator
érték.NOT IN
– Megjeleníti azokat a termékeket, amelyek nem tartoznak a kiválasztott kategóriába.
ids
– Megjeleníti a termékeket a Postaazonosítók vesszővel elválasztott listájából.skus
– Megjeleníti a termékeket a vesszővel elválasztott listából.
* Ha a termék nem jelenik meg, győződjön meg róla, hogy nincs beállítva a Rejtett a katalógus láthatóságában.
Speciális termékjellemzők
Ezeket az attribútumokat nem lehet használni a fent felsorolt „Tartalmi attribútumokkal”, mivel valószínűleg konfliktusokat okoznak és nem jelennek meg. Csak az alábbi speciális attribútumok egyikét használja.
best_selling
– Megjeleníti a legjobb eladási termékeket. Be kell állítanitrue
.on_sale
– Megjeleníti az értékesített termékeket. Be kell állítanitrue
.
Termékkategóriák rövid kódjai
A két rövid kód bármelyik oldalon megjeleníti a termékkategóriákat.
[product_category]
– A termékeket egy meghatározott termékkategóriában jeleníti meg.[product_categories]
– Megjeleníti az összes termékkategóriát.
Példa termék szcenáriók
A következő forgatókönyvekben egy példaként használt ruházati üzletet fogunk használni.
1. forgatókönyv – Véletlenszerű eladások
Négy véletlenszerűen értékesített terméket szeretnék megjeleníteni.
[products limit="4" columns="4" orderby="popularity" class="quick-sale" on_sale="true" ]
Ez a rövid kód négy termékből áll, amelyek négy oszlopot tartalmaznak (amelyek egy sorban lesznek), amelyek a legnépszerűbb eladási tételeket mutatják. Hozzáad egy CSS osztályt is quick-sale
, amelyet a témámban módosíthatok.
2. forgatókönyv – Kiemelt termékek
Szeretnék megjeleníteni a soronként megjelenő két termékemet, legfeljebb négy elemet.
[products limit="4" columns="2" visibility="featured" ]
Ez a rövid kód azt mondja, hogy legfeljebb négy termék két oszlopba töltődik be, és ezeknek tartalmaznia kell. Bár nem kifejezetten meg van adva, az alapértelmezett értékeket használja, mint például a cím szerinti rendezés (A-tól Z-ig).
3. forgatókönyv – Legjobb eladási termékek
Egy sorban szeretném megjeleníteni a három legjobb eladási termékemet.
[products limit="3" columns="3" best_selling="true" ]
4. forgatókönyv – legújabb termékek
Először a legújabb termékeket szeretném megjeleníteni – négy termék egy sorban. Ehhez a postai azonosítót (amely a termék oldala létrehozásakor jön létre), a rendelés és a rendelés parancs használatával fogjuk használni. Mivel nem látja a Postazonosítót a frontendről, az ID # s a képek fölé kerültek.
[products limit="4" columns="4" orderby="id" order="DESC" visibility="visible"]
5. forgatókönyv – specifikus kategóriák
Csak kapucnis pólókat és ingeket szeretnék megjeleníteni, de nem tartozékokat. Két sor négy sort használok.
[products limit="8" columns="4" category="hoodies, tshirts" cat_operator="AND"]
Alternatívaként csak azokat a termékeket szeretném megjeleníteni, amelyek nem szerepelnek ezekben a kategóriákban. Mindössze annyit kell változtatnom, cat_operator
hogy a NOT IN
.
[products limit="8" columns="4" category="hoodies, tshirts" cat_operator="NOT IN"]
Ne feledje, hogy annak ellenére, hogy a határértéket választotta 8
, csak négy termék felel meg a kritériumoknak, így négy termék jelenik meg.
6. forgatókönyv – Attribútum kijelzés
A ruházati cikkek mindegyike rendelkezik a „tavaszi / nyári” vagy „őszi / téli” tulajdonságokkal, a megfelelő szezontól függően, és néhány tartozéknak mindkettője van, mivel egész évben viselni lehet. Ebben a példában soronként három terméket akarok, amelyek az összes „tavaszi / nyári” elemet jelenítik meg. Ez az attribútum slug season
, és az attribútumok warm
és cold
. Azt is szeretném, ha a legújabb termékektől a legrégebbihez rendeznék őket.
[products columns="3" attribute="season" terms="warm" orderby="date"]
Egy másik változat szerint, ha akartam megjeleníteni kizárólag hideg időjárás termékek, én is hozzá NOT IN
, mint én terms_operator
:
[products columns="3" attribute="season" terms="warm" terms_operator="NOT IN"]
Ne feledje, hogy a használatával NOT IN
kizárom azokat a termékeket, amelyek mind a „tavaszi / nyári”, mind a „őszi / téli” termékek. Ha akartam mutatni az összes hideg időben megfelelő felszerelés, beleértve a jelen megosztott kiegészítők, azt megváltoztatni a kifejezést warm
, hogy cold
.
7. forgatókönyv – csak a legfelső szintű kategóriák megjelenítése
Képzeld el, hogy csak a legfelső szintű kategóriákat szeretnéd megjeleníteni az oldalon, és kizárni az alkategóriákat, de ez az alábbi rövid kóddal lehetséges.
[product_categories number="0" parent="0"]
8. szcenárió – Csak termékek megjelenítése a „hoodie” címkével
[products tag="hoodie"]
Termékek rendezése egyedi meta mezők segítségével
A Termékek rövid kód használatakor választhat, hogy a termékeket a fent megadott értékekkel rendelheti meg. A termékeket az egyes meta mezők segítségével is rendezheti az alábbi kód használatával (ebben a példában az árat megrendeli):
add_filter( 'woocommerce_shortcode_products_query', 'woocommerce_shortcode_products_orderby' ); function 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'; } return $args; }
Ezt a részletet a theme.php fájlba kell helyeznie a téma mappájába, majd testre szabhatja a meta_key szerkesztésével.
Termékoldal
Egy teljes termékoldal megjelenítése ID vagy SKU szerint.
[product_page id = "99"] [product_page sku = "FOO"]
Kapcsolódó termékek
Sorolja fel a kapcsolódó termékeket.
paraméterek:
array( 'limit' => '12', 'columns' => '4', 'orderby' => 'title' ) [related_products limit="12"]
“limit” érv
Kosárba
Mutassa az azonos termék árának és kosarának gombját.
paraméterek:
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"]
Kosár URL-je
Válasszon azonosítóval az URL-címet az egyetlen termék kosárba gombjával.
paraméterek:
array( 'id' => '99', 'sku' => 'FOO' )
[add_to_cart_url id="99"]
A WooCommerce értesítések megjelenítése a nem WooCommerce oldalakon
[shop_messages]
lehetővé teszi a WooCommerce értesítések megjelenítését (például: „A termék hozzáadva a kosárhoz”) a nem WooCommerce oldalakon. Hasznos, ha más rövid kódokat használ, mint például [add_to_cart]
, és szeretné, ha a felhasználók visszajelzést kapnának a tevékenységükről.
Hibakeresés Rövid kódok
Ha helyesen illesztette be a rövid kódokat, és a kijelző nem megfelelő, győződjön meg róla, hogy nem helyezte be a rövid kódot a <pre> címkék közé. Ez egy gyakori probléma. A címkék eltávolításához szerkessze az oldalt, és kattintson a Szöveg fülre