JTL-Wawi Connector für Virtuemart by web-signs :: Dokumentation
JTL-Wawi Connector für Virtuemart by web-signs :: Dokumentation
Version: 1.5.1-5
Demoversion    aktuell ist v.1.5.1-5 (2010-01-31)
Dokumentation
Dokumentation

Vorbemerkung

Bei dieser Version des "JTL-Wawi Connector für VirtueMart" handelt es sich um eine von der Internetagentur web-signs entwickelte Lösung.
Die Programmierung erfolgte auf Basis des von JTL-Software angebotenen Connectors. Ein anderer Ansatz konnte derzeit auch gar nicht gewählt werden, da nur die Kenntnis der JTL-Wawi-API (die aus dem vorhandenen Code tlw. erkennbar wird) die Programmierung eines solchen Connectors ermöglicht. Der Programmcode wurde komplett umgeschrieben, um auf die Möglichkeiten, die das Joomla!-Framework bietet, voll zugreifen zu können.

Bei Fragen oder Problemen wenden Sie sich bitte an rbaier@web-signs.de.

Mein besonderer Dank gilt Christoph Käufer, der die Headergrafik gestaltet hat.

Installation

  1. Erstellen Sie zuerst Sicherheitskopien Ihrer Joomla!-Datenbank und bei Bedarf auch von JTL-Wawi.
  2. Laden Sie das gesamte Verzeichnis jtlwawi_connector mit allen enthaltenen Dateien mit einem FTP-Programm in das Verzeichnis administrator/ Ihrer Joomla!-Installation hoch.
  3. Rufen Sie mit dem Browser Ihrer Wahl die URL http://[Joomla!-URL]/administrator/jtlwawi_connector/install/index.php auf.
    Nehmen Sie dort Ihre Einstellungen (Button "Einstellungen >>") vor und drücken Sie anschließend auf "Installation starten >>". Notieren Sie sich die Einstellungen, da Sie diese in JTL-Wawi unter "Einstellungen -> Shop-Einstellungen" eintragen müssen.
    Sollten hierbei Fehler auftreten (was normalerweise nicht der Fall sein dürfte), führen Sie bitte die manuelle Installation durch.
  4. Führen Sie nun die Einstellungen im Warenwirtschaftssystem JTL-Wawi (bitte die aktuellste stabile Version von JTL-Wawi nutzen!) unter "Shop-Einstellungen" durch.
  5. Entfernen Sie zu Ihrer Sicherheit das Installationsverzeichnis des Connectors (Verzeichnis install/) vom Server!

Manuelle Installation

Falls bei der Installation Fehler aufgetreten sein sollten, müssen Sie die Aktualisierung Ihrer Datenbank manuell vornehmen. Hat die oben beschriebene automatische Installation geklappt, dann darf die manuelle Installation nicht ausgeführt werden!
Zur manuellen Installation sind folgende Schritte nötig:
  1. Ausführen der ersten 4 Schritte wie bei der normalen Installation (sollte bereits erledigt sein).
  2. Mit phpMyAdmin oder einem ähnlichem Tool an der Joomla!-Datenbank anmelden.
  3. install/vmjtl_connector.sql in der Datenbank ausführen.
  4. Folgenden SQL-Befehl ausführen:
    INSERT INTO `jtlwawi_sync` VALUES ("Benutzername", MD5("Passwort"), 1);
    Für "Benutzername" und "Passwort" tragen Sie bitte Ihre eigenen Werte ein.
  5. Danach http://[Joomla!-URL]/administrator/jtlwawi_connector/admin aufrufen.
    Login mit Benutzername / Passwort, wie in Schritt 4 angegeben.
    Menüpunkt "Konfiguration" aufrufen und Einstellungen vornehmen - abspeichern.
  6. Führen Sie nun die Einstellungen im Warenwirtschaftssystem JTL-Wawi unter "Shop-Einstellungen" durch.

Konfigurationsoptionen

Beim Installieren werden nachfolgend aufgeführte Einstellungen abgefragt.
Die Einstellungen können unter http://[Joomla!-URL]/administrator/jtlwawi_connector/admin/index.php geändert werden. Als Login dient der bei der Installation erstellte Synchronisationsbenutzer.
Standardwährung: Währung, welche als Standard genommen werden soll.
Verfügbarkeitsdatum: In JTL-Wawi angelegte Artikel erhalten dieses Datum standardmäßig.
Hinweis: Falls in JTL-Wawi für Erscheinungsdatum ein Datum eingetragen wurde, wird dieses verwendet.
Standard-Verfügbarkeit: In JTL-Wawi angelegte Artikel erhalten die angegebene Lieferzeit standardmäßig.
Hinweis: Falls in JTL-Wawi das Funktions-Attribut Lieferfrist (Wert z.B. 48.gif) eingetragen wurde, wird dieses verwendet.
JTL-Wawi Endkunde: JTL-Wawi Privatkundenpreise werden diesen Kundengruppen zugeordnet.
JTL-Wawi Händlerkunde: JTL-Wawi Händlerpreise werden diesen Kundengruppen zugeordnet.
Kategorievorlage: Standardvorlage für neu erstellte Kategorien.
Anzahl Produkte nebeneinander: Standardvorgabe für die Anzahl der in der Kategorieansicht nebeneinander dargestellten Produkte.
Produktvorlage: Standardvorlage für neu erstellte Produkte (Detailansicht).
Funktions-Attribute: Bitte hierzu die Erläuterungen, die direkt auf der Konfigurationsseite stehen, beachten!
Weitere Konfigurationsoptionen dürften selbsterklärend sein bzw. sind für Installation/Konfiguration näher erläutert.

Bitte beachten Sie beim Einsatz des Connectors die Synchronisationsprioritäten und Nutzungsrichtlinien.
Sie können diese bei JTL-Software nachlesen.