Dokumentation & System-Enzyklopädie

MarbleSend arbeitet mit einem einzigen Master-Hintergrundprozess: worker.php. Das Dashboard prüft cm_settings['worker_last_run'], um festzustellen, ob der Cronjob alle 60 Sekunden ausgeführt wird.

Die Wachstums-Visualisierung stellt die Volumenverteilung über vier wählbare Zeiträume dar: 7 Tage, 30 Tage, 90 Tage und Seit Jahresbeginn (YTD). Jeder Balken repräsentiert einen aggregierten Zeitabschnitt und zeigt beim Daraufzeigen die Anzahl der gesendeten und geöffneten E-Mails an.

Der Feed in der rechten Spalte zeigt kürzliche Campaign-Aussendungen in Echtzeit mit animierten Status-Badges (Completed, Sending pulsierend, Failed, Draft), Zustellquoten und einer dauerhaften System-Heartbeat-Statuskarte an.

Die untere Prüftabelle listet kürzliche Broadcast-Ausführungen mit vollständigen Metadaten auf: Campaign-Name, Lebenszyklus-Status, Herkunfts-Tag (manual, wiederkehrender Zeitplan, RSS-Feed oder erneuter Versand an Nicht-Öffner), Empfänger-Zustellverhältnis und verifizierte Öffnungsrate.

Wenn Ihrer Absenderdomain verifizierte SPF-, DKIM- oder DMARC-records fehlen, hebt MarbleSend ein Hinweisfeld direkt über den KPI-Metriken hervor. Ein Klick auf Domain-DNS verifizieren öffnet den 4-stufigen Diagnoseassistenten unter /settings?tab=deliverability und verhindert, dass Nutzer die Domain-Reputation mit unauthentifizierten Postfächern beschädigen.

Direkte Aktionsauslöser, die das Dashboard mit schnellen Arbeitsabläufen verbinden: automatisierte wiederkehrende Newsletter-Zeitpläne, RSS-zu-E-Mail-Verarbeitungspipelines, Abonnentenlisten-Erfassung, Double-Opt-in-Verifizierung und Unterdrückungsschutz.

Immer wenn ein Broadcast aktiv versendet wird, gleitet oben auf /campaigns ein fixiertes Monitor-Banner ins Blickfeld. Es fragt /api/campaigns/:id/progress alle 1,5 Sekunden ab, ohne die gesamte Seite neu zu laden.

Die linke Spalte ermöglicht ein punktgenaues Abonnenten-Targeting. Admins können nach benutzerdefinierten Kontakt-Tags filtern, nach Teil-E-Mail/Namen suchen und einzelne Kontakte auswählen oder auf Alle Passenden Auswählen klicken.

Um katastrophale Fehler zu vermeiden (z. B. das Versenden von E-Mails mit fehlerhaften Platzhaltern, fehlenden Abmeldelinks oder Spam-Triggern), erfordert MarbleSend vor dem Start einen Preflight-Check.

Bevor Tausende von E-Mails in die Warteschlange eingereiht werden, versendet die Schaltfläche Test-E-Mail senden sofort eine einzelne Testnachricht direkt an das Postfach des Administrators oder der Qualitätssicherung, ohne die Empfängerliste in der Datenbank zu berühren. Alle Platzhalter-Tags ({{first_name}}, {{email}}, {{unsubscribe_link}}) werden mit Vorschauwerten gefüllt, sodass Sie die E-Mail-Darstellung in Gmail, Apple Mail und Outlook prüfen können.

Alle ausgehenden Link-Tags (<a href="...">) werden durch App\Services\TrackingInjector verarbeitet. UTM-Parameter (utm_source, utm_medium, utm_campaign, utm_content) werden automatisch angehängt, bevor URLs für das Klick-Tracking verpackt werden. Mailto-Links, Tel-Links und Abmeldelinks bleiben unberührt.

Das vollständige Verlaufsportfolio bietet Multi-Attribut-Filterung nach Herkunft (manual, recurring, rss, resend_unopened), Status (completed, sending, failed, draft) und Datumsbereich. Admins können mehrere Campaigns auswählen, um aggregierte CSV-Zustellprotokolle herunterzuladen.

Unter /campaigns/:id/report präsentiert MarbleSend einen umfassenden Bericht nach der Campaign:

Zentraler Speicher für alle Marketing-, Transaktions- und Autoresponder-Templates. Mit clientseitiger Sofortsuche, unveränderlichen URL-Slugs und Live-Entwurfsanzeige.

Klassische Desktop-E-Mail-Programme (insbesondere Microsoft Outlook mit Word-HTML-Rendering) unterstützen kein CSS Grid oder Flexbox. MarbleSend liefert 8 responsive Layouts auf Tabellenbasis für Gmail, Outlook, Apple Mail und Yahoo:

Ein fokussierter Editor für E-Mail-Entwickler mit Tab-Einrückung, Live-Zeichenzähler und automatischer Bereinigung von überflüssigen Leerzeichen.

Simuliert Desktop- und Mobil-Clients in einer isolierten Iframe-Sandbox, schützt die Admin-Oberfläche vor Style-Konflikten und bietet sofortiges Feedback.

Beim Versand ersetzt die Template-Engine Tokens dynamisch durch Empfängerattribute, sichere Tracking-Links, RSS-Artikelzusammenfassungen und News-Beiträge.

Ein Dialogwerkzeug zum Versenden von Test-E-Mails an beliebige Adressen über ausgewählte SMTP-Profile vor dem finalen Versand.

Integrierter AI-Copywriter mit direktem BYOK-Betrieb (Bring Your Own Key) für die Erstellung und Verfeinerung zustellsicherer E-Mail-Templates ohne Proxy-Umwege.

Durchsucht die Betreffzeilen Ihrer Templates, bewertet Öffnungschancen, Spam-Risiken und mobile Längenbegrenzungen mit Vorschlägen in 1 Klick.

Schreiben Sie Artikel im Tab Beiträge unter Vorlagen (Markdown mit Live-Vorschau). Ein Newsletter-Zeitplan mit der Einstellung „News-Beiträge“ sendet jeden Beitrag mit dem Status Bereit genau einmal, den ältesten zuerst, indem er den Platzhalter {{news_posts}} seiner Vorlage füllt. Beiträge existieren nur in Ihrer E-Mail — es gibt keine öffentliche Seite.

MarbleSend bietet zwei synchronisierte Betriebsansichten für unterschiedliche Arbeitsabläufe: einen kompakten Bento-Grid-Manager (/schedules) und einen umfangreichen interaktiven Monatskalender (/schedules/list).

Wiederkehrende Zeitpläne basieren auf SchedulerService::computeNextRun(), das manuelle Zeitstempelberechnungen durch präzise PHP DateTimeImmutable-Mathematik ersetzt.

MarbleSend stellt über natives SimpleXML und cURL eine direkte Verbindung zu Ihrem Blog oder Feed her und wandelt neue Artikel ohne externe Tools in automatisierte Campaigns um.

Im Gegensatz zu statischen Campaign-Snapshots ermitteln terminierte Aussendungen ihre Empfängerliste dynamisch genau in der Sekunde, in der das Ereignis ausgelöst wird.

Jeder automatisierte Lauf erstellt einen unveränderlichen Audit-Datensatz in cm_schedule_occurrences, der Zeitstempel, Ergebnisse, Empfängerzahlen und Fehlerdaten dokumentiert.

Administratoren können den Countdown-Timer umgehen und eine außerplanmäßige Sendung jedes Zeitplans sofort über die Aktion "Trigger Send Now" auslösen.

MarbleSend verfügt über einen Enterprise-Parallelitätsschutz, der speziell dafür entwickelt wurde, doppelte Aussendungen auf kostengünstigen Shared-Hosting-Umgebungen zu verhindern.

Die dynamische Optimization Tip-Karte auf der Seite Schedules bietet 8 praxiserprobte operative Empfehlungen für eine zuverlässige Zustellung auf Shared-Hosting-Servern:

Ein Newsletter-Zeitplan kann jetzt Artikel statt einer festen Vorlage senden. Setzen Sie Inhaltsquelle auf „News-Beiträge“, und jeder Durchlauf liefert die nächsten Bereit-Beiträge aus Vorlagen → Beiträge, eingefügt über {{news_posts}} in die Vorlage. Wartet kein Beitrag, wird nichts gesendet.

1. 1Öffnen Sie Vorlagen → Beiträge und schreiben Sie Ihren Artikel in Markdown.
2. 2Erstellen oder öffnen Sie eine Vorlage und setzen Sie {{news_posts}} dorthin, wo die Artikel erscheinen sollen (die Starter-Vorlage „News-Beiträge-Newsletter“ enthält ihn bereits).
3. 3Öffnen Sie Zeitpläne → Neu, lassen Sie den Typ auf Newsletter und setzen Sie Inhaltsquelle auf „News-Beiträge“.
4. 4Wählen Sie Vorlage, Zielgruppe, SMTP-Profil, Beiträge pro E-Mail (1–20) und Taktung.
5. 5Speichern. Nur Beiträge, die nach diesem Zeitpunkt Bereit werden, kann dieser Zeitplan senden.
6. 6Markieren Sie den Beitrag als Bereit. Der nächste Durchlauf — oder Jetzt ausführen — sendet ihn.

