Das Plugin bei FATCHIP: https://www.fatchip.de/Plugins/OXID-eShop/OXID-Plugin-Betreiber-Statistiken.html
Das Plugin auf Github: https://github.com/FATCHIP-GmbH/plugin-oxid6-stats (private)

• OXID CE/PE/EE ab Version 6.0.x bis 6.5.x
  
• SSH-Zugang zum Shoproot

Bitte deaktivieren und aktivieren Sie das Plugin einmal, nachdem die aktualisierten Dateien auf Ihren Server geladen wurden.

Entfernen Sie alle alten Plugindateien aus dem modules Ordner.

Entfernen Sie die Einträge des Moduls in der entsprechenden Shop-Yaml

  {shoproot}/var/configuration/shops

Führen Sie die nachfolgend aufgeführten Schritte der Installation aus.

Melden Sie sich per SSH an dem Server an, auf dem sich die Shop-Installation befindet, und navigieren Sie zu dem Verzeichnis, in dem sich der Source- und Vendorornder befinden. Führen Sie folgenden Befehl aus, um die nötigen Änderungen in der Datenbank vorzunehmen:

vendor/bin/oe-eshop-doctrine_migration migration:migrate fcStats

Loggen Sie sich in den Admin des Shops und starten Sie die Berechnung via *FATCHIP Statistiken* → *Modul-Wartung* → *fehlende Datenbankindezes ergänzen und Daten vorberechnen* neu.

Loggen Sie sich in den Admin Ihres Shops und wechseln Sie zu *Service* → *Tools*. Fügen Sie nachfolgende SQL-Befehle in das Textfeld und klicken Sie auf Update starten.

alter table oxorderarticles_fcstats modify column `FCSTATS_FCARTID` char(32) COLLATE latin1_general_ci NULL DEFAULT NULL COMMENT 'oxarticle ID';
alter table oxorderarticles_fcstats modify column `FCSTATS_PARENTID` char(32) COLLATE latin1_general_ci NULL DEFAULT NULL COMMENT 'oxarticle parent ID';
alter table oxorderarticles_fcstats modify column `FCSTATS_ROOTCATID` char(32) COLLATE latin1_general_ci NULL DEFAULT NULL COMMENT 'oxarticle rootcat ID';
alter table oxorderarticles_fcstats modify column `FCSTATS_CATID` char(32) COLLATE latin1_general_ci NULL DEFAULT NULL COMMENT 'oxarticle category ID';
truncate oxorderarticles_fcstats;

Starten Sie die Berechnung via *FATCHIP Statistiken* → *Modul-Wartung* → *fehlende Datenbankindezes ergänzen und Daten vorberechnen* neu.

Loggen Sie sich in den Admin Ihres Shops und wechseln Sie zu *Service* → *Tools*. Fügen Sie nachfolgende SQL-Befehle in das Textfeld und klicken Sie auf Update starten.

truncate oxorderarticles_fcstats;

Starten Sie die Berechnung via *FATCHIP Statistiken* → *Modul-Wartung* → *fehlende Datenbankindezes ergänzen und Daten vorberechnen* neu.

Öffnen Sie die Datei composer.json im Stammverzeichnis Ihres Shops und fügen Sie das Repository hinzu oder vervollständigen Sie die vorhandene Konfiguration:

"repositories": [{
  "type": "composer",
  "url": "https://packages.fatchip.de/packages"
}]

Nach erfolgter Ergänzung der Datei composer.json können Sie da Plugin installieren.
Melden Sie sich dazu per SSH an dem Server an, auf dem sich die Shop-Installation befindet, und navigieren Sie zu dem Verzeichnis, in dem sich der Source- und Vendorornder befinden.
Führen Sie folgenden Befehl aus, um das Plugin zu installieren

  composer require fatchip-gmbh/plugin-oxid6-stats

Beachten Sie, dass der genaue Aufruf des Composers für Ihre konkrete OXID-Installation abweichen kann.

Sie werden nun nach einem Benutzer und einem Passwort gefragt. Geben Sie die Zugangsdaten ein, welche Ihnen per E-Mail übersandt wurden.
Bitte speichern Sie diese Zugangsdaten nicht auf Ihrem Server, da es sonst zu Problemen kommt, sollten Sie mehrere unserer Plugins einsetzen oder einsetzen wollen.

Nach korrekter Eingabe der Zugangsdaten wird das Plugin installiert.

Erstellen Sie im Verzeichnis {shoproot}/source/modules einen Unterordner fc. In dem Pluginpaket befindet sich der Ordner fcStats.
Kopieren Sie den Inhalt aus diesem Ordner in das eben erstellte Verzeichnis fc(bei FTP - binären Übertragungsmodus nutzen).

