Tovább a tartalomhoz

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.

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: false az adó figyelmen kívül hagyásához, include_tax vagy exclude_tax az adó hozzáadásához vagy kihagyásához;
  • subscription_length: true (alap) a hossz szerepeltetéséhez, false a kihagyásához;
  • sign_up_fee: true (alap) a feliratkozási díj szerepeltetéséhez, false a 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).

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.

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 );

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:

Tiszteletben tartjuk a magánszférádat

Sütiket használunk a böngészési élmény javítására és a forgalom elemzésére. Az analitika csak akkor indul, ha engeded. Adatvédelmi irányelvek, Sütitájékoztató.

Sütibeállítások