tfm_dropshipper

Versender / Dropshipper-Verwaltung für xt:Commerce

Das Plugin "tfm_dropshipper" verwaltet Versender (Lieferanten/Dropshipper) im xtAdmin und ordnet diese per Dropdown einzelnen Produkten zu. Sobald eine Bestellung mit mindestens einem zugeordneten Produkt einen konfigurierten Bestellstatus erreicht (z.B. "Zahlung erhalten"), wird automatisch eine eigene Fulfillment-Mail an den betroffenen Versender versendet – mit Lieferadresse des Kunden und nur den Artikeln, die diesen Versender betreffen.

Enthält eine Bestellung Produkte mehrerer Versender, erhält jeder Versender eine eigene, separate Mail mit ausschließlich seinen eigenen Positionen.

Screenshots

Installation & Konfiguration

Führen Sie die generelle Installationsanleitung für 4tfm-Plugins aus.

Nachdem das Plugin installiert und aktiviert ist, laden Sie den Administrationsbereich mit der F5-Taste neu.

Bei einer bereits installierten Version: Plugin-Ordner überschreiben und in der Plugin-Verwaltung auf "Update" klicken (nicht deinstallieren/neu installieren, dabei würden eigene Versender-Daten verloren gehen). Das Update übernimmt Sprachtexte, Hooks, Konfigurationsoptionen und den aktuellen Mail-Inhalt automatisch.

Plugin-Optionen:

Option	Beschreibung	Standardwert
Für Mandant aktivieren	Aktiviert den automatischen Fulfillment-Mail-Versand für den jeweiligen Mandanten	true
Bestellstatus für Fulfillment-Mail	Kommagetrennte Liste von Bestellstatus-IDs, bei deren Erreichen die Fulfillment-Mail ausgelöst wird, z.B. `23` für "Zahlung erhalten" (die genaue ID kann je Shop abweichen, nachzuschlagen unter xtAdmin > Einstellungen > Systemstatus). Ist das Feld leer, wird nie versendet.	leer

Versender anlegen

Unter xtAdmin > Katalog > Versender können beliebig viele Versender angelegt werden:

Feld	Beschreibung
Status	Aktiv/Inaktiv – nur aktive Versender stehen bei der Produktzuordnung zur Auswahl
Firmenname	Firmenname des Versenders (Pflichtfeld)
Ansprechpartner	Name des Ansprechpartners, wird in der Mail-Anrede verwendet
Anrede	Herr / Frau / Firma / neutral / keine Angabe
E-Mail-Adresse	Empfänger-Adresse der Fulfillment-Mail (Pflichtfeld)
Kontakt-Telefonnummer	Telefonnummer des Versenders (Referenz, wird nicht automatisch verschickt)
E-Mail und Telefonnummer an Kunden senden	Wenn aktiviert, enthält die Fulfillment-Mail zusätzlich die E-Mail-Adresse und Liefer-Telefonnummer des Kunden, damit der Versender ihn bei Bedarf direkt kontaktieren kann
E-Mail-Template	Optional: eigenes, im E-Mail-Manager angelegtes Template für diesen Versender auswählen. Bleibt das Feld leer, wird das Standard-Template "tfm_dropshipper" verwendet

Eigenes Mail-Template für einen Versender erstellen

Standardmäßig verwenden alle Versender das Template "tfm_dropshipper". Möchten Sie für einen einzelnen Versender einen abweichenden Text verwenden (z.B. zusätzlicher Hinweis, andere Anrede), legen Sie dafür eine eigene Kopie an:

Unter xtAdmin > Inhalte > E-Mail Manager das Template "tfm_dropshipper" suchen und markieren.
Über die Schaltfläche "Kopieren" eine Kopie des Templates erstellen.
Die Kopie öffnen und im Feld "Vorlagen-Typ" (tpl_type) einen eigenen, eindeutigen Namen eintragen, der mit tfm_dropshipper beginnt, z.B.
```
tfm_dropshipper_expressversand
```
Wichtig: Nur Templates mit diesem Präfix stehen später im Versender-Formular zur Auswahl.
Betreff sowie HTML- und Text-Inhalt je Sprache nach Bedarf anpassen. Die verfügbaren Platzhalter (Lieferadresse, Artikel, ggf. Kontaktdaten des Kunden) entsprechen dem Standard-Template.
Speichern.

Anschließend beim betreffenden Versender im Feld "E-Mail-Template" die neu angelegte Vorlage auswählen und den Versender speichern. Bleibt das Feld leer, wird weiterhin das Standard-Template "tfm_dropshipper" verwendet.

Hinweis: Wird stattdessen direkt das Standard-Template "tfm_dropshipper" bearbeitet, wirkt sich die Änderung auf alle Versender ohne eigene Vorlage aus.

Produkt-Zuordnung

Im Produkt-Bearbeiten-Formular steht ein eigenes Panel "Versender" mit einem Dropdown-Feld zur Verfügung, über das jedem Produkt genau ein Versender zugeordnet werden kann. Produkte ohne Zuordnung lösen keine Fulfillment-Mail aus.

Funktionsweise

Erreicht eine Bestellung einen der unter "Bestellstatus für Fulfillment-Mail" konfigurierten Status (z.B. Statuswechsel auf "Zahlung erhalten"), prüft das Plugin alle bestellten Produkte auf eine Versender-Zuordnung und gruppiert sie entsprechend. Für jeden betroffenen Versender wird – im Stil der Bestellbestätigung ("send_order") – eine eigene Mail versendet:

nur die Lieferadresse des Kunden (keine Rechnungsadresse)
E-Mail-Adresse und Liefer-Telefonnummer des Kunden nur, wenn beim Versender aktiviert
nur die Artikel der Bestellung, die diesem Versender zugeordnet sind

Jede Fulfillment-Mail wird pro Bestellung und Versender nur einmal versendet – auch dann, wenn die Bestellung später erneut auf einen der konfigurierten Status gesetzt wird.

Ist unter "Bestellstatus für Fulfillment-Mail" kein Status eingetragen, wird nie eine Fulfillment-Mail versendet.

Pflegt ein anderes Plugin zusätzliche Artikel-Informationen (z.B. Produktoptionen) über das Feld products_information in die Bestellung ein, wird dieser Zusatztext automatisch unter dem jeweiligen Artikel mit ausgegeben.

Hookpoint für andere Plugins

Möchten Sie ein weiteres Plugin bauen, das z.B. noch einen Lieferschein oder ein Label als PDF an die Fulfillment-Mail anhängt, steht folgender Hookpoint zur Verfügung:

class.tfm_dropshipper.php:sendMail_bottom

Er läuft direkt vor dem Versand jeder einzelnen Fulfillment-Mail (Empfänger und Template-Variablen sind bereits gesetzt). Im Hook-Scope stehen unter anderem $tfm_ds_mail (die xtMailer-Instanz, z.B. für _addAttachment()), $tfm_ds_data (Datensatz des Versenders) und $tfm_ds_products (die Artikel dieses Versenders) zur Verfügung. Details und ein Beispiel finden Sie in der README des Plugins.