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értelmezettfalsebeállításoktruea 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értelmezettorderbymó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_sellingvagytop_rated.best_selling– A legjobban értékesített termékek letöltése. Nem használható együtton_salevagytop_rated.top_rated– A legmagasabb minősítésű termékek letöltése. Nem használható együtton_salevagybest_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értelmezettvisibilitybeá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_operatorhogy 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 INkizá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