Documentation & Encyclopédie système

MarbleSend repose sur un gestionnaire d'arrière-plan principal unique : worker.php. Le tableau de bord inspecte cm_settings['worker_last_run'] pour déterminer si le cron s'exécute bien toutes les 60 secondes.

Le visualiseur de croissance restitue la distribution du volume sur quatre périodes sélectionnables : 7 jours, 30 jours, 90 jours et depuis le début de l'année (YTD). Chaque barre représente un segment temporel agrégé, affichant le nombre d'envois et d'ouvertures au survol.

Le flux de la colonne de droite présente les récentes expéditions de Campaign en direct avec des badges de statut animés (Completed, Sending pulsant, Failed, Draft), les ratios de livraison et l'état du système.

Le tableau d'audit inférieur répertorie les récentes diffusions avec métadonnées : nom de Campaign, statut, origine (manual, schedule, rss, auto_resend), ratio destinataires/envoyés et taux d'ouverture vérifié.

Lorsque votre domaine d'expédition ne dispose pas de records SPF, DKIM ou DMARC vérifiés, MarbleSend met en évidence une bannière d'avertissement directement au-dessus des métriques KPI. Cliquer sur Vérifier le DNS du domaine ouvre l'assistant de diagnostic en 4 étapes sous /settings?tab=deliverability, empêchant les utilisateurs d'endommager la réputation de leur domaine avec des boîtes non authentifiées.

Accélérateurs reliant le tableau de bord aux flux stratégiques : newsletters récurrentes automatisées, intégration de flux RSS-vers-email, capture de listes d'abonnés, conformité double opt-in et suppression automatique.

Dès qu'un envoi de broadcast est en cours, une bannière de suivi persistante s'affiche en haut de /campaigns. Elle interroge /api/campaigns/:id/progress toutes les 1,5 seconde sans recharger la page.

La colonne de gauche permet un ciblage d'abonnés très précis. Les administrateurs peuvent filtrer par tags personnalisés de contact, rechercher par e-mail/nom partiel, et sélectionner des contacts individuels ou cliquer sur Tout sélectionner.

Pour éviter des erreurs désastreuses (ex. envoyer des e-mails avec des variables cassées, des liens de désinscription manquants ou des termes spams), MarbleSend exige un contrôle pré-vol avant le lancement.

Avant de confier des milliers d'e-mails à la file d'attente, le bouton Envoyer un e-mail de test expédie instantanément un e-mail de test unique à l'administrateur ou à la boîte QA sans toucher à la liste des destinataires en base. Toutes les balises ({{first_name}}, {{email}}, {{unsubscribe_link}}) sont remplies avec des valeurs d'aperçu fictives afin que vous puissiez contrôler le rendu sur Gmail, Apple Mail et Outlook.

Toutes les balises d'ancrage sortantes (<a href="...">) sont traitées via App\Services\TrackingInjector. Les paramètres UTM (utm_source, utm_medium, utm_campaign, utm_content) sont ajoutés automatiquement avant l'encapsulation de redirection de clics. Les liens mailto, tel et de désinscription restent intacts.

Le portfolio d'historique complet offre un filtrage multi-critères par origine (manual, recurring, rss, resend_unopened), statut (completed, sending, failed, draft) et plage de dates. Les administrateurs peuvent sélectionner plusieurs Campaigns pour télécharger les logs de livraison groupés au format CSV.

Sous /campaigns/:id/report, MarbleSend présente un rapport d'après-campagne complet :

Dépôt centralisé pour tous les templates d'emails marketing, transactionnels et autoresponders. Propose un filtrage instantané côté client, des slugs d'URL immuables et des indicateurs d'état de brouillon en direct.

Les moteurs d'affichage de bureau modernes (notamment Microsoft Outlook utilisant Word HTML) ne prennent pas en charge CSS Grid ou Flexbox. MarbleSend intègre 8 mises en page basées sur tableaux testées sur Gmail, Outlook, Apple Mail et Yahoo :

Un éditeur dédié aux développeurs d'emails, avec gestion de l'indentation Tab, suivi en temps réel du nombre de caractères et normalisateur automatique des espaces.

Simule les clients de messagerie de bureau et mobiles dans un cadre iframe isolé, protégeant l'interface d'administration de tout conflit de style.

Au moment de l'envoi, le moteur de modèles remplace dynamiquement les tokens par les attributs du destinataire, des liens de suivi sécurisés, des résumés d'articles RSS et des articles d'actualité.

