[TYPO3-commerce] short manual
Steffen Kamper
steffen at dislabs.de
Sat Mar 24 13:46:36 CET 2007
Thanx Stephan for this tutorial
I placed it on my site and did some corrections - it's still german, please
have a look:
http://www.sk-typo3.de/Shop-aufsetzen-mit-commerce-Quickt.286.0.html
I would like to place a sample of Shop Menu at the bottom, so you told from
Forum entry, do you have a link ?
vg Steffen
"Firma Cordes" <mail at firma-cordes.com> schrieb im Newsbeitrag
news:mailman.90873.1174657314.21067.typo3-project-commerce at lists.netfielders.de...
Hi,
a view people asked me if i´m able to translate my short manual to English.
Sorry, my English is really bad. But maybe another person will do so?
Here is the text in German: (Sorry, some types are lost during copying)
1) Die Seiten und Sysordner wie in der Quickinstall beschrieben anlegen.
z. B. eine Seite "Shop" (Shortcut zur neuen Unterseite Produktliste) und
untergeordnete Seiten (nicht im Menue sichtbar) und Sysordner anlegen:
- Produktliste (spaeter wird Plugin ausgewaehlt)
- Details (spaeter wird Plugin ausgewaehlt)
- Warenkorb (spaeter wird Plugin ausgewaehlt)
- Bestellung (spaeter wird Plugin ausgewaehlt)
- Adressmanagement (spaeter wird Plugin ausgewaehlt)
- Rechnung (spaeter wird Plugin ausgewaehlt)
- Content leerer Warenkorb (Text: "Warenkorb noch leer" o. ae.)
- Contend leerer Checkout (Text: "Bestellung erst nach Produktauswahl
moeglich" o. ae.)
- Sys. User (Sysordner)
- Sys. Adressen (Sysordner)
2) tt_adress installieren. Im neu angelegten Sysordner "Adresses" werden
spaeter die Adressdaten für tt_adress angelegt.
3) Neue Frontend-Usergrups anlegen im neu angelegten User-Sysfolder. Z. B.:
- Shop-Kunden (ID merken)
- Shop-Sonderkunden
- Shop-Haendler
4) Commerce-Extension installieren (und alle geforderte weiteren Extensions)
5) Auf der Seite, auf der auch die Typoscript-Einstellungen fuer die Seiten
stehen (Roottemplate) muss das Template (ueber "Liste") bearbeitet werden.
Hier unter Include static (from extensions): "COMMERCE" aus der Auswahlliste
hinzufuegen. (Include static (from extensions) wird ausfuehrlich in Foren
beschrieben.)
6) im Extensionmanager unter "Commerce" folgende Einstellunen vornehmen:
- Invoice BACKEND LOGIN required = ja (Haekchen)
- Simple Mode for products = nein (nur ja, wenn zu Produkten keine
verschiedenen Attribute existieren sollen, z. B. verschiedene Groessen oder
Farben o. ae.)
- Wenn zuvor ja, dann gelten folgende Felder (Voreinstellungen stehen
lassen)
- fields for products...
- fields for articles...
- Page-ID for Invoice = Seiten ID von der neuen Seite "Rechnung"
- Invoice Page Type = 0
- Preview Page Type = Seiten ID von der neuen Seite "Produktliste"
- Default Name of E-mail Sender = Name des Emailabsenders fuer den
Mailversand durch den Shop an Kunden
- Default E-Mailaddress of E-mail Sen... = Emailadresse zum obigen
Emailnamen (auch Antwortadresse für Kunden)
- Page-Id for new address records = Seiten ID des neuen Sysordner "Sys.
Adressen"
- Field mapping feuser-tt_address = Voreinstellung uebernehmen. (Hier wird
festgelegt welche Felder in fe_users und tt_adress miteinander abgeglichen
werden fuer automatisch erzeugte Eintraege neuer Shopkunden.)
- Attribute Lokalisation = 0
- Exclude Folder from Statistic = 0
nun auf Update klicken, dann Caches loeschen
7) Unter "Template" / "Constant Editor" folgende Einstellungen vornehmen:
PLUGIN.COMMERCE: GENERAL
- Address PID = Seiten ID des neuen Sysordner "Sys. Adressen"
- USER PID = Seiten ID des neuen Sysordner "Sys. Users"
- Edit Address PID = Seiten ID der neuen Seite "Adressmanagement"
- Basket PID = Seiten ID der neuen Seite "Warenkorb"
- Override PID = Seiten ID der neuen Seite "Produktliste"
- Checkout PID = Seiten ID der neuen Seite "Bestellung"
- Empty basket PID = Seiten ID der neuen Seite "Content leerer Warenkorb"
- Empty Checkout PID = Seiten ID der neuen Seite "Content leere Bestellung"
- Payment Article = 1 (ID der Standard-Bezahlungsweise - kann sp?er ge?dert
werden)
- Payment Product = 1 (ID des Kategorieordners Payment - Voreinstellung
stimmt)
- Delivery Product = 2 (ID des Kategorieordners Delivery - Voreinstellung
stimmt)
- Default Category = 2 (ID der sp?er anzulegenden Kategorie
"Produktkatalog")
- USER Group ID = ID der Frontend-Usergroup "Shop-Kunden", die wir uns
vorher gemerkt haben sollten.
- Currency = EUR
- ArticleTypes = 1
Update drcken
Bei den sonstige PLUGIN.COMMERCE Konstanten kann die Voreinstellung benutzt
werden. Wenn sp?er eigene Templates fr das Frontendrendering benutzt werden
sollen (Ordner p1 bis p6 des Commerce-Ordners auf dem Server in eigenen
Ordner kopieren und bearbeiten), dann muss hier der Speicherort der eigenen
Templates eingetragen werden. - Versucht das erst, wenn Ihr die Vorlagen
probiert habt. - (Hierzu kann ich keine Infos liefern. Nachfragen zwecklos,
ich habe selbst zu wenig Ahnung)
8) Ein Fehler in static_info_tables muss beseitig werden. Mit phpMyAdmin
kann man die SQL-Datenbank bearbeiten.
Um das Euro-Zeichen - / EUR - richtig darzustellen, muss in der Datenbank
in der Tabelle static_currencies (im Feld cu_symbol_left in der Zeile uid:
49) € eingetragen werden. (Tipp von:
www.it-bo.com/typo3-online-marketing/hilfe/tx-commerce-download-links.html)
9) Cachs l?chen und dann das Backend neu starten. Nun erscheint die Rubrik
Commerce mit
- Kategorie
- Bestellung
- Stammdaten
- Statistics
10) auf Kategorie klicken. Auf das erscheinende "Category" klicken (auf den
Text). Nun "Neuen Datensatz anlegen". Auf das erscheinende "Kategorien"
klicken. Titel = "Produktkatalog" + speichern.
Nun gibt es den Kategorie-Oberordner "Produktkatalog" (ID=2) und "System"
(ID=1). Diese ID=2 wurde ja schon zuvor im Constant-Editor eingetragen. Wenn
der Produktkatalog eine andere ID hat, dann muss das im Constant-Editor
korregiert werden.
11) Legen Sie weitere Kategorien unter dem Kategorieordner "Produktkatalog"
an, indem Sie auf das Icon vom Ordner "Produktkatalog" klicken und "neue
Unterkategorie" w?len. So k?nen Kategorien und Unter-Kategorien angelegt
werden. Zur Zeit sollte Sie keine Unter-Unter-Kategorien anlegen, denn das
ist noch Fehlerhaft.
12) Unter Commerce / Stammdaten k?nen Sie Hersteller und Lieferanten Ihrer
Produkte eintragen.
13) Legen Sie Attribute an. Commerce / Stammdaten / Attribute: "neues
Attribut" anklicken. Titel = Name des Attributs (z. B. Farbe, Gr?e, Ma?,
Material, Spannung, Ausstattung, und so weiter ...)
Wenn es zu Attributen FESTE Werte gibt (z. B. Farben: rot, wei? schwarz,
blau, ...) kann "Hat Werteliste" angeklickt werden. In diesem Fall kann
unter dem Reiter "Zugeordnete Werte" einige feste Werte angelegt werden.
14) Produkte anlegen. (Kann auch sp?er geschehen)
- Links unter Commerce auf Kategorien klicken
- Auf das Icon einer Kategorie klicken und "neues Produkt" ausw?len.
- Unter dem Reiter Allgemein den Titel und Text ausfllen und Bild ausw?len.
Unten Hersteller ausw?len und kontrollieren ob die Kategorie stimmt. Evtl.
weitere Kategorie ausw?len. (z. B. Kategorie "Sonderangebot")
- SPEICHERN!
- Unter dem Reiter "Attribute ausw?len":
- Attribute mit Wertelisten k?nen bei bedarf unter "Auswahl" ausgew?lt
werden. Daraus ergibt sich sp?er eine Liste aus m?lichen Artikeln. Wenn die
m?liche Liste aller M?lichkeiten jedoch zu gro?wird, dann gibt es eine
Fehlermeldung. Dann muss hier ein Attribut gel?cht werden und unter "sollte"
angegeben werden.
- Unter "sollte" k?nen die Attribute ausgew?lt werden, die immer angezeigt
werden. (z. B. hat jeder Artikel eine andere Farbe)
- Unter "kann" k?nen die Attribute ausgew?lt werden, die nur angezeigt
werden, wenn sie auch einen Inhalt haben.
- Unter "Produkt" werden Attribute ausgew?lt, die fr ALLE Artikel dieses
Produktes gelten. Z. B. sind alle Artikel dieses Produktes aus dem Material
Metall (und das soll auch in jedem Artikel angezeigt werden). Bei den
Artikeln kann dann dieses Attribut nicht mehr ge?dert werden, muss aber auch
nicht jedesmal neu ausgew?lt werden.
- Unter "Filteratribute" sollen Attribute ausgew?lt werden, nach denen die
Artikel bei einer Suche, bzw. Filterung ausgew?lt werden k?nen.
- SPEICHERN!
- Wenn Attribute unter "Produkt" ausgew?lt wurden, erscheint nun ein Reiter
fr Attributauswahl. Dort k?nen die Attribute, die fr alle Artikel dieses
Produktes gelten, mit Inhalt gefllt werden.
- SPEICHERN!
- Unter dem Reiter "Artikel erzeugen" erscheint unter "erzeugbare Artikel"
eine Liste aller Artikel, die nach den Wertelisten m?lich sind. (Wenn keine
Attribute mit Wertelisten ausgew?lt wurden, erscheint hier KEINE Liste.)
W?lt die Artikel aus der Liste aus und klickt auf SPEICHERN.
- Wenn keine Liste angezeigt wird, w?lt "Einen leeren Datensatz erzeugen"
aus und kickt auf SPEICHERN. Das muss so oft wiederholt werden, wie Artikel
gewnscht sind.
- In beiden F?len erscheint nun unter "existierende Artikel" eine Liste
aller Artikel.
- Artikel bearbeiten (Bleistiftsymbol):
- Unter dem Reiter "Allgemein" kann der Titel mit Ergnzenden Infos versehen
werden, die der Shopverwalter sp?er in den Bestellungen sieht. Au?rdem mssen
die Bestellnummer (Bei Bedarf EAN-Code) und der Steuersatz und der Lieferant
eingetragen/ausgew?lt werden.
- SPEICHERN
- Unter dem Reiter "Attribute editieren" k?nen die zuvor ausgew?lten
Attribute mit Inhalt gefllt werden.
- SPEICHERN
- Unter dem Reiter "Preise" kann der Bruttopreis angegeben werden. Der
Nettopreis wird automatisch anhand des Steuerschlssels ausgerechnet. - Wenn
"Neuer Preis hinzufgen" ausgew?lt wurde erscheint nach dem Speichern weitere
Eingabefelder fr Preise. Damit ist es m?lich verschiedene Preise fr
verschiedene Frontend-Usergruppen oder verschiedene Zeiten oder bei
verschiedenen Bestellmengen (Mengenrabatt) anzulegen.
- SPREICHERN und Schlie?n.
- N?hster Artikel bearbeiten ...
15) Auf den neu angelegten Seiten muss je ein Seiteninhalt des Typs Plugin
angelegt werden.
- Produktliste (Plugin Commerce: Produktliste)
- Anzeigetyp = Standardansicht
- Anzahl Topprodukte = 0
- Kategorieauswahl: = die Kategorie "Produktkatalog" ausw?len. (Nicht
mehrere Kategorien anw?len. Das ist noch fehlerhaft.
- unter dem Reiter Templatedateien mssen unter "Detailseite" und
"Warenkorbseite" die entsprechenden neuen Seiten verlinkt werden (auf das
Ordnersymbol klicken und entsprechenden Ordner ausw?len)
- Details (Plugin Commerce: Produktliste)
- Anzeigetyp = Standardansicht
- Anzahl Topprodukte = 0
- Kategorieauswahl: = nichts ausw?len
- unter dem Reiter Templatedateien muss unter "Warenkorbseite" die
entsprechenden neue Seite verlinkt werden
- Anzahl Produkte insgesamt = 1
- Warenkorb (Plugin Commerce: Warenkorb)
keine Einstellungen
- Bestellung (Plugin Commerce: Checkout)
keine Einstellungen
- Adressmanagement (Plugin Commerce: Adressverwaltung)
keine Einstellungen
- Rechnung (Plugin Commerce: Rechnung)
keine Einstellungen
mal wieder Caches l?chen.
16) Wenn die Seite "Shop" richtig als Shortcut mit "Produktliste" verknpft
wurde dann kann nun im Frontend auf "Shop" klicken. Es sollte eine Liste der
Kategorien und bei Auswahl die Unterkategorien erscheinen. Dann k?nen
Probebestellungen durchgefhrt werden.
17) Ein eigenes Menue fr den Shop ist natrlich besser als nur die
Listendarstellung. Hier seht nach meinem Beispiel aus dem Foreneintrag "tx
commerce - Menue".
18) Es kann eine Loginseite eingerichtet werden (dazu gibt es genug Infos in
Foren und Manuals). Die Kunden bekommen nach der Bestellung einen Loginnamen
(Emeiladresse) und ein Kennwort per Email mitgeteilt.
- Legt eine neue Seite mit einem Shortcut zur Seite "Adressmanagement" an,
die nur fr (alle) eingeloggte User sichtbar ist. Dadurch k?nen eingeloggte
Kunden ihre Adressen bearbeiten.
19) ?er Liste / "Sys. Users" kommt man an die User-Eintragungen. Hier kann
man den automatisch als Shop-Kunden angelegten Ustern einer anderen
Frontend-Usergroup zuordnen, wenn es sich zum Beispiel um "Sonderkunden"
handelt, die Sonderpreise angezeigt bekommen sollen. (Dazu mssen sich die
Kunden vor dem Einkauf erst einloggen.)
20) Durch verschiedene Frontend-Usergruppen k?nen Spezialseiten fr
verschiedene Gruppen angelegt werden. (Kundenbindung)
21) Bestellabwicklung:
- Unter Commerce / Bestellungen erscheint der Ordner "Bestellungen". Diesen
?fnen und auf den ersten Unterordner klicken.
- Auf der erscheinenden Seite kann man sich oben zwischen "Kundendaten" und
"Bestelldaten" entscheiden.
- Bei "Kundendaten" werden die Kunden angeeigt. Klickt man auf einen Kunden,
siht man dessen Bestellungen.
- Bei "Bestelldaten" werden alle Bestellungen angezeigt.
- Meim Klick auf ein Icon der Bestellungen kann man dies bearbeiten. Dadurch
kann man alle Bestelldetails unter verschiedenen Reitern ansehen.
- Unter dem ersten Reiter "Basis" kann unter "Ordner Status" im Rahmen der
Bestellbearbeitung ein anderer Ordner ausgew?lt werden, in den diese
Bestellung verschoben werden soll. Dadurch haben Sie immer einen aktuellen
?erblick ber alle Bestellungen und deren Status.
So, nun habt Ihr den Shop am Laufen!
Dazu jedoch ein Tipp: Die Templates liegen im Commerce-Ordner
(typo3conf/ext/commerce/) unter p1 bis p6. Ein Typoscript-Beispiel liegt
unter typo3conf/ext/commerce/static/ im setup.txt
------------
My Typoscript as an example:
## shop
plugin.tx_commerce_pi3.adminmail.showCurrency = 1
plugin.tx_commerce_pi3.usermail.showCurrency = 1
plugin.tx_commerce_pi3.currency = EUR
plugin.tx_commerce_pi1.minRecords = 1
plugin.tx_commerce_pi1.maxRecords = 10
plugin.tx_commerce_lib.invoicePageId = 9
plugin.tx_commerce_lib.invoicePid = 9
plugin.tx_commerce_pi1._LOCAL_LANG.de{
pi_list_browseresults_first = erste
pi_list_browseresults_prev = << vorige
pi_list_browseresults_page = Seite
pi_list_browseresults_next = nächste >>
pi_list_browseresults_last = letzte
}
plugin.tx_commerce_pi1.singleView.products.fields.images.file.maxW = 400
plugin.tx_commerce_pi3 {
## sets Usermail Charset and Encoding
usermail {
##charset = utf-8
showCurrency = 0
charset = iso-8859-1
encoding = 8bit
from = info at youradress.de
## Do not user non Asci-Chars here, as not supported by MAIL
from_name = yourname
templateFile = {$plugin.tx_commerce_pi3.UserMailTemplateFile}
}
## sets AdminMail Charset and Encoding
adminmail {
showCurrency = 0
charset = utf-8
encoding = 8bit
## Only used, when no userMial is given thou the checkout
from = shop at yourmail.de
from_name = Bestellung
mailto = shop at yourmail.de
templateFile = {$plugin.tx_commerce_pi3.AdminMailTemplateFile}
}
}
-------------
My Constants as an example:
plugin.tx_commerce_pi1.templateFile =
fileadmin/templates/commerce/pi1/category_product.tpl
plugin.tx_commerce_pi2.templateFile =
fileadmin/templates/commerce/pi2/shoppingcart.tpl
plugin.tx_commerce_pi3.AdminMailTemplateFile =
fileadmin/templates/commerce/pi3/template_adminmail.tpl
plugin.tx_commerce_pi3.templateFile =
fileadmin/templates/commerce/pi3/template_checkout.tpl
plugin.tx_commerce_pi3.UserMailTemplateFile =
fileadmin/templates/commerce/pi3/template_usermail.tpl
plugin.tx_commerce_pi4.templateFile =
fileadmin/templates/commerce/pi4/template_addresses.tpl
plugin.tx_commerce_pi6.templateFile =
fileadmin/templates/commerce/pi6/invoice.tpl
plugin.tx_commerce_lib.addressPid = 15
plugin.tx_commerce_lib.userPid = 6
plugin.tx_commerce_lib.editAddressPid = 10
plugin.tx_commerce_lib.basketPid = 12
plugin.tx_commerce_lib.overridePid = 14
plugin.tx_commerce_lib.checkoutPid = 98
plugin.tx_commerce_lib.invoicePageId = 9
plugin.tx_commerce_lib.invoicePid = 9
plugin.tx_commerce_lib.emptyBasketPid = 8
plugin.tx_commerce_lib.emptyCheckoutPid = 7
plugin.tx_commerce_lib.paymentArticleId = 2
plugin.tx_commerce_lib.payProdId = 1
plugin.tx_commerce_lib.delProdId = 2
plugin.tx_commerce_lib.catUid = 2
plugin.tx_commerce_lib.userGroup = 3
plugin.tx_commerce_lib.currency = EUR
plugin.tx_commerce_lib.regularArticleTypes = 1
plugin.tx_commerce_lib.defEmailSendername = yourname
plugin.tx_commerce_lib.defEmailAdress = shop at yourname.de
plugin.tx_commerce_pi1.attributeLinebreakChars = <br />
plugin.tx_commerce_lib.useRootlineInformationToUrl = 1
More information about the TYPO3-project-commerce
mailing list