# 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/](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](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/scaled-1680-/gc-goldapi-2023-06-15-12-50-37-free-real-time-gold-and-silver-spot-prices-rest-json-api-goldapi-io-mozilla.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/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](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/scaled-1680-/gc-goldapi-2023-06-15-12-53-14-free-real-time-gold-and-silver-spot-prices-rest-json-api-goldapi-io-mozilla.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/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](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/scaled-1680-/gc-goldapi-2023-06-15-12-58-06-free-gold-and-silver-prices-json-api-goldapi-io-mozilla-firefox.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/gc-goldapi-2023-06-15-12-58-06-free-gold-and-silver-prices-json-api-goldapi-io-mozilla-firefox.png) # 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](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/scaled-1680-/gc-goldapi-2023-06-15-13-00-01-eigenschaften-1786-mozilla-firefox.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/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](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/scaled-1680-/gc-goldapi-2023-06-15-13-08-55-c-users-chris-desktop-greenshot-gc-goldapi-2023-06-15-13-00-01-eigenschaften.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/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](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/scaled-1680-/gc-goldapi-2023-06-15-13-10-31-eigenschaften-neue-eigenschaft-hinzufugen-1786-mozilla-firefox.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/gc-goldapi-2023-06-15-13-10-31-eigenschaften-neue-eigenschaft-hinzufugen-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](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/scaled-1680-/gc-goldapi-2023-06-15-13-13-39-eigenschaften-edelmetall-1786-mozilla-firefox.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/gc-goldapi-2023-06-15-13-13-39-eigenschaften-edelmetall-1786-mozilla-firefox.png) # 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](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/scaled-1680-/gc-goldapi-2023-06-15-13-19-35-module-manager-1786-mozilla-firefox.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/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](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/scaled-1680-/gc-goldapi-2023-06-15-13-52-22-module-manager-1786-mozilla-firefox.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/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. - admin-Logdateien wurden durch das Back Office erzeugt - cron durch den Cronjob - install und uninstall Logs erscheinen bei den Installations- und Deinstallationsvorgängen #### 3) Logdateien löschen Über diesen Button lassen sich alle Logdateien aus dem Modulverzeichnis löschen # 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](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/scaled-1680-/gc-goldapi-2023-06-15-17-18-29-artikel-1786-mozilla-firefox.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/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](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/scaled-1680-/gc-goldapi-2023-06-15-17-20-33-artikel-1786-mozilla-firefox.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/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. - Bei Gold-Artikeln sind Rahmen und Button in Gold eingefärbt - Bei Silber-Artikeln sind Rahmen und Button in Silber eingefärbt [![gc_goldapi_2023-06-15 17_24_25-Artikel • 1786 – Mozilla Firefox.png](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/scaled-1680-/gc-goldapi-2023-06-15-17-24-25-artikel-1786-mozilla-firefox.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/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](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/scaled-1680-/gc-goldapi-2023-06-15-17-30-18-clipboard.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/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](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/scaled-1680-/gc-goldapi-2023-06-15-17-34-38-artikel-1786-mozilla-firefox.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/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](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/scaled-1680-/gc-goldapi-2023-06-15-17-39-26-artikel-1786-mozilla-firefox.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/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](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/scaled-1680-/gc-goldapi-2023-06-15-17-41-15-artikel-1786-mozilla-firefox.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/gc-goldapi-2023-06-15-17-41-15-artikel-1786-mozilla-firefox.png) # Cronjob einrichten ### Cron Infos [![gc_goldapi_2023-06-15 13_32_38-Module Manager • 1786 – Mozilla Firefox.png](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/scaled-1680-/gc-goldapi-2023-06-15-13-32-38-module-manager-1786-mozilla-firefox.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/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](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/scaled-1680-/gc-goldapi-2023-06-15-13-42-52-module-manager-1786-mozilla-firefox.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/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](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/scaled-1680-/gc-goldapi-2023-06-15-13-48-40-schedule-a-task-plesk-obsidian-18-0-53-mozilla-firefox.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/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.