WooCommerce v2 lekérdezési ciklusok és dinamikus címkék

A Bricks WooCommerce-specifikus lekérdezési ciklusokat és dinamikus címkéket ad a haladó moduláris Kosár, Pénztár és Fiókom elrendezésekhez.

Akkor használd őket, ha a haladó moduláris elemekkel építkezel, vagy ha egyéni, kosárfüggő elrendezés kell, például minikosár a Dinamikus töredék elemben.

Lekérdezési ciklusok

A ciklus típusát a Lekérdezés típusa vezérlőben választod. A wooCart a meglévő Kosár tartalma ciklus. A többi csak akkor jelenik meg, ha a haladó moduláris elemek be vannak kapcsolva.

Lekérdezés típusa	Felirat a szerkesztőben	Mire jó
wooCart	Kosár tartalma	A látható kosártételek: kosársorok és egyéni minikosár-sorok.
wooCartCoupons	Pénztár : Felhasznált kuponok	A kosárra felhasznált kuponok.
wooCartFees	Pénztár : Felhasznált díjak	A kosár díjai.
wooCartTaxes	Pénztár : Felhasznált adók	A kosár adósorai.
wooOrderItems	Rendelés : Rendelési tételek	A jelenlegi rendelés tételei.
wooOrderTotals	Rendelés : Rendelés összesen	A jelenlegi rendelés összegsorai.
wooOrderDownloads	Rendelés : Rendelés letöltései	A jelenlegi rendelés letölthető tételei.
wooOrderCustomerNotes	Rendelés : Vásárlói megjegyzések	A jelenlegi rendelés vásárlói megjegyzései.
wooAccountOrders	Fiók : Rendelések	A vásárló rendelései a Rendelések állapotban.
wooAccountOrderActions	Fiók : Rendelési műveletek	Az aktuális rendelés műveletei egy wooAccountOrders cikluson belül.
wooAccountDownloads	Fiók : Letöltések	A fiókhoz elérhető letöltések.
wooAccountAddresses	Fiók : Címek	A számlázási és szállítási címsorok a Címek állapotban.

A rendelési ciklusok az aktuális rendelés környezetét használják. Ez a környezet megvan a Pénztár v2 Fizetés, Köszönjük és Rendelés visszaigazolása állapotában, a Fiókoldal v2 Megrendelés megtekintése állapotában és a rendelésfüggő fiókciklusokon belül.

Kosár címkék

Ezeket a wooCart ciklusban használd:

Címke	Mit ad
{woo_cart_product_name}	A kosártétel terméknevét a WooCommerce kosártétel-metaadataival együtt.
{woo_cart_product_title}	A termék címe változatattribútumok és más kosártétel-metaadat nélkül. A :plain leveszi a termékhivatkozást.
{woo_cart_item_price}	A formázott egységár. Akciós tételnél az eredeti és a jelenlegi ár is szerepel a WooCommerce akciós ár jelölésével. A :value a formázatlan, jelenlegi egységárat adja.
{woo_cart_item_save}	A teljes tételmennyiségre számolt formázott megtakarítás. A :value a formázatlan összeget, a :percentage a kedvezmény százalékát adja százalékjel nélkül.
{woo_cart_remove_link}	Az eltávolító hivatkozás. Ha csak az URL kell: {woo_cart_remove_link:url}.
{woo_cart_quantity}	A mennyiségmező. A számértékhez: {woo_cart_quantity:value}.
{woo_cart_subtotal}	A kosársor részösszege.

A wooCart cikluson belül termékcímkék is használhatók, például {featured_image}, {woo_product_price}, {woo_product_sku} és {woo_product_gtin}.

A {woo_cart_product_title} akkor jó, ha a termékcímet és a tételadatokat külön elemben vagy stílussal kell megjeleníteni. A {woo_cart_product_name} megmarad azoknak az elrendezéseknek, amelyek az összevont kimenetre épülnek (tételmetaadatok, utánrendelési értesítések, WooCommerce kosártétel-horgok).

