easydb Shop

Der easydb-Shop ist eine Erweiterung der easydb, die es erlaubt Bilder innerhalb eines Shopsystems anzubieten und zu verkaufen.

Konfigurationsvariablen für den Shop

EASYSHOP_DEFAULT_ITEM_SEARCH_ATTRIBUTES=cat_paths,title_de,description_de,unique_identifier
EASYSHOP_DEFAULT_CATEGORY_SEARCH_ATTRIBUTES=full_cat_path,description_de
EASYSHOP_DEFAULT_ITEM_ORDER=title_de ASC
EASYSHOP_AUTOCOMPLETE_MAX_ENTRIES=16
EASYSHOP_DOWNLOAD_FILENAME_ITEM_COLUMN=unique_identifier
EASYSHOP_DISABLE_FREEBIES=1
EASYSHOP_DOWNLOAD_LARGE=3543
EASYSHOP_DOWNLOAD_MEDIUM=2500
EASYSHOP_DOWNLOAD_SMALL=360
EASYSHOP_TOOLTIP_IMAGE_SIZE=200
EASYSHOP_TOOLTIP_IMAGE_SIZE=200
# Dateinamen-Prefix für das Rechnungs-PDF
EASYSHOP_INVOICE_FILENAME_PREFIX=Rechnung-No

Payment-Modul

Das Payment-Modul der easydb ermöglicht eine Anbindung an verschiedene Bezahlsysteme und wird z.B. vom easydb-Shop verwendet. Das Payment-Modul bietet folgende Konfigurationsvariablen:

PAYMENT_PROVIDER

Der Provider gibt an, welchen Bezahlsystem-Anbieter Sie verwenden möchten, um Zahlungen durchzuführen. Derzeit gibt es nur "telecash" (siehe Abschnitt 1.1), auf Wunsch können aber weitere Bezahlsysteme über eine Plugin-API angebunden werden.

PAYMENT_TYPES

Diese Variable steuert die angebotenen Arten der Zahlung wie z.B. Überweisung oder Kreditkartenzahlung. Gültige Werte sind (getrennt durch Komma, jeweils ohne Anführungszeichen):

  • "direct_debit" für Lastschrift
  • "credit_card" für Kreditkartenzahlung
  • "invoice" für Rechnungszahlung (muss optional für individuelle Kunden freigeschaltet werden, standardmäßig nicht erlaubt)
  • "prepayment" für Vorauskasse

PAYMENT_TYPE_DEFAULT

Gibt an, welche Zahlungsart im Zahlungsformular vorausgewählt sein soll. Erwartet einen einzelnen Zahlungstyp (z.B. "credit_card"), der auch unter PAYMENT_TYPES aufgelistet sein muss.

PAYMENT_CREDIT_CARD_ALLOWED_VENDORS

Eine Liste mit Kürzeln unterstützter Kreditkartenanbieter. Gültige Werte sind (getrennt durch Komma, jeweils ohne Anführungszeichen):

  • "visa" für VISA
  • "amex" für American Express
  • "mastercard" für MasterCard

Sie müssen mit den angebotenen Kreditkartenabietern sogenannte Akzeptanzverträge abschließen, um Zahlungen abwickeln zu können. Mehr Informationen dazu erhalten Sie von Ihrem Bezahlsystemanbieter.

PAYMENT_FAKE_AMOUNT

Einige Provider verwenden bestimmte Bestellwerte, um Test-Rückgaben für Transaktionen zu beeinflussen. Wenn diese Variable gesetzt ist, erlaubt easydb die Eingabe eines manipulierten Rechnungsbetrages.

Verwenden Sie diese Variable keinesfalls in einem Produktiv-System, da der Kunde damit die Höhe seines Abbuchungsbetrages beeinflussen kann!

Provider "telecash"

Das "telecash"-Provider-Plugin bietet eine Anbindung an das Bezahlsystem Telecash. Es verwendet eine Server2Server-API, über die komplette Zahlungen abgewickelt werden können, ohne dass eine externes Formular verwendet wird. Damit erhält die Anwendung volle Kontrolle über das Aussehen der Eingabeformulare.

TELECASH_IPG_URL

Geben Sie hier die URL des Telecash-Zahlungsservers an (die genaue URL erhalten Sie von Telecash).

TELECASH_IPG_STOREID

Geben Sie hier die ID Ihres Telecash-Kontos an, dies sollte eine längere (11-stellige) Zahl sein.

TELECASH_IPG_USERID

Dies ist die Nummer des zu verwendenden Nutzer-Kontos (Telecash erlaubt das Anlegen mehrerer Nutzer, die die gleiche Store ID verwenden – also praktisch verschiedene "Verkäufer"). Üblicherweise sollte das die "1" für den ersten Nutzer sein (ohne Anführungszeichen).

TELECASH_IPG_PASSWORD

Dies ist das Passwort für Ihr Telecash-Konto, welches Sie zusammen mit der StoreID erhalten haben sollten.

TELECASH_IPG_CAINFO

Das globale Serverzertifikat (z.B. "geotrust.pem") – lassen Sie dies zunächst leer, da das bereits auf Ihrem Server installierte Zertifikat bevorzugt werden sollte. Nur bei Verbindungsproblemen sollten Sie dieses Zertifikat verwenden.

TELECASH_IPG_SSLCERT

Geben Sie hier den Pfad zu Ihrem persönlichen Zertifikat an, welches Sie als tar-Archiv von Telecash erhalten haben sollten. Das tar-Archiv sollte in der Form "IPG_Certificate_WS<store_id>._.<user_id>.tar" benannt sein und drei Dateien enthalten (<store_id> und <user_id> müssen dabei jeweils durch die entspr. Werte ersetzt werden):

  • "WS<store_id>._.<user_id>.key",
  • "WS<store_id>._.<user_id>.p12",
  • "WS<store_id>._.<user_id>.pem".

Die .pem-Datei ist das SSL-Zertifikat, deren absoluten Pfad (inkl. Dateinamen) im Dateisystem Sie für diese Konfigurationsvariable angeben müssen.

TELECASH_IPG_SSLKEY

Geben Sie hier den absoluten Pfad (inkl. Dateinamen) zur .key-Datei an, die Sie im tar-Archiv vorfinden sollten (wie unter TELECASH_IPG_SSLCERT beschrieben).

TELECASH_IPG_SSLKEY_PASSWORD

Geben Sie hier das Passwort zum Entschlüsseln des SSL-Zertifikats an, das Sie zusammen mit dem tar-Archiv erhalten haben sollten (nicht zu verwechseln mit dem Store-Passwort, welches Sie bereits verwendet haben).

TELECASH_HAS_DATA_STORAGE

Falls Sie die DataStorage-Erweiterung beauftragt haben, geben Sie hier eine 1 an, um dem Payment-Modul mitzuteilen, dass Kundendaten auf Serverseite gespeichert werden können. Ohne DataStorage-Erweiterung können Sie auf diese Angabe verzichten.

Für TELECASH_IPG_SSLKEY, TELECASH_IPG_SSLCERT, TELECASH_IPG_CAINFO können Sie auch relative Pfad-Angaben verwenden. easydb stellt dann EASYDB_ROOT als Prefix vor den Pfad.