Installation der Software

Nach dem Herunterladen der Software in seiner neusten Version kann die Software nun installiert werden. Folgen Sie den folgenden Schritten, um sicher durch die kurze Installation geführt zu werden.

Themen auf dieser Seite:

• Voraussetzungen
• SHA1-Summe des Downloads überprüfen
• Entpacken des Archivs
• Lokale Installation
• Installation auf einem Webserver/Webspace
• Bearbeiten der config.php
• Setup starten
• Grundlegende Einstellungen
• Einrichten des Administrators
• Installation der Shop-Software
• Der erste Login

Voraussetzungen ↑

Um die Onlineshop-Software Farmr Pro zu installieren, sind einige Vorbedingungen an das Betreibersystem geknüpft. Farmr Pro benötigt einen HTTP-Server, der in der Lage ist, PHP zu interpretieren (PHP > 5.3.x). Ferner sollte PHP mit MySQL- sowie mit PHP-GD-Unterstützung (Grafikbibliothek zur Bearbeitung von Bilddateien) installiert sein. Auch ein lokaler oder entfernter MySQL-Server mit ausreichenden Rechten zum Anlegen von Datentabellen muss vorhanden sein (hier: MySQL > 5.5.x). Reine Webpräsenzen ohne Unterstützung von PHP und MySQL funktionieren nicht mit Farmr Pro.

SHA1-Summe des Downloads überprüfen ↑

Überprüfen Sie die SHA1-Summe des Downloads und somit die Integrität des Downloads. Den SHA1-Hashcode ermitteln Sie durch die Verwendung der entsprechenden Programme wie zum Beispiel fciv.exe für Windows (über Befehlszeile) oder sha1sum für Linux (über Shell).

Beispiel Windows:
fciv.exe -v -sha1 farmrpro-0.1.9.3.zip

Beispiel Linux:
sha1sum farmrpro-0.1.9.3.zip

SHA1-Summe für Version 0.1.9.3
eb82afc7199ac43c277c15b67af3a8406e780e5d

Entspricht die SHA1-Summe nicht der hier dargestellten, ist der Download fehlerhaft und die Datei sollte nicht verwendet werden, da Fehler bei der Installation als auch schadhafte Veränderungen durch Dritte nicht ausgeschlossen werden können. Wiederholen Sie ggf. den Download. Bleiben die Überprüfungen der SHA1-Summe weiterhin falsch, obwohl Sie die Datei über den Original-Downloadlink heruntergeladen haben, informieren Sie uns bitte kurz per E-Mail an support@farmr.de.

Entpacken des Archivs ↑

Entpacken Sie das heruntergeladene ZIP-Archiv mit einer herkömmlichen Archivsoftware, die in der Lage ist, ZIP-Archive zu öffnen und zu entpacken (z.B. WinRAR für Windows). Nach dem Entpacken sollte der Ordner farmrpro in Ihrem Verzeichnis zu finden sein.

Lokale Installation ↑

Entscheiden Sie nun, an welchem Ort Sie die Shopsoftware installieren wollen. Sie können zu Testzwecken die Software in einer lokalen Sandbox (z.B. einem Testsystem wie XAMPP mit HTTP- und MySQL-Server) laufen lassen oder aber direkt in den Produktionsbetrieb eines laufenden Webservers/Webspaces integrieren.

Möchten Sie den Shop erst einmal ausprobieren, empfehlen wir den Shop in einer Sandbox zu installieren. Verschieben Sie dazu den gesamten Ordner farmrpro in das Verzeichnis, aus dem  Ihr lokaler HTTP-Server Webinhalte lesen und ausgeben kann (z.B. Verzeichnis “C:\…\Eigene Dokumente\www” oder ähnlich).

Installation auf einem Webserver/Webspace ↑

Um den Ordner farmrpro auf einem Webserver/Webspace zu installieren, benötigen Sie einen FTP-Client (Windows: Filezilla, Linux: gFTP), der den Ordner auf Ihren Server/Space aufspielt. Verbinden Sie sich mittels des FTP-Clients mit Ihrem Server/Space und kopieren Sie den gesamten Ordner in das Wurzelverzeichnis, aus dem der Webserver die Webseitendokumente ausliest und an den anfragenden Browser zurückgibt.

Beispiel: So könnte die Verzeichnisstruktur nach dem Aufspielen des Ordners auf Ihrem Webserver/Webspace aussehen

• www/
  • farmrpro/
    • admin
    • ajax
    • content
    • js
    • …

Bearbeiten der config.php ↑

Bevor die Installationsroutine über den Webbrowser aufgerufen werden kann, muss die im Ordner enthaltene Datei config_sample.php editiert werden. In ihr werden die Basiseinstellungen für die MySQL-Serverbenutzung für die Software bereitgestellt. Öffnen Sie die Datei mit einem Texteditor und passen sie die Einstellungen gemäß des zu verwendenden MySQL-Servers an.

Beispiel: Editieren Sie die Einstellungsdatei config_sample.php

Geben Sie die URL oder IP-Adresse zum MySQL-Server an, oft reicht localhost
define(”MYSQL_SERVER”,”localhost”);

Hier geben Sie bitte den Nutzernamen an, mit dem Sie sich beim MySQL-Server anmelden können
define("MYSQL_USERNAME","mustermann");

Geben Sie hier das zum Nutzernamen gehörige Passwort an
define("MYSQL_PASSWORD","test123");

Wählen Sie bitte hier die zu verwendende Datenbank an
define("MYSQL_DB","mustermann");

Geben Sie hier das Vorzeichen der Shoptabellen an, die Tabellen werden darüber definiert.
define("TABLES_PREFIX","shop");

