Installation VirtueMart 4 – JTL WaWi Connector in Joomla 5

Die Installation des VirtueMart 4 – JTL WaWi Connectors in Joomla 5 ist ein einfacher, aber wichtiger Schritt, um die volle Funktionalität zwischen Ihrem Online-Shop und der JTL-WaWi ERP-Software zu nutzen. Diese Anleitung hilft Ihnen Schritt für Schritt bei der Installation und Aktivierung der Komponente.

Voraussetzungen für die Installation

Bevor Sie mit der Installation des VirtueMart 4 – JTL WaWi Connectors beginnen, stellen Sie sicher, dass Sie die folgenden Voraussetzungen erfüllen:

• Joomla 5 ist auf Ihrem Server korrekt installiert und läuft reibungslos.
• Sie haben das VirtueMart 4 Komponente bereits auf Joomla installiert und konfiguriert.
• Sie haben die Connector-Datei des VirtueMart 4 – JTL WaWi Connectors von unserer Webseite heruntergeladen.

Schritt 1: Joomla 5 Backend aufrufen

Loggen Sie sich in das Backend Ihrer Joomla 5-Installation ein, indem Sie in Ihrem Browser die URL http://ihre-domain.de/administrator aufrufen. Verwenden Sie Ihren Administrator-Benutzernamen und Ihr Passwort, um Zugriff auf das Joomla-Dashboard zu erhalten.

Schritt 2: Erweiterungen hochladen und Joomla-Backup erstellen

Bevor Sie mit der Installation fortfahren, sollten Sie unbedingt ein vollständiges Backup Ihrer Joomla-Website erstellen. Dies stellt sicher, dass Sie im Falle eines Fehlers oder einer Inkompatibilität schnell wieder auf den vorherigen Stand zurücksetzen können.

Joomla-Backup erstellen:

1. Verwenden Sie eine Backup-Erweiterung wie Akeeba Backup (eine der am häufigsten verwendeten Joomla-Backup-Erweiterungen). Diese Erweiterung erstellt eine vollständige Sicherung Ihrer Website, inklusive der Datenbank und aller Dateien.
2. Installieren Sie die Erweiterung (falls noch nicht installiert):
   • Gehen Sie im Joomla-Backend zu Erweiterungen > Verwalten > Installieren.
   • Laden Sie das Akeeba Backup ZIP-Paket herunter und installieren Sie es wie jede andere Erweiterung.
3. Nach der Installation:
   • Gehen Sie zu Komponenten > Akeeba Backup.
   • Klicken Sie auf Backup Now, um eine vollständige Sicherung Ihrer Joomla-Installation zu erstellen.
4. Speichern Sie die Backup-Datei sicher auf Ihrem Computer oder einem externen Speicherort.

Erweiterungen hochladen:

Nachdem Sie das Backup erstellt haben, können Sie mit der Installation fortfahren:

1. Gehen Sie im Joomla-Dashboard zum Menüpunkt Erweiterungen und wählen Sie Verwalten > Installieren aus.
2. Unter dem Reiter Paket hochladen können Sie die zuvor heruntergeladene VirtueMart 4 – JTL WaWi Connector ZIP-Datei auswählen.
3. Klicken Sie auf Hochladen & Installieren, um die Datei auf Ihren Server zu übertragen und die Komponente zu installieren.

---

Warum ein Joomla-Backup wichtig ist:

Durch das Erstellen eines Backups sichern Sie Ihre Joomla-Website, bevor Sie neue Erweiterungen oder Änderungen vornehmen. Sollte bei der Installation etwas schiefgehen (z.B. Inkompatibilitäten oder Serverprobleme), können Sie jederzeit auf die vorherige Version Ihrer Website zurückgreifen und den Betrieb schnell wiederherstellen.

---

Diese Anleitung fügt den wichtigen Schritt des Backups vor der Installation hinzu, um sicherzustellen, dass du deine Website sicher hältst, bevor du neue Erweiterungen wie den VirtueMart 4 – JTL WaWi Connector installierst.

Schritt 3: Installation überprüfen

Nach erfolgreicher Installation wird eine Bestätigungsmeldung angezeigt. Sie können die Installation überprüfen, indem Sie im Menü auf Erweiterungen > Verwalten > Installierte Erweiterungen klicken und nach VirtueMart 4 – JTL WaWi Connector suchen. Die Komponente sollte hier als aktiv angezeigt werden.

Schritt 4: VirtueMart 4 – JTL WaWi Connector konfigurieren

Nachdem die Komponente erfolgreich installiert wurde, besteht der nächste Schritt darin, die Verbindung zwischen JTL-WaWi und Ihrem VirtueMart-Shop herzustellen. Dies ermöglicht die Synchronisation von Bestellungen, Lagerbeständen und Kundendaten zwischen den beiden Systemen.

