Bugfix: Update im Warendialog hatte die Warengruppe verschluckt.
[kivitendo-erp.git] / xtcom / readme.first
1 Shop - Schnittstelle Lx-ERP <-> xt:Commerce
2
3
4 Info:
5         Die Zusammenarbeit mit der Version 2.6.x wurde nicht getestet!
6
7         Die Anmeldung der Benutzer an LxO hat sich geändert. Auch wurde  Lagerwesen eingeführt.
8         Damit die Schnittstelle mit Version 2.6.0 und neuer funktioniert, sollten hier Anpassungen
9         durchgeführt werden.
10         
11
12 Vorraussetzungen:
13         Lx-ERP Version >= 2.4.0 < 2.6.0
14         xt:Commerce 3.04
15         Pear DB, PHP-ImageMagick
16
17 Installation:
18 Das tar-File unterhalb vom Webserververzeichnis oder vom ERP-Verzeichnis entpacken.
19
20         $ cd /var/www/html
21         $ tar xzf /pfad/zu/xtcomm.tgz
22
23 In das Verzeichnis oscomm wechseln und Schreibrechte auf die Datei conf.php und 
24 die Verzeichnisse xtcom und tmp für den Webbenutzer (apache,www-data,httpd) vergeben.
25
26         $ chown apache xtcom
27         $ chown apache xtcom/conf.php
28         $ chmod 600 xtcom/conf.php
29         $ chown apache xtcom/tmp
30
31 Bitte zuerst einen Benutzer für die ERP anlegen, der mit der Schnittstelle benutzt 
32 werden soll. Dann noch die Artikel 'Diverse 16%', 'Versandkosten' und 'Nachname' anlegen.
33 Sollen 'PayPal','Mindermengenzuschlag' und '7%'-Artikel extra verwendet werden, legen Sie
34 auch diese Artikel zunächst an.
35
36 Im Browser dann folgende URL aufrufen:
37
38         http://webserver/pfad/xtcomm/confedit.php
39
40         z.B.: http://localhost/xtcomm/confedit.php
41
42 Benutzer und Kennwort für die Erstinstallation sind:
43
44         xtcom / xtcom
45
46 Die Maske sogfälltig ausfüllen.
47
48         db-Host         db-Server für die jeweilige Anwendung
49         Database        Namen der Datenbankinstanzen
50         db-User         Username und Kennwort für die jeweilige Instanz
51         User-ID         Mit dieser ID soll in die ERP geschrieben werden
52         CSV-Dir         hier wird die csv-Datei erwartet (Schreibrechte!)
53         Image-Dir       hier liegen die Bilder
54         ftp-Host        Webserver der jeweiligen Anwendung
55         ftp-User        Name und Kennwort für ftp-Zugang
56         ID-xxxx         Interne ID der Waren. Lx-ERP:
57         Shopsprache     Die Id der Voreingestellten Sprache. Nur für diese 
58                                 werden die Artikel eingestellt.
59         Bildergröße     in Byte
60
61 Das Formular abschicken. 
62
63 Sollen später Änderungen durchgeführt werden, so muß bei der Anmeldung 
64 der ERP-ftp-User als Benutzer verwendet werden.
65
66 In der Shopinstanz muß noch eine Tabelle angelegt werden. Das wird 
67 normalerweise durch das Programm condedit.php erledigt. Sollte das aus 
68 irgend einem Grund nicht funktionieren, führen Sie dazu die
69 Datei oscom.sql als Datenbankbenutzer auf die Shopinstanz aus.
70
71         $ mysql -p -u dbuser dbinstanz < xtcom.sql
72         Enter password:
73
74 Ist diese Tabelle nicht angelegt, werden Kunden in der ERP immer wieder neu 
75 angelegt.
76
77 Fehlerquellen:
78 Befinden sich ERP und Shop nicht auf dem gleichen Server, achten Sie darauf, das
79 die entsprechende Datenbank von Aussen erreichbar ist. Dazu müssen folgende Ports 
80 freigeschaltet werden:
81
82         MySQL           3306
83         PostgreSQL      5432
84
85 Auch muß auf dem Shopserver ein ftp-Dienst eingerichtet werden, wenn Bilder über-
86 tragen werden sollen. Die Firewal ist entsprechend anzupassen.
87
88 Arbeiten:
89 In der ERP kann nun bei den Artikeln das Häckchen Shop gesetzt werden.
90 Bitte auch eine Warengruppe vergeben, da sonst alle Artikel in Default landen.
91 Da die ERP nur eine Kategorieebene verwalten kann, muß der ganze Kategorienpfad
92 hintelegt werden. Die einzelnen Kategorien werden durch Ausrufezeichen (!) getrennt.
93
94         Hardware -> Monitore -> LCD = Hardware!Monitore!LCD
95
96 Die URL für die Shopschnittstelle lautet:
97
98         http://webservername/pfad/xtcom/trans.php
99
100
101 Die Schnittstelle kann auch in die ERP integriert werden. Dazu installieren Sie
102 die Schnittstelle wie beschrieben unterhalb der ERP. 
103 Erweitern Sie die menu.ini um die Einträge im xtcom-Verzeichnis. z.B.:
104
105         $ cat /pfad/zu/xtcom/menu.ini >> /pfad/zu/lx-erp/menu.ini
106
107 Unter dem Menüpunkt Shop stehen Ihnen nun die Module shopimport_db und xtcomexport 
108 zur Verfügung.
109
110 Copyright:
111 Die Schnittstelle mit ihren einzelnen Bestandteilen steht unter Copyright der
112 Lx-System. Die Schnittstelle und auch einzelne Programmabschnitte unterliegen 
113 dem Urheberrecht sowie auch anderer Gesetze zum Schutz des geistigen Eigentums. 
114 Sie dürfen weder für kommerzielle Zwecke noch zur bloßen Weitergabe kopiert, 
115 verändert oder Dritten zugänglich gemacht werden.
116
117                                 info@lx-system.de