Speichern Sie als nächsten Schritt die Datei nicht als config_sample.php sondern als config.php ab. Andernfalls kann keine Konfigurationsdatei von der Software gefunden werden und die Installation schlägt fehl.

Wichtig: Haben Sie sich für die Installation auf einem Webserver/Webspace entschieden, vergessen Sie bitte nicht die editierte Datei config.php mittels FTP-Client auf den Server in den Hauptordner der Shop-Software zu überspielen.

Setup starten ↑

Haben Sie die Konfigurationsdatei editiert und auf den zu verwendenden MySQL-Server ausgerichtet (und ggf. auf den Server hochgeladen), kann nun der eigentliche Setupvorgang gestartet werden. Geben Sie dazu die Adresse (URL oder IP) des Shops in die Adresszeile Ihres Browsers ein.

Über einen Server
Haben Sie die Software auf einem per URL erreichbaren Server/Webspace installiert und führt die Angabe der URL im Browser auf das eigentliche Shop-Verzeichnis, so reicht die Eingabe der URL, z.B.

http://www.ihreshopdomain.de/

Liegt die Shopsoftware in einem Unterverzeichnis der Domain, geben Sie bitte zusätzlich zur URL den Pfad zu diesem Unterverzeichnis an, z.B.

http://www.ihreshopdomain.de/farmrpro/

Über LAN/Localhost
Haben Sie die Software hingegen zu Test- und Entwicklungszwecken auf einem lokalen Server im LAN oder auf dem Localhost installiert, geben Sie bitte die IP-Adresse des Servers im LAN oder die Adresse des Localhosts an, ggf. erweitert um das Verzeichnis, in dem die Shop-Software liegt, z.B.

http://127.0.0.1/farmrpro

oder

http://192.168.1.15/farmrpro

Der folgende Setup-Bildschirm sollte nun in Ihrem Browser erscheinen:

Grundlegende Einrichtung ↑

Unter dem Punkt ‘Grundlegende Einstellungen’ der 5-Minuten-Installation werden zwei wichtige Dinge festgelegt: Zum einen der Name der Shop (kann jederzeit verändert werden) als auch die URL zum Shop. Gerade hier ist es wichtig, die URL zum Shop genau zu setzen, denn ohne genaue URL wird weder das Setup noch später die Software funktionieren. Achten Sie daher bitte genauestens auf die richtige Angabe der URL zum Shop und ggf. derem Unterverzeichnis.

Beispiel URL-Eingabe:
Liegt die Shopsoftware in dem Verzeichnis, auf das die Domain gerichtet ist, reicht die Eingabe

http://www.ihreshopdomain.de/

Liegt die Shopsoftware jedoch in einem Unterverzeichnis, muss die URL um dieses Verzeichnis erweitert werden:

http://www.ihreshopdomain.de/farmrpro/

WICHTIG: Bitte vergessen Sie nicht das abschließende Slash-Zeichen / hinter der vollständigen URL.

Einrichten des Administrators ↑

Eine Nutzerverwaltung mit verschiedenen Nutzungsrechten ist derzeit in Farmr Pro nicht vorgesehen und realisiert. Daher wird nur der Benutzer ‘Admin’ angelegt. Das Passwort können Sie in der Admin-Einrichtung frei wählen. Das Passwort muss dabei mindestens 6 Zeichen lang sein und darf die Maximallänge von 20 Zeichen nicht überschreiten.

Nach dem Passwort geben Sie bitte noch die Korrespondenz-Emailadresse an, über die der Shop seine automatisierten Mails versendet und für Kunden erreichbar sein wird, z.B. shop@ihreshopdomain.de.

Installation der Shop-Software ↑

Sind alle Einstellungen vorgenommen, klicken Sie bitte abschließend auf die Schaltfläche ‘Onlineshop einrichten’. Die Software wird nun mit Ihren Vorgaben installiert. Dazu erstellen die Setuproutinen alle notwendigen Datentabellen, die die Software benötigt, um ihre Funktionalität zu gewährleisten. Treten hier Fehler auf, sind entweder Datenabellen gleichen Namens bereits in der Datenbank enthalten oder aber im schlimmsten Fall ist Ihr Webspace/-Server nicht mit der geeigneten Funktionalität an PHP und/oder MySQL ausgestattet. Im ersten Fall des Vorhandenseins von Tabellen gleichen Namens, überprüfen Sie, ob Sie den Shop ggf. schon einmal installiert haben (ggf. Update statt Neuinstallation empfohlen) und ob Sie Tabellen noch benötigen. Sie können die Tabellen löschen (sofern die darin enthaltenen Daten nicht mehr benötigt werden) oder, sofern Sie sich nicht sicher sind, ob Sie die Datentabellen löschen wollen, in der Datei ‘config.php’ über die Einstellungsoption TABLES_PREFIX einen neuen Präfix für die Tabellen setzen.

Der erste Login ↑

Nach einer erfolgreichen Installation, wird Ihnen der Benutzernamen sowie das dazugehörige Passwort als Klartext angezeigt sowie ein Link zum Login angeboten. Klicken Sie auf diesen Link, um zum Login zu gelangen. Geben Sie dort bitte Ihren Benutzernamen ‘admin’ sowie Ihr Passwort ein. Sie werden bei erfolgreicher Prüfung zum ersten Mal das Back-Office der Software betreten.

Herzlichen Glückwunsch, die Installation von Farmr Pro war erfolgreich.

Welche Einstellungen Sie an Ihrem Shop als erstes vornehmen sollten und wie Sie Ihren Shop richtig über das Back-Office einrichten, können Sie in der Dokumentation “Einstellungen” nachlesen.

Wir wünschen Ihnen auf Ihrem Weg mit Farmr Pro viel Erfolg :)