[TYPO3-commerce] short manual

Fri Mar 23 14:41:52 CET 2007

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) &euro; 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