Outil modal permettant d'expédier des emails de test vers n'importe quelle adresse via le profil SMTP sélectionné avant de programmer ou d'envoyer la Campaign.

Rédacteur AI intégré fonctionnant directement via BYOK (Bring Your Own Key) pour créer et optimiser des templates emails ultra-performants sans intermédiaire.

Analyse les lignes d'objet de tous vos templates, évaluant le taux d'ouverture estimé, les alertes de filtres anti-spam et la longueur avec variantes en 1 clic.

Rédigez des articles dans l'onglet Articles de Modèles (Markdown avec aperçu en direct). Une planification de Newsletter réglée sur « Articles d'actualité » envoie chaque article Prêt une seule fois, du plus ancien au plus récent, en remplissant le marqueur {{news_posts}} de son modèle. Les articles n'existent que dans votre e-mail — il n'y a pas de page publique.

MarbleSend propose deux vues opérationnelles synchronisées adaptées à différents flux de travail : un gestionnaire compact en grille Bento (/schedules) et un calendrier mensuel interactif étendu (/schedules/list).

Les planifications récurrentes sont animées par SchedulerService::computeNextRun(), qui élimine le calcul manuel des horodatages au profit des mathématiques robustes de DateTimeImmutable en PHP.

MarbleSend se connecte directement à votre blog ou flux de contenu à l'aide de SimpleXML et cURL natifs, transformant les nouveaux articles en Campaign automatisées sans outils d'intégration tiers.

Contrairement aux instantanés statiques de Campaign, les envois planifiés résolvent dynamiquement leur liste de destinataires à la seconde exacte où l'occurrence se déclenche.

Chaque exécution automatisée crée une ligne d'audit immuable dans cm_schedule_occurrences, détaillant les horodatages, les résultats, les totaux de destinataires et la télémétrie des erreurs.

Les administrateurs peuvent contourner le compte à rebours et déclencher immédiatement un envoi non planifié de n'importe quelle planification à l'aide de l'action "Trigger Send Now".

MarbleSend intègre un périmètre de concurrence d'entreprise spécialement conçu pour empêcher les envois en double sur les environnements d'hébergement mutualisé économiques.

La carte dynamique Optimization Tip sur la page Schedules fournit 8 recommandations opérationnelles concrètes et éprouvées en production pour une livraison fiable en hébergement mutualisé :

Une planification de Newsletter peut désormais envoyer des articles au lieu d'un modèle fixe. Réglez Source du contenu sur « Articles d'actualité » : chaque exécution remet les prochains articles Prêts de Modèles → Articles, insérés dans le modèle via {{news_posts}}. Rien n'est envoyé quand aucun article n'attend.

1. 1Ouvrez Modèles → Articles et rédigez votre article en Markdown.
2. 2Créez ou ouvrez un modèle et placez {{news_posts}} là où les articles doivent apparaître (le modèle de départ « Newsletter d'articles d'actualité » le contient déjà).
3. 3Ouvrez Planifications → Nouvelle, gardez le type Newsletter et réglez Source du contenu sur « Articles d'actualité ».
4. 4Choisissez le modèle, l'audience, le profil SMTP, le nombre d'articles par e-mail (1–20) et la cadence.
5. 5Enregistrez. Seuls les articles qui deviennent Prêts après ce moment peuvent être envoyés par cette planification.
6. 6Marquez l'article Prêt. La prochaine occurrence — ou Exécuter maintenant — l'envoie.

• Passer une planification de Modèle uniquement à Articles d'actualité fixe une nouvelle date butoir à ce moment ; revenir en arrière l'efface.
• L'enregistrement du formulaire de planification revérifie que le modèle contient {{news_posts}}. Pause et Reprise ne font que basculer l'interrupteur marche/arrêt sans jamais le vérifier : vous pouvez donc toujours mettre en pause.
• Suppression intelligente est désactivée automatiquement en mode Articles d'actualité : elle exclurait tous ceux qui ont reçu un numéro précédent.
• Articles d'actualité n'existe que pour les planifications de Newsletter ; les planifications RSS gardent leur propre logique de flux.

• La liste des planifications étiquette ces planifications « Articles d'actualité » au lieu de « Newsletter ».
• Le panneau de détail indique combien d'articles Prêts attendent cette planification.
• Dans le formulaire, les modèles sans {{news_posts}} sont signalés, et un avertissement apparaît si vous en choisissez un.

