xt_elefunds - Spenden in xt:Commerce Shops
Das xt_elefunds Plugin: einkaufen, aufrunden und spenden in Online-Shops
Mit dem Plugin xt_elefunds können Sie Ihren Kunden die Möglichkeit geben, mit Ihren Bestellungen einen Betrag an einen wohltätigen Zweck zu spenden. Dieses geschieht automatisch über de Service von https://elefunds.de/
Installation
Installieren Sie das Plugin wie üblich, eine Lizenz ist für dieses Plugin nicht notwendig.
Konfiguration:
Nachdem Sie das Plugin installiert und aktiviert haben, tragen Sie in den Plugin-Optionen Ihre Kunden-Nummer in das Feld "Kunden ID" und Ihren Elefunds-API-Key in das Feld "API Key" ein.
In den Optionen müssen Sie die IDs der jeweiligen Bestellstatus eintragen:
- Bestellstatus "Abgeschlossen": Status für Bestellungen die erfolgreich bearbeitet wurden
- Bestellstatus "offen": Status für Bestellungen die sich in Bearbeitung befinden
- Bestellstatus "cancelled": Status für stornierte Bestellungen
Bei mehreren Status pro Feld können Sie die Liste der IDs mit Kommata trennen
Integration in das Templates:
1. Öffnen Sie die Datei: templates/xt_grid/xtCore/pages/checkout/subpage_confirmation.html
1.1. Fügen Sie dem HTML-Element welches den Preis umschließt die CSS-ID "grand-total-value" hinzu:
id="grand-total-value"
Beispiel (für das xt_grid):
Suchen Sie
{$total}
Die Zeile, die Sie finden werden sieht so aus:
<p class="total">{txt key=TEXT_TOTAL}<span class="float-right">{$total}</span></p>
Ändern Sie die Zeile in:
<p class="total">{txt key=TEXT_TOTAL}<span id="grand-total-value" class="float-right">{$total}</span></p>
Sollte in Ihrem Template kein HTML-Element um den Preis sein, fügen Sie einfach ein "Span" ein.
1.2 Suchen Sie nun folgenden Code in der Datei:
{form type=form name=process action='checkout' method=post conn=SSL}
Ersetzen Sie diesen Code mit folgendem Code:
{form type=form name=process action='checkout' method=post conn=SSL id='checkout-form'}
1.3 Suchen Sie nun folgenden Code in der Datei:
<th width="100" class="right">{txt key=TEXT_TOTAL_PRICE}</th> </tr> </thead> <tfoot>
Ersetzen Sie diesen Code mit folgendem Code:
{hook key=checkout_tpl_form_total_lines}
2.2: E-Mail-Template
2.3: PDF-Rechnung:
Damit der disclaimer von Elefunds automatisch auf der PDF-Rechnung (xt_orders_invoice) erscheint, müssen Sie mindestens die Version 1.3.7 verwenden, bzw. auf diese aktualisieren.
Prüfen der Integration:
Führen Sie nun einige Checkouts mit den verschiedenen Zahlungsarten durch und prüfen Sie, ob im Backend alles korrekt in der Bestellung gespeichert ist.