• Der Wechsel von Nur Vorlage zu News-Beiträge setzt in diesem Moment einen neuen Stichtag; der Wechsel zurück löscht ihn.
• Beim Speichern des Zeitplan-Formulars wird erneut geprüft, ob die Vorlage {{news_posts}} enthält. Pausieren und Fortsetzen schalten nur den Ein/Aus-Schalter um und prüfen das nie, sodass Sie immer pausieren können.
• Intelligente Unterdrückung wird im Modus News-Beiträge automatisch deaktiviert: Sie würde alle ausschließen, die eine frühere Ausgabe erhalten haben.
• News-Beiträge gibt es nur für Newsletter-Zeitpläne; RSS-Zeitpläne behalten ihre eigene Feed-Logik.

• Die Zeitplanliste kennzeichnet diese Zeitpläne als „News-Beiträge“ statt „Newsletter“.
• Das Detailpanel zeigt, wie viele Bereit-Beiträge für diesen Zeitplan warten.
• Im Formular werden Vorlagen ohne {{news_posts}} markiert, und eine Warnung erscheint, wenn Sie eine auswählen.

MarbleSend entkoppelt die Kampagnenausführung von Zustellrelais mit zwei Transportmodellen: (1) Bring Your Own (BYO) SMTP zur Anbindung eigener Mailserver und (2) MarbleSend SMTP via Amazon SES für sofortige Enterprise-Cloud-Zustellung ohne AWS-Konten oder IP-Aufwärmen. Kampagnen binden sich dynamisch an Profile mit nahtlosem Standard-Fallback und atomarer Guthabenabrechnung.

# Check resolution via dig (macOS / Linux):
dig CNAME <token1>._domainkey.yourdomain.com +short

# Check resolution via nslookup (Windows / PowerShell):
nslookup -type=CNAME <token1>._domainkey.yourdomain.com

MarbleSend versendet E-Mails im Hintergrund. Ein Cron-Job ist ein Zeitgeber in Ihrem Hosting-Panel, der MarbleSend jede Minute weckt, damit es Zeitpläne und Autoresponder ausführen, fehlgeschlagene Zustellungen wiederholen, Bounces einsammeln und eine lange Campaign weiterführen kann. Eine Campaign, die Sie senden, startet sofort, doch alles, was später geschehen muss, hängt von diesem Zeitgeber ab. Zeigt Settings → System den Status Cron nicht erkannt, fehlt der Zeitgeber, läuft nicht jede Minute oder zeigt auf den falschen Ort. Die drei Schritte unten beheben das.

Für technische Nutzer

E-Mail-Kompilierung, Zielgruppenabfragen, Versand und Webhook-Verarbeitung arbeiten asynchron über einen 1-minütigen Hintergrund-Worker. MarbleSend nutzt eine Dual-Entrypoint-Architektur (nativer CLI-Worker worker.php oder HTTP-cron.php), geschützt durch nicht-blockierende Dateisperren gegen Überlappungen auf Shared Hosting.

* * * * * php /home/USER/your-folder/worker.php >/dev/null 2>&1

GET https://your-domain.com/cron.php?token=SECURE_TOKEN

MarbleSend ist als international zugängliche, selbst gehostete Plattform konzipiert. Es bietet 23 vollständig von Menschen kuratierte native Sprachwörterbücher, automatische Rechts-nach-Links-Layout-Spiegelung für Arabisch, persistente Tri-State-Theme-Anpassung und strenge Single-Tenant-Sicherheit.

Die REST API ermöglicht externen Websites, Landingpages, mobilen Apps und dem offiziellen WordPress-Plugin MarbleSend Forms die sichere Interaktion mit Ihrer Kontaktdatenbank und Sende-Engine. API-Schlüssel verwenden kryptografische Präfixe, Einweg-SHA-256-Speicherung und granulare Scopes.

Webhooks bieten Echtzeit-HTTP-Ereignis-Streaming an externe Endpunkte, sodass CRM-Systeme, Slack-Benachrichtigungen oder benutzerdefinierte Automatisierungen sofort auf Abonnenten-Anmeldungen, Kampagnen-Versendungen, Abmeldungen und Hard Bounces reagieren können.

Die Zustellbarkeit entscheidet, ob Ihre E-Mails im Posteingang landen oder im Spam-Ordner verschwinden. MarbleSend verfügt über eine integrierte DNS-Inspektions-Engine, die vier sequenzielle, nicht-blockierende Abfragen direkt an autoritative Nameserver ohne externe APIs sendet.

MarbleSend bietet eine flexible Dual-Mode-KI-Engine für Copywriting, Betreffzeilen und Spam-Scoring: (1) Bring Your Own Key (BYOK) für Direktverbindungen zu führenden LLMs ohne Aufschlag und (2) MarbleSend KI-Credits für sofortigen Pay-as-you-go-Zugang zu kuratierten Spitzenmodellen ohne Entwicklerkonten.