Öffnen Sie die Datei composer.json im Stammverzeichnis Ihres Shops und fügen Sie diese Autoload-Konfiguration hinzu oder vervollständigen Sie die vorhandene Konfiguration:

  "autoload": {
    "psr-4": {
      "FC\\Stats\\": "./source/modules/fc/fcStats"
    }
  },

Nach erfolgter Ergänzung der Datei composer.json müssen die Änderungen dem OXID-System mitgeteilt werden.
Melden Sie sich dazu per SSH an dem Server an, auf dem sich die Shop-Installation befindet, und navigieren Sie zu dem Verzeichnis, in dem sich der Source- und Vendorornder befinden.
Führen Sie folgenden Befehl aus, um die Autoloader-Dateien neu zu generieren

  vendor/bin/composer dump-autoload

Beachten Sie, dass der genaue Aufruf des Composers für Ihre konkrete OXID-Installation abweichen kann.

Nach erfolgreicher Aktion wird folgende Meldung angezeigt:
Generating autoload files
Generated autoload files

In OXID-Versionen ab 6.2 (ältere Versionen können den Schritt überspringen) muss die Modulkonfiguration eingelesen werden.
Melden Sie sich dazu per SSH an dem Server an, auf dem sich die Shop-Installation befindet, und navigieren Sie zu dem Verzeichnis, in dem sich der Source- und Vendorornder befinden. Führen Sie die folgenden Befehle aus:

vendor/bin/oe-console oe:module:install-configuration source/modules/fc/fcStats
vendor/bin/oe-console oe:module:apply-configuration 

Bei erfolgreichem Einlesen/Import erscheint die Nachricht
Module configuration has been installed

Leeren Sie das Temp Verzeichnis (tmp) in Ihrem OXID eShop Hauptverzeichnis. Die enthaltene .htaccess-Datei darf dabei aber NICHT gelöscht werden!

Aktivieren Sie das Betreiber-Statistiken Plugin im OXID Administrationsbereich unter Erweiterungen → Module → FATCHIP Module OXID Stats.

Da die Abfragen der Statistiken recht rechenintensiv sein könnten, werden diese initial generiert. Dieser Vorgang wird beim Aufruf der Plugineinstellungen unter Erweiterungen → Module → FATCHIP Module OXID Stats → Einstellungen mit dem Button Speichern ausgeführt.

Alternativ können Sie die Vorberechnung der Statistiken auch über dem Button „fehlende Datenbankspalten ergänzen und Daten vorberechnen“ unter FATCHIP Statistiken → Modul-Wartung → Daten generieren initiieren.

Sie können diesen Vorgang auch regelmäßig über einen Cronjob ausführen, dass dafür benötigte Script finden Sie unter /modules/fc/fcStats/batch/fcstats_batch_generator.php.

Die Betreiber-Statistiken Grundeinstellungen können Sie unter Erweiterungen → Module → FATCHIP Module OXID Stats → Einstellungen vornehmen.

In den Betreiber-Statistiken Plugin-Setup unter FATCHIP Statistiken → Modul-Wartung können Sie den Status der relevanten Systemvorrausetzungen prüfen und ggf. die Vorberechnung der Statistiken generieren.

Um die generierten CSV-Statistiken über das OXID-Backend herunterladen zu können, muss ein Benutzer und ein Passwort festgelegt werden. Geben Sie einfach die gewünschten Daten ein und klicken Sie auf die Schaltfläche *Passwort für CSV-Download generieren*

Unter FATCHIP Statistiken → Mobile-App finden Sie den QR-Code und einen persönlichen Link zu Ihrer Betreiber-Statistiken Mobile-App. Eine für Smartphones optimierte Ansicht mit einer Übersicht der Bestellungen und dem Top-Artikel des Tages.

Unter FATCHIP Statistiken finden Sie alle Statistiken mit wichtigen Kennzahlen aus Ihrem OXID eShop. Folgende Statistiken sind verfügbar: Bestellungen, Top-Produkte, Top-Kategorien, Top-Lieferanten, Top-Hersteller, Top-Zahlungsarten, Nach Ländern, Top-Kunden, Kundengruppen, Benutzergruppen, Zielgruppen und Gutscheine.

