JTL-Shop neu installieren

Voraussetzungen/Einschränkungen

• Sie haben eine Edition/Paketkonfiguration gebucht, in der die hier beschriebenen Softwarekomponenten enthalten sind. Je nach gebuchter JTL-Edition kann die Anzahl an JTL-Shops (Standard-Variante und Community Free-Variante), die Sie verwenden können, begrenzt sein. Lesen Sie mehr zum Thema hier: Die JTL-Editionen im Überblick.

Systemvoraussetzungen prüfen

1. Stellen Sie sicher, dass die folgenden Systemvoraussetzungen von Ihrem Webserver erfüllt werden:

Hinweis: Die Systemvoraussetzungen stellen das offiziell unterstützte, empfohlene und supportete Setup für den Betrieb von JTL-Shop dar. Der Betrieb auf ähnlichen Setups (Windows, FreeBSD, sunOS, nginx-webserver, PHP-FPM) ist zwar generell möglich, jedoch können wir dafür keinen Support für die Einrichtung und/oder daraus entstehenden Problemen mit der Software anbieten. Alternative HTTP-Server (z. B. NGINX): Bitte beachten Sie, dass die .htaccess-Regeln (u. a. zum Verzeichnisschutz!) bei diesen Servern manuell durch entsprechende Regeln nachgetragen werden müssen.

Die folgenden Systemvoraussetzungen müssen von Ihrem Webserver erfüllt werden:

• JTL-Wawi: Mindestens Version 1.0, für volle UTF-8-Unterstützung mindestens JTL-Wawi 1.6

Hinweis: Ab JTL-Wawi 1.6 benötigen Sie mindestens Version 4.06 von JTL-Shop.

• Betriebssystem: Linux (Debian, Ubuntu etc.). Bitte beachten Sie die aufgeführten Hinweise zum Betriebssystem.
• 64-bit-Apache-Webserver (PHP-Mode: FCGI oder Apache Module) 2.2 oder 2.4 mit mod_rewrite-Modul, .htaccess support. Der Webserver muss erlauben, dass Standardregeln überschrieben und ergänzt werden.
• Datenbank: MySQL 5 ab 5.7 oder MariaDB von Version 10.1 bis einschließlich 10.9.6; ab JTL-Shop 5.2.3 bis einschließlich 10.11 (LTS); ab JTL-Shop 5.1 auch MySQL 8.0
• PHP-Version: JTL-Shop 5 benötigt ab Version 5.2 mindestens PHP 8.1; wir empfehlen ab 5.2.3 PHP 8.2.

Exkurs: Welche PHP-Version unterstützt JTL-Shop?

