Jooglies Goodies für Joomla und VirtueMart

VirtueMart E-Mail Pro - Dokumentation

Overrides für die Bestätigungs-E-Mails mit Einstellmöglichkeiten

Voraussetzungen für die Installation und Konfiguration

  • FTP-Zugang und FTP-Programm
  • Zugang zum Joomla Erweiterungmanager als Super User oder Administrator.

Installation

Das ZIP-Archiv enthält sieben Dateien, die in den Override-Ordner invoice kopiert werden müssen.
/templates/Mein_Template/html/com_virtuemart/invoice/
(Mein_Template entspricht dem Namen Ihres Templates)

Im Download sind zwei Dateien erhalten, für Neuistallationen bitte die neuere Version 3.4.x installieren, die andere Datei 3.2.x. ist für bestehende angepasste Systeme zum Vergleich.

Bitte sichern sie zuerst alle vorhandenen Dateien in diesem Ordner, sofern er bereits vorhanden ist.

Enthaltene Dateien:
  • mail_html.php
  • mail_html_footer.php
  • mail_html_header.php
  • mail_html_pricelist.php
  • mail_html_shopper.php
  • mail_html_shopperaddresses.php
  • mail_html_vendor.php

Bei der FTP-Übertragung werden die Dateirechte normalerweise automatisch gesetzt. Je nach Provider und FTP-Programm kann das unterschiedlich sein. Bitte richten Sie sich nach den anderen Dateien der Installation, diese werden die Rechte 640, 644 oder 755 oder ähnliches haben.

Sprach-Overrides in Joomla anlegen

Für einige Sprachvariablen sollten Sprach-Overrides angelegt werden, um die Voreinstellung in VM E-Mail Pro an Ihre Bedürfnisse anzupassen.

Wie Sie Sprach-Overrides in Joomla anlegen.

  • COM_VIRTUEMART_UID="USt-IdNr. "
  • COM_VM_CUSTOMER_NR="Kundennummer"
  • COM_VM_CUSTOMER_NR_GUEST="Gastbestellung"
  • COM_VIRTUEMART_LEGAL="Rechtliche Hinweise"

Überschriften der Produkttabellen kürzen:

  • COM_VIRTUEMART_ORDER_PRINT_SKU="Art.-Nr."
  • COM_VIRTUEMART_PRODUCT_NAME_TITLE="Produktname"
  • COM_VIRTUEMART_ORDER_PRINT_PRODUCT_STATUS="Status"
  • COM_VIRTUEMART_ORDER_PRINT_PRICE="Preis"
  • COM_VIRTUEMART_ORDER_PRINT_QTY="Anzahl"
  • COM_VIRTUEMART_ORDER_PRINT_PRODUCT_TAX="MwSt."
  • COM_VIRTUEMART_ORDER_PRINT_SUBTOTAL_DISCOUNT_AMOUNT="Rabatt"
  • COM_VIRTUEMART_ORDER_PRINT_TOTAL="Summe"

Sprach-Overrides für Bestellstatus-Nachrichten

Endlich können Sie je nach Bestellstatus eine eigene Nachricht in der E-Mail senden.

Es werden Sprachvariablen generiert, die nach dem Schema "Bestellstatusvariable" + "_MSG" zusammengesetzt werden.
Einige Beispiele:

  • COM_VIRTUEMART_ORDER_STATUS_PENDING_MSG="Sie haben den Kaufvorgang vorzeitig im Warenkorb abgebrochen."
  • COM_VIRTUEMART_ORDER_STATUS_CONFIRMED_BY_SHOPPER_MSG="Ihre Bestellung ist bei uns eingegangen."
  • COM_VIRTUEMART_ORDER_STATUS_CONFIRMED_MSG="Ihre Bestellung ist bestätigt."
  • COM_VIRTUEMART_ORDER_STATUS_CANCELLED_MSG="Ihre Bestellung wurde abgebrochen."
  • COM_VIRTUEMART_ORDER_STATUS_REFUNDED_MSG="der Betrag wurde erstattet."
  • COM_VIRTUEMART_ORDER_STATUS_SHIPPED_MSG="Ihre Ware wurde versendet."
  • COM_VIRTUEMART_ORDER_STATUS_COMPLETED_MSG="der Auftrag ist hiermit abgeschlossen."
  • COM_VIRTUEMART_ORDER_STATUS_DENIED_MSG="die Bezahlung wurde vom Zahlungsprovider abgelehnt."

Je nach Bestellstatus können Sie hier auch Bankdaten explizit angeben, oder andere wichtige Informationen eingeben.

VirtueMart erlaubt die Erstellung eigener Bestellstatusse, zum Beispiel könnten Sie einen Status "verzögerte Lieferung" anlegen, und dann eine entsprechende Standardnachricht über die Statusänderung senden. Dies kann zu enormer Zeitersparnis führen, wenn oft bestimmte Vorgänge anfallen, die sonst per Hand geschrieben werden. Beratungen zur Verbesserung des Arbeitsablaufs übernehmen wir im Rahmen unserer kostenpflichtigen Supportstunden.

Konfiguration

Es gibt zwei Möglichkeiten, die Layouts zu konfigurieren. Über die Variablen im PHP-Quelltext der Overrides oder durch das Plugin "Jooglies VirtueMart Override Controller) . Das Admin-Template wird nicht weiter entwickelt, allerdings noch einige Zeit gepflegt.
Wenn Sie keine Änderungen in den Layouts vorgenommen haben, empfehlen wir den Wechsel auf die Plugin-Version.

Da die E-Mail-Layouts meistens nur einmal konfiguriert werden, und die Einstellungen dann nicht mehr geändert werden, ist es möglich, die Einstellungen für Live-Shops nur in den Layouts vorzunehmen und das Plugin nicht zu verwenden.

Plugin "Jooglies VirtueMart Overrides Controller" öffnen

  • Öffnen Sie den Plugin-Manager im Joomla-Menü -> Erweiterungen -> Plugins.
  • Geben Sie in der Suche "Jooglies" an.
  • Klicken Sie zum Öffnen des Plugins auf "System - Jooglies VirtueMart Overrides Plugin".

E-Mail-Einstellungen im dritten Reiter des Plugins

Die ersten drei Einstellungen bestimmen, welche Spalten in der Rechnung angezeigt werden.
Wählen Sie Nein, wenn Sie die Spalten Artikelnummer, Status oder Preisnachlass ausblenden möchten.

Die Einstellung zum Ausblenden der Mehrwertsteuer befindet sich nach wie vor im Reiter Kasseneinstellungen der originalen VirtueMart-Konfiguration.

  • Verwende Google Web Font: Open Sans - Verwendet Open Sans von Google als Schriftart. Wird nicht durch alle E-Mail-Programme unterstützt. Datenschutz-Grundverordnung beachten! Empfohlen: Aus.
  • Zeige unterschiedliche Nachrichten nach Status - Wenn Sie unterschiedliche Statusnachrichten anzeigen möchten, für die sie wie oben beschrieben, Sprach-Overrdes angelegt haben.
  • Zeige Kundennummer - Zeigt die Kundennummer
  • Zeige Link zur Bestellung - Ein Link zur Bestellübersicht im Live-Shop wird angeboten.
  • Zeige rechtliche Informationen - Zeigt die rechtlichen Informationen, die für den VirtueMart-Verkäufer angelegt wurden. (Zu finden unter VM-Menü - Shop - Shop - Reiter Verkäufer.)
  • Zeige Footer in E-Mail - Zeigt den VirtueMart-Footer in der E-Mail (Standard-Einstellung VM: Ein).

Kopf für VirtueMart-E-Mails konfigurieren

Der Kopf der VirtueMart-E-Mail und der Kopf der PDF-Rechnung sind identisch. Sie werden weiterhin über die VirtueMart-eigenen Einstellungen für den Shop-Verkäufer konfiguriert.

Öffnen Sie die Verkäufer-Einstellungen über VirtueMart-Menü -> Shop -> Shop oder über Joomla-Menü -> VirtueMart -> Shop.

Wenn Sie ein Logo in den Header einfügen möchten und noch kein Bild für den Verkäufer hochgeladen haben, können Sie dies nun im ersten Reiter nachholen. JPG ist bevorzugt, PNG wird nicht unterstützt. Im Abschnitt "Datei hochladen" wählen Sie die Option "hochladen", anschließend eine Bilddatei auf der Festplatte aus. Speichern Sie mit dem Speichern-Button oben. Evtl. müssen Sie im Reiter (Ver)Käufer Informationen noch einige Angaben ausfüllen, bevor Sie speichern können.

Weiter zum Reiter Rechnungen/E-Mails.
Im Abschnitt Briefkopf verwenden Sie die folgenden Einstellungen, um ein Logo links und z. Bsp. Ihre Adresse rechts anzugeben.

  • Briefkopf anzeigen: Ja (Haken setzen)
  • Linie unter dem Briefkopf: Ja (empfohlen)
  • Verkäuferabbildung einblenden: Ja
  • Briefkopf-Zelle Höhenverhältnis: 1 (Voreinstellung)
  • Linienfarbe: #000000 (schwarz, Voreinstellung)
  • Größe der Verkäuferabbildung: 60mm (für ca. die Hälfte der Rechnungsbreite, (20 cm Blattbreite minus Rand) geteilt durch 2)

Beispiel-Code für Briefkopf/Header

Beispiel mit automatisch generierten Daten aus der Verkäuferadresse:

<table>
  <tr>
    <td style="width:30%;"> </td>
    <td style="width:70%;">
      <h1>{vm:vendorname}</h1>
      <p> </p>
      <p>{vm:vendoraddress}</p>
    </td>
  </tr>
</table>

Beispiel mit frei wählbarem Text:

<table>
  <tr>
    <td style="width:30%;"> </td>
    <td style="width:70%;text-align: right;">
      <h1 style="text-align: right;">Blumengeschäft Freudlinger</h1>
      <p>Im Rosengarten 12<br />
        12345 Rosendorf<br />
        Telefon: 01234 567890</p>
    </td>
  </tr>
</table>

Die erste Tabellenzelle TD mit der Breite 30% fügt Abstand zum Logo ein. Die zweite Tabellenzelle mit der Breite 70% enthält den anzuzeigenden Text. Diese Werte müssen je nach Art und Größe des Logos angepasst werden. Achten Sie darauf, dass es zusammen 100% werden.

Beispiel-Code für Brieffuß/Footer

<table style="width: 100%;">
<tbody>
  <tr><td colspan="4"> </td></tr>
  <tr>
    <td style="width: 25%;vertical-align: top">
      <p>Geschäftsführer/Inhaber<br />
        Vorname, Name</p>
    </td>
    <td style="width: 25%;;vertical-align: top">
      <p>Name der Bank<br />
        IBAN DE00 0000 0000 0000 0000 00<br />
        BIC XXXXXXXXXXX</p>
    </td>
    <td style="width: 25%;;vertical-align: top">
      <p>Geben Sie bei einer Überweisung immer die Rechnungsnummer
        und Bestellnummer als Verwendungszweck ein.</p>
    </td>
    <td style="width: 25%;;vertical-align: top">
      <p>Amtsgericht -Stadt-, HRB 000000<br />
        UST-IdNr. DE000000000<br />
        Steuer-Nr. 000/0000/0000</p>
    </td>
  </tr>
  <tr><td colspan="4"> </td></tr>
  <tr>
    <td colspan="4">Seite {vm:pagenum} von {vm:pagecount}</td>
  </tr>
</tbody>
</table>

Beispiel-Code für Brieffuß/Footer mit einer Zeile in voller Breite

<table style="width: 100%;">
<tbody>
  <tr><td> </td></tr>
  <tr>
    <td style="width: 100%;vertical-align: top">
      Unternehmen - Herr Mustermann - Musterstraße - 12345 Musterstadt - Land
    </td>
  </tr>
  <tr><td> </td></tr>
  <tr>
    <td>Seite {vm:pagenum} von {vm:pagecount}</td>
  </tr>
</tbody>
</table>

TCPDF ist ein PDF-Generator, der im Hintergrund die Formatierung der PDF-Datei übernimmt. TCPDF beherrscht nicht alle CSS-Regeln, und akzeptiert auch keine externen CSS-Dateien. Das eigenwillige Verhalten von TCPDF ist der Grund, warum das HTML nicht immer dem Auge des Perfektionisten wohltut.

Feintuning per Handarbeit für Coder

Sollten Sie mit der Breite der Spalten in der E-Mail nicht zufrieden sein, bedarf es ein wenig Handarbeit in der mail_html_pricelist.php.

  • Öffnen Sie die Datei in einem Code-Editor wie Notepad++ oder Sublime Text.
  • Im oberen Bereich sind Prozentzahlen für die Tabellenspalten angegeben. Es wird unterschieden zwischen 4 bis 8 Spalten.
  • Ändern Sie die Prozentzahlen für die Anzahl der Spalten, die bei Ihnen zur Verfügung stehen (z. Bsp. 6 Spalten, wenn Sie Status und Preisnachlass ausgeblendet haben).
  • Für die ausgeblendeten Spalten tragen Sie 0% ein, für die anderen sollte die Summe der Prozentzahlen 100% ergeben, wenn die Tabelle über die ganze Seite gehen soll.
  • Speichern Sie die Datei nach der Anpassung und achten Sie darauf, dass die Datei als UTF-8 ohne BOM gespeichert wird.

Mit der vorhandenen Anleitung sollten Sie in der Lage sein, eine sauber aufgebaute E-Mail zu bekommen. Diese E-Mail ist ein Zusammenschnitt aus jahrelangen Anpassungen von E-Mails für Einzelkunden, die oft ein Vielfaches für die Erstellung einer Rechnung/E-Mail ausgegeben haben, die ihrem Corporate Design entspricht. Dieses Grundlayout kann nicht bis auf die kleinste Einzelheit auf jedes Design angepasst werden, jedoch denken wir, einen guten Kompromiss zwischen Preis und Erscheinungsbild gefunden zu haben, so dass Shop-Betreiber mit mittlerem Budget ihren Kunden eine ansehnliche E-Mail bieten können.

Individuelle Anpassung auf Wunsch

Sollten Sie weitergehende Anpassungen wünschen, lassen wir Sie nicht im Regen stehen. Nehmen Sie einfach Kontakt zu uns auf. Wir machen Ihnen gerne einen Kostenvoranschlag.

Jooglies.com is not affiliated with or endorsed by the Joomla! Project. It is not supported or warranted by the Joomla! Project or Open Source Matters.

VirtueMart ist eine geschützte Marke der iStraxx UG (haftungsbeschränkt).