A {woo_cart_item_price} az aktuális kosártétel termékét vagy változatát használja, és követi a bolt kosár adómegjelenítési beállítását. A {woo_cart_item_save} ezt az egységárat hasonlítja az eredeti árhoz, majd a pénzbeli megtakarítást megszorozza a tétel mennyiségével.

Kosártétel adatai elem

A Kosártétel adatai elemet egy Kosár tartalma lekérdezési cikluson belülre tedd. A változatattribútumokat és a tételadatokat a terméknévtől külön jeleníti meg.

Az elem akkor is kiírja a változatattribútumokat, ha az értékük szerepel a változat nevében. Kiírja a WooCommerce woocommerce_get_item_data szűrőjén át hozzáadott kompatibilis adatokat is, és megőrzi a bővítmények biztonságos, formázott megjelenítési értékeit.

A kimenet vezérlői:

• Címkék megjelenítése és Címke utótagja. Az alapértelmezett utótag a :.
• Elválasztók megjelenítése és Elválasztó. Az alapértelmezett elválasztó a /.
• Elrendezési vezérlők: irány, törés, igazítás, elosztás, sor- és oszloptávolság.
• Tételvezérlők: irány, igazítás, távolság, belső margó, háttér, szegély és doboz-árnyék.
• Címke- és Érték-vezérlők: szélesség, növekedés és zsugorodás, térköz, háttér, szegély, doboz-árnyék és tipográfia.
• Elválasztó tipográfiája és margója.

Ha az elemet Kosár tartalma cikluson kívül használod, vagy az aktuális tételnek nincs tételadata, a weboldalon nem jelenít meg semmit.

Kosárösszegek és pénztári címkék

Ezek a címkék a kosárban, a pénztárban és a kosárfüggő töredékekben a wooCart cikluson kívül is használhatók:

• {woo_cart_items_count}
• {woo_cart_order_subtotal}
• {woo_cart_order_total}
• {woo_cart_applied_coupon_total_amount}
• {woo_cart_applied_fee_total_amount}
• {woo_cart_shipping_method}
• {woo_cart_shipping_total_amount}
• {woo_free_shipping_min_amount}
• {woo_free_shipping_remaining}
• {woo_free_shipping_progress}
• {woo_checkout_current_step_number}
• {woo_url}

Egyes címkék a :value szűrővel formázatlan számot adnak a formázott WooCommerce-HTML helyett, például {woo_cart_shipping_total_amount:value} és {woo_free_shipping_progress:value}.

Kupon-, díj- és adócímkék

Lekérdezési ciklus	Címkék
wooCartCoupons	{woo_cart_applied_coupon}, {woo_cart_applied_coupon_amount}
wooCartFees	{woo_cart_applied_fee}, {woo_cart_applied_fee_amount}
wooCartTaxes	{woo_cart_applied_tax_label}, {woo_cart_applied_tax_amount}

Ha csak az összesített érték kell, használd a cikluson kívüli összegcímkéket: {woo_cart_applied_coupon_total_amount} és {woo_cart_applied_fee_total_amount}.

WooCommerce URL címke

A {woo_url} címkével a gyakori WooCommerce-oldalak és végpontok URL-jét írhatod ki. Kulcs nélkül a bolt URL-jét adja.

Címke	Mit ad
{woo_url} vagy {woo_url:shop}	A Bolt oldal URL-je
{woo_url:cart}	A Kosár oldal URL-je
{woo_url:checkout}	A Pénztár oldal URL-je
{woo_url:account} vagy {woo_url:myaccount}	A Fiókom oldal URL-je
{woo_url:dashboard}	A fiók vezérlőpult végpontjának URL-je
{woo_url:orders}	A fiók rendelések végpontjának URL-je
{woo_url:downloads}	A fiók letöltések végpontjának URL-je
{woo_url:addresses} vagy {woo_url:edit-address}	A fiók címszerkesztő végpontjának URL-je
{woo_url:edit-account}	A fiókszerkesztő végpont URL-je
{woo_url:payment-methods}	A fizetési módok végpontjának URL-je
{woo_url:add-payment-method}	A fizetési mód hozzáadása végpont URL-je
{woo_url:lost-password}	Az elfelejtett jelszó végpont URL-je
{woo_url:order-withdrawal}	A Rendelés elállása végpont URL-je, ha engedélyezve van
{woo_url:customer-logout}	A kijelentkezés végpont URL-je
{woo_url:terms}	A WooCommerce általános szerződési feltételek oldalának URL-je
{woo_url:privacy}	A WooCommerce adatvédelmi oldalának URL-je

