Kosmetik: Alignment
[kivitendo-erp.git] / olcom / readme.first
1 Shop - Schnittstelle Lx-ERP <-> osCommerce/xt:Commerce
2
3 Vorraussetzungen:
4         Lx-ERP Version >= 2.4.0
5         xt:Commerce 2.0 RC1.2
6         Pear DB, PHP-ImageMagick
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/xtcomm.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/xtcomm/confedit.php
24
25         z.B.: http://localhost/xtcomm/confedit.php
26
27 Benutzer und Kennwort für die Erstinstallation sind:
28
29         xtcom / xtcom
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
46 Das Formular abschicken. 
47
48 Sollen später Änderungen durchgeführt werden, so muß bei der Anmeldung 
49 der ERP-ftp-User als Benutzer verwendet werden.
50
51 In der Shopinstanz muß noch eine Tabelle angelegt werden. Das wird 
52 normalerweise durch das Programm condedit.php erledigt. Sollte das aus 
53 irgend einem Grund nicht funktionieren, führen Sie dazu die
54 Datei oscom.sql als Datenbankbenutzer auf die Shopinstanz aus.
55
56         $ mysql -p -u dbuser dbinstanz < xtcom.sql
57         Enter password:
58
59 Ist diese Tabelle nicht angelegt, werden Kunden in der ERP immer wieder neu 
60 angelegt.
61
62 Fehlerquellen:
63 Befinden sich ERP und Shop nicht auf dem gleichen Server, achten Sie darauf, das
64 die entsprechende Datenbank von Aussen erreichbar ist. Dazu müssen folgende Ports 
65 freigeschaltet werden:
66
67         MySQL           3306
68         PostgreSQL      5432
69
70 Auch muß auf dem Shopserver ein ftp-Dienst eingerichtet werden, wenn Bilder über-
71 tragen werden sollen. Die Firewal ist entsprechend anzupassen.
72
73 Arbeiten:
74 In der ERP kann nun bei den Artikeln das Häckchen Shop gesetzt werden.
75 Bitte auch eine Warengruppe vergeben, da sonst alle Artikel in Default landen.
76 Da die ERP nur eine Kategorieebene verwalten kann, muß der ganze Kategorienpfad
77 hintelegt werden. Die einzelnen Kategorien werden durch Ausrufezeichen (!) getrennt.
78
79         Hardware -> Monitore -> LCD = Hardware!Monitore!LCD
80
81 Die URL für die Shopschnittstelle lautet:
82
83         http://webservername/pfad/xtcom/trans.php
84
85
86 Die Schnittstelle kann auch in die ERP integriert werden. Dazu installieren Sie
87 die Schnittstelle wie beschrieben unterhalb der ERP. 
88 Erweitern Sie die menu.ini um die Einträge im xtcom-Verzeichnis. z.B.:
89
90         $ cat /pfad/zu/xtcom/menu.ini >> /pfad/zu/lx-erp/menu.ini
91
92 Unter dem Menüpunkt Shop stehen Ihnen nun die Module shopimport_db und xtcomexport 
93 zur Verfügung.
94
95 Copyright:
96 Die Schnittstelle mit ihren einzelnen Bestandteilen steht unter der "Artistic License".
97 Das Copyright gehört Holger Lindemann.