- MODX 2
- MODX 3
- PHP 7.2
Campaign
The tab builds a new campaign from three blocks: letter, recipients, time.
Letter
| Field | Meaning |
|---|---|
| Email template | a PostCraft.* chunk. Its text is copied into the campaign when it is queued |
| Subject | required |
| Preview text | the line next to the subject in the inbox. Hidden in the letter itself. 40–100 characters work best |
| Unsubscribe page language | language of the page behind . The list depends on the site of the From mailbox |
| From | sender mailbox |
| Reply-To | address for replies. Empty means replies go to the From address |
Recipients
- Addresses: one per line or comma separated.
- Saved list and Insert: addresses from the Lists tab.
- Add unique emails from saved forms (FormIt): addresses from FormIt submissions. Refresh FormIt count shows how many there are.
PostCraft removes duplicates and skips blacklisted addresses. One run queues up to 10,000 addresses.
The Do not resend to addresses that already got this letter checkbox skips addresses that got this template in another campaign or wait for it in the queue. PostCraft checks this when queueing and again before each letter goes out. Test letters do not count.
Time
Letters go out on the chosen day between From and To in the site time zone. Inside the window PostCraft picks the hour for each address from its opens and clicks over the last 90 days. A new address gets the hour when all recipients open letters most often, or 10:00 without any history. If that hour falls outside the window, the letter gets a random time inside it.
Send to everyone now turns off the date and hours: letters go out with the next cron run.
Buttons
- Test to me sends one letter to the email of your MODX profile. It stays out of the stats.
- Schedule queues the letters and shows the campaign number.
Campaign status
| Status | What happens |
|---|---|
| Scheduled | waits for its window |
| Sending | cron sends letters |
| Paused | no letters until Resume |
| Cancelled | unsent letters will not go out |
| Done | the queue is empty |
Pause, Resume, Cancel mailing and Edit live in the Stats tab table. After a pause, letters whose time has passed move to the nearest window.
Editing a campaign
You can edit a scheduled or paused campaign. If sending is in progress, click Pause first.
The edit window changes the subject, preheader, date, hours and the address list in the queue. Delete a line and that address gets no letter. New addresses join the campaign. The Reload letter body from template checkbox takes fresh HTML if the template changed after queueing.
Edits apply to unsent letters only.