A regisztrált WooCommerce fiókvégpont-lekérdezési változók kulcs szerint is feloldhatók. Ez csak URL-t ad vissza, nem ad hozzá egyéni Fiókoldal v2 állapotot.

Fiók címkék

A Fiókoldal v2 állapotaiban használhatók.

Környezet	Címkék
Címek állapot	{woo_account_addresses_description}
wooAccountAddresses lekérdezési ciklus	{woo_account_address_type}, {woo_account_address_title}, {woo_account_address}, {woo_account_address_has_address}, {woo_account_address_edit_url}, {woo_account_address_action_label}
Cím szerkesztése állapot	{woo_account_edit_address_title}, {woo_account_edit_address_type}, {woo_account_edit_address_type_label}

Rendelés elállása címkék

Ezek a címkék haladó moduláris elemeket és olyan WooCommerce-verziót igényelnek, amely tartalmazza a Rendelés elállása funkciót, és az be van kapcsolva. A Fiókoldal v2 Rendelés elállása állapotában használd őket.

Címke	Mit ad
{woo_order_withdrawal_screen}	Az aktuális képernyő: form, review vagy confirmation. A szerkesztőben üres.
{woo_order_withdrawal_value:first_name}	A megadott keresztnév.
{woo_order_withdrawal_value:last_name}	A megadott vezetéknév.
{woo_order_withdrawal_value:email}	A megadott e-mail-cím.
{woo_order_withdrawal_value:email_confirmation}	A megadott e-mail-megerősítés.
{woo_order_withdrawal_value:order_number}	A megadott rendelésszám.
{woo_order_withdrawal_value:withdrawal_type}	Az elállás típusának kulcsa, például full_order vagy specific_items_only.
{woo_order_withdrawal_value:withdrawal_type_label}	Az elállás típusának felirata, például „Entire order” vagy „Specific items only”.
{woo_order_withdrawal_value:additional_details}	A megadott további részletek, a sortörések szövegként megmaradnak. Üres mezőnél a „None provided” szöveget írja ki.

Az értékcímkék a szerkesztőben mintaadatot, a weboldalon a beküldött űrlapértékeket mutatják. Nem kérnek le adatot egy egyező WooCommerce-rendelésből, és nem hoznak létre rendelési környezetet a rendelési címkéknek és ciklusoknak. Az elállási állapot weboldali megjelenítésén kívül nem adnak értéket.

Rendelési címkék

Pénztár v2 rendelési állapotokban, Fiókoldal v2 rendelési állapotokban vagy rendelésfüggő lekérdezési ciklusokban használhatók.

Általános rendelési címkék:

• {woo_order_id}
• {woo_order_number}
• {woo_order_date}
• {woo_order_status}
• {woo_order_failed_text}: a sikertelen rendelés üzenete (lásd lent).
• {woo_order_total}
• {woo_order_payment_title}
• {woo_order_email}
• {woo_order_checkout_payment_url}
• {woo_order_again_url}
• {woo_order_user_id}
• {woo_order_billing_address}
• {woo_order_billing_phone}
• {woo_order_shipping_address}
• {woo_order_shipping_phone}
• {woo_order_view_url}
• {woo_order_view_aria_label}
• {woo_order_item_count}
• {woo_order_total_with_item_count}

A wooOrderItems cikluson belül:

• {woo_order_item_name}
• {woo_order_item_title}: a termék címe változat-metaadat nélkül. A :plain leveszi a termékhivatkozást.
• {woo_order_item_quantity}
• {woo_order_item_price}
• {woo_order_item_line_subtotal}
• {woo_order_item_meta}

A {woo_order_item_title} a Rendelési tétel adatai elemmel együtt hasznos, ha a cím és a mentett rendelési metaadat külön stílust kap. Ha az eredeti terméket törölték, a címke a rendeléssel elmentett tételnévre vált vissza.

