16. E-pood

Kellele: administraator seadistab poe; toimetajad ja administraatorid haldavad tooteid ja tellimusi.

E-pood on lisamoodul. Külastajad panevad tooted ostukorvi ja maksavad Stripe’iga (kaardiga) või PayPaliga. Müüa saab füüsilisi tooteid (saadad ise) ja digitaalseid (ostja laadib faili alla). Kuni poodi sisse ei lülita, seda ei eksisteeri: pole menüükirjeid, lehti ega plokke.

Mida vaja on

• Aktiveerimiskood. Selle saad Mellalt; see võib olla seotud sinu saidi aadressi ja lõppkuupäevaga.
• Saidi aadress täidetud: Seaded → Üldine (näiteks https://example.com). Aadressiga seotud kood töötab ainult siis, kui see klapib.
• Stripe’i ja/või PayPali ärikonto.
• Serveris seadistus SETTINGS_KEY (sama, mis kaitseb meiliparooli). Ilma selleta ei saa maksevõtmeid salvestada. Serveri haldaja võib võtmed panna ka serveri keskkonda (STRIPE_SECRET_KEY jne, vt .env.example).

Poe sisselülitamine

1. Ava Seaded ja jaotis E-pood.
2. Kleebi aktiveerimiskood ja klõpsa Aktiveeri. Välja all on näha, kas kood kehtib ja kui kaua.
3. Märgi Lülita e-pood sisse.
4. Vali valuuta, füüsiliste toodete saatmiskulu ja summa, millest alates on saatmine tasuta (0 = pole kunagi tasuta). Hinnad sisaldavad alati käibemaksu.
5. Soovi korral vali müügitingimuste leht: ostja peab enne maksmist märkima kasti, mis sellele viitab.
6. Soovi korral sisesta aadress uute tellimuste teadete jaoks (muidu kasutatakse kontaktiaadressi).
7. Klõpsa Salvesta seaded.

Vasakusse menüüsse ilmub grupp E-pood (Tooted, Tellimused) ja lehe-ehitajas Pood ploki grupp.

Kui eemaldad aktiveerimiskoodi, lülitub pood ise välja. Tooted ja tellimused jäävad alles.

Maksete seadistamine

Tee seda: Seaded → E-pood → Maksed. Võtmeid ei saa tagasi lugeda: pärast salvestamist on näha ainult, et need on salvestatud.

Stripe

1. Kopeeri Stripe’i töölaualt salavõti (sk_live_…, testimiseks sk_test_…) lahtrisse Stripe’i salavõti.
2. Lisa Stripe’is veebihaak (webhook) sündmusele checkout.session.completed. Selle aadress on võtmeväljade all, näiteks https://example.com/api/shop/webhook/stripe.
3. Kopeeri veebihaagi allkirjastamise võti (whsec_…) lahtrisse Stripe’i veebihaagi allkirjastamise võti.

PayPal

1. Loo PayPali arendajate töölaual rakendus ja kopeeri selle Client ID ja Secret.
2. Vali katsetamise ajal Liivakast (testimine) ja valmis olles Live. Liivakastil ja päris keskkonnal on erinevad võtmed.

Makseviis ilmub kassasse ainult siis, kui selle võtmed on täidetud. Katseta esmalt testvõtmetega: tee ise tellimus ja kontrolli, et see jõuab jaotisse Tellimused.

Tooted

Ava Tooted ja klõpsa Uus toode.

• Pealkiri ja Kirjeldus iga saidi keele jaoks. Vaikekeele pealkiri on kohustuslik; teise keele tühi väli kasutab vaikekeele teksti.
• Tüüp: Füüsiline (saadetakse) või Digitaalne (allalaadimine).
• Hind käibemaksuga.
• Laoseis: arv või tühi (piiramatu). Nullis on toode Otsas. Laoseis väheneb, kui tellimus on makstud.
• Tootekood (SKU), sinu enda kood (valikuline).
• Pildid: peamine pilt ja lisapildid galeriisse. Ilma peamise pildita kasutatakse galerii esimest pilti.
• Kategooriad ja sildid: märgi sobivad. Loo need menüüs jaotistes Tootekategooriad ja Tootesildid; need töötavad nagu postituste kategooriad ja sildid (ka keelte kaupa), kuid on neist eraldi.
• Aadress: toote veebiaadress (/shop/…). See tehakse pealkirjast.
• Olek: Mustand on külastajale nähtamatu; Avaldatud on poes.

Digitaalsed tooted. Salvesta toode esmalt, siis lae jaotises Allalaadimine fail üles (PDF, zip, e-raamat, heli jne). Määra, mitu korda ostja tohib faili alla laadida ja mitu päeva link kehtib. Faili hoitakse avalikest failidest eraldi; ilma ostja isikliku lingita ei saa seda keegi avada.

Mida külastaja näeb

• /shop näitab avaldatud tooteid; igal on oma leht koguse lahtri ja nupuga Lisa ostukorvi.
• Ostukorv näitab read, saatmise ja kogusumma ning nuppu Vormista tellimus.
• Kassas sisestab ostja nime, e-posti ja (füüsiliste toodete puhul) saatmisaadressi ning valib Stripe’i või PayPali. Maksmine toimub Stripe’i või PayPali enda lehel, nii et kaardiandmed ei jõua sinu saidile.
• Pärast maksmist jõuab ostja tellimuse lehele, kus on tulemus ja digitoodete puhul allalaadimisnupud. Ostjale läheb kinnitusmeil (kui väljaminev meil on Seadetes seadistatud) ja sulle teade.

Igal kategoorial ja sildil on oma leht, /shop/category/<aadress> ja /shop/tag/<aadress>, mis näitab ainult selle tooteid. Poe leht näitab kategooriaid väikeste linkidena toodete kohal ja tootelehel on toote enda kategooriad ja sildid.

Toodete lisamiseks mõnele teisele lehele, näiteks avalehele, kasuta plokki Tootevõrgustik. Plokk Ostukorvi link lisab nupu ostukorvi juurde, näiteks päisesse; sellel võib olla ikoon (ostukorv, kott või korv) või sinu oma pilt ning esemete arv sulgudes või väikeses märgis. Plokk Tootekategooriad loetleb kategooriad või sildid ja Tootevõrgustik võib näidata ainult ühte kategooriat. Mõlemad on lehe-ehitaja grupis Pood.

Poe lehed kasutavad sinu päist ja jalust jaotisest Kujundus.

Poe lehtede kujundamine

Kui pood on sees, näitab Kujundus Päise, Jaluse ja Postituse kõrval veel viit malli: Pood (toodete loend), Toode, Ostukorv, Kassa ja Tellimus. Ava mõni ja muuda seda nagu iga teist lehte: liiguta, lisa ja eemalda plokke ning kujunda neid vahekaardil Kujundus (värvid, kirjad, vahed, nurgad).

• Pood kasutab plokke Poe pealkiri (kategooria lehel näitab see kategooria nime), Tootekategooriad (lingid) ja Tootevõrgustik (mitu toodet, mitu veergu, ostukorvi nupuga või ilma).
• Toode koosneb plokkidest Toote pildid, Toote nimi, Toote hind, Toote kirjeldus, Tootekategooriad ja -sildid ja Ostukast. Sisseehitatud paigutuses on pildid vasakul ja ülejäänud paremal; saad need ümber paigutada, näiteks hinna nime kohale tõsta.
• Ostukorvil, Kassal ja Tellimusel on igaühel üks põhiplokk (Ostukorv, Kassa vorm, Tellimuse kokkuvõte). Pane selle ümber pealkirju, teksti, pilte või veerge, nagu tahad, näiteks märkus tarneaja kohta kassavormi kohale.

Ehitajas näitavad need plokid väljamõeldud näidistooteid ja -tellimusi, nii et lehti saab kujundada enne, kui oled midagi müünud. Lähtesta vaikekujundusele (ehitajas) toob malli tagasi sisseehitatud paigutusele.

Tellimused

Tellimused näitab makstud tellimusi, uuemad ees. Menüüs olev number loendab uusi, mida pole veel avanud. Klõpsa tellimusel, et näha ostjat, tooteid, saatmisaadressi ja ostja märkust.

Tagasimaksed. Tee tagasimakse Stripe’is või PayPalis endas. Seejärel klõpsa siin Märgi tagastatuks: see salvestab selle ja lülitab ostja allalaadimislingid välja. Laoseisu automaatselt tagasi ei panda.

Hea teada

• Hinnad sisaldavad käibemaksu; pood ei arvuta käibemaksu, arveid ega riigipõhist saatmist. Saatmine on üks kindel summa kõigile tellimustele, milles on füüsiline toode.
• Tellimus märgitakse makstuks alles siis, kui Stripe või PayPal kinnitab sama summa, mis tellitud.
• Kui kaks ostjat maksavad viimase eseme eest samal hetkel, on mõlemad tellimused kehtivad ja laoseis jääb nulli. Sina otsustad, kuidas edasi.

Tõrkeotsing