BX Mailtext

Stand: 05.03.2026

Überblick

BX Mailtext ist ein Admin-Modul für modified eCommerce zur zentralen Verwaltung von E-Mail-Templates.

Es bearbeitet Plain-Text- und HTML-Vorlagen dateibasiert im aktiven Template und nutzt eigene DB-Tabellen für Template-Metadaten, Platzhalter und Whitelist-Eintraege.

Kernkomponenten:

• Admin-Controller mit Action-Routing (admin/bx_mailtext.php)
• Service-/Helper-Funktionen (admin/includes/extra/functions/bx_mailtext.php)
• Systemmodul fuer Install/Update/Remove (admin/includes/modules/system/bx_mailtext.php)

Aktueller Funktionsumfang

• Template-Editor für Frontend/Backend-Mails (TXT + HTML)
• Sprachumschaltung für die Bearbeitung
• Testmail-Versand (TXT/HTML)
• Platzhalter-Panel mit Drag-and-Drop in Textarea/CKEditor
• Backup-Management (anlegen, wiederherstellen, loeschen)
• Audit (DB gegen Dateisystem) inkl. CSV-Export
• Aktion zum Erstellen fehlender DB-Eintraege aus vorhandenen Templates
• Aktion zum Nachziehen fehlender Platzhalter aus Template-Dateien
• Demodata-Verwaltung pro Template
• AJAX-Modal für Demodata (Create/Edit/Delete)
• Auto-Generierung fehlender Demodata bei DB-Neueintrag

Installation und Konfiguration

Systemmodul-Datei:

• admin/includes/modules/system/bx_mailtext.php

Beim Installieren werden automatisch:

1. Admin-Berechtigung admin_access.bx_mailtext angelegt/gesetzt
2. Konfigurationsgruppe erzeugt
3. Konfigurations-Keys angelegt
4. Tabellen erstellt
5. Standard-Mailtypen, Platzhalter und Whitelist-Datensaetze geseedet

Relevante Konfigurations-Keys:

• MODULE_BX_MAILTEXT_STATUS
• MODULE_BX_MAILTEXT_VERSION
• MODULE_BX_MAILTEXT_CONFIG_ID

Modulversion laut Code: 2.0.0

Datenbanktabellen

Tabellenkonstanten in includes/extra/database_tables/bx_mailtext.php:

• TABLE_BX_MAILTEXT_MAILS => mailtext_mails
• TABLE_BX_MAILTEXT_PLACEHOLDERS => mailtext_placeholders
• TABLE_BX_MAILTEXT_WHITELIST => mailtext_whitelist

Tabellenzweck:

• mailtext_mails: Mailtypen inkl. mailid, systemposition und Anzeigename
• mailtext_placeholders: Platzhalter je Template (FK auf mailtext_mails)
• mailtext_whitelist: Script-/Pfad-Whitelist für Mail-Zuordnungen

Dateistruktur

Routing, Bootstrap und Integrationen

• admin/includes/extra/filenames/bx_mailtext.php
• admin/includes/extra/menu/bx_mailtext.php
• includes/extra/database_tables/bx_mailtext.php
• includes/extra/wysiwyg/bx_mailtext.php

Modul-Logik und UI

• admin/bx_mailtext.php
• admin/includes/extra/functions/bx_mailtext.php
• admin/includes/extra/javascript/bx_mailtext.php
• admin/includes/extra/css/bx_mailtext.php
• admin/includes/modules/bx_mailtext/list.php
• admin/includes/modules/bx_mailtext/editor.php
• admin/includes/modules/bx_mailtext/backups.php
• admin/includes/modules/bx_mailtext/audit.php
• admin/includes/modules/bx_mailtext/demodata/
• admin/includes/modules/bx_mailtext/backups/

Sprachdateien

• lang/german/modules/system/bx_mailtext.php
• lang/german/extra/admin/bx_mailtext.php
• lang/english/modules/system/bx_mailtext.php
• lang/english/extra/admin/bx_mailtext.php

Admin-Assets

• admin/images/icons/heading/bx_mailtext.png
• admin/images/supermailer/mailtext.jpg

Relevante Controller-Actions

Wichtige Actions in admin/bx_mailtext.php:

• mv_mailtext_audit
• mv_mailtext_audit_export_csv
• mv_mailtext_create_db_entry
• mv_mailtext_sync_placeholders
• mv_mailtext_backup_list
• mv_mailtext_build_backup
• mv_mailtext_restore_backup
• mv_mailtext_delete_backup
• mv_change_language
• mv_demodata_modal (HTML-Response)
• mv_demodata_save (JSON-Response)
• mv_demodata_delete (JSON-Response)
• send_test_mail
• mv_update

Template-Pfade

Dateiablage je Sprache und Position:

• Frontend: templates//mail//
• Backend: templates//admin/mail//

Dateipaare pro Mail-ID:

• .txt
• .html

Hinweis: Fehlende Dateien werden beim Laden bei Bedarf erstellt (inkl. Verzeichnisanlage).

Audit und Konsistenzprüfung

Das Audit wertet aus:

1. DB-Eintraege mit fehlenden Template-Dateien
2. Dateien ohne DB-Eintrag (Orphans)
3. Vollstaendige Templates ohne passende Placeholder-Eintraege

Zusatzfunktionen:

• Kennzahlen-Zusammenfassung
• CSV-Export (mailtemplate_audit_YYYYMMDD_HHMMSS.csv)
• DB-Eintrag aus Dateifund erzeugen
• Placeholder aus Dateien in DB synchronisieren

Platzhalter und Demodata

Erkannte Placeholder-Formate:

• Smarty: {$variable} und {$object.property}
• Token: [SIGNATUR]

Demodata-Dateien:

• Speicherort: admin/includes/modules/bx_mailtext/demodata/
• Namenskonvention: mv_demodata__.php

Verhalten:

• Bei neuen DB-Eintraegen kann automatisch eine Demodata-Datei erzeugt werden
• Demodata kann im Admin per Modal bearbeitet/gespeichert/geloescht werden
• Testmail-Rendering nutzt Demodata-Dateien zur Placeholder-Befuellung

Hinweise fuer Betrieb und Wartung

• Modul arbeitet legacy-kompatibel mit xtc_db_* und direktem SQL.
• Schreibrechte sind erforderlich.
• Betroffene Pfade: templates//...
• Betroffene Pfade: admin/includes/modules/bx_mailtext/backups/
• Betroffene Pfade: admin/includes/modules/bx_mailtext/demodata/
• Die Modul-CSS bindet Font Awesome per CDN ein (cdnjs.cloudflare.com).
• Nach neuen Mailtemplates empfiehlt sich ein Auditlauf fuer DB/Datei/Placeholder-Konsistenz.

Kurzfazit

BX Mailtext 2.0.0 bietet einen vollstaendigen Admin-Workflow fuer E-Mail-Templates in modified: Bearbeitung, Testversand, Platzhalterpflege, Backups, Audit und Demodata-Management in einem Modul.