1. Öffnen Sie den JTL WaWi Connector

Navigieren Sie in Ihrem Joomla-Backend zu Komponenten > VirtueMart > JTL WaWi Connector.

2. Lizenz aktivieren

3. .htaccess-Konfiguration (falls erforderlich)

Falls Sie eine Fehlermeldung bezüglich der Erreichbarkeit der URL erhalten (z.B. „The URL is not reachable“), müssen Sie möglicherweise Ihre .htaccess-Datei anpassen, um sicherzustellen, dass die URL korrekt aufgelöst wird.

1. Öffnen Sie die .htaccess-Datei, die sich im Stammverzeichnis Ihrer Joomla-Installation befindet.
2. Fügen Sie direkt nach der Zeile RewriteEngine On folgende Regel hinzu:

1. Speichern Sie die Datei und laden Sie sie auf Ihren Server hoch.
2. Testen Sie die URL erneut, um sicherzustellen, dass die Weiterleitung nun korrekt funktioniert.

4. JTL-WaWi Konfiguration

Im Abschnitt JTL-WaWi Configuration des Connectors sehen Sie die notwendigen Verbindungsdaten, die in JTL-WaWi eingetragen werden müssen:

• JTL-Shop-URL: Dies ist die URL Ihres VirtueMart-Shops. Diese URL verbindet JTL-WaWi mit Ihrem VirtueMart
• Sync-Benutzername: Dieser Benutzername wird für die Synchronisation zwischen JTL-WaWi und VirtueMart verwendet.
• Sync-Kennwort: Dies ist das zugehörige Passwort für den Synchronisationsbenutzer. Es wird bei jeder Installation individuell erstellt.

5. Konfiguration in JTL-WaWi vornehmen