1. Welche OXID eShop Versionen sind mit dem Betreiber-Statistiken Plugin von FATCHIP kompatibel?
2. Kann ich irgendwo vorab die Funktionsweise des Betreiber-Statistiken Plugins einsehen?
3. Beim Aufruf der Statistiken im Admin erscheint eine weisse Seite - was soll ich tun?
4. Braucht man den Button "fehlende Datenbankspalten ergänzen und Daten vorberechnen" (FATCHIP Statistiken -> Modul-Wartung) nur einmalig bei der Erstinstallation oder braucht man ihn jedes mal um die Statistiken genau zu berechnen?
5. Die Vorberechnung der Statistiken schlägt fehl, was tun?
6. Die Betreiber-Statistiken werden nicht angezeigt, was tun?
7. Wie kann ich die Scriptlaufzeit anpassen (max_execution_time)?
8. Warum wird das Plugin nach der Installation in OXID 6.2 nicht in der Pluginliste angezeigt?

Die aktuellsten Informationen hierzu erhalten Sie in der Kompatibilitätsmatrix in unserem Shop.

Ja, wir haben ein Video-Tutorial erstellt, welches die Grundfunktionen des Plugins erklärt. Das Video ist hier erreichbar.
Des Weiteren können Sie im Demoshop die Funktionsweise auch direkt ausprobieren. Wählen Sie aus der angezeigten Liste einfach Fatchip aus und dann das entsprechende Modul.

Erhöhen Sie die max_execution_time und das memory_limit in der php.ini - je mehr Daten Sie in Ihrem Shop haben, desto höher muss der Wert konfiguriert werden.

Da viele Abfragen sehr rechenintensiv sind werden einige Daten vorberechnet und zur Vereinfachung und Verbesserung der Leistung in die Datenbank geschrieben.

Dieser Prozess ist regelmäßig vor Erzeugung neuer Statistiken nötig um genaue und aktuelle Ergebnisse zu erhalten. Dies kann man manuell erledigen oder automatisiert per Cronjob auf die Datei „/modules/fc/fcStats/batch/fcstats_batch_generator.php„.

Wenn die Vorberechnung der Statistiken fehlschlägt, könnte es daran liegen, dass die erlaubte Scriptlaufzeit max_execution_time auf Ihrem Server zu niedrig ist. Dadurch werden Scripte nach einer bestimmten Zeitspanne vom Parser gestoppt. Den Wert können Sie unter Service → Systeminfo → max_execution_time prüfen.

Prüfen Sie, ob alle Schritte der Installation korrekt ausgeführt worden sind und unter FATCHIP Statistiken → Modul-Wartung alle erforderlichen Systemvoraussetzungen erfüllt sind.

Da einige der Statistiken sehr rechenintensiv sein könnten, sollten diese regelmäßig vor Erzeugung neuer Statistiken initial generiert werden, damit eine Vorberechnung stattfindet. Die Vorberechnung der Statistiken kann unter FATCHIP Statistiken → Modul-Wartung → Daten generieren wiederholt werden. Sie können diesen Vorgang auch regelmäßig über einen Cronjob ausführen, dass dafür benötigte Script finden Sie unter /modules/fcStats/batch/fcstats_batch_generator.php.

Wenn die Vorberechnung der Statistiken fehlschlägt, könnte es daran liegen, dass die erlaubte Scriptlaufzeit max_execution_time auf Ihrem Server zu niedrig ist. Dadurch werden Scripte nach einer bestimmten Zeitspanne vom Parser gestoppt. Den Wert können Sie unter Service → Systeminfo → max_execution_time prüfen.

Ab OXID 6.2 wird die Pluginkonfiguration (metadata.php) nicht mehr automatisch eingelesen. Dafür müssen Sie den folgenden Befehl über die SSH Kommandozeile in dem Shopverzeichnis (wo der „vendor“ Ordner liegt) ausführen:

./vendor/bin/oe-console oe:module:install-configuration source/modules/fc/fcStats/

Nach der Ausgabe von „Module configuration has been installed.“ wird das Plugin unter Erweiterungen → Module aufgelistet und kann aktiviert werden.

Sollten Sie Hilfe von FATCHIP benötigen, schicken Sie bitte eine detaillierte Fehlerbeschreibung inkl. Plugin- und Shopversion an support@fatchip.de.

Sollte das OXID Plugin Betreiber-Statistiken nach der Installation nicht wie erwartet funktionieren, prüfen Sie ob alle Installationsschritte richtig durchgeführt worden sind.
Weitere Informationen finden Sie in unserem Online Shop unter: https://www.fatchip.de/Plugins/OXID-eShop/OXID-Plugin-Betreiber-Statistiken.html

Außerdem bietet FATCHIP einen Plugin-Installationsservice an. Weitere Informationen hierzu finden Sie unter:
https://www.fatchip.de/Servicepakete/Plugin-Installationsservice-OXID-eShop-PE.html
https://www.fatchip.de/Servicepakete/Plugin-Installationsservice-OXID-eShop-EE.html