• Mailserver: Lokal oder per SMTP erreichbar
• PHP-Module:
• SimpleXML
• Imagick
• Curl
• Iconv
• MBString
• Tokenizer
• Intl
• PDO (MySQL)
• IonCube-Loaders (http://www.ioncube.com/loaders.php): JTL-Shop 5 wird mit offenem Quelltext ausgeliefert und ist ohne IonCube-Loader betriebsbereit. Ein IonCube-Loader wird unter Umständen jedoch für den Betrieb von Drittanbieter-Plugins benötigt.
• PHP-Einstellungen:
• PHP-Skript-Ausführungszeit (max_execution_time) mindestens 120 Sekunden
• PHP-Speicherlimit (memory_limit) mindestens 128 MB
• Maximale PHP Übertragungsgröße (FILE / upload_max_filesize) mindestens 6 MB
• Maximale PHP Übertragungsgröße (POST / post_max_size) mindestens 8 MB
• allow_url_fopen aktiviert

---

Exkurs: Benötigter Webspace

Für wie viele Artikel wie viel Webspace benötigt wird, lässt sich nur theoretisch rechnerisch bestimmen. Ausschlaggebend sind nicht die Artikel selbst, sondern hauptsächlich deren Bilder. Artikelbilder werden in Originalgröße auf dem Webspace abgelegt und zusätzlich je Shop-Sprache in vier verschiedenen Größen skaliert gespeichert.

So ergibt sich bei einer Shopsprache je nach Ziel-Bildgrößen und Qualität die 2–3-fache Größe der Originalbild-Dateigrößen für den benötigten Webspace.

• Eine Shopsprache
• 200 KB durchschnittliche Originalgröße
• Denken Sie darüber nach, welche Bildgrößen Sie Kunden zur Verfügung stellen wollen. Wenn Sie Full-HD-Bilder bereitstellen wollen, sollten Sie keine 4k-Bilder in JTL-Wawi hinterlegen, die sehr viel Speicherplatz benötigen.
• Artikelbilder, die in JTL-Wawi bei den Artikeln hinterlegt werden
• Achten Sie darauf, dass die Bilder gut komprimiert sind (zulässige Dateiformate für Artikelbilder sind .jpg/.jpeg und .png).
• Im Shop wird eingestellt, dass die größte Anzeigeform für Artikelbilder der Originalgröße in JTL-Wawi entspricht.

Unter diesen Voraussetzungen würden 10 GB Webspace für etwa 17.000 bis 25.000 Artikelbilder reichen.

---

Hinweis zur Shop-Domain: Wir raten dringend davon ab, für Ihren Shop eine Domain mit Umlauten/Sonderzeichen zu verwenden. Diese führen immer wieder zu Problemen. Ein fehlerfreier Einsatz kann leider nicht gewährleistet werden. Wir empfehlen stattdessen, als Hauptdomain eine Domain ohne Umlaute/Sonderzeichen und die anderen Domains nur als Aliasdomains zu verwenden, die auf die Hauptdomain weiterleiten.

---

Webhosting-spezifische Voraussetzungen:

Unserer Erfahrung nach gibt es Probleme bei Servern mit sunOS und dem IonCube-Loader! Bitte erkundigen Sie sich vor der Shop-Installation bei Ihrem Hoster, welches Betriebssystem auf dem Server eingesetzt wird. Wir empfehlen den Einsatz von Linux-Webservern.

Info für 1&1-Hosting-Kunden: Bei 1&1-Hosting-Kunden sind nach Installation des JTL-Shop zusätzliche Schritte erforderlich, um ionCube zu aktivieren, siehe JTL-Shop auf einem Server von 1&1 oder Strato betreiben.

Info für Strato Managed Virtual Server Kunden: Bei der Installation des Shops/IonCube muss „PHP-Modus und -Beschleuniger“ auf CGI stehen. Für die Nutzung des SEO-Moduls muss der Modus dann wieder auf „Fast CGI + APC“ gesetzt werden.

Funktion von JTL-Shop auf Ihrem Server testen

JTL-Software stellt Ihnen ein kostenloses Testskript zum Herunterladen bereit, mit dem Sie prüfen können, ob Ihr Webserver die Systemvoraussetzungen zum Betrieb des Shops erfüllt.

1. Klicken Sie auf den nachfolgenden Link und laden Sie das Testskript herunter: Testskript herunterladen.
2. Entpacken Sie die heruntergeladene .zip-Datei und laden Sie alle entpackten Dateien mit einem FTP-Programm auf Ihren Webservern in einen Ordner, beispielsweise jtl-shop-systemcheck.
3. Rufen Sie das Testskript mit Ihrem Browser auf, beispielsweise http://Ihre-Domain.de/jtl-shop-systemcheck/. Wenn Sie das Skript in ein anderes Unterverzeichnis entpackt haben, passen Sie den Aufruf entsprechend an.
4. Warten Sie, bis das Testskript erfolgreich durchgelaufen ist und entfernen Sie anschließend den Ordner von Ihrem Webserver.

Um JTL-Shop neu zu installieren, müssen Sie 3 wesentliche Schritte nacheinander durchführen: Shop-Paket herunterladen und auf Webspace hochladen, Dateirechte setzen und Installationsvorgang starten. In den folgenden Abschnitten lesen Sie, wie Sie diese Schritte durchführen.

Schritt 1: Shop-Paket herunterladen und auf Webspace hochladen

In diesem Schritt müssen Sie das Shop-Paket herunterladen, die .zip-Datei entpacken und auf Ihren eigenen Webspace hochladen. Je nachdem, ob Sie JTL-Shop in der Standard-Variante oder in der Community Free-Variante nutzen, unterscheidet sich der Buchungsprozess und der Download. Lesen Sie mehr zum Thema hier: Lizenz für JTL-Shop erwerben; Community Free Edition von JTL-Shop herunterladen.

1. Entpacken Sie die .zip-Datei lokal in ein Verzeichnis auf Ihrem Rechner. Der Ordner, in dem die entpackten Shop-Dateien liegen, hat die folgende Verzeichnisstruktur:

• admin
• bilder
• classes
• dbeS
• downloads
• export
• gfx
• includes
• install
• jtllogs
• media
• mediafiles
• templates
• templates_c
• update
• uploads
• + zusätzliche einzelne Dateien

2. Übertragen Sie die entpackten Verzeichnisse und Dateien per FTP auf Ihren Webspace. Stellen Sie hierfür Ihr FTP-Programm so ein, dass PHP-Dateien im Binärformat übertragen werden.

Schritt 2: Dateirechte setzen

Die Installation sowie der Betrieb des JTL-Shop erfordern es, bestimmte Zugriffsrechte auf bestimmte Ordner/Verzeichnisse und Dateien zu gewähren. Sie können mit Hilfe Ihres FTP-Programms Rechte für Ordner und Dateien setzen. In den meisten Fällen müssen Ordner die Rechte 755 und Dateien die Rechte 644 erhalten. Dies kann sich jedoch bei manchen Servern unterscheiden.

Bei einer Neuinstallation des JTL-Shop ist standardmäßig die Datei includes/config.JTL-Shop.ini.php nicht angelegt. In dieser Datei werden während der Installation wichtige Datenbankverbindungs-Einstellungen geschrieben sowie das Verschlüsselungspasswort für sensible Kundendaten gespeichert. Die Datei config.JTL-Shop.ini.php ist im Ordner includes nicht vorhanden, benennen Sie die Datei config.JTL-Shop.ini.initial.php um in config.JTL-Shop.ini.php. Für die Installation geben Sie dieser Datei bitte auch Schreibrechte (Im Zweifel 777).

Bitte stellen Sie sicher, dass die folgenden Ordner (und die darin enthaltenen Ordner/Dateien) vom Webserver beschreibar sind:

• admin/includes/emailpdfs
• admin/templates_c
• dbeS/tmp
• dbeS/logs
• bilder (sowie alle Unterverzeichnisse)
• includes/config.JTL-Shop.ini.php
• install/logs
• export
• jtllogs
• mediafiles (sowie alle Unterverzeichnisse)
• media (sowie alle Unterverzeichnisse)
• rss.xml
• shopinfo.xml
• templates_c
• uploads

Wenn Sie einen Root-Server betreiben, dann können Sie die Rechte mit folgendem Befehl setzen:

chmod -R 755 bilder/* dbeS/tmp dbeS/tmp dbeS/logs admin/templates_c jtllogs install/logs templates_c includes/config.JTL-Shop.ini.php mediafiles admin/includes/emailpdfs shopinfo.xml rss.xml uploads export media

Schritt 3: Installationsvorgang mit dem Installer starten

1. Rufen Sie in Ihrem Browser die Seite <IHRE-SHOP-URL>/install auf. Sie gelangen auf die Seite Herzlich Willkommen bei der Installation Ihres neuen JTL-Shops.
2. Klicken Sie auf die Schaltfläche Weiter zu Schritt 1. Sie gelangen auf die Seite Bestehende Installation, in der JTL-Shop prüft, ob bereits eine Installation vorhanden ist. Falls dies der Fall ist, lesen Sie bitte die Anleitung JTL-Shop updaten.

3. Klicken Sie auf Weiter, um zur Seite Dateirechte zu gelangen. Hier prüft JTL-Shop, ob Sie alle Dateirechte korrekt gesetzt haben und weist Sie auf ggf. falsch gesetzte Rechte hin.
4. Klicken Sie erneut auf Weiter. Sie gelangen nun zur Seite Serverkonfiguration. Hier zeigt Ihnen JTL-Shop, ob Ihr Server korrekt konfiguriert wurde. Wenn Sie vorher den Systemcheck durchgeführt haben, sollten hier keine Fehler angezeigt werden.

Wenn alle Serveranforderungen und Dateirechte mit OK angezeigt werden, können Sie nun eine Datenbank für JTL-Shop mit einem Datenbankverwaltungsprogramm wie etwa PhpMyAdmin erstellen und die Daten der Datenbankverbindung eintragen.

Erläuterungen zu den Datenbank-Formularfeldern:
Der DB-Host ist der Servername, auf dem die Datenbank läuft. Gewöhnlich ist es localhost. Den DB-Benutzernamen erhalten Sie in den meisten Fällen von Ihrem Hoster, es sei denn, Sie haben Root-Rechte auf der Datenbank und können eigene Datenbankbenutzer erstellen. Beachten Sie bitte, dass der Datenbankbenutzer folgende Rechte auf der Datenbank braucht: SELECT, CREATE, ALTER, INSERT, UPDATE, DELETE, INDEX, DROP. Das DB-Passwort zum Datenbankbenutzer erhalten Sie ebenfalls von Ihrem Hoster. Der Datenbankname ist der Name der Datenbank, die für JTL-Shop erstellt wurde, und, für die der Datenbankbenutzer die oben genannten Rechte besitzt.

5. Klicken Sie auf Weiter, um zur Seite Datenbankparameter zu gelangen. Geben Sie hier die Zugangsdaten und den Namen Ihrer Datenbank an.
6. Klicken Sie auf Daten prüfen, um zu sehen, ob die Daten korrekt eingegeben wurden. Klicken Sie anschließend auf Weiter. Sie gelangen auf die Seite Admin- und Sync-Benutzer.

Demodaten installieren: Sie können diese Checkbox aktivieren, wenn Sie möchten, dass Ihr JTL-Shop mit Demodaten befüllt wird. So können Sie sich relativ schnell ein Bild von JTL-Shop machen, ohne ihn mit JTL-Wawi zu verbinden und Ihre eigenen Artikel in den Shop zu laden. Sie können JTL-Shop zu einem späteren Zeitpunkt zurücksetzen, um die Demodaten wieder aus dem System zu entfernen.

7. Notieren Sie die Benutzerdaten, da Sie diese zur Anmeldung im Backend von JTL-Shop benötigen. Klicken Sie anschließend auf Weiter. Sie gelangen zur Seite Schema importieren.
8. Klicken Sie auf Weiter, um die Installation abzuschließen. Sie erhalten eine Zusammenfassung der Installation.

9. Entfernen Sie nach erfolgreicher Installation das install/-Verzeichnis aus Ihrem Shop. Der Datei includes/config.JTL-Shop.ini.php sollten Schreibrechte entzogen werden. 644 ist ab jetzt ausreichend für diese Datei.

Sie können nach erfolgreicher Installation mit der JTL-Shop-Grundkonfiguration fortfahren, um Einstellungen, Kategorien und Artikel in den JTL-Shop zu übertragen.

Domainweiterleitung einrichten

Hierbei handelt es sich nicht um eine JTL-Shop-spezifische Einstellung, sondern um eine ganz allgemeine Einstellung des Webspace. Dieser Schritt ist für eine erfolgreiche Installation von JTL-Shop nicht notwendig, er wird aber dringend empfohlen. Für Suchmaschinen ist es wichtig, dass gleiche Inhalte nicht über unterschiedliche Domains zugänglich sind (Stichwort: Duplicate Content). Unterschiedliche Domains sind auch schon Domains, die sich in der Subdomain unterscheiden. Insbesondere ist www.meinshop.de eine andere Domain als nur meinshop.de. Sollte Ihr Webspace über beide Domains erreichbar sein, so sollten Sie dringend die Anweisungen in diesem Abschnitt befolgen und eine Domainweiterleitung einbauen. Eine solche Weiterleitung verhindert also das Auftreten von Duplicate Content, das für das Ranking bei Suchmaschinen schädlich ist.

Achtung: Wenn Sie eine Weiterleitung einrichten, sollten Sie sicherstellen, dass die gewünschte Domain auch in der Datei includes/config.JTL-Shop.ini.php bei URL_SHOP steht. Sollte dies nicht der Fall sein, korrigieren Sie dies bitte, denn sonst gibt es bei jedem Klick eine unnötige Weiterleitung.

Um eine Weiterleitung (technisch ist es eine Umschreibung) einzurichten, muss in der .htaccess-Datei, die sich im Wurzelverzeichnis des Shops befindet, direkt unter der Zeile RewriteEngine On (bei JTL-Shop3 ist dies die Zeile 29) einer der nachfolgenden Abschnitte eingefügt werden. Bitte die Beispieldomain meinshop.de mit Ihrer tatsächlichen Domain ersetzen! Die .htaccess-Dateien haben ab JTL-Shop-Version 3.03 vorgefertigte, auskommentierte Regeln bereits integriert (#REWRITE ANPASSUNG 2 (auf www.meinedomain.de umleiten)), so dass Sie die Regeln nur auskommentieren (# entfernen) und die Domain anpassen brauchen.

Weiterleitung von meinshop.de auf www.meinshop.de

Die wohl häufigste Regeln, ist die Umschreibung auf www.

RewriteCond %{HTTP_HOST} ^meinshop.de
RewriteRule ^(.*)$ http://www.meinshop.de/$1 [r=301,L]

Diese Weiterleitung bewirkt, dass bei Eingabe von http://meinshop.de/meinartikel der Browser auf http://www.meinshop.de/meinartikel umgeleitet wird.

Weiterleitung von www.meinshop.de auf meinshop.de

Einige Shops bevorzugen es ohne www.

RewriteCond %{HTTP_HOST} ^www.meinshop.de
RewriteRule ^(.*)$ http://meinshop.de/$1 [r=301,L]

Weiterleitung von meinshop.eu und www.meinshop.eu auf www.meinshop.de

Es können auch mehrere Regeln gemacht werden, die mit [OR] getrennt werden

RewriteCond %{HTTP_HOST} ^meinshop.eu [OR]
RewriteCond %{HTTP_HOST} ^www.meinshop.eu
RewriteRule ^(.*)$ http://www.meinshop.de/$1 [r=301,L]

Weiterleitung von meinzweitershop.de und www.meinzweitershop.de auf www.meinshop.de

Natürlich können auch ganz anders lautende Domains umgeleitet werden:

RewriteCond %{HTTP_HOST} ^meinzweitershop.de [OR]
RewriteCond %{HTTP_HOST} ^www.meinzweitershop.de
RewriteRule ^(.*)$ http://www.meinshop.de/$1 [r=301,L]

Installation abgeschlossen: Nächste Schritte

Nach der Installation beginnt der Einrichtungsassistent. Folgen Sie den Schritten des Assistenten. Lesen Sie danach Einrichtung und Grundkonfiguration für die Einrichtung von JTL-Wawi und Shop.

Video

JTL-Shop installieren

In diesem Video erklären wir Ihnen, wie Sie JTL-Shop installieren.