A Rendelési tétel adatai elemet egy Rendelés : Rendelési tételek lekérdezési cikluson belülre tedd. A mentett változat- és egyéb formázott rendelési tétel-metaadatokat jeleníti meg a Pénztár v2 Fizetés, Köszönjük és Rendelés visszaigazolása állapotában, a Fiókoldal v2 Megrendelés megtekintése állapotában és a Fiók : Rendelések cikluson belüli Rendelési tételek cikluson.

A Kosártétel adatai és a Rendelési tétel adatai elem vezérlői megegyeznek, de más adatforrást használnak. A kosártétel adatai az aktív kosárból jönnek, a rendelési tétel adatai a mentett rendelési tételből, a WooCommerce formázott metaadat-szűrőinek lefuttatásával.

Egyéni CSS-hez az elemek külön osztályelőtagot használnak:

Kimenet	Kosártétel adatai	Rendelési tétel adatai
Gyökér	.brx-cart-item-data	.brx-order-item-data
Tétel	.brx-cart-item-data__item	.brx-order-item-data__item
Címke	.brx-cart-item-data__label	.brx-order-item-data__label
Érték	.brx-cart-item-data__value	.brx-order-item-data__value
Elválasztó	.brx-cart-item-data__separator	.brx-order-item-data__separator

Minden tétel kap egy metaadat-kulcs módosító osztályt is, például .brx-cart-item-data__item--color, és egy ugyanilyen data-key attribútumot.

A wooOrderTotals cikluson belül:

• {woo_order_total_label}
• {woo_order_total_value}

A wooAccountOrderActions cikluson belül, általában egy wooAccountOrders cikluson belül:

• {woo_order_action_url}
• {woo_order_action_name}
• {woo_order_action_aria_label}

A wooOrderDownloads vagy wooAccountDownloads cikluson belül:

• {woo_order_download_product}
• {woo_order_download_name}
• {woo_order_download_url}
• {woo_order_downloads_remaining}
• {woo_order_download_access_expires}

A wooOrderCustomerNotes cikluson belül:

• {woo_order_customer_note_date}
• {woo_order_customer_note_comment}

Sikertelen rendelés üzenete

A {woo_order_failed_text} címkével a fizetési hiba üzenetét írhatod ki a Pénztár v2 Köszönjük állapotában. A weboldalon csak olyan aktuális rendelésnél ad üzenetet, amelynek az állapota Sikertelen. Más állapotnál, vagy ha nincs elérhető rendelés, nem ad értéket.

Az üzenet a WooCommerce woocommerce_thankyou_order_failed_text szűrőjét használja, amely megkapja az üzenetet és az aktuális WC_Order objektumot. A Bricks a HTML-t a wp_kses_post() függvénnyel tisztítja, és ha a szűrő nem szöveget ad vissza, visszaállítja az alapértelmezett, lefordított üzenetet.

A szerkesztőben a sikertelen előnézeti rendelés a szűrt üzenetet mutatja. Ha nincs sikertelen előnézeti rendelés, a Bricks az alapértelmezett üzenetet mutatja a szűrő meghívása nélkül.

Egy már mentett Pénztár v2 elrendezés frissítését a Pénztár oldal fejezet írja le.

Feltételek

A Bricks pénztár- és rendelésfüggő elrendezésekhez WooCommerce-feltételeket ad:

• Pénztár : Bejelentkezési lépés szükséges
• Pénztár : Szállítás szükséges
• Pénztár : Szállítási cím szükséges
• Pénztár : A rendelés állapota
• Rendelés : Szállítási cím szükséges
• Rendelés : Van letöltése

Segítségükkel a pénztárlépéseken, a Köszönjük és Rendelés visszaigazolása elrendezéseken, a Megrendelés megtekintése képernyőkön és más pénztár- vagy rendelésfüggő részeken jeleníthetsz meg vagy rejthetsz el tartalmat.