1. Öffnen Sie die Verkaufskanalverwaltung in JTL-WaWi.
2. Wählen Sie den entsprechenden Verkaufskanal aus (z.B. Onlineshop - JTL-Shop).
3. Wechseln Sie zum Reiter Webserver und tragen Sie die Verbindungsdaten ein:
• JTL-Shop-URL: Geben Sie hier die URL Ihres VirtueMart-Shops ein, wie sie in VirtueMart angezeigt wird (z.B. http://j4vm4.testserver.com).
• Sync-Benutzername: Tragen Sie den in VirtueMart erstellten Synchronisationsbenutzernamen ein (z.B. jtl_conn).
• Sync-Kennwort: Geben Sie das zugehörige Passwort ein, das Sie in VirtueMart für diesen Benutzer erhalten haben.
4. Klicken Sie auf Verbindung testen, um sicherzustellen, dass die Verbindung zwischen JTL-WaWi und Ihrem VirtueMart-Shop erfolgreich hergestellt wurde.

Wichtige Hinweise:

• Die Benutzername- und Passwort-Daten für die Synchronisation werden bei jeder Installation individuell generiert. Verwenden Sie daher die jeweils spezifischen Daten, die in Ihrem VirtueMart-Backend angezeigt werden.
• JTL-WaWi verbindet sich nicht direkt mit der Datenbank von VirtueMart, sondern über die Webserver-Verbindung (über die Shop-URL) zur VirtueMart-Komponente.
• Falls Sie Probleme mit der Erreichbarkeit der URLs haben, stellen Sie sicher, dass Ihre .htaccess-Datei korrekt konfiguriert ist und dass das mod_rewrite-Modul auf Ihrem Webserver aktiviert ist.

Mit diesen Schritten können Sie die Verbindung zwischen JTL-WaWi und Ihrem VirtueMart-Shop problemlos herstellen und die automatische Synchronisation von Bestellungen und Lagerbeständen sicherstellen.

Schritt 5: Testen der Verbindung und Synchronisation

Nachdem alle Einstellungen vorgenommen wurden, ist es wichtig, die Verbindung zwischen VirtueMart und JTL-WaWi zu testen, um sicherzustellen, dass die Synchronisation reibungslos funktioniert. Gehen Sie dabei schrittweise vor und überprüfen Sie folgende Bereiche:

1. Testbestellung in VirtueMart

Erstellen Sie eine Testbestellung in Ihrem VirtueMart-Shop und überprüfen Sie, ob die folgenden Daten korrekt in JTL-WaWi übertragen werden:

• Bestellungen: Wird die Bestellung in JTL-WaWi korrekt angezeigt?
• Kundendaten: Wurden die Kundendaten richtig importiert und den Bestellungen zugeordnet?
• Lagerbestände: Wurden die Lagerbestände für die verkauften Produkte automatisch aktualisiert, um Überverkäufe zu verhindern?

2. Neue Produkte in JTL-WaWi anlegen und synchronisieren

Um sicherzustellen, dass die Produktsynchronisation korrekt funktioniert, legen Sie in JTL-WaWi ein neues Produkt an:

• Erstellen Sie ein neues Produkt mit einer Produktbeschreibung, Preis, Lagerbestand und ggf. Bildern.
• Weisen Sie das Produkt einer bestehenden Kategorie zu oder erstellen Sie eine neue Kategorie.
• Synchronisieren Sie das Produkt mit Ihrem VirtueMart-Shop.

Überprüfen Sie anschließend in VirtueMart:

• Wird das neue Produkt korrekt im VirtueMart-Shop angezeigt?
• Sind alle Produktdetails wie Preis, Beschreibung, Bilder und Lagerbestände korrekt synchronisiert?

3. Neue Kategorien in JTL-WaWi erstellen und prüfen

Legen Sie eine neue Kategorie in JTL-WaWi an, um zu testen, ob Kategorien ordnungsgemäß mit VirtueMart synchronisiert werden:

• Erstellen Sie eine neue Kategorie in JTL-WaWi und ordnen Sie Produkte dieser Kategorie zu.
• Synchronisieren Sie die Kategorien und Produkte mit VirtueMart.

Überprüfen Sie in VirtueMart:

• Wird die neue Kategorie korrekt angezeigt?
• Sind die zugeordneten Produkte in der neuen Kategorie sichtbar und vollständig synchronisiert?

4. Neue Kunden in JTL-WaWi anlegen und überprüfen

Testen Sie die Kundensynchronisation, indem Sie einen neuen Kunden in JTL-WaWi anlegen:

• Erstellen Sie einen neuen Kunden in JTL-WaWi, füllen Sie die benötigten Felder wie Name, Adresse, E-Mail und weitere relevante Informationen aus.
• Synchronisieren Sie die Kundendaten mit VirtueMart.

Überprüfen Sie in VirtueMart:

• Ist der neu erstellte Kunde in der Kundendatenbank von VirtueMart sichtbar?
• Wurden alle relevanten Daten (Name, Adresse, E-Mail, etc.) korrekt übernommen?

5. Lagerbestandssynchronisation testen

Stellen Sie sicher, dass die Lagerbestände zwischen VirtueMart und JTL-WaWi korrekt synchronisiert werden:

• Erhöhen oder reduzieren Sie den Lagerbestand eines Produkts in JTL-WaWi.
• Synchronisieren Sie die Daten und überprüfen Sie, ob der geänderte Lagerbestand korrekt in VirtueMart angezeigt wird.

Überprüfen Sie in VirtueMart:

• Wurde der geänderte Lagerbestand korrekt in VirtueMart übernommen?
• Wird der richtige Lagerbestand im Shop angezeigt, um Überverkäufe zu vermeiden?

6. Fehlerbehebung bei der Synchronisation

Falls bei der Synchronisation Fehler auftreten oder bestimmte Daten nicht korrekt übertragen werden, überprüfen Sie folgende Punkte:

• Verbindungseinstellungen: Stellen Sie sicher, dass die Verbindung zwischen JTL-WaWi und VirtueMart korrekt eingerichtet ist.
• Datenbankabgleich: Überprüfen Sie, ob die Datenbankabgleich-Einstellungen zwischen beiden Systemen korrekt sind.
• Protokolle: Prüfen Sie die Protokolle in JTL-WaWi und VirtueMart, um etwaige Fehlermeldungen zu identifizieren.

Schritt 6: Fehlerbehebung bei der Installation

Sollten während der Installation oder Konfiguration Fehler auftreten, können Sie die folgenden Punkte überprüfen:

• PHP-Version: Stellen Sie sicher, dass Ihr Server die von Joomla 5 und VirtueMart 4 benötigte PHP-Version unterstützt (mindestens PHP 8.1).
• Dateiberechtigungen: Überprüfen Sie, ob alle Ordner auf Ihrem Webserver die korrekten Schreib- und Leserechte haben.
• Joomla 5-Kompatibilität: Achten Sie darauf, dass die installierten Plugins und Erweiterungen vollständig kompatibel mit Joomla 5 sind.

Fazit

Die Installation des VirtueMart 4 – JTL WaWi Connectors in Joomla 5 eröffnet Ihnen zahlreiche Möglichkeiten zur Optimierung Ihrer Geschäftsprozesse. Mit der automatischen Bestellübertragung und Echtzeit-Lagerbestandssynchronisation können Sie Ihren VirtueMart-Shop nahtlos mit JTL-WaWi verbinden und so eine reibungslose Verwaltung Ihrer Bestellungen und Lagerbestände sicherstellen. Befolgen Sie die oben genannten Schritte, um die Installation erfolgreich abzuschließen und Ihr E-Commerce-Geschäft effizient zu betreiben.