Tovább a tartalomhoz

Kódrészletek és kiegészítő bővítmények

Kész kódrészletek és kis segédbővítmények az Előfizetések megjelenésének és működésének testreszabásához.

Ezekkel a kódrészletekkel és mini-bővítményekkel testreszabhatod az előfizetések megjelenését és működését. A kódot külön kódrészlet-bővítménybe (snippet plugin) érdemes tenni, nem a sablon fájljaiba vagy a functions.php-ba. A testreszabásokra nincs támogatás, ha módosítanod kell egy részletet, fordulj fejlesztőhöz.

Kész segédbővítmények (GitHubról tölthetők le):

  • Fizetés gomb a függő fizetésű előfizetésnél: a Fiókom → Előfizetés megtekintése oldalon közvetlenül az előfizetés mellett jelenik meg a Fizetés gomb, így nem kell lejjebb keresni a rendelést.
  • Egyszeri megerősítés lemondáskor: megerősítő ablakot ad, mielőtt az ügyfél lemondja az előfizetést. A WooCommerce → Beállítások → Előfizetések oldalon ki- és bekapcsolható.
  • Megerősítés fizetési mód törlésekor: emlékeztet, hogy a fizetési módot használó előfizetéseket is frissíteni kell. Csökkentheti a sikertelen fizetéseket.

Gombok elrejtése és hozzáadása:

  • A Fizetési módok fül elrejtése a Fiókom menüből:
add_filter( 'woocommerce_account_menu_items', 'remove_payment_methods_tab_my_account', 999 );
function remove_payment_methods_tab_my_account( $items ) {
unset( $items['payment-methods'] );
return $items;
}
  • A Lemondás gomb elrejtése az előfizetés megtekintésénél (a többi művelet látszik marad):
function eg_remove_my_subscriptions_button( $actions, $subscription ) {
unset( $actions['cancel'] );
return $actions;
}
add_filter( 'wcs_view_subscription_actions', 'eg_remove_my_subscriptions_button', 100, 2 );
  • Egyes műveletek elrejtése csak egy adott termékű előfizetésnél: a $subscription->has_product( $product_id ) feltétellel, a change_payment_method, change_address, switch, resubscribe, pay, reactivate és cancel kulcsok közül a kívántakat törölve az $actions tömbből ugyanazon a wcs_view_subscription_actions szűrőn.
  • A felfüggesztés tiltása megadott termékeknél (a termékazonosítók listájában szereplő terméket tartalmazó előfizetést az ügyfél nem függesztheti fel):
function prevent_suspension_per_product( $user_can_suspend, $subscription ) {
if ( ! $user_can_suspend ) {
return $user_can_suspend;
}
$product_ids = array( 438, 128, 2, 345 ); // a tiltandó termékek azonosítói
foreach ( $product_ids as $product_id ) {
if ( $subscription->has_product( $product_id ) ) {
return false;
}
}
return $user_can_suspend;
}
add_filter( 'wcs_can_user_put_subscription_on_hold', 'prevent_suspension_per_product', 15, 2 );
  • A Lemondás gomb elrejtése a próbaidőszak alatt: a wcs_view_subscription_actions szűrőben a $subscription->get_time( 'trial_end' ) értékét az aktuális időhöz mérve, ha a próbaidő még tart, töröld a cancel elemet.
  • A Lemondás gomb elrejtése, ha az előfizetésnek van beállított befejezési dátuma: ugyanezen a szűrőn, a get_time( 'end' ) értéke alapján.
  • Gombok az Előfizetések listán (Fiókom): a woocommerce_my_subscriptions_actions akcióba kapcsolva a wcs_get_all_user_actions_for_subscription() eredményéből külön Fizetési mód módosítása, Megújítás most vagy Lemondás gomb írható ki a lista soraiban, ha az adott művelet elérhető.
  • Egyedi árszöveg: az Custom Price String for WooCommerce Subscriptions bővítménnyel átírhatod a termékoldalakon megjelenő árszöveget, az egyszerű, változó és előfizetéses termékekét, a „-tól” árakat és a foglalható termékeket is.
  • Kupon automatikus alkalmazása újrafeliratkozáskor: a WOOCOMMERCE_SUBSCRIPTIONS_AUTO_RESUBSCRIBE_COUPON állandóval megadott kupont a bővítmény minden újrafeliratkozási kosárra ráteszi. A kupon máshol is használható, ha nem korlátozod.
  • Termékkategória elrejtése a bolt oldalról: a woocommerce_product_query akcióban egy tax_query feltétellel (a product_cat taxonómia egy adott slugjára NOT IN operátorral) kizárhatod a kategóriát a boltból. A termékek közvetlen hivatkozással továbbra is elérhetők.
  • Átirányítás a kosárra: a woocommerce_add_to_cart_redirect szűrőben, ha a hozzáadott termék előfizetéses (WC_Subscriptions_Product::is_subscription()), a visszaadott cím a kosár címe (WC()->cart->get_cart_url()). Egy meghatározott oldalra is irányíthatsz: a szűrő a get_permalink( <oldal azonosítója> ) értékét adja vissza.
  • „Számlázási adatok” cím átírása „Fiókadatok”-ra fizetés nélküli pénztárnál (például ingyenes próba): a gettext szűrővel, ha a kosárnak nincs szüksége fizetésre.
  • Az „ismétlődő összeg x-ként” szöveg a blokkos pénztárban: a sorszámnév nélküli alak (például „3. naponta” helyett „3 naponta”) a blokkos pénztár szövegeinek wp.hooks i18n.gettext szűrőjével módosítható, a woocommerce-subscriptions szövegtartomány „Recurring total every” kezdetű szövegeire.
  • Egyedi számlázási gyakoriság (például 50 havonta): a woocommerce_subscription_period_interval_strings szűrővel egy új érték adható az intervallumok listájához:
