Wechseln zu: Navigation, Suche

JTL-Shop:Installation:Neuinstallation

(Weitergeleitet von JTL-Shop3-Neuinstallation)

JTL-Shop Neuinstallation

Systemvoraussetzung

Bitte stellen Sie sicher, dass die folgenden Systemvoraussetzungen von Ihrem Webserver erfüllt werden:

  • Datenbank: MySql 5
  • Ab Shopversion 4.00 mindestens PHP 5.4. JTL-Shop3.20 ist unter PHP 5.3 bis PHP 5.6 lauffähig.
  • GD Lib aktiviert (PHP-Modul)
  • SimpleXML (PHP-Modul)
  • Empfohlen: ImageMagick und php-Modul Imagick (beschleunigt den Bilderabgleich bei der Shop-Wawi Synchronisation)
  • Mailserver
  • safe_mode OFF
  • register_globals OFF (Seit PHP 5.4 ist diese Einstellung entfernt)
  • mod_rewrite PHP-Modul
  • PHP-Modul ionCube aktiviert (IonCube Loaders). Ab JTL-Shop 4 ist der Shop nicht mehr verschlüsselt. Jedoch wird der IonCube-Loader noch für verschiedene Plugins von Servicepartnern benötigt.

Exkurs: Welche PHP-Version wird unterstützt? Jtl-wawi-jtl-shop-php-version-kompatibilitaet.jpg

  • memory_limit in php.ini mindestens 128MB (siehe PHP-Handbuch ini.core.php)
  • PHP Skript Ausführungszeit (max_execution_time) mindestens 120 Sekunden.
  • CURL
  • allow_url_fopen aktiv (wenn Zahlungsart Saferpay genutzt werden soll)
  • magic_quotes_runtime deaktiviert
  • Maximale PHP Übertragungsgröße (FILE) mindestens 6MB ( upload_max_filesize )
  • Maximale PHP Übertragungsgröße (POST) mindestens 8MB

Bitte beachten Sie:
Die Community Free Edition funktioniert nur mit JTL-Wawi ab Version 1.0. Außerdem empfehlen wir den Shop-Betrieb auf einem Apache Webserver (PHP-Mode: FCGI oder Apache Module). Bei Shop-Installationen auf Windows-, FreeBSD- oder sunOS-Servern können wir leider keinen umfassenden Support leisten. Alternative HTTP-Server (z.B. NGINX / PHP-FPM): Bitte beachten Sie, dass die .htaccess-Regeln (u. a. zum Verzeichnisschutz!) bei diesen Servern manuell durch entsprechende ProxyPass-Regeln nachgetragen werden müssen.

Webhosting-spezifische Voraussetzungen:

  • Info für All-Inkl Webhosting-Kunden: Stellen Sie sicher, dass Ihr Server PHP5 voreingestellt hat. Falls Sie sich nicht sicher sind, bitten Sie den All-Inkl Support dies zu prüfen und ggf. einen Umzug auf einen Server mit voreingestelltem PHP5 vorzunehmen.
  • 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.

Ausschließlich für Shop3 gilt außerdem:

  • 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:Installation:1und1_oder_Strato
  • 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.

Testen Sie, ob JTL-Shop auf Ihrem Server läuft

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

Shop3 Testskript Installationsanleitung:

  1. Testskript herunterladen
  2. Entpacken Sie die heruntergeladene Datei und laden Sie alle entpackten Dateien mit einem FTP-Programm auf Ihren Webserver in einen Ordner "shop3-systemcheck"
  3. Rufen Sie das Testskript mit Ihrem Browser auf (z. B. http://Ihre-Domain.de/shop3-systemcheck/). Wenn Sie das Testskript in ein anderes Unterverzeichnis entpackt haben, passen Sie den Aufruf entsprechend an.


Shop4 Testskript Installationsanleitung:

  1. Testskript herunterladen
  2. Entpacken Sie die heruntergeladene Datei und laden Sie alle entpackten Dateien mit einem FTP-Programm auf Ihren Webserver in einen Ordner "shop4-systemcheck"
  3. Rufen Sie das Testskript mit Ihrem Browser auf (z. B. http://Ihre-Domain.de/shop4-systemcheck/). Wurde das Skript in ein anderes Unterverzeichnis entpackt, passen Sie den Aufruf entsprechend an.


Die Neuinstallation des JTL-Shop ist in drei wesentliche Schritte unterteilt, die nacheinander durchlaufen werden müssen:

  1. Shop-Paket herunterladen, entpacken und auf eigenen Webspace hochladen
  2. Dateirechte setzen
  3. Installationsvorgang mit dem Installer starten

1. Shop-Paket herunterladen, entpacken und auf eigenen Webspace hochladen

  • Laden Sie das aktuelle JTL-Shop-Installationspaket von unserer Filebase herunter. Die Zugangsdaten zur Filebase erhalten Sie automatisch per E-Mail nach Bestellung des JTL-Shop und erfolgreichem Zahlungseingang.
  • 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
  • export
  • gfx
  • includes
  • install
  • jtllogs
  • mediafiles
  • templates
  • templates_c
  • update
  • + zusätzliche einzelne Dateien

Entpackte Dateien auf Webserver hochladen:

Die soeben entpackten Verzeichnisse und Dateien müssen nun per FTP auf Ihren Webspace übertragen werden.
Bitte stellen Sie Ihr FTP-Programm so ein, dass PHP-Dateien im Binärformat übertragen werden.

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 beschreibbar 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


Bei einigen Hostern reicht die Vergabe der Zugriffsrechte 755 nicht damit der Webserver Dateien beschreiben kann, setzten Sie dann hier die Zugriffsrechte auf 777.

3. Installationsvorgang mit dem Installer starten

Rufen Sie in Ihrem Browser die Seite <IHRE-SHOP-URL>/install auf.

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. 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.

Bitte bestätigen Sie die Datenbankangaben mit einem Klick auf Installation starten, um den Installationsprozess einzuleiten.

Nach erfolgreicher Installation entfernen Sie bitte 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.

4. Einrichtung einer Domainweiterleitung

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 vorgefertige, 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 anderslautende Domains umgeleitet werden:

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

5. SEO-Modul-Einrichtung bei Shops in Unterverzeichnissen

Falls Ihr Shop in einem Unterverzeichnis installiert ist und Ihr SEO-Modul nicht funktioniert (Fehler 404 kommt im Shop, wenn Sie auf Links klicken), müssen Sie Ihre .htaccess-Datei um eine RewriteBase erweitern. Dazu muss folgende Zeile direkt unter die Zeile 29 RewriteEngine on mit angepassten Verzeichnisnamen gesetzt werden:

RewriteBase /meinverzeichnis

Ab Version JTL-Shop3.03 können Sie die Schablone REWRITE ANPASSUNG 1 (REWRITEBASE) dafür nutzen. Kommentieren Sie dazu die Zeile #RewriteBase /meinverzeichnis aus (# entfernen) und passen Sie den Verzeichnisnamen an.

Abhängig vom Hoster kann es für den Betrieb des SEO-Moduls auch notwendig sein, die Rewrite Base explizit mit "/" anzugeben, also:

RewriteBase /

Installation abgeschlossen: Nächste Schritte

Nach erfolgreicher Installation geht es weiter mit der Einrichtung und Grundkonfiguration von JTL-Wawi und Shop.


Zurück zur Übersicht