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.
Vásárlói oldal (Fiókom)
Szekció neve “Vásárlói oldal (Fiókom)”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, achange_payment_method,change_address,switch,resubscribe,pay,reactivateéscancelkulcsok közül a kívántakat törölve az$actionstömbből ugyanazon awcs_view_subscription_actionsszű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_actionsszű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 acancelelemet. - 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_actionsakcióba kapcsolva awcs_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ő.
Termékek és pénztár
Szekció neve “Termékek és pénztár”- 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_queryakcióban egytax_queryfeltétellel (aproduct_cattaxonómia egy adott slugjáraNOT INoperá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_redirectszű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ő aget_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
gettextszű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.hooksi18n.gettextszűrőjével módosítható, awoocommerce-subscriptionsszö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_stringsszű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_lengthsszű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_thresholdszűrő értékét 500-ra emelve sok változat esetén is gördülékenyen töltődnek be a változatok.
Megújítás, lemondás és fizetés
Szekció neve “Megújítás, lemondás és fizetés”- 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_rulesszű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 aretry_after_interval,email_template_customer,email_template_admin,status_to_apply_to_orderésstatus_to_apply_to_subscriptionmező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_permittedszű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_orderszű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 aget_status()adja.
Készült: