Understand QCLF Email Delivery Retries and Per-Template State

QCLF email delivery is task-driven and tracks state per notification + template. This matters when more than one published Core/Custom template matches one recipient/event: each matching template is attempted independently.

The canonical QC Live Forum Notification Delivery Scheduled Task runs every 5 minutes and processes up to 100 due notification recipients per service call.

Successful Templates Are Not Re-Sent on Retry

For each matching published template, QCLF checks #__qcforum_notification_email_deliveries. A template already marked sent is skipped on later retries. If Template A succeeds and Template B fails, the next task run retries B without duplicating A.

Three-Attempt Failure Path

QCLF allows up to three notification delivery attempts. Mailer failures keep the template/notification pending until the attempt ceiling, then mark the exhausted path failed. Unresolved template tokens are also recorded as failed template attempts and prevent a successful notification completion.

Delivery Revalidates the Recipient

  • Blocked/deleted Joomla users are suppressed.
  • Global email preference and reaction-email preference are rechecked.
  • Follow/subscription and recipient-role relationships are rechecked.
  • Normal recipients must still have access to the target Topic unless the event is a relationship/privileged notice.
  • Administrator external email must still be in the current configured Admin Notification address list.

Premium Custom Templates Are Rechecked Too

Runtime skips Custom templates when Max/All Access is no longer effective. If no matching template remains sendable because the required feature is unavailable, QCLF suppresses that notification instead of repeatedly trying an unusable premium template.

Operational Failure Signals

When a recipient exhausts delivery attempts, QCLF can emit an email_delivery_failed event; aggregate failures can emit notification_delivery_failed. A due pending queue older than 30 minutes can produce a deduplicated notification_queue_stalled operational alert.

Community Discussion

Want to compare forum workflows, share practical QCLF tips, or discuss how other Joomla site owners use this feature? Visit the QC Live Forum Community. For private support, bug reports, account-specific entitlement problems, or feature requests, use the QuantaCade support system.