EDD-átvitel: visszafelé kompatibilitás

Az átvitel végén természetes ösztön kikapcsolni a Migrator bővítményt, és késznek tekinteni a munkát. Ne tedd.

A Migrator csendben visszafelé kompatibilitási réteget ad, amely a meglévő vásárlóidat fennakadás nélkül kiszolgálja. A szoftverlicencek tovább érvényesítenek, a PayPal-előfizetések tovább megújulnak, a régi EDD-URL-ek tovább működnek, a régi rendelések Stripe-webhookjai pedig megtalálják a megfelelő tranzakciót. Ha túl korán kapcsolod ki, a vásárlók érzik.

Miért létezik ez a réteg

Az EDD és a FluentCart más URL-szerkezetet, más API-végpontokat és más azonosítóformátumokat használ. Az átvitel után az adataid FluentCart-formátumban vannak, de a külvilág (a vásárlóid telepített szoftvere, a PayPal megújítási értesítései, a Stripe webhook-előzményei, a régi e-mailekben elmentett hivatkozások) még EDD-ül beszél.

A Migrator a kettő között áll, és fordít: EDD-formátumban fogadja a kéréseket, megkeresi a megfelelő FluentCart-rekordot, és a munkát a megfelelő helyre irányítja. A vásárlók semmi különbséget nem látnak. Ez a réteg teszi az átvitelt éles átvágás helyett puha átmenetté.

Mit kezel a réteg

Az összegző képernyő négy területet sorol fel, amelyeket a Migrator továbbra is áthidal.

Licenc-API végpontok

Ha EDD Software Licensinggel adtál el szoftvert, a vásárlóid bővítményei, témái vagy alkalmazásai rendszeresen hívják az oldaladat, hogy:

• aktiváljanak egy licencet egy új telepítésen;
• kikapcsoljanak egy licencet eltávolításkor;
• ellenőrizzék, hogy a licenc még érvényes-e;
• keressenek szoftverfrissítést.

Ezek a hívások az EDD URL-formátumát és paramétereit használják. A Migrator mindegyiket elfogja, megkeresi a megfelelő FluentCart-licencet, a műveletet a FluentCarton keresztül végzi el, és a vásárló szoftvere által várt formátumban válaszol. A vásárlóknak nem kell frissíteniük a szoftverüket, és nem veszik észre a változást.

PayPal IPN a régi előfizetésekhez

Az EDD-korszakban létrehozott aktív PayPal Standard előfizetések minden megújító fizetésnél továbbra is az EDD régi IPN-végpontjára küldenek azonnali fizetési értesítést. A Migrator nélkül ezek az értesítések csendben elbuknak: az előfizetés a PayPal oldalán tovább megújulni látszik, de a FluentCart sosem rögzíti a megújítást.

A Migrator elkapja az IPN-t, azonosítja az előfizetést, létrehozza a megújító rendelést a FluentCartban, és frissíti az előfizetés számlázásszámát. A PayPal tovább terheli a vásárlót, a FluentCart pedig tud róla.

Stripe-webhook terhelésazonosító feloldása

A Stripe korábban terhelésazonosítókkal (ch_xxx) azonosította a tranzakciókat. A mai Stripe-webhookok a fizetési szándék azonosítójára (pi_xxx) hivatkoznak. Az EDD-ből átvitt rendeléseknél az eredeti tranzakciós rekord a terhelésazonosítót tárolja, így a csak fizetési szándék azonosítóval érkező webhook nem találja meg a rendelését.

A Migrator a FluentCart tranzakció-keresésébe tartalék feloldást köt be, amely a régi rekordoknál a terhelésazonosítót fizetési szándék azonosítóra (és fordítva) oldja fel. Az átvitt rendelések webhookjai így helyesen érvényesülnek.

Régi EDD letöltési és megújítási URL-ek

A régi e-mailek, könyvjelzők, fiókoldalak és külső hivatkozások EDD-formátumú URL-eket tartalmazhatnak:

• /?edd_action=process_download&...
• /?edd_action=...&order_id=... a megújítási hivatkozásokhoz;
• az EDD fiókoldalaira mutató vásárlói irányítópult-hivatkozások.

A Migrator felismeri ezeket, és a megfelelő FluentCart-URL-re irányítja át, így az egy évvel ezelőtti e-mailből érkező vásárló a megfelelő oldalra kerül, nem 404-re.

Mikor kapcsolható ki a Migrator

Nincs rögzített határidő. A helyes válasz: „amikor a régi forgalom nullára csökken”. A legtöbb boltnál ez legalább egy teljes előfizetési számlázási ciklust jelent az átvitel után, általában egy évet. Hosszú lecsengésű licencaktiválásoknál még többet.

Ésszerű teszt: nézd meg a hozzáférési naplóidban, volt-e az elmúlt 30 napban találat EDD-formátumú URL-ekre. Ha nem volt, valószínűleg kikapcsolhatod a Migratort. Ha még érkeznek kérések, hagyd aktívan.

Az Easy Digital Downloadst jóval a Migrator előtt kikapcsolhatod. A Migrator az összeférhetőségi munkához nem igényli az EDD aktív állapotát, csak a FluentCartba átvitt adatokat.

A kikapcsolás biztonságos sorrendje:

1. Az átvitel kész és ellenőrzött.
2. Futtasd a wp fluent_cart_migrator migrate_from_edd --verify_license parancsot a licencek épségének ellenőrzéséhez.
3. Kösd újra a fizetési átjárókat a FluentCartban.
4. Kapcsold ki az Easy Digital Downloadst.
5. Hagyd a Migratort és az EDD adatbázistábláit az átmeneti időszakra.
6. Az átmeneti idő után (jellemzően 6-12 hónap) értékeld, megszűnt-e a régi forgalom.
7. Csak ezután fontold meg a Migrator kikapcsolását és az edd_cleanup futtatását.

Mi romlik el, ha túl korán kapcsolsz ki

Ha kikapcsolod	Mi romlik el
Easy Digital Downloads (a Migrator még aktív)	Semmi, ami a vásárlóknak látszana. A Migrator az összeférhetőségi munkát önállóan kezeli.
FluentCart Migrator (EDD-korszakbeli licencvásárlókkal)	Az EDD-korszakban eladott szoftver licencaktiválása és frissítésellenőrzése leáll. A vásárlók „érvénytelen licenc” hibát látnak.
FluentCart Migrator (aktív PayPal Standard előfizetésekkel)	A megújító fizetések a PayPalnál megtörténnek, de a FluentCartban sosem rögzítődnek. Az előfizetések lejártnak látszanak, miközben tovább terhelődnek.
FluentCart Migrator (régi, elmentett hivatkozásokkal)	A régi EDD-formátumú URL-ek 404-et adnak.

Ezek egyike sem romlik el azonnal vagy látványosan neked: a vásárlóknál csendben buknak el, ami a legrosszabb fajta hiba. Hagyd aktívan a Migratort, amíg aktívan meg nem győződtél arról, hogy nincs több régi forgalom.

Teljesítményhatás

A kompatibilitási réteg könnyű. Csak akkor kapcsolódik a kérések irányításához, ha egy bejövő URL vagy webhook EDD-formátumú mintára illik, így a normál FluentCart-forgalmat nem érinti. Tétlenül a Migrator semmibe nem kerül.

Kapcsolódó fejezetek: Hibaelhárítás (ha egy vásárló törött licencről vagy hiányzó megújításról panaszkodik) és WP-CLI (a --verify_license és az edd_cleanup parancs).