Debugcode entfernt.
[kivitendo-erp.git] / oscom / readme.first
1 Shop - Schnittstelle Lx-ERP <-> osCommerce/xt:Commerce
2
3 Vorraussetzungen:
4         Lx-ERP Version >= 2.4.0
5         osCommerce 2.2 ms 2
6         Pear DB
7
8 Installation:
9 Das tar-File unterhalb vom Webserververzeichnis oder dem ERP-Verzeichnis entpacken.
10
11         $ cd /var/www/html
12         $ tar xzf /pfad/zu/oscomm.tgz
13
14 In das Verzeichnis oscomm wechseln und Schreibrechte auf die Datei conf.php und 
15 das Verzeichnis tmp für den Webbenutzer (apache,www-data,httpd) vergeben.
16
17         $ chown apache conf.php
18         $ chmod 600 conf.php
19         $ chown apache tmp
20
21 Im Browser folgende URL aufrufen:
22
23         http://webserver/pfad/oscomm/confedit.php
24
25         z.B.: http://localhost/oscomm/confedit.php
26
27 Benutzer und Kennwort für die Erstinstallation sind:
28
29         oscom / oscom
30
31 Die Maske sogfälltig ausfüllen.
32
33         db-Host         db-Server für die jeweilige Anwendung
34         Database        Namen der Datenbankinstanzen
35         db-User         Username und Kennwort für die jeweilige Instanz
36         User-ID         Mit dieser ID soll in die ERP geschrieben werden
37         CSV-Dir         hier wird die csv-Datei erwartet (Schreibrechte!)
38         Image-Dir       hier liegen die Bilder
39         ftp-Host        Webserver der jeweiligen Anwendung
40         ftp-User        Name und Kennwort für ftp-Zugang
41         ID-xxxx         Interne ID der Waren. Lx-ERP:
42         Shopsprache     Die Id der Voreingestellten Sprache. Nur für diese 
43                         werden die Artikel eingestellt.
44         Bildergröße     in Byte
45         Preisgruppe     Welche Preisgruppe soll verwendet werden
46         Bestellnummern-
47         erweiterung     Zeichen die der Auftragsnummer vorangestellt werden
48
49 Das Formular abschicken. 
50
51 Sollen später Änderungen durchgeführt werden, so muß bei der Anmeldung 
52 der ERP-ftp-User als Benutzer verwendet werden.
53
54 In der Shopinstanz muß noch eine Tabelle angelegt werden. Das wird 
55 normalerweise durch das Programm condedit.php erledigt. Sollte das aus 
56 irgend einem Grund nicht funktionieren, führen Sie dazu die
57 Datei oscom.sql als Datenbankbenutzer auf die Shopinstanz aus.
58
59         $ mysql -p -u dbuser dbinstanz < oscom.sql
60         Enter password:
61
62 Ist diese Tabelle nicht angelegt, werden Kunden in der ERP immer wieder neu 
63 angelegt.
64
65 Fehlerquellen:
66 Befinden sich ERP und Shop nicht auf dem gleichen Server, achten Sie darauf, das
67 die entsprechende Datenbank von Aussen erreichbar ist. Dazu müssen folgende Ports 
68 freigeschaltet werden:
69
70         MySQL           3306
71         PostgreSQL      5432
72
73 Auch muß auf dem Shopserver ein ftp-Dienst eingerichtet werden, wenn Bilder über-
74 tragen werden sollen. Die Firewal ist entsprechend anzupassen.
75
76 Arbeiten:
77 In der ERP kann nun bei den Artikeln das Häckchen Shop gesetzt werden.
78 Bitte auch eine Warengruppe vergeben, da sonst alle Artikel in Default landen.
79 Da die ERP nur eine Kategorieebene verwalten kann, muß der ganze Kategorienpfad
80 hintelegt werden. Die einzelnen Kategorien werden durch Ausrufezeichen (!) getrennt.
81
82         Hardware -> Monitore -> LCD = Hardware!Monitore!LCD
83
84 Die URL für die Shopschnittstelle lautet:
85
86         http://webservername/pfad/oscom/trans.php
87
88
89 Die Schnittstelle kann auch in die ERP integriert werden. Dazu installieren Sie
90 die Schnittstelle wie beschrieben unterhalb der ERP. 
91 Ersetzen Sie die menu.ini durch die Version im oscom-Verzeichnis.
92
93         $ cp /pfad/zu/oscom/menu.ini /pfad/zu/lx-erp
94
95 Unter dem Menüpunkt Shop stehen Ihnen nun die Module shopimport_db und oscomexport 
96 zur Verfügung.
97
98 Copyright:
99 Die Schnittstelle mit ihren einzelnen Bestandteilen steht unter "Artistic License".
100 Das Copyright gehört Holger Lindemann.