• Pénztár : Bejelentkezési lépés szükséges csak a kijelentkezett vásárlóknál ad Igen értéket, ha a WooCommerce-ben a Pénztári belépés bekapcsolása be van kapcsolva. A generált többlépéses Pénztár v2 ezzel rejti el a Fiók belépés lépést és a hozzá tartozó navigációt, ha a lépés nem elérhető.
• Pénztár : Szállítás szükséges a szállítási módokhoz és a teljes Szállítás lépéshez való. Igen értéket ad, ha a nem üres kosárban van szállítást igénylő termék. Többlépéses pénztárnál a Szállítás lépésre és a hozzá tartozó navigációs elemre is alkalmazd.
• Pénztár : Szállítási cím szükséges a „Szállítás másik címre” vezérlőhöz és a szállítási címmezőkhöz való. Ha a WooCommerce a szállítást a számlázási címre kényszeríti, ez a feltétel Nem értéket ad, még ha a kosárnak szállítás is kell.

A feltételek beállítását és az összehasonlítás működését az Elemfeltételek fejezet írja le.

A Rendelés elállásának képernyője feltétellel (Adataid, Áttekintés vagy Megerősítés érték) a Fiókoldal v2 elállási állapotának megfelelő szakaszát jelenítheted meg. Haladó moduláris elemeket és bekapcsolt WooCommerce Rendelés elállása funkciót igényel. A szerkesztőben mind a három szakasz látható marad.

Interakciók

A Bricks három WooCommerce-interakcióindítót ad:

• Bricks cart contents changed: lefut egy megerősített AJAX-os tételhozzáadás, -eltávolítás vagy mennyiségváltoztatás és a kapcsolódó felületfrissítések után. Nem fut le a kezdeti szinkronizálásnál, változatlan mennyiségnél, sikertelen frissítésnél, kupon-, cím-, szállítás- vagy csak összegújraszámításnál.
• Bricks dynamic fragments refreshed: lefut, miután a Dinamikus töredék tartalma frissült.
• Bricks checkout step changed: lefut, miután a Pénztár v2 lépése megváltozott.

A cart contents changed indító akkor is elérhető, ha a WooCommerce aktív, a Dinamikus töredék nélküli oldalakon is. A másik kettőhöz haladó moduláris elemek kellenek. Egyéni kosár-megerősítő felugróhoz a cart contents changed indítót használd (lásd Interakciók): a töredékfrissítés önmagában nem igazolja, hogy a kosártételek változtak.

A Pénztár lépés interakciós művelet a többlépéses pénztárat a következő vagy az előző lépésre, egy adott lépésre vagy egy adott pénztármezőre állíthatja. A célul szolgáló lépést vagy mezőt a látótérbe is görgetheti.

A teljes többlépéses menetet a Többlépéses pénztár fejezet írja le.

JavaScript-események

Fejlesztők ugyanezekre a weboldali eseményekre figyelhetnek:

document.body.addEventListener("bricks/woocommerce/cart-contents-changed", (event) => {
  console.log(event.detail.requestId, event.detail.sourceEvent);
});

document.body.addEventListener("bricks/woocommerce/fragments/refreshed", (event) => {
  console.log(event.detail.fragments);
});

document.body.addEventListener("bricks/woocommerce/checkout-step-changed", (event) => {
  console.log(event.detail.stepId);
});

A bricks/woocommerce/cart-contents-changed eseménynél a requestId a megerősített kérést azonosítja, a sourceEvent az AJAX-végpont nevét tartalmazza (például bricks_update_cart_item_quantity), vagy update_cart értéket kosároldali kérésnél. Az esemény nem tartalmaz kosártétel-adatot.

Kuponhiba-események

A Bricks egyéni kuponkezelői ezeket a WooCommerce-eseményeket küldik, ha a válasz hibaértesítést tartalmaz. jQuery(document.body).on() hívással figyelheted őket:

Esemény	Bricks kezelő	További argumentumok
errored_coupon	Kosár kupon, bekapcsolt „Kosár frissítése AJAX-szal” beállítással	Kuponkód, a visszaadott értesítés nyers HTML-je
errored_coupon_in_checkout	Pénztár kupon	Kuponkód, a visszaadott értesítés nyers HTML-je

A meglévő applied_coupon és applied_coupon_in_checkout esemény a hibás válaszoknál is lefut, ezért nem igazolják, hogy a kupont elfogadták.