Namestitev in nastavitev modula za razdeljene cene

1. Prijavite se v Leanpay aplikacijo za želeno okolje (testno ali produkcijsko).

2. Pojdite v razdelek Company.

3. Pomaknite do razdelka Development in pridobite:
– API key in
– Pre-qualify URL.
API key je ključen za sinhronizacijo razpoložljivih obročnih načrtov (installment plans) za vaš račun.

4. Obiščite Shopify integracijski endpoint na https://installmentapp.leanpay.si/.

5. Vnesite Shopify store URL.

6. Preusmerjeni boste v Shopify, na zaslon za namestitev aplikacije. Kliknite Install.

7. Ko je aplikacija nameščena, boste preusmerjeni v configuration view. API key in Pre-qualify URL sta na voljo v Leanpay Gateway panel pod Company → Development.

– Izberite ustrezno API environment in mode za izbrani API key.
– Nastavitev Payment Information URL je izbirna. Če je URL nastavljen in vodi na stran, ki pojasnjuje možnosti plačilne metode, bo uporabljen v gumbu znotraj widgetov (“More information”).

8. Po shranjevanju (“Save & Sync plans”) bo izbirni seznam Installment group dropdown samodejno napolnjen.

9. Izberite in aktivirajte skupino, ki bo uporabljena za vse front-end calculations. Aplikacija bi morala biti zdaj konfigurirana in pripravljena za prikaz widgetov.

1. Pojdite na Store → Themes → “Customize” aktivne teme.

2. Na voljo bodo trije novi widgeti:

Product Widget

Vstavite v želeno območje znotraj strani izdelka. Dodatne nastavitve niso potrebne.

Horizontal Widget

Vstavite v katerokoli območje z večjo širino (npr. collection head).
Vrednost cene je nastavljiva ročno.

Vertical Widget

Vstavite v katerokoli območje z manjšo širino. Idealno za mobilne poglede ali sidebars.
Niz vrednosti cene (price value string) je nastavljiv ročno.

Privzeto Product widget (calculator) ne podpira dogodkov spremembe cene ob menjavi variante (price variant change events) zaradi specifik implementacije v Shopifyju. Ker vsaka tema upravlja posodobitve cen drugače, ne obstaja standardiziran način za zaznavanje teh dogodkov.

Za odpravo te omejitve in zagotavljanje združljivosti s prilagoditvami aplikacij tretjih oseb Leanpay Marketing Tools ponuja programski način za sprožanje posodobitev cene ob spremembi variant.

Primer implementacije:

// Example: When variant changes
function onVariantChange(variant) {
 // Your existing variant change logic...

 // Notify Leanpay widget of price change
 if (variant && variant.price) {
   window.dispatchEvent(new CustomEvent('leanpay:priceChange', {
     detail: {
       price: variant.price / 100  // Convert cents to currency units
     }
   }));
 }
}

// Example: When quantity changes
function onQuantityChange(quantity) {
 const basePrice = 99.99;
 const newPrice = basePrice * quantity;

 window.dispatchEvent(new CustomEvent('leanpay:priceChange', {
   detail: {
     price: newPrice
   }
 }));
}