MarbleSend verifiziert die Produkt-Authentizität mittels asymmetrischer Ed25519-Kryptografie über die native libsodium-Erweiterung von PHP. Ein signiertes License Grant Token wird bei der Erstaktivierung ausgestellt und lokal ohne permanente Verbindungsanforderungen validiert.

Das Plugin ruft die MarbleSend REST API über HTTPS auf, deshalb können WordPress und MarbleSend auf verschiedenen Servern laufen. Auf die MarbleSend-Datenbank hat es keinen Zugriff.

curl -X POST https://your-domain.com/api/contacts \
  -H "Authorization: Bearer ms_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{"email":"visitor@example.com","name":"John Doe","tags":["newsletter","source:wpforms"]}'

Ein langsames oder nicht erreichbares MarbleSend soll das Formular eines Besuchers weder hängen lassen noch einen Lead kosten. Einsendungen von Formular-Plugins werden eingereiht und im Hintergrund gesendet.

// Non-blocking submission buffer in WordPress
set_transient('marblesend_forms_queue_' . wp_generate_uuid4(), $payload, 3600);
if (!wp_next_scheduled('marblesend_forms_process_queue')) {
    wp_schedule_single_event(time() + 5, 'marblesend_forms_process_queue');
}

Das Plugin enthält ein Anmeldeformular, Sie brauchen also keinen Formular-Builder. Fügen Sie es per Shortcode, Gutenberg-Block oder Widget ein. Alle drei führen denselben Code aus.

[marblesend_form tags="newsletter,inbound" show_name="1" consent="I agree to receive email updates and accept the privacy policy."]

WPForms ist einer der meistgenutzten Formular-Builder. Das Plugin liest die Einsendung, sobald WPForms sie validiert hat, ein WPForms-Add-on brauchen Sie also nicht.

add_action('wpforms_process_complete', function($fields, $entry, $form_data, $entry_id) {
    $email = $fields[1]['value'] ?? ''; // Numeric Field ID #1
    $name  = $fields[0]['value'] ?? ''; // Numeric Field ID #0
    MarbleSend_Integration_Base::dispatch('wpforms', $form_data['id'], $email, $name);
}, 10, 4);

Contact Form 7 definiert seine Felder als Tags in einer Textvorlage. Das Plugin greift ein, nachdem die E-Mail des Formulars gesendet wurde.

add_action('wpcf7_mail_sent', function($contact_form) {
    $submission = WPCF7_Submission::get_instance();
    $data = $submission ? $submission->get_posted_data() : [];
    $email = $data['your-email'] ?? '';
    $name  = $data['your-name'] ?? '';
    MarbleSend_Integration_Base::dispatch('cf7', $contact_form->id(), $email, $name);
}, 10, 1);

Das Plugin lauscht auf die Aktion, die Fluent Forms nach dem Speichern eines Eintrags auslöst.

add_action('fluentform/submission_inserted', function($entryId, $formData, $form) {
    $email = $formData['email'] ?? '';
    $name  = is_array($formData['names'] ?? null) ? implode(' ', $formData['names']) : ($formData['first_name'] ?? '');
    MarbleSend_Integration_Base::dispatch('fluentforms', $form->id, $email, $name);
}, 10, 3);

Das Plugin liest den Eintrag direkt, nachdem Formidable Forms ihn gespeichert hat.

add_action('frm_after_create_entry', function($entryId, $formId) {
    $entry = FrmEntry::getOne($entryId, true);
    $email = $entry->metas[12] ?? $entry->metas['email-address'] ?? '';
    $name  = $entry->metas[11] ?? $entry->metas['full-name'] ?? '';
    MarbleSend_Integration_Base::dispatch('formidable', $formId, $email, $name);
}, 30, 2);

Das Plugin lauscht auf den Hook, den Forminator bei der Verarbeitung einer Einsendung auslöst.

add_action('forminator_custom_form_submit_before_set_fields', function($formId, $response, $fieldData) {
    $fields = array_column($fieldData, 'value', 'name');
    $email  = $fields['email-1'] ?? '';
    $name   = $fields['name-1'] ?? '';
    MarbleSend_Integration_Base::dispatch('forminator', $formId, $email, $name);
}, 10, 3);

Eine E-Mail zu erfassen ist nur der erste Schritt. Tags bestimmen, was danach mit dem Kontakt passiert.

{
  "email": "lead@agency.com",
  "name": "Jane Smith",
  "tags": ["source:wpforms", "ebook-download", "vip-inbound"],
  "consent_source": "api"
}