docs.modx.pro
  1. Extras
  2. Sendex
  3. FAQ

FAQ ​

Site subscription ​

Form is empty or missing ​

  1. Snippet must be uncached: [[!Sendex]], not [[Sendex]]
  2. Newsletter ID in &id= exists and is active (or pass &showInactive=1)
  3. Clear MODX cache after package install

Guest does not receive confirmation email ​

  1. sendex_confirm_email = Yes (default)
  2. Check SMTP / MODX emailsender
  3. Confirm link expires in 30 minutes — subscribe again after expiry
  4. Rate limit: sendex_confirm_rate_limit > 0 throttles emails per address
  5. Recipient spam folder
  1. Target page calls [[!Sendex]]
  2. Landing snippet without &widgetKey (confirm/unsubscribe links omit sendex_widget_key)
  3. Hash already used or expired (registry /sendex/subscribe/)

Logged-in user still sees subscribe form ​

  1. Profile email may match a guest row — merge may be pending; refresh the page
  2. Sendex plugin subscribed to OnUserActivate / OnUserSave (reinstall package on upgrade)

Guest and MODX user ​

Guest subscribed then registered — two rows? ​

No. Merge policy: on activation or user save guest rows with the same email get user_id. Unique (newsletter_id, email) prevents duplicates.

Merge did not run ​

  1. Profile email exactly matches guest subscription
  2. Sendex plugin active on OnUserActivate and OnUserSave
  3. OnBeforeUserActivate is not used — cancelled activation must not merge

Queue and sending ​

Emails are not sent ​

Check in order:

  1. Queue has rows (Components → Sendex → Email queue)
  2. Cron runs php core/components/sendex/cron/send.php from MODX root
  3. email_from / emailsender set, newsletter template exists
  4. MODX log — PHPMailer errors after sxOnQueueSendFailed
  5. Hosting outbound mail limits

Cron runs but queue does not shrink ​

  1. Row in claim (claimed_at, expires_at +900 sec)
  2. SMTP error — claim released, row kept for retry
  3. sendex_queue_limit (default 100) — each run processes at most that many rows

Send to subscribers vs Add to queue ​

ActionWhat it does
Send to subscribersaddQueues() + immediate flush()
Add to queueaddQueues() only; send separately or via cron

For large lists build the queue and flush via cron in batches.

Manager and settings ​

No access to Sendex in manager ​

Page requires view_sendex or view_document. Transport does not create view_sendex — view_document is usually enough.

No CSV export button ​

  1. sendex_hide_export_button = No
  2. User has edit_document permission

sendex_queue_limit missing in settings ​

Transport does not create this key. Add manually under System settings namespace sendex, default value 100.

MODX 3 ​

Compatibility ​

Sendex 2.0.0-pl verified on MODX 3.2.0-pl. Models are global sx*, not MODX\Revolution\sx*. Manager menu: namespace + action. DB schema via Phinx on install/upgrade.

sxOn* events not listed ​

Reinstall Sendex via Extras → Installer — transport registers events. invokeEvent by name works even without UI registration.