Szűrők
Az Előfizetések bővítmény fontosabb szűrői: árszöveg, periódusok, hosszak, megújítási rendelés, újrafeliratkozás és beállítások.
A bővítmény több mint 400 szűrőt használ. Itt a hasznosabbak szerepelnek. A lista nem oktatóanyag, csak a használható pontokat mutatja.
Termék és árszöveg
Szekció neve “Termék és árszöveg”woocommerce_is_subscription a bővítmény többi része számára dönti el, hogy egy termék előfizetéses-e.
Paraméterek: $is_subscription (logikai), $product_id, $product (WC_Product). Ezzel az előfizetési funkciók egy része nem előfizetéses termékekre is bekapcsolható.
woocommerce_subscriptions_product_price_string az előfizetéses termék ár-szövegét adja (például „10 Ft / hónap, 12 hónapig, 5 Ft feliratkozási díjjal”). Az előfizetés ára összetettebb, mint egy sima termék áráé: van számlázási időszaka (például hónap), intervalluma (például 2 hetente), hossza (például 12 hónap) és feliratkozási díja. A termék ára mindenhol a WC_Subscriptions_Product::get_subscription_price_string() függvényből jön, amely ezen a szűrőn megy át.
Paraméterek: $subscription_string, $product, $include (tömb):
tax_calculation:falseaz adó figyelmen kívül hagyásához,include_taxvagyexclude_taxaz adó hozzáadásához vagy kihagyásához;subscription_length:true(alap) a hossz szerepeltetéséhez,falsea kihagyásához;sign_up_fee:true(alap) a feliratkozási díj szerepeltetéséhez,falsea kihagyásához;price: a termék tényleges ismétlődő ára helyett használt ár.
woocommerce_subscription_price_string a kosár és a rendelés végösszegének árszövege. Ugyanezek az adatok a kosárban és a rendelésen is megjelennek, ezért a WC_Subscriptions_Manager::get_subscription_price_string() függvény ezen a szűrőn adja vissza az értéket.
Paraméterek: $subscription_string, $subscription_details (tömb): initial_amount (előre fizetett összeg a feliratkozási díjjal), initial_description (az összeg után álló szó, alapból „up front”), recurring_amount, subscription_interval (alap 1), subscription_period (day, week, month, year), subscription_length (alap 0, vagyis határozatlan), trial_length (alap 0), trial_period.
woocommerce_subscriptions_product_first_renewal_payment_time az első megújítás időpontját módosítja, például egyedi hosszúságú kezdő időszakhoz, vagy olyan fizetési napra igazításhoz, amit a beépített számlázási nap igazítás nem tud. Alapból a termék számlázási időszakából és intervallumából számolódik, de bármilyen jövőbeli érvényes időpontra állítható.
Paraméterek: $first_renewal_timestamp, $product_id, $from_date_param (MySQL dátum UTC-ben, üresen a mai nap), $timezone (site vagy gmt, alap site).
Időszakok, hosszak, intervallumok
Szekció neve “Időszakok, hosszak, intervallumok”woocommerce_subscription_periods a bővítményben használt összes időszakot ($period_key => $period_labels) átadja, így módosítható, mely időszakok érhetők el és milyen felirattal. Figyelem: új időszak (például kéthetente vagy kétévente) bevezetésekor a pénztárban csak az ezeket támogató fizetési átjárókat szabad felkínálni.
woocommerce_subscription_lengths az előfizetéses termékeknél megadható hosszakat (a tömb első szintje az időszak: day, week, month, year; a második szinté a hossz egész számként, a 0 jelentése „nincs korlát”) adja át. Ezzel szűkíthetők a hosszak. Példa: határozatlan hosszú előfizetések tiltása.
function eg_do_not_allow_all_time_subscriptions( $subscription_lengths ) { foreach ( $subscription_lengths as $period => $allowed_lengths ) { if ( isset( $subscription_lengths[ $period ][0] ) ) { unset( $subscription_lengths[ $period ][0] ); } } return $subscription_lengths;}add_filter( 'woocommerce_subscription_lengths', 'eg_do_not_allow_all_time_subscriptions', 10 );woocommerce_subscription_period_interval_strings a számlázási intervallumokat (például 10 / hónap, 2 havonta, 3 havonta) adja át, ezzel korlátozható a választék. Alapból legfeljebb minden 6. időszak választható (1: „per”, 2: „every 2nd” … 6: „every 6th”). Példa: csak a minden időszakos (napi, heti, havi) számlázás engedélyezése:
function eg_do_not_allow_non_single_billing_intervals( $billing_intervals ) { array_splice( $billing_intervals, 1 ); return $billing_intervals;}add_filter( 'woocommerce_subscription_period_interval_strings', 'eg_do_not_allow_non_single_billing_intervals', 10 );Felhasználó és vásárlói műveletek
Szekció neve “Felhasználó és vásárlói műveletek”| Szűrő | Paraméterek | Mire jó |
|---|---|---|
wcs_get_users_subscriptions |
$subscriptions, $user_id |
A wcs_get_users_subscriptions() visszatérési értéke. Ezzel adhatsz a felhasználóhoz adatbázisban nem tárolt előfizetést, például ha az másik áruházban van. |
wcs_user_has_subscription |
$has_subscription, $user_id, $product_id, $status (alap any) |
Megadja, hogy a felhasználónak van-e előfizetése egy termékre, opcionális státuszszűréssel. |
wcs_users_change_status_link |
$action_link, $subscription_id, $status |
A vásárló a Fiókom → Előfizetés megtekintése oldalon gombbal módosíthatja az előfizetés státuszát. A gomb URL-jét a wcs_get_users_change_status_link() adja, ez a szűrő módosítja. Ha a link paraméterei (change_subscription_to érvényes státusszal, _wpnonce, subscription_id) rendben vannak, a bejelentkezett felhasználó saját előfizetése módosul. |
wcs_view_subscription_actions |
$action_link, $subscription_id, $status |
A Fiókom → Előfizetés megtekintése oldal gombjait a wcs_get_all_user_actions_for_subscription() adja, és ezen a szűrőn át külső kód új gombokat adhat hozzá. |
wcs_can_user_resubscribe_to_subscription |
$can_user_resubscribe, $subscription, $user_id |
Szabályozza, hogy a felhasználó újrafeliratkozhat-e. Alapból az előfizetésnek inaktívnak (lejárt vagy lemondott) kell lennie, legalább egy fizetésnek meg kell történnie (a feliratkozási díj megkerülése ellen), a szülő rendelést nem válthatta le megújítási rendelés, és a megvásárolt termék nem törölhető. Ezeket a feltételeket módosíthatod. |
Megújítási rendelés
Szekció neve “Megújítási rendelés”Az Előfizetések a megújítások minden adatát egy szokásos WooCommerce-rendelésben tárolja, amely külön jelölővel kapcsolódik az előfizetéshez.
wcs_renewal_order_created: a megújítási rendelés a wcs_create_renewal_order() függvényből jön létre (ütemezett megújításnál, kézi feldolgozásnál az előfizetés szerkesztőjében, vagy a REST API-val), ezért ezen a szűrőn bármi hozzáadható, eltávolítható vagy módosítható rajta. Például kedvezmény adható egy bizonyos megújításra (évi 12.-re), vagy egyszeri extra díj egy havi előfizetés éves megújításán.
Paraméterek: $renewal_order (WC_Order), $subscription (WC_Subscription).
wcs_renewal_order_meta_query: megújítási rendelés létrehozásakor a bővítmény a rendelés szinte minden meta-adatát átmásolja (kivéve néhány WooCommerce- és Előfizetések-adatot). A bővítmény kizárásos elvet követ: ami nincs kizárva, az másolódik, így jobb a kompatibilitás más bővítményekkel. Ha a bővítményed meta-adata egy rendeléshez kötődik (például fizetési token vagy csomagkövetési kód), ezzel a szűrővel zárd ki a másolásból. A szűrő érvényes SQL-t vár.
Paraméterek: $order_meta_query (SQL-szöveg), $to_order, $from_order.
function eg_do_not_copy_meta_data( $order_meta_query, $to_order, $from_order ) { $order_meta_query .= " AND `meta_key` NOT IN ('_my_extensions_meta_key', '_my_extensions_other_meta_key')"; return $order_meta_query;}add_filter( 'wcs_renewal_order_meta_query', 'eg_do_not_copy_meta_data', 10, 3 );Váltás és beállítások
Szekció neve “Váltás és beállítások”wcs_switch_proration_extra_to_pay: a váltáskor az időarányos fizetendő többletet módosítja. Az apply_filters( 'wcs_switch_proration_extra_to_pay', $extra_to_pay, $subscription, $cart_item, $switch_item ) hívás paraméterei: $extra_to_pay (tizedes szám, a váltás miatt fizetendő időarányos összeg), $subscription (a váltott előfizetés), $cart_item (az új termék kosártétele), $switch_item (a váltási kosártétel a váltás adataival, például a forrás előfizetéssel és a cél variációval).
woocommerce_subscription_settings: egyedi beállításokat adhatsz a WooCommerce → Beállítások → Előfizetések oldalhoz. A beállítások tömbje a woocommerce_admin_fields() formátumú, ugyanezt használja a megjelenítés (woocommerce_admin_fields()) és a mentés (woocommerce_update_options()) is.
Készült: