Gold API - Modul für PrestaShop

Produktpreise einfach und automatisiert mit goldapi.io verbinden.

Einführung

Einführung

Edelmetallpreise in Echtzeit

Dieses PrestaShop Modul erlaubt es den aktuellen Gold- und Silberkurs über eine Schnittstelle zum Anbieter Goldapi.io abzufragen und damit den Preis für Edelmetall-Artikel wie Goldmünzen, Goldbarren, Silbermünzen und Silberbarren automatisch zu aktualisieren.

2023-06-06 13_25_26-Free Gold and Silver Prices JSON API _ GoldAPI.io – Mozilla Firefox.png

Einführung

Funktionsübersicht

Installation

Installation

7 Schritte zur einfachen Modulinstallation

  1. Gehen Sie im PrestaShop Backoffice zur Modulverwaltung (ehemals Modul-Manager) und klicken Sie auf „Modul hochladen“
  2. Ziehen Sie nun die Moduldatei (zip-Datei) per Drag & Drop oder wählen Sie
    die Datei im System-Verzeichnisbaum aus
  3. Wählen Sie die hochzuladende ZIP-Datei aus und klicken Sie auf "OK"
  4. Ihr Modul wird installiert und erscheint in der Liste der installierten Module
  5. Warten Sie bis die Modulinstallation erfolgreich abgeschlossen ist
  6. Um mit der Einrichtung zu beginnen, klicken Sie auf "Konfigurieren". Wenn Sie mehrere Shops haben, müssen Sie jeden Shop separat konfigurieren. Bitte wählen Sie Ihren Shop direkt aus dem Menü aus, mit dem Sie beginnen möchten.
  7. Testen Sie das Modul: Gehen Sie zur Frontend-Ansicht Ihrer Website und überprüfen Sie, ob das Modul wie erwartet funktioniert.

Viel Erfolg!

Einrichtung

Einrichtung

GoldAPI Konto einrichten

Sie benötigen für die Nutzung der Gold-API ein gültiges und aktives Google Konto.

Gehen Sie zur Seite https://www.goldapi.io/ und klicken Sie auf den Button "GET FREE API KEY OR SIGN IN"

gc_goldapi_2023-06-15 12_50_37-Free Real-Time Gold and Silver Spot Prices REST JSON API _ GoldAPI.io – Mozilla .png

Danach werden Sie aufgefordert sich mit Ihren Google-Kontodaten einzuloggen. (Erst E-Mail oder phone, dann im zweiten Schritt das Passwort eingeben)

gc_goldapi_2023-06-15 12_53_14-Free Real-Time Gold and Silver Spot Prices REST JSON API _ GoldAPI.io – Mozilla .png

Danach sind Sie eingelogged und können direkt den API-KEY einsehen und kopieren.

gc_goldapi_2023-06-15 12_58_06-Free Gold and Silver Prices JSON API _ GoldAPI.io – Mozilla Firefox.png

Einrichtung

Eigenschaften von Artikeln einrichten

Gehen Sie in Ihrem PrestaShop Back Office auf Katalog > Varianten & Eigenschaften (1) > Eigenschaften (2)

Dort klicken Sie auf den Button "Neue Eigenschaft hinzufügen" (3) und ergänzen die Eigenschaft "Edelmetall" (4).

gc_goldapi_2023-06-15 13_00_01-Eigenschaften • 1786 – Mozilla Firefox.png

Danach die neuen Eigenschaftswerte für Gold und Silber hinzufügen:

gc_goldapi_2023-06-15 13_08_55-C__Users_Chris_Desktop_Greenshot_gc_goldapi_2023-06-15 13_00_01-Eigenschaften • .png

gc_goldapi_2023-06-15 13_10_31-Eigenschaften _ Neue Eigenschaft hinzufügen • 1786 – Mozilla Firefox.png

Für Silber analog verfahren. Damit sind wir vorbereitet, das Modul einzustellen.

gc_goldapi_2023-06-15 13_13_39-Eigenschaften _ Edelmetall • 1786 – Mozilla Firefox.png

Einrichtung

allgemeine Modul-Konfiguration

Wichtig ist hier, dass ein gültiges Konto bei GoldAPI.io existiert und die Eigenschaftswerte für Gold und Silber bereits angelegt wurden.

Einstellungen

gc_goldapi_2023-06-15 13_19_35-Module Manager • 1786 – Mozilla Firefox.png

1) API-Key

Der API-Key wurde im vorherigen Kapitel bereits kopiert und kann jetzt hier in der Konfiguration eingetragen werden

2) Eigenschaft Edelmetall

Die Eigenschaft wurde im vorherigen Kapitel bereits angelegt und muss hier ausgewählt werden

3) Eigenschaftwert Gold

Der Eigenschaftswert Gold wurde im vorherigen Kapitel bereits angelegt und muss hier ausgewählt werden

4) Eigenschaftwert Silber

Der Eigenschaftswert Silber wurde im vorherigen Kapitel bereits angelegt und muss hier ausgewählt werden

5) Maximale Änderung (in %)

Dies ist ein Sicherheits-Merkmal des Moduls. Hier wird eine Zahl eingegeben, die bestimmt, wie hoch Preisschwankungen akzeptiert werden. Wenn dieser Wert bei einem Cronaufruf überschritten wird, dann wird der Preis im Shop nicht aktualisiert und der Shopbetreiber erhält per E-Mail eine Nachricht.

Beim initialen Einrichten der Artikel empfiehlt es sich, diesen Wert auf eine sehr hohe Zahl zu setzen und erst später im Livebetrieb diesen Wert sukzessive an die eigenen Sicherheitsbedürfnisse anzupassen.

6) Produktpreise ins Log schreiben 

Bei „Ja“ werden alle Preisänderungen in einer Log-Datei protokolliert, siehe Protokolleinträge / Log Einstellungen unten

7) Cron-Fehler E-Mail

Falls Sie über Fehler per E-Mail benachrichtigte werden möchten, geben Sie hier bitte eine gültige Mailadresse ein.

Cron Infos

Die Einstellungen zum Cronjob werden separat im übernächsten Kapitel beschrieben

Log Einstellungen

gc_goldapi_2023-06-15 13_52_22-Module Manager • 1786 – Mozilla Firefox.png

1) Loglevel

In diesem Dropdown wird das Log-Level festgelegt. Das sind interne Loglevel, die in der Programierung verschiedene Log-Mengen in das Log schreiben. NONE schaltet das Log ganz aus, DEBUg erzeugt die meisten und Emergency die wenigsten Log-Einträge.

2) Logdateien

Die Logdateien sind mit einem Zeitstempel versehen.

3) Logdateien löschen

Über diesen Button lassen sich alle Logdateien aus dem Modulverzeichnis löschen

Einrichtung

Artikel-Preisregeln konfigurieren

Eigenschaft dem Artikel zuweisen

Im Reiter "Allgemein > Eigenschaften" weisen Sie dem Produkt die Eigenschaft "Edelmetall" und den passenden Eigenschaftwert "Gold" oder "Silber" zu:

gc_goldapi_2023-06-15 17_18_29-Artikel • 1786 – Mozilla Firefox.png

Damit steht die Zuordnung, welcher Typ Preis bei der Preisaktualisierung gezogen werden soll.

gc_goldapi_2023-06-15 17_20_33-Artikel • 1786 – Mozilla Firefox.png

Preise

Im Reiter "Preise" finden Sie daraufhin die Einstellungen für den individuellen Preisaufschlag bezogen auf das Edelmetall.

gc_goldapi_2023-06-15 17_24_25-Artikel • 1786 – Mozilla Firefox.png

1) Spot-Preis-Anzeige

Neben der Goldapi-Überschrift finden Sie die aktuellen Spot-Preise für Gold und Silber und können daraufhin die Auswirkung auf den Endpreis besser abschätzen.

2) Preise abrufen

Mit diesem Button lassen sich die aktuellen Spot-Preise bei der Schnittstelle von Goldapi.io holen.

Preisauswirkung

a) Keine

Wenn bei der Auswirkung nichts ausgewählt wird, dann wird der Produktpreis nicht angepasst. Sie können einen fixen Preis festlegen, bei der API eine neuen Spot-Preis anfordern (1), das Spotpreis-Update wird kurz angezeigt (2), der zuvor festgelegte Preis ändert sich nicht (3).

gc_goldapi_2023-06-15 17_30_18-Clipboard.png

b) Prozentsatz

Der Prozentsatz eignet sich, wenn Sie auf ganze Unzen einen Preisaufschlag in Prozent definieren möchten. Das geht schnell und ist aber nur bei ganzen Unzen sinnvoll. Hierbei wird der prozentuale Aufschlag definiert (1), der Preis abgerufen (2) und der berechnete Preis wird hier direkt eingetragen (3).

gc_goldapi_2023-06-15 17_34_38-Artikel • 1786 – Mozilla Firefox.png

c) Betrag

Der Betrag verhält sich ähnlich, nur dass hier statt dem Prozentsatz ein Festwert (1) eingetragen wird. Dabei kann gewählt werden, ob der Wert inkl. oder zzgl. MwSt. (2) in die Berechnung einfließen soll. API abrufen (3) und der Preis wird aktualisiert (4)

gc_goldapi_2023-06-15 17_39_26-Artikel • 1786 – Mozilla Firefox.png

d) Formel

Die wichtigste und mächtigste Funktion ist die Formel, denn hierbei lassen sich ganz individuell Preisaufschläge modellieren.

Die Variable {sport} muss Bestandteil der Formel sein und ist der Wert des aktuellen Spotpreise des gewählten Edelmetalls.

In diesem Beispiel wird der Spotpreis doppelt genommen (für 2 Unzen) und mit einem zusätzlichen Aufschlag von 100 berechnet (1). Auch hier kann man zwischen zzgl. MwSt. und Bruttopreis wählen (2), den neuen Preis abrufen (3) und die Formel wird bei der Neuberechnung des Endpreises berücksichtigt (4).

gc_goldapi_2023-06-15 17_41_15-Artikel • 1786 – Mozilla Firefox.png

Einrichtung

Cronjob einrichten

Cron Infos

gc_goldapi_2023-06-15 13_32_38-Module Manager • 1786 – Mozilla Firefox.png

Der Cron Aufruf kann entweder per Wget oder über den PHP Interpreter aufgerufen werden. Bitte prüfen Sie bei Ihrem Provider, wie Crons eingerichtet werden.

1) Cron Aufruf per Wget

Hier wird die hier angegebene URL per Wget auf dem Server ausgeführt. Dieser Aufruf wird zum Beispiel über die CLI (Command Line Interface / Shell) direkt auf dem Server ausgeführt.

2) Cron Aufruf per PHP Interpreter

Dieser Aufruf kann direkt über den PHP Interpreter über die CLI (Command Line Interface / Shell) direkt auf dem Server ausgeführt und kann so in eine Crontab eingetragen werden.

3) Cron Aufruf per Button

Wen Sie diesen Button anklicken wird der Cron-Aufruf umittelbar in einem neuen Browsertab ausgeführt. Sie können per Rechtsklick auf den Button auf die Cron-URL kopieren, um den Link z.B. in Plesk bei den geplanten Aufgaben zu hinterlegen.gc_goldapi_2023-06-15 13_42_52-Module Manager • 1786 – Mozilla Firefox.png

Im Plesk stellen Sie den Cronjob dann auf "Fetch a URL" und geben im Feld "URL" den kopierten Link ein.

gc_goldapi_2023-06-15 13_48_40-Schedule a Task - Plesk Obsidian 18.0.53 – Mozilla Firefox.png

4) Cron läuft auf Wartung

Führen Sie Cronjobs aus, auch wenn der Wartungsmodus in Ihrem Shop aktiviert ist. Ansonsten wird der Aufruf nicht erfolgreich sein.

Übersetzungen & Sprachen

Übersetzungen & Sprachen

Übersetzungen

Die Übersetzungen können direkt in der Modulkonfigurationsansicht vorgenommen werden. Klicken Sie dazu einfach auf Übersetzen und wählen Sie anschließend die gewünschte Sprache aus. Zur Auswahl stehen alle von Ihnen installierten Sprachen. Deutsch und Englisch werden mit dem Modul mitgeliefert.

 

2023-06-06 13_38_27-Übersetzungen • 1786 – Mozilla Firefox.png

Modul-Kompatibilität

Modul-Kompatibilität

Kompatibilität mit PrestaShop

GoldAPI für PrestaShop 8

GoldAPI für PrestaShop 1.7

Hinweis: Falls Sie eine PrestaShop 1.7. Version nutzen, können die Screenshots lt. dieser Dokumentation abweichen.

Lizenz

Lizenz

Lizenz Gold API Modul

Fazit/ Downloads

Verwalten Sie Edelmetallkurse durch Echtzeitanbindung an GoldAPI.io. Edelmetallpreise unterliegen an der Börse ständigen Schwankungen und können sich daher innerhalb von Minuten stark verändern. Dieses Tool unterstützt Sie bei einer soliden Preiskalkulation.

Fazit/ Downloads

Hilfreiche Links und Downloads

Download Gold API für PrestaShop 8
(zur Zeit nur auf Anfrage verfügbar)

Hinweis
Bitte beachten Sie, dass diese Dokumentation eine Momentaufnahme darstellt und sich von älteren oder zukünftigen Versionen unterscheiden kann. Wir sind darum bemüht, unsere Dokumentation aktuell zu halten. Bei Rückfragen oder Unsicherheiten stehen wir Ihnen jederzeit gerne zur Verfügung.

Hilfreiche Links
Goldapi.io
Anbieter der Wechselkurs-Schnittstelle für Edelmetalle

Falls Sie Unterstützung bei der Optimierung Ihres PrestaShop-Shops benötigen, zögern Sie nicht, Gurkcity zu kontaktieren. Unser Support-Team steht Ihnen nicht nur bei der Modulinstallation zur Seite, sondern bietet Ihnen auch umfassende Dienstleistungen als PrestaShop Full-Service-Agentur an.