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.