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