HUB3 barkod za PrestaShop: Modul koji kupcu s bankovnom uplatom prikazuje 2D barkod s IBAN-om, iznosom i pozivom na broj, pa se nalog u aplikaciji banke popuni sam

Sadržaj

1. Što modul radi
2. Instalacija
3. Postavke
4. Barkod u e-mailu kupcu
5. Barkod na PDF računu
6. Rješavanje problema
7. Česta pitanja

Što modul radi

Kad kupac odabere plaćanje bankovnom uplatom, modul generira 2D barkod po standardu HUB3 s podacima za uplatu: IBAN primatelja, iznos, model HR00 i poziv na broj te podatke platitelja. Kupac barkod skenira aplikacijom svoje banke i nalog za plaćanje popuni se sam, bez prepisivanja.

• Barkod se prikazuje na stranici potvrde narudžbe.
• Barkod se sam dodaje u e-mail s podacima za bankovnu uplatu, bez uređivanja predloška.
• Barkod se sam dodaje na PDF račun dok narudžba nije plaćena.
• Barkod se generira na vašem poslužitelju, bez vanjskih servisa, bibliotekom TCPDF koja dolazi s PrestaShopom.

Poziv na broj je referenca narudžbe ako se sastoji samo od znamenki; inače se koristi ID narudžbe. Modul je u radu na trgovini s PrestaShopom 1.7.8.

Instalacija

Kroz administraciju (preporučeno)

1. Preuzmite .zip (gumb na vrhu stranice).
2. U administraciji otvorite Moduli → Upravitelj modula.
3. Kliknite Učitaj modul i odaberite datoteku hub3payment-1.7.1.zip.
4. Nakon instalacije kliknite Konfiguriraj.

Preko FTP-a

1. Raspakirajte .zip na računalu.
2. Mapu hub3payment prebacite u mapu /modules/ na poslužitelju.
3. U administraciji pronađite modul i kliknite Instaliraj.

Nadogradnja sa starije verzije: novu .zip datoteku učitajte preko postojećeg modula. PrestaShop pri nadogradnji sam uključuje barkod u e-mailu i na računu, a postavke ostaju sačuvane.

Postavke

Kliknite Spremi. Modul radi uz PrestaShopov modul za bankovnu uplatu (ps_wirepayment): provjerite je li on instaliran i aktivan, jer se za druge načine plaćanja barkod ne prikazuje.

Barkod u e-mailu kupcu

Barkod se u e-mail s podacima za bankovnu uplatu (bankwire) dodaje sam, ispod podataka banke. Predložak e-maila ne treba uređivati. Barkod ide samo u HTML verziju e-maila; tekstualna verzija ostaje nepromijenjena.

Barkod na drugom mjestu u e-mailu

1. Pronađite predložak za bankovnu uplatu, obično /themes/VAŠA_TEMA/mails/hr/bankwire.html (za engleski /en/bankwire.html).
2. Na željeno mjesto zalijepite oznaku {hub3_html_block}.
3. Spremite datoteku. Kad oznaka postoji u predlošku, modul barkod stavlja samo na to mjesto i ne dodaje ga drugi put.

Izgled bloka u e-mailu mijenja se u datoteci /modules/hub3payment/views/templates/hook/mail_barcode.tpl.

Za e-mail se slika barkoda sprema u mapu /modules/hub3payment/img/ pod nasumičnim imenom, jer je e-mail klijent dohvaća s poslužitelja. Slika sadrži podatke za uplatu (ime i adresu platitelja), pa staru arhivu te mape po potrebi povremeno obrišite.

Barkod na PDF računu

Na PDF račun narudžbe plaćene bankovnom uplatom modul sam dodaje barkod s iznosom, IBAN-om i pozivom na broj. Predložak računa ne treba uređivati.

Barkod se prikazuje samo dok narudžba nije plaćena, kako kupac ne bi platio dvaput. U standardnim postavkama PrestaShop račun izdaje tek u statusu „Plaćanje prihvaćeno”, kada barkod više nije potreban. Ako račun izdajete prije uplate (npr. u statusu „Čeka se bankovna uplata” uključite opciju da se kupcu izda račun), barkod će se na njemu prikazati.

Izgled bloka na računu mijenja se u datoteci /modules/hub3payment/views/templates/hook/pdf_invoice.tpl.

Rješavanje problema

Barkod se vidi na webu, ali ne u e-mailu

• Provjerite prima li kupac e-mail u HTML obliku; u tekstualnoj verziji e-maila barkoda nema.
• Ako ste oznaku {hub3_html_block} dodali ručno, provjerite je li u predlošku za jezik kupca.
• Provjerite smije li web poslužitelj pisati u mapu /modules/hub3payment/img/ (uobičajeno dozvole 755 uz vlasnika koji je korisnik web poslužitelja). Ne postavljajte dozvole 777.

Bankovna aplikacija ne prepoznaje barkod

• Provjerite je li IBAN ispravno upisan, bez razmaka.
• Provjerite sadrže li naziv ili adresa neobične simbole (npr. emojije). Hrvatska slova modul sam prilagođava, ostali simboli mogu smetati.

Barkod se uopće ne prikazuje

• Kupac mora odabrati plaćanje bankovnom uplatom.
• PrestaShop mora sadržavati biblioteku TCPDF (dolazi uz standardnu instalaciju); bez nje modul ništa ne prikazuje.

Barkoda nema na PDF računu

• Provjerite je li narudžba već plaćena; na računu plaćene narudžbe barkoda namjerno nema.
• Ako vaša tema ima vlastiti predložak računa (/themes/VAŠA_TEMA/pdf/invoice.tpl), on mora sadržavati mjesto za module: {$HOOK_DISPLAY_PDF}. Standardni PrestaShop predložak ga ima.

Česta pitanja

Licenca, odgovornost i prilagodba

Modul je objavljen pod licencom AFL-3.0, bez jamstva i bez obveze podrške. Za usklađenost poslovanja odgovara trgovac.

Modul za sidrenu cijenu i cjenik za PrestaShop i WooCommerce te aplikacija za Shopify su na stranici Moduli. Prilagodbu modula ili modul po mjeri radimo po ponudi.