Professional Documents
Culture Documents
Vejledning - Commerce, 2. Udg
Vejledning - Commerce, 2. Udg
Dokumentation
Vejledning i oprettelse af produkter og
lagerhåndtering i Commerce til TYPO3
Udarbejdet af:
Stenskjær.dk
v/ Michael Stenskjær Christensen
michael@stenskjaer.dk / michael31255902@gmail.com
For: Jesuswear.dk
Vejledning til oprettelse af produkter samt lagerhåndtering i Commerce til TYPO3.
Af: Michael S. Christensen 20-07-08
Indledning................................................................................................................... 3
Terminologi ............................................................................................................... 3
Forholdet mellem produkter og artikler ............................................................... 3
Kategorier og visning på hjemmesiden ................................................................. 4
Brugeropsætning af commerce ............................................................................. 4
Oprettelse af produktegenskaber ........................................................................ 4
Oprettelse af kategorier......................................................................................... 5
Oprettelse af produkter......................................................................................... 6
Oprettelse af artikler.............................................................................................. 8
CASE: Oprettelse af en trøje som produkt. ....................................................... 9
Lagerhåndtering ..................................................................................................12
Indkommende ordrer.............................................................................................12
2
Vejledning til oprettelse af produkter samt lagerhåndtering i Commerce til TYPO3.
Af: Michael S. Christensen 20-07-08
Indledning
Dette er en manual i opsætning af produkter med forskellige egenskaber i shopmodulet
Commerce til TYPO3. Administrationen af Commerce befinder sig i TYPO3s backend,
hovedsagligt under menupunktet ”Commerce” i menuen til venstre. Statistikmodulet
og ordremodulet er ikke færdigt udviklede i Commerce og er derfor ikke implementeret
i opsætningen af shoppen på Jesuswear.dk.
Derudover vejledes der i denne guide også til administration af lagerbeholdning,
hvor der gøres brug af et udvidelsesmodul til Commerce der hedder Commerce_ext.
Dette modul har også mulighed for at administrere påmindelser til butikkens kunder
om betaling, samt at producere fakturaer i pdf-format. Disse funktioner er ikke
implementeret på Jesuswear.dk
Vær opmærksom på, at billeder i denne guide ikke nødvendigvis er totalt identiske
med, hvad man møder i TYPO3 backenden, dette vil skyldes varierende
brugerrettigheder. Ikke desto mindre bør de være anvendelige til illustration og
vejledning.
Terminologi
Frontend: Den del af hjemmesiden, som brugeren ser, og som man kommer til ved at
skrive hjemmesidens adresse.
Backend: Administrationsdelen, som man kommer til ved at tilføje /typo3 til
hjemmesidens adresse og derefter skrive sit brugernavn og adgangskode.
Modul: En afgrænset funktionalitet i systemet. Når der i denne guide refereres til
moduler, tilgås de fra menupunkterne i venstre side af backenden.
Sidetræ: Den hierarkiske oversigt over hjemmesidens struktur af sider, som ses, når
man vælger page- eller listmodulet i backenden.
3
Vejledning til oprettelse af produkter samt lagerhåndtering i Commerce til TYPO3.
Af: Michael S. Christensen 20-07-08
(hastighed og stabilitet) har det ingen betydning, men hvis der skal ændres priser, kan
dette bliver lidt mere omstændigt.
Brugeropsætning af commerce
Oprettelse af produktegenskaber
Før der oprettes produkter og artikler, er det en fordel at definere de egenskaber, det
skal være muligt at give en artikel. Egenskaber kan også tilføjes efter oprettelsen af
produkter og artikler.
Først vælges modulet ”systemdata” under punktet
”Commerce” i menuen til venstre.
Hvis der allerede er oprettet én eller flere egenskaber,
vil de, samt deres værdier, da være at finde og ændre.
Men i første omgang nøjes vi med at vælge ”Create
new attribute”. Derefter skal egenskabens ”basic
data” indtastes. Følgende felter er til rådighed: Titel,
Internal Title og Unit, samt afkrydsningsboxen ”has
valuelist”. Titlen er den tekst der vil blive vist i
frontenden. Feltet ”internal title” giver mulighed for at definere en title, som kun vil
være synlig i backenden, og som altså kan have særlig anvendelighed i forhold til
administrationen. I feltet ”unit” kan man angive en eventuel enhed, som vil blive tilføjet
egenskabens værdi som suffix. Det vil sige, at hvis man eksempelvis skriver ”kg.” i dette
felt og giver en artikel værdien 12 for denne egenskab, vil der i frontenden stå: ”12 kg.”.
I feltet ”has valuelist” skal man vælge, om den aktuelle egenskab har en række
forskellige værdier, som man enten kan vælge imellem i backenden, når man definerer
en artikel, eller som brugeren kan vælg imellem i frontenden i en drop-down liste.
Afkrydser man dette felt, skal siden kort opdatere for at vise nye felter – for når man
vælger ”has valuelist”, skal man afgøre, hvorvidt det skal være muligt at vælge flere
værdier for egenskaben på samme tid (dette illustreres på s. 8).
4
Vejledning til oprettelse af produkter samt lagerhåndtering i Commerce til TYPO3.
Af: Michael S. Christensen 20-07-08
NB: På dette niveau i systemet vil det ikke blive fortolket korrekt, hvis man
indtaster danske bogstaver. Det skyldes, at der anvendes et karaktersystem, der ikke
indeholder de danske bogstaver. Det vil sige, at for at skrive æ, ø og å, skal man
anvende de såkaldte ascii karakter koder, som er en definition
af det ønskede tegn i et sprog, som dette karaktersystem kan æ æ
1
forstå. Se tabellen for reference til danske bogstaver. Vær ø ø
opmærksom på, at når disse koder anvendes, skal de betragtes å å
som et normalt bogstav. Det vil sige, at der ikke skal være Æ Æ
mellemrum eller andet før eller efter koden. Størrelse
Ø Ø
vil eksempelvis blive vist som ”Størrelse” i frontenden.
Å Å
Hvis man glemmer dette, rapporteres der også en fejl i
backenden, ved hver enkel artikel, under fanebladet ”edit attributes”. Det er
udelukkende i netop disse felter, at jeg har oplevet dette problem - det vil sige, at ved
alle andre felter i shoppens backend kan man som udgangspunkt anvende danske
bogstaver. Hvis det forekommer andre steder, vil man kunne se det i frontenden, hvor
de danske bogstaver vil blive vist forkert (altså, det vil snarere være nogle mærkelige
volapyk-symboler).
Oprettelse af kategorier
Først vælges modulet ”Products” under menupunktet Commerce i menuen til venstre.
1
En komplet oversigt over denne type tegnkoder er tilgængelige her:
http://www.ascii.cl/htmlcodes.htm
5
Vejledning til oprettelse af produkter samt lagerhåndtering i Commerce til TYPO3.
Af: Michael S. Christensen 20-07-08
Hvis man ønsker at oprette produktkategorier, kan man klikke på symbolet for
enten en eksisterende kategori eller den overordnede kategori (hedder: ”Category”) og
vælge ”New subcategory”, hvorefter titlen defineres. Hvis man ønsker at skjule
kategorien, sættes kryds i feltet ”hide” – på denne måde kan man undgå at slette den,
hvis det blot skal skjules midlertidigt. Man kan oprette og ændre i kategorierne som
man ønsker - for at ændre, vælger man blot ”edit”, når man trykker på den givne
kategoris ikon.
Oprettelse af produkter
For at oprette et produkt klikkes på ikonet for en kategori eller et andet produkts ikon,
hvor ”new product” vælges.
Derefter er det muligt at definere generelle
informationer om produktet. Titlen vises i frontend, men
ved nuværende opsætning har subtitle ingen funktion. I
feltet ”description” indtastes den ønskede beskrivelse af
produktet, som ønskes vist på den side der kommer ved
at trykke på produktets titel, billede eller teksten ”læs
mere” i produktlisten i frontenden. Teksten udfærdiges
med den normale teksteditor fra TYPO3, hvor det også
er muligt at lave overskrifter, indsætte links og så videre,
præcis som når man opretter normale indholdselementer. Derefter er det muligt at
uploade et eventuelt billede, som man ønsker vist på produktets detaljeside.
I feltet ”teaser” indtastes den korte beskrivelse, som der ønskes vist på produktlisten
i frontenden. (NB: det er ikke nødvendigt at skrive ”læs mere” og lave links – det
genereres automatisk, og man kan faktisk slet ikke lave det manuelt). Det er muligt at
uploade et teaserbillede – hvis man ikke gør det, bliver det billede, man evt. uploader
efter feltet ”description” vist. Dette vises dog ikke i produktlisten, når der ingen varer er
på lager, så hvis man ønsker, at der altid vises et billede (uanset lagerstatus), skal der
også uploades et billede her.2 Sidst vælges hvilke kategorier produktet skal være en del
af (det er muligt at vælge så mange kategorier som der ønskes). Bemærk: hvis et
produkt er en del af flere kategorier vil det i ”træet”, der ses på forrige billede, optræde
under alle de kategorier, det er en del af. Hvis man ændrer produkter under én af
kategorierne, ændres det automatisk alle de andre steder. Det samme gælder for
artikler tilknyttet produktet.
2
Tip: Der er ingen grund til at tage højde for billedets størrelse. Hvis det er for stort laver
TYPO3 automatisk billedet om til den rigtige størrelse, hvis det er mindre en max-
størrelsen for billeder i hhv. produktlisten og på produktets detaljeside, vises billedet som
det er. Dog er der ingen grund til at bruge meget store billeder, det tager blot længere tid
at uploade, men kvaliteten forbliver den samme i frontenden. Det er muligt at ændre max-
størrelsen for billeder i både produktlisten og på detaljesiden.
6
Vejledning til oprettelse af produkter samt lagerhåndtering i Commerce til TYPO3.
Af: Michael S. Christensen 20-07-08
Derefter defineres, hvilke egenskaber, der skal være mulige at se for dette produkt.
Vælg fanebladet ”Select attributes” (det er som udgangspunkt ikke nødvendigt at
gemme ændringerne, når man blot skifter mellem faneblade for samme produkt).
Når dette faneblad vælges, ses fem rækker: Select, Shall, Can, Product og Filter
attributes. For hver række er det muligt at vælg én eller flere af de allerede definerede
egenskaber.
Vælges egenskaber i rækken ”select”, vil det være muligt for brugeren af vælge mellem
de definerede værdier for den egenskab i en drop-down liste på produktets detaljeside
(hvis vel at mærke der er defineret flere forskellige værdier – se s. 4-5). Vælges
egenskaber til rækken ”shall” vil denne egenskab altid blive vist for produktet,
ligegyldigt om der er defineret nogen værdi for egenskaben eller ej. Produktegenskaber,
der kan tilføjes produktet, men ikke nødvendigvis skal vises for hver enkelt artikel i
frontenden kan tilføjes i rækken ”can” – da vises denne egenskab kun, hvis den er givet
en værdi ved den aktuelle artikel. I rækken ”product” vælges de egenskaber, der ønskes
vist, uanset hvilken artikel man måtte være under, og som det ikke skal være muligt at
vælge imellem for kunden. Det er muligt at sortere egenskaberne, hvis man vælger flere
i samme række. Med pilene til højre for feltet i kolonnen ”selected” kan man vælge
rækkefølgen af egenskaber – dette har også effekt i frontenden. Husk: når man i
frontenden vælger størrelse eller farve fra en dropdown, vælger man i virkeligheden en
ny artikel, der er tilknyttet samme produkt. Derfor kan man også definere særlige
egenskaber, der kun vises ved en bestemt artikel – jeg vil dog ikke anbefale det, men det
7
Vejledning til oprettelse af produkter samt lagerhåndtering i Commerce til TYPO3.
Af: Michael S. Christensen 20-07-08
er muligt. Vælges én eller flere egenskaber som tilføjes i rækken ”products”, bør man
gemme. Derefter kan man, for det aktuelle produkt se, at der tilføjes et faneblad der
hedder ”edit attributes”. Trykker man der, vil man kunne definere de egenskaber, der
skal gælde for alle artikler til dette produkt (fx vægt, model, materiale m.m).
Oprettelse af artikler
Når det ovenstående arbejde er gjort, er det
simpelt at oprette og ændre artikler. For at
oprette en artikel skal man være inde i
redigeringsdelen for et produkt, hvor
fanebladet ”articles” vælges. (se billede, nr.
1). Hvis der allerede er oprettet nogle
artikler – som tilfældet er på billedet, kan
man se og ændre dem herfra. For at oprette
nye artikler vælges fanebladet ”producible
articles” (billede, nr. 2). Hvis der er oprettet
nogle produktegenskaber, som har flere
værdier (se evt s. 4-5), vises en liste med
8
Vejledning til oprettelse af produkter samt lagerhåndtering i Commerce til TYPO3.
Af: Michael S. Christensen 20-07-08
9
Vejledning til oprettelse af produkter samt lagerhåndtering i Commerce til TYPO3.
Af: Michael S. Christensen 20-07-08
Oprettelse af produktet:
Derefter oprettes produktet (modulet Category vælges, der klikkes på ikonet for den
kategori, produktet skal tilhøre og vælges ”new product”), og en beskrivelse og billeder
lægges op. Når fanebladet ”select attributes” vælges, er det vigtigt at være opmærksom
på, hvor man vælger hvilke egenskaber. Det skulle være muligt for brugeren af vælge
imellem både farve og størrelse, så derfor vælges de to egenskaber i rækken ”Select”.
Bemærk at det kun er de egenskaber der er blevet givet en liste af værdier, der kan
vælges her. De øvrige egenskaben vælges i rækken ”product” da de er ens for alle
udgaver af produktet (hvis man fx ønsker at vægten skal være forskellige i forskellige
størrelser, kan den i stedet vælges i rækken ”can”) – se billedet.
Når disse valg gemmes, skal de generelle egenskaber, der gælder for enhver udgave af
produktet defineres – det gøres under fanebladet ”edit attributes”. Som bekendt lavede
vi en liste af værdier til egenskaben ”model”, derfor kan man her vælge blandt dem fra
en drop down. Ved egenskaben materiale skal der defineres en værdi ”i hånden”.
Oprettelse af artikler
Under fanebladet ”articles” og derunder ”producible articles” ses således en liste over de
mulige produktartikler man kan oprette. Her vælges dem, der kan forhandles. Når de
ønskede er valgt og der gemmes, oprettes en masse artikler til det aktuelle produkt
(med samme navn som produktet). Her kan det være en fordel at navngive hver artikel i
overensstemmelse med dens særlige egenskaber (da denne title ikke vises i frontenden)
– fx S, lyseblå for den første, M, lyseblå for den næste etc. Husk: Fordi egenskaben
”vægt” valgtes i rækken ”can” under ”select attributes”, skal man definere den for hver
10
Vejledning til oprettelse af produkter samt lagerhåndtering i Commerce til TYPO3.
Af: Michael S. Christensen 20-07-08
Tip:
Hvis man vil oprette et produkt, hvor det ikke skal være muligt at vælge mellem
forskellige værdier af én eller flere egenskaber, optræder der ingen mulige artikler under
fanebladet ”producible articles”. Det er dog en betingelse, for at et produkt kan vises i
frontenden, at der er oprettet mindst én artikel – i dette tilfælde vælger man således
”create an empty article” og gemmer. Der oprettes én artikel uden nogen øvrige
egenskaber end dem, der er tilføjet til produktet i det hele taget (i rækken ”product”
under ”select attributes”). Her definerer man således pris og moms for den aktuelle vare.
11
Vejledning til oprettelse af produkter samt lagerhåndtering i Commerce til TYPO3.
Af: Michael S. Christensen 20-07-08
Lagerhåndtering
Jeg har installeret en ekstra extension, som vil håndtere lagerstatus for produkterne i
commerce. Hvis man vælger modulet ”Stock handling” under commerce (den med det
lilla ikon), vil man se en oversigt over sidens produkter samt, i parentes angivet, hver
enkelt artikels antal på lager. Herfra er det muligt at ændre lagerstatus ved at vælge en
artikel og angive lagerbeholdningen i feltet ”Stock” under fanebladet ”Extra
information”. Der er også et felt, der hedder ”Min Stock”. Det er fordi systemet har en
funktion hvor der sendes en påmindelse til en specificeret emailadresse, når
lagerbeholdningen er under et vist niveau (som standard har jeg vist sat den til 4 i
systemet) – i dette felt kan man ændre denne grænse for denne specifikke artikel.
Det er dog ikke nødvendigt at gå ind i modulet ”stock handling” for at ændre
lagerbeholdningen (her har man blot et godt overblik). Men kan ændre den ved at gå
ind i modulet ”Category” og vælge den artikel, man ønsker at sætte lagerbeholdningen
for. Derefter vælges fanebladet ”Extra information” hvor de samme felter som i
modulet ”stock handling” er tilgængelige. Lagerbeholdning skal naturligvis sættes for
hver enkelt artikel.
Når en kunde køber én eller flere varer, reduceres lagerbeholdningen i systemet
med dette antal. Samtidig foretages der kontrol for hvert skridt i købsprocessen for, om
varen stadig er på lager – hvis ikke, får kunden besked herom.
Husk: Hvis man har produkter, hvor der vælges mellem forskellige egenskaben af
brugeren, er det meget vigtigt, at mindst én artikel tilhørende at produkt er på lager,
ellers kan det slet ikke lade sig gøre at vælge mellem forskellige egenskaber.
Indkommende ordrer
Når en kunde opretter en ordre, tilsendes shoppens administrator en mail (til en af mig
fastsat mailadresse), brugeren tilsendes en
ordrebekræftelse og der oprettes en ordre i
systemets database. Det betyder, at det er muligt
at se en hvilken som helst ordre, dens varer,
kundens adresse samt pris og valuta ved at klikke
på List-modulet under punktet ”Web”, og
derefter vælge mappen ”Incoming”, som er en
undermappe til hhv. mappen ”Commerce” og
”Orders” som formentlig er placeret nederst i
sidetræet (se billedet). Da vil man se to lister,
”Orders” og ”Order_articles”. Listen ”Orders”
indeholder alle de ordrer der er oprettet på siden. Som udgangspunkt placeres de nyeste
nederst – ved at trykke på kolonneoverskriften ”Order number” kan man ændre
sorteringen til at vise de nyeste først. Når man trykker på denne (eller en hvilken som
helst anden) kolonneoverskrift, er det også muligt at vælge, hvilke data, den skal vise i
listen. Holdes ctrl nede, er det muligt at vælge flere titler på samme tid i feltet under
12
Vejledning til oprettelse af produkter samt lagerhåndtering i Commerce til TYPO3.
Af: Michael S. Christensen 20-07-08
listen af ordrer og derefter vælge ”set fields”. Bemærk: det er ikke under modulet
”Orders” under punktet ”Commerce” i venstre menu, at man kan se ordrerne.
13