Függvények: lemondás és megújítás

Mindhárom függvény a 3.0-s verziótól elavult, az újabb kód a konkrét tagságra épülő megfelelőiket használja. Egyedi kód, ezért a bevezetéséhez érdemes fejlesztő segítségét kérni.

rcp_can_member_cancel()

Megmondja, hogy a felhasználó le tudja-e mondani az automatikus megújítást az oldalról (a weboldali lemondó hivatkozással, az átjáróban is). Az elavult RCP_Member osztályt és az ügyfél elsődleges tagságát használja, ahogy a régi, egytagságos oldalakon.

Új kódban használd az rcp_can_membership_be_cancelled( $membership_id ) függvényt vagy az RCP_Membership::can_cancel() metódust, ha ismered a tagságot.

A lemondás csak akkor engedélyezett, ha a tagság ismétlődő, a státusza aktív, ki van fizetve, nem járt le, és az átjáró támogatja az oldalról történő lemondást (Stripe, API-hozzáféréssel rendelkező PayPal és Braintree, adatokkal beállított 2Checkout és hasonlók). Szűrője: rcp_membership_can_cancel.

• $user_id (egész): a felhasználó azonosítója. Alapérték: 0, ez a bejelentkezett felhasználót jelenti.

Visszatérési érték: true, ha a tag lemondhat, különben false.

if ( rcp_can_member_cancel() ) {
  // Mutasd a lemondó hivatkozást a bejelentkezett felhasználónak.
}

$membership = rcp_get_customer_single_membership( $customer_id );
if ( $membership && rcp_can_membership_be_cancelled( $membership->get_id() ) ) {
  // Ez az ajánlott módszer, ha ismered a tagság azonosítóját.
}

A lemondás admin oldali menetéről a „Tagságok lemondása” fejezet szól, a lemondó hivatkozás címét az rcp_get_membership_cancel_url() adja.

rcp_can_member_renew()

Megmondja, hogy a felhasználó megújíthatja-e a tagságát a bővítmény megújítási folyamatán át. Az ügyfél egyetlen tagságát tölti be az rcp_get_customer_single_membership() függvénnyel, ami akkor a megfelelő, ha a több tagság le van tiltva.

Új kódban az adott tagság RCP_Membership::can_renew() metódusát használd.

A megújítás jellemzően nem lehetséges: aktív, automatikusan megújuló előfizetésnél, lejárat nélküli (none) aktív tagságnál, ingyenes tagságnál, befejezett részletfizetési tervnél és inaktív tagsági szintnél (kivéve, ha az rcp_can_renew_deactivated_membership_levels szűrő engedi). Szűrője: rcp_membership_can_renew.

• $user_id (egész): a felhasználó azonosítója. Alapérték: 0, ez a bejelentkezett felhasználót jelenti.

Visszatérési érték: true, ha a megújítás engedélyezett. false, ha nem az, vagy ha nincs ügyfél vagy tagság.

if ( rcp_can_member_renew() ) {
  // Mutass megújítás gombot vagy a regisztrációs oldalra mutató hivatkozást.
}

$membership = rcp_get_membership( $membership_id );
if ( $membership && $membership->can_renew() ) {
  // Egy konkrét tagság ellenőrzése.
}

rcp_cancel_member_payment_profile()

Az ügyfél elsődleges tagságához (rcp_get_customer_single_membership()) tartozó fizetési profilt, vagyis az előfizetést mondja le az átjárónál. Ha akarod, a tagság státuszát is cancelled-re állítja (ez az alapérték). Ha több tagság engedélyezett, csak az elsődleges tagság mondódik le, nem a fiók összes tagsága.

Új kódban az rcp_cancel_membership_payment_profile( $membership_id, $set_status ) függvényt használd, ha ismered a tagság azonosítóját. Visszatérési értéke true vagy WP_Error, az átjáró rétegétől függően.

• $member_id (egész): a WordPress-felhasználó azonosítója. Alapérték: 0, ez a bejelentkezett felhasználót jelenti (az rcp_get_customer_by_user_id() alapján).
• $set_status (logikai): beállítsa-e a tagság státuszát cancelled-re. Alapérték: true.

Visszatérési érték: true, ha a lemondás sikerült. false, ha nincs ügyfél vagy tagság, ha a $member_id értéke 0 és senki nincs bejelentkezve, vagy ha az átjáró WP_Error-t adott.

$success = rcp_cancel_member_payment_profile( get_current_user_id() );

if ( $success ) {
  // A fizetési profil lemondva az átjárónál.
}

$result = rcp_cancel_membership_payment_profile( $membership_id, true );

if ( is_wp_error( $result ) ) {
  // Az átjáró hibájának kezelése.
}