function wcs_custom_frequency( $intervals ) {
$custom_frequency = 50; // a kívánt szám
$intervals[ $custom_frequency ] = sprintf( __( 'every %s', 'my-text-domain' ), WC_Subscriptions::append_numeral_suffix( $custom_frequency ) );
return $intervals;
}
add_filter( 'woocommerce_subscription_period_interval_strings', 'wcs_custom_frequency' );
  • Hosszabb futamidők (például 48 hónap, 10 és 20 év): a woocommerce_subscription_lengths szűrővel:
function eg_extend_subscription_expiration_options( $subscription_lengths ) {
$subscription_lengths['year'][10] = wcs_get_subscription_period_strings( 10, 'year' );
$subscription_lengths['year'][20] = wcs_get_subscription_period_strings( 20, 'year' );
$subscription_lengths['month'][48] = wcs_get_subscription_period_strings( 48, 'month' );
return $subscription_lengths;
}
add_filter( 'woocommerce_subscription_lengths', 'eg_extend_subscription_expiration_options' );
  • Több változat az AJAX-os választóban: a woocommerce_ajax_variation_threshold szűrő értékét 500-ra emelve sok változat esetén is gördülékenyen töltődnek be a változatok.
  • Lemondás a sikertelen újrapróbálások után: egy segédbővítmény lemondja a rendelést és az előfizetést is, ha minden automatikus újrapróbálás elbukott (alapból az előfizetés csak felfüggesztve marad).
  • A „Lemondás függőben” állapot kihagyása: egy segédbővítmény azonnal Lemondva állapotba teszi az előfizetést, ha az ügyfél lemondja a Fiókomban.
  • Lemondás teljes visszatérítésnél: egy segédbővítmény azonnal lemondja az előfizetést, ha a szülő vagy a legutóbbi megújítási rendelést teljesen visszatérítik. A régebbi rendelések visszatérítése nem váltja ki.
  • Csak kézi megújításra érvényes kupon: a megadott kuponkódok csak megújítási rendelés kifizetésekor használhatók, az első feliratkozáskor nem. A kódok a beállítóoldalon, állandóval vagy szűrővel adhatók meg.
  • Termék korlátozása adott számú aktív előfizetésre: az előfizetéses termék a megadott számú, még le nem zárult előfizetésig vásárolható (például kizárólagos tagság). A limit elérése után a termék a vásárlói oldalon már nem vásárolható, a kézi megújítás és a sikertelen fizetések rendezése viszont továbbra is megy.
  • Az eredeti számlázási nap megtartása késői fizetésnél: a következő megújítás dátuma az eredeti ütemezett fizetési dátumból számolódik, nem a tényleges fizetésből, így az előfizetés például mindig a hónap 1-jén újul meg.
  • Korai megújítás szinkronizált előfizetéseknél: egy segédbővítmény lehetővé teszi az idő előtti megújítást a számlázási napra igazított előfizetéseknél is.
  • A készlet ne csökkenjen megújításkor: a WooCommerce alapból megújítási rendelésnél is csökkenti a készletet. Egy segédbővítmény ezt kikapcsolja, így a készlet csak az első vásárláskor módosul.
  • Egyedi újrapróbálási szabályok: a wcs_default_retry_rules szűrővel lecserélheted az alapértelmezett szabályokat. A példában az első sikertelen fizetés után azonnal e-mail megy az ügyfélnek, majd 12 óra, 12 óra, 1 nap, 2 nap és 3 nap múlva próbál újra a rendszer. Közben a rendelés Függőben, az előfizetés Felfüggesztve állapotú marad. Minden szabály tartalmazza a retry_after_interval, email_template_customer, email_template_admin, status_to_apply_to_order és status_to_apply_to_subscription mezőt.
  • Szerepkör ne változzon: alapból a bővítmény az előfizetés aktiválásakor, lemondásakor, lejáratakor módosítja a felhasználó szerepkörét. Kikapcsolható:
