@@ -232,15 +232,15 @@ Given a job, find all email addresses that should receive the mailing (`job.mail
If a job has `is_retry = 1`, the queue is generated by finding all jobs with the same `mailing_id` and joining to bounce event (through queue). Otherwise, the queue is generated as follows:
- Included recipients (`group_type = Include`)
- Static groups - All contacts belonging to (`status = In`) any group in `crm_mailing_group where mailing_id = job.mailing_id`.
- Saved searches - All contacts matching the where clause of a saved search linked from groups in `crm_mailing_group`.
- Previous mailings - All email addresses in `Mailing_Event_Queue` with the `job.mailing_id` keyed from the mailing-group join table. Only jobs with `Complete` status should be considered.
- Static groups - All contacts belonging to (`status = In`) any group in `crm_mailing_group where mailing_id = job.mailing_id`.
- Saved searches - All contacts matching the where clause of a saved search linked from groups in `crm_mailing_group`.
- Previous mailings - All email addresses in `Mailing_Event_Queue` with the `job.mailing_id` keyed from the mailing-group join table. Only jobs with `Complete` status should be considered.
- Excluded recipients (`group_type = Exclude`)
- Static groups - All contacts belonging to (`status = In`) any group in `crm_mailing_group where mailing_id = job.mailing_id`.
- Saved searches - All contacts matching the where clause of a saved search linked from groups in `crm_mailing_group`.
- Previous mailings - All email addresses in `Mailing_Event_Queue` with the `job.mailing_id` keyed from the mail-group join table.
- Successful deliveries in previous jobs of the same mailing - All email addresses in `Mailing_Event_Queue` where `job.mailing_id = mailing_id` inner join to `Mailing_Event_Delivery` and left join to `Mailing_Event_Bounce` where `Mailing_Event_Delivery.id <> null` and `Mailing_Event_Bounce.id is null`.
- Static groups - All contacts belonging to (`status = In`) any group in `crm_mailing_group where mailing_id = job.mailing_id`.
- Saved searches - All contacts matching the where clause of a saved search linked from groups in `crm_mailing_group`.
- Previous mailings - All email addresses in `Mailing_Event_Queue` with the `job.mailing_id` keyed from the mail-group join table.
- Successful deliveries in previous jobs of the same mailing - All email addresses in `Mailing_Event_Queue` where `job.mailing_id = mailing_id` inner join to `Mailing_Event_Delivery` and left join to `Mailing_Event_Bounce` where `Mailing_Event_Delivery.id <> null` and `Mailing_Event_Bounce.id is null`.
### Status
...
...
@@ -257,37 +257,37 @@ Job `status` can take one of 5 states.
Events within CiviMail are usually designed for when CiviMail receives an email in the VERP structure as defined above. There can also be events fired when CiviCRM is preparing emails to send or delivering emails, or processing forms with links generated from CiviMails.
- Delivery
- Registered after a successful SMTP transaction.
- Action - Add a new row in `Mailing_Event_Delivery` with the `queue_id`.
- Registered after a successful SMTP transaction.
- Action - Add a new row in `Mailing_Event_Delivery` with the `queue_id`.
- Bounce
- Registered after an unsuccessful SMTP transaction (fast bounce), or by the inbound processor (slow bounce, see: [CiviMail Mailer Settings](https://wiki.civicrm.org/confluence/display/CRMDOC/CiviMail+Mailer+Settings))
- Action:
- Add a new row in `Mailing_Event_Bounce` with the `queue_id`, `bounce_type` and `bounce_reason` returned by the bounce processor
- Count the bounce events for `email_id` and compare with the `hold_threshold` for the matching bounce type. If the email address has more than the threshold of any type of bounce, place it on bounce hold.
- Registered after an unsuccessful SMTP transaction (fast bounce), or by the inbound processor (slow bounce, see: [CiviMail Mailer Settings](https://wiki.civicrm.org/confluence/display/CRMDOC/CiviMail+Mailer+Settings))
- Action:
- Add a new row in `Mailing_Event_Bounce` with the `queue_id`, `bounce_type` and `bounce_reason` returned by the bounce processor
- Count the bounce events for `email_id` and compare with the `hold_threshold` for the matching bounce type. If the email address has more than the threshold of any type of bounce, place it on bounce hold.
- Unsbuscribe
- Registered after either a Successful SMTP transacftion or submission on the usubscribe webform
- Action
- Removes the contact from the group leaving a note in the `civicrm_subscription_history` table indicating it was from an email and when it happend
- Add a row in `mailing_event_unsbuscribe` setting the `is_domain = 0`for the new row.
- Registered after either a Successful SMTP transacftion or submission on the usubscribe webform
- Action
- Removes the contact from the group leaving a note in the `civicrm_subscription_history` table indicating it was from an email and when it happend
- Add a row in `mailing_event_unsbuscribe` setting the `is_domain = 0`for the new row.
- Opt Out
- Registered after a successful SMTP transaction or on submisssion of the opt out form.
- Action
- Adds a row in `mailing_event_unsubscrive` setting `is_domain = 1`.
- Updaes the `is_opt_out` field to 1 for the contact
- Registered after a successful SMTP transaction or on submisssion of the opt out form.
- Action
- Adds a row in `mailing_event_unsubscrive` setting `is_domain = 1`.
- Updaes the `is_opt_out` field to 1 for the contact
- tracking url
- Regisreted when a successfull webrequest is recieved and processed
- Action adds a row into `mailing_event_trackable_url_open` with the current date and the `url_id` that was clicked
- Regisreted when a successfull webrequest is recieved and processed
- Action adds a row into `mailing_event_trackable_url_open` with the current date and the `url_id` that was clicked
- Reply
- Registered when CiviMail successfully processes an SMTP transaction.
- Action
- Adds a record into `mailing_event_reply` table with the relevant `queue_id` and when the reply was procesed
- Rewrites the mail envelope and sends on the email to the intended reply address as set in the `civicrm_mailing` table
- Registered when CiviMail successfully processes an SMTP transaction.
- Action
- Adds a record into `mailing_event_reply` table with the relevant `queue_id` and when the reply was procesed
- Rewrites the mail envelope and sends on the email to the intended reply address as set in the `civicrm_mailing` table
- Queue
- Registered with CiviMail goes to send a CiviMail and creates queues as above
- Action - Adds a row to `mailing_event_queue` table with relevant `queue_id`
- Registered with CiviMail goes to send a CiviMail and creates queues as above
- Action - Adds a row to `mailing_event_queue` table with relevant `queue_id`
- Subscribe / Confirm
- Regisreted CiviMail successfully processes an SMTP transaction or when the relevant form is used
- Action
- Adds a row into either `mailing_event_confirm` or `mailing_event_subscribe`
- if subscribe and double confirm is enabled sends a confirm email, for confirmations and where double confirm is not used, it adds a relevant row into `civicrm_group_contact`and `civicrm_subscription_history` adding the contact to the relevant group.
- Regisreted CiviMail successfully processes an SMTP transaction or when the relevant form is used
- Action
- Adds a row into either `mailing_event_confirm` or `mailing_event_subscribe`
- if subscribe and double confirm is enabled sends a confirm email, for confirmations and where double confirm is not used, it adds a relevant row into `civicrm_group_contact`and `civicrm_subscription_history` adding the contact to the relevant group.