MarbleSend découple l'exécution des campagnes des relais de livraison grâce à deux modèles de transport: (1) Bring Your Own (BYO) SMTP pour connecter vos serveurs existants, et (2) MarbleSend SMTP via Amazon SES pour une livraison cloud professionnelle instantanée sans configuration AWS ni préchauffage d'IP. Les campagnes se lient dynamiquement avec repli par défaut et comptabilité atomique.

# 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 envoie les e-mails en arrière-plan. Une tâche cron est un minuteur de votre panneau d'hébergement qui réveille MarbleSend chaque minute afin qu'il puisse exécuter les planifications et les autoresponders, réessayer les envois échoués, collecter les bounces et poursuivre une longue Campaign. Une Campaign que vous envoyez démarre aussitôt, mais tout ce qui doit se produire plus tard dépend de ce minuteur. Si Settings → Système affiche Cron non détecté, le minuteur est absent, ne s'exécute pas chaque minute ou pointe au mauvais endroit. Les trois étapes ci-dessous le corrigent.

Pour les utilisateurs techniques

La compilation des e-mails, la résolution des requêtes d'audience, l'expédition et le traitement des webhooks fonctionnent de manière asynchrone via un worker en arrière-plan de 1 minute. MarbleSend utilise une architecture à double point d'entrée (CLI worker.php ou HTTP cron.php) protégée par des verrous de fichiers non bloquants pour éliminer les exécutions chevauchantes sur hébergement mutualisé.

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

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

MarbleSend est conçu comme une plateforme auto-hébergée internationale. Il intègre 23 dictionnaires de langues natives entièrement organisés par des humains, la mise en miroir automatique de droite à gauche pour l'arabe, la personnalisation persistante du thème tri-state et un périmètre de sécurité renforcé.

La REST API permet aux sites web externes, landing pages, applications mobiles et au plugin officiel WordPress MarbleSend Forms d'interagir en toute sécurité avec vos contacts et votre moteur de diffusion. Les clés API utilisent un préfixe cryptographique, un stockage unidirectionnel SHA-256 et des portées de capacité granulaires.

Les webhooks fournissent un flux d'événements HTTP en temps réel vers des endpoints externes, permettant aux CRM, alertes Slack ou flux d'automatisation de réagir instantanément aux inscriptions, diffusions de campagnes, désabonnements et rebonds durs.

La délivrabilité détermine si vos messages arrivent dans la boîte de réception ou dans les spams. MarbleSend intègre un moteur d'inspection DNS qui exécute quatre requêtes séquentielles non bloquantes directement auprès des serveurs de noms faisant autorité sans dépendance d'API tierce.

MarbleSend propose un moteur d'IA bi-mode polyvalent pour la rédaction, la suggestion d'objets et l'audit anti-spam: (1) Bring Your Own Key (BYOK) pour se connecter directement aux grands modèles de langage sans marge, et (2) Crédits IA MarbleSend pour un accès instantané à la carte à des modèles sélectionnés sans gérer de clés API.

MarbleSend vérifie l'authenticité du produit par cryptographie asymétrique Ed25519 via l'extension native libsodium de PHP. Un License Grant Token signé est émis lors de l'activation initiale et validé localement sans connexion permanente.

Le plugin appelle la REST API de MarbleSend en HTTPS : WordPress et MarbleSend peuvent donc tourner sur des serveurs différents. Il n'a aucun accès à la base de données de MarbleSend.

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"]}'

Un MarbleSend lent ou injoignable ne doit ni bloquer le formulaire d'un visiteur ni faire perdre un lead. Les envois des plugins de formulaires sont mis en file et transmis en arrière-plan.

// 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');
}

Le plugin inclut un formulaire d'abonnement : vous n'avez pas besoin d'un constructeur de formulaires. Ajoutez-le avec un shortcode, un bloc Gutenberg ou un widget. Les trois exécutent le même code.

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

WPForms est l'un des constructeurs de formulaires les plus utilisés. Le plugin lit l'envoi une fois que WPForms l'a validé : aucun module complémentaire WPForms n'est nécessaire.

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 définit ses champs sous forme de tags dans un modèle texte. Le plugin intervient après l'envoi de l'email du formulaire.

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);

Le plugin écoute l'action que Fluent Forms déclenche après l'enregistrement d'une entrée.

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);

Le plugin lit l'entrée juste après son enregistrement par Formidable Forms.

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);

Le plugin écoute le hook que Forminator déclenche pendant le traitement d'un envoi.

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);

Recueillir un email n'est que la première étape. Les tags déterminent ce qui arrive ensuite au contact.

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