Modul-Dokumentation „Währungsumrechner“

Allgemeine Infos zum Modul und zu uns 😊

Was das Modul kann

Dieses Modul ermittelt die aktuellen Umrechnungskurse (in Euro) der verwendeten Währungen und aktualisiert diese in deinem OXID Shop. Ausschlaggebend sind die aktuellen Umrechnungskurse der Europäischen Zentralbank http://www.ecb.europa.eu.

Basiswährung (mit Umrechnungskurs 1) ist EUR, das muss so in deinem Shop eingerichtet sein.

Es werden folgende Währungen unterstützt:

• Australischer Dollar
• Brasilianischer Real
• Britisches Pfund
• Bulgarische Lew
• Dänische Kronen
• Hongkong-Dollar
• Indische Rupien
• Indonesische Rupiah
• Japanische Yen
• Kanadischer Dollar
• Kroatische Kuna
• Malaysischer Ringgit
• Mexikanischer Peso
• Neuseeländischer Dollar
• Norwegische Kronen
• Philippinische Peso
• Polnische Zloty
• Renminbi (China)
• Rumänischer Leu
• Russischer Rubel
• Schekel (Israel)
• Schwedische Kronen
• Schweizer Franken
• Singapur Dollar
• Südafrikanischer Rand
• Südkoreanischer Won
• Thailändischer Bath
• Tschechische Kronen
• Türkische Lira
• Ungarische Forint
• US Dollar

Einrichtung und Verwendung

Voraussetzungen

Das Modul aktualisiert nur Währungen, die du bereits in deinem Shop konfiguriert hast. Wie du Währungen richtig konfigurierst, erklären wir gut verständlich weiter unten.

Ganz wichtig: Der Name der Währung (das ist der erste Wert in der jeweiligen Zeile) MUSS der internationalen Schreibweise nach ISO 4217 entsprechen (3-stellig, in Großbuchstaben). Weiter unten findest du eine Tabelle aller unterstützten Währungen mit dem jeweils korrekten Namen.

Sicherheitsschlüssel einrichten

Den „Sicherheitsschlüssel“ kannst du verwenden, um Cronjob-Aufrufe zu autorisieren. Unberechtigte Aufrufe des Cronjobs, die den Sicherheitsschlüssel nicht enthalten, werden dann ignoriert.

Der Sicherheitsschlüssel wird in den Moduleinstellungen von dir festgelegt.

Du darfst große und kleine Buchstaben (keine Umlaute), Zahlen sowie Unterstrich und Bindestrich verwenden.
Der Sicherheitsschlüssel ist optional, du musst ihn nicht verwenden.

! Wenn du den Sicherheitsschlüssel verwenden möchtest, gib bitte den Sicherheitsschlüssel im Cronjob-Aufruf immer korrekt mit an (siehe unten). Der Cronjob wird sonst nicht ausgeführt.

Cronjob einrichten

Der Cronjob wird wie folgt aufgerufen:

LINK_ZU_DEINEM_SHOP/?cl=dwa_currencyrate_cron

Läuft dein Shop also unter www.oxid-extensions.de, dann lautet der Aufruf des Cronjobs:
www.oxid-extensions.de/?cl=dwa_currencyrate_cron

Verwendest du einen Sicherheitsschlüssel (siehe oben), muss dieser als zusätzlicher Parameter an die URL angehangen werden, und zwar in dieser Form:

www.ihre-shop-domain.de/?cl=dwa_currencyrate_cron&key=IHR_VERWENDETER_KEY

Tipp: Teste den Cronjob-Pfad mit Sicherheitsschlüssel, indem du ihn einmal manuell aufrufst. Wenn du die Meldung „Success“ erhältst, ist alles in Ordnung.

Währungen ausschließen

Du kannst Währungen von der Aktualisierung ausschließen, wenn du diese z. B. ausschließlich manuell aktualisieren möchtest.

Gib dazu den Namen der Währung(en) in den Moduleinstellungen mit Komma getrennt und ohne Leerzeichen an, z. B

Mit dieser Einstellung deaktivierst du die Aktualisierung von CZK, CHF und RUB.

Status E-Mail

Nach der Aktualisierung kannst du dir optional eine E-Mail senden lassen, die dich darüber informiert, dass der Cronjob gelaufen ist und welche Währungen aktualisiert wurden (mit altem + neuem Kurs).

Die E-Mail wird an die im Shop eingestellte Info E-Mail gesendet.

Aktiviere den E-Mail Versand in den Moduleinstellungen.

Währungen richtig anlegen

Eine kleine Anleitung

Die in deinem OXID Shop verwendeten Währungen kannst du unter Stammdaten → Grundeinstellungen auf dem Tab „Einstell.“ pflegen.

Klicke unten auf „Weitere Einstellungen“. Dort findest du folgenden Bereich:

Das linke Feld ist nach der Installation von OXID eShop noch leer. Du pflegst dort die Währungen ein, und zwar jede Währung in einer neuen Zeile.

In dieser Zeile legst du die Einstellungen für die Währung fest. Gib wie in der Beschreibung rechts von OXID angegeben die Werte ohne Leerzeichen und durch ein @ getrennt an.

[name] – der Name der Währung nach ISO 4217 (siehe unten)

[rate] – die Umrechnungsrate – hier kannst du einfach 1 angeben, die korrekten Kurse berechnet das Modul ja dann für dich

[decimal separator] – Trennzeichen für Dezimalwerte (meist ,)

[thousand separator] – Trennzeichen für Tausenderwerte (meist . oder gar nichts)

[symbol] – das ist das Währungszeichen, das dann im Shop angezeigt wird

[decimal precision] – Anzahl Nachkommastellen (in der Regel 2)

DIN Namen für Währungen