add_filter( 'woocommerce_subscriptions_update_users_role', '__return_false', 100 );
  • Letöltések lemondás vagy lejárat után is: a woocommerce_order_is_download_permitted szűrővel igaz értéket adva a Lemondva és Lejárt előfizetésekre, az ügyfél továbbra is eléri a letölthető fájlokat.
  • Az ügyfél is megkapja a lemondott rendelés e-mailjét: a woocommerce_email_recipient_cancelled_order szűrővel a címzettekhez add hozzá az ügyfél e-mail-címét.

Segédbővítmények üzemeltetéshez és hibakereséshez

Szekció neve “Segédbővítmények üzemeltetéshez és hibakereséshez”
  • Az összes megújítás szüneteltetése: megakadályozza, hogy az Action Scheduler felvegye az ütemezett műveleteket (automatikus fizetés, újrapróbálás, futamidő vége), a többit nem érinti. A feloldás után a kimaradt műveletek azonnal lefutnak. Csak az Előfizetések bővítmény kezelte előfizetésekre hat, a régi PayPal Standardra és a WooPayments előfizetésekre nem.
  • Subscriptions Importer and Exporter: ingyenes eszköz előfizetők CSV-vel történő átviteléhez, lásd az átviteli fejezetet.
  • A jelentések gyorsítótárának automatikus frissítése le: teljesítményt javíthat, vagy megakadályozhatja az ismétlődő, nem kívánt frissítéseket jelentéssűrű oldalakon.
  • Összegek újraszámolása adóbeállítás-változás után: minden előfizetés összegét újraszámolja, hogy az új adóbeállítások érvényesüljenek.
  • Megújítási események naplózása: a WooCommerce naplóiba ír wcs-renewal-log- előtaggal, így követhető, miért nem megy végig az automatikus megújítás.
  • Megújítási események időtartamának mérése: a megújítási események kezdetét és végét naplózza, szintén wcs-renewal-log- előtaggal. A naplók a WooCommerce → Állapot → Naplók oldalon láthatók.
  • Következő fizetési dátumok eltolása: minden előfizetés következő fizetési dátumát 1 perccel hátrébb teszi. Az időzónák eltéréséből adódó dupla megújítások kezelésére való.
  • Az előkészítő mód kikapcsolása (Backstage): kikapcsolja az előkészítő módot, amelyet egyébként a cím megváltozása indít el. Több előtér-címmel működő oldalnál hasznos (például WPML), ahol minden környezet ugyanazt a WordPresst használja. Figyelem: a másolt vagy előkészítő címeken is élesben fizetést fog feldolgozni, ezért klónozáskor nagyon kell vigyázni.
  • Automatikus fizetés kiválasztott előfizetésekre előkészítő módban (Upstage): a duplikált terhelések elleni védelem megtartásával lehet fizetést tesztelni.
  • Előfizetés állapotának ellenőrzése adminértesítéssel: egy adott azonosítójú előfizetés állapotát (aktív, nem aktív, nem található) admin figyelmeztetésben mutatja ki, hibakereséshez. Az előfizetést a wcs_get_subscription( $azonosito ) függvénnyel kéri le, az állapotot a get_status() adja.

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