{"id":14498,"date":"2022-02-09T12:36:06","date_gmt":"2022-02-09T10:36:06","guid":{"rendered":"https:\/\/www.wp-crm.com\/?post_type=docs&p=14498"},"modified":"2023-06-20T16:56:50","modified_gmt":"2023-06-20T13:56:50","slug":"filter-wp-crm-system-email-notifications-task","status":"publish","type":"docs","link":"https:\/\/www.wp-crm.com\/docs\/filter-wp-crm-system-email-notifications-task\/","title":{"rendered":"Filter: WP-CRM System Email Notifications Task"},"content":{"rendered":"\n

The\u00a0wp_crm_system_email_notifications_task<\/strong><\/mark>\u00a0filter allows you to modify the various variables used to send an email notification for task.<\/p>\n\n\n\n

The filter is passed one argument as an array:<\/p>\n\n\n\n

$send_email    = array(\n    'send'        => true,\n    'vars'        => $vars,\n    'to'        => $to,\n    'subject'    => $subject,\n    'message'    => $message,\n    'headers'    => $headers,\n    'id'        => $ID,\n    'post'        => $post,\n);<\/pre>\n\n\n\n
The variables in the array can be used to modify a number of behaviors including how frequently a notification is sent, who it is sent to, the subject , message, and the headers sent along with the message.<\/p>\n\n\n\n
In order for the email to be sent,\u00a0$send_email[‘send’]<\/strong><\/mark>\u00a0must be\u00a0true,<\/strong><\/mark> which it is by default. If for some reason a condition is met where you do not want the email to be sent again, you can use the filter to set\u00a0$send_email[‘send’]<\/strong><\/mark>\u00a0to\u00a0false<\/strong><\/mark>, which will prevent the email from sending.<\/p>\n\n\n\n
When this filter is run, you can set custom metadata for the task that can be used in the future, or use existing data to determine if an email should be sent, who it should be sent to, and more.<\/p>\n\n\n\n
For example:<\/p>\n\n\n\n
\/\/ Only send email if the project status is 'complete'\nadd_filter( 'wp_crm_system_email_notifications_task', 'prevent_sending_until_project_complete' );\nfunction prevent_sending_until_project_complete( $send_email ){\n    $status = get_post_meta( $send_email['id'], '_wpcrm_task-status', true );\n    if( 'complete' != $status ){\n        $send_email['send'] = false;\n    }\n    return $send_email;\n}<\/pre>\n\n\n\n
\/\/ Only send email when the assigned user is changed\nadd_filter( 'wp_crm_system_email_notifications_task', 'send_assigned_user' );\nfunction send_assigned_user( $\n    \/\/ Assigned user in WP-CRM System\n    $assigned = get_post_meta( $send_email['id'], '_wpcrm_task-assignment', true );\n\n    \/\/ Get previous assigned user\n    $previous = get_post_meta( $send_email['id'], '_wpcrm_task_email_notification_previously_assigned', true );\n\n    if( $assigned == $previous ){\n        \/\/ The assigned user is the same as the previously assigned user, so prevent sending.\n        $send_email['send'] = false;\n    } else {\n        \/\/ Set the currently assigned user as a custom post meta value so we can check for it again in the future.\n        update_post_meta( $send_email['id'], '_wpcrm_task_email_notification_previously_assigned', $assigned );\n    }\n    return $send_email;\n}<\/pre>\n","protected":false},"excerpt":{"rendered":"
The\u00a0wp_crm_system_email_notifications_task\u00a0filter allows you to modify the various variables used to send an email notification for task. The filter is passed one argument as an array: $send_email    = array(     ‘send’        => true,     ‘vars’        => $vars,     ‘to’        => $to,     ‘subject’    => $subject,     ‘message’    => $message,     ‘headers’    => $headers,     ‘id’        => $ID,     ‘post’        => $post, ); The variables in the array can be used to modify a…<\/p>\n","protected":false},"author":465,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"om_disable_all_campaigns":false},"doc_category":[87],"doc_tag":[],"yoast_head":"\nFilter: WP-CRM System Email Notifications Task - WP-CRM System<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.wp-crm.com\/docs\/filter-wp-crm-system-email-notifications-task\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Filter: WP-CRM System Email Notifications Task - WP-CRM System\" \/>\n<meta property=\"og:description\" content=\"The\u00a0wp_crm_system_email_notifications_task\u00a0filter allows you to modify the various variables used to send an email notification for task. The filter is passed one argument as an array: $send_email    = array(     'send'        => true,     'vars'        => $vars,     'to'        => $to,     'subject'    => $subject,     'message'    => $message,     'headers'    => $headers,     'id'        => $ID,     'post'        => $post, ); The variables in the array can be used to modify a…\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.wp-crm.com\/docs\/filter-wp-crm-system-email-notifications-task\/\" \/>\n<meta property=\"og:site_name\" content=\"WP-CRM System\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/wpcrm\/\" \/>\n<meta property=\"article:modified_time\" content=\"2023-06-20T13:56:50+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:site\" content=\"@wpcrmsystem\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.wp-crm.com\/docs\/filter-wp-crm-system-email-notifications-task\/\",\"url\":\"https:\/\/www.wp-crm.com\/docs\/filter-wp-crm-system-email-notifications-task\/\",\"name\":\"Filter: WP-CRM System Email Notifications Task - WP-CRM System\",\"isPartOf\":{\"@id\":\"https:\/\/www.wp-crm.com\/#website\"},\"datePublished\":\"2022-02-09T10:36:06+00:00\",\"dateModified\":\"2023-06-20T13:56:50+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/www.wp-crm.com\/docs\/filter-wp-crm-system-email-notifications-task\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.wp-crm.com\/docs\/filter-wp-crm-system-email-notifications-task\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.wp-crm.com\/docs\/filter-wp-crm-system-email-notifications-task\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.wp-crm.com\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"WP-CRM System Documentation\",\"item\":\"https:\/\/www.wp-crm.com\/docs\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Filter: WP-CRM System Email Notifications Task\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.wp-crm.com\/#website\",\"url\":\"https:\/\/www.wp-crm.com\/\",\"name\":\"WP-CRM System\",\"description\":\"Customer Relationship Management Built For WordPress\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.wp-crm.com\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Filter: WP-CRM System Email Notifications Task - WP-CRM System","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.wp-crm.com\/docs\/filter-wp-crm-system-email-notifications-task\/","og_locale":"en_US","og_type":"article","og_title":"Filter: WP-CRM System Email Notifications Task - WP-CRM System","og_description":"The\u00a0wp_crm_system_email_notifications_task\u00a0filter allows you to modify the various variables used to send an email notification for task. The filter is passed one argument as an array: $send_email    = array(     'send'        => true,     'vars'        => $vars,     'to'        => $to,     'subject'    => $subject,     'message'    => $message,     'headers'    => $headers,     'id'        => $ID,     'post'        => $post, ); The variables in the array can be used to modify a…","og_url":"https:\/\/www.wp-crm.com\/docs\/filter-wp-crm-system-email-notifications-task\/","og_site_name":"WP-CRM System","article_publisher":"https:\/\/www.facebook.com\/wpcrm\/","article_modified_time":"2023-06-20T13:56:50+00:00","twitter_card":"summary_large_image","twitter_site":"@wpcrmsystem","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.wp-crm.com\/docs\/filter-wp-crm-system-email-notifications-task\/","url":"https:\/\/www.wp-crm.com\/docs\/filter-wp-crm-system-email-notifications-task\/","name":"Filter: WP-CRM System Email Notifications Task - WP-CRM System","isPartOf":{"@id":"https:\/\/www.wp-crm.com\/#website"},"datePublished":"2022-02-09T10:36:06+00:00","dateModified":"2023-06-20T13:56:50+00:00","breadcrumb":{"@id":"https:\/\/www.wp-crm.com\/docs\/filter-wp-crm-system-email-notifications-task\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.wp-crm.com\/docs\/filter-wp-crm-system-email-notifications-task\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.wp-crm.com\/docs\/filter-wp-crm-system-email-notifications-task\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.wp-crm.com\/"},{"@type":"ListItem","position":2,"name":"WP-CRM System Documentation","item":"https:\/\/www.wp-crm.com\/docs\/"},{"@type":"ListItem","position":3,"name":"Filter: WP-CRM System Email Notifications Task"}]},{"@type":"WebSite","@id":"https:\/\/www.wp-crm.com\/#website","url":"https:\/\/www.wp-crm.com\/","name":"WP-CRM System","description":"Customer Relationship Management Built For WordPress","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.wp-crm.com\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/www.wp-crm.com\/wp-json\/wp\/v2\/docs\/14498"}],"collection":[{"href":"https:\/\/www.wp-crm.com\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.wp-crm.com\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.wp-crm.com\/wp-json\/wp\/v2\/users\/465"}],"replies":[{"embeddable":true,"href":"https:\/\/www.wp-crm.com\/wp-json\/wp\/v2\/comments?post=14498"}],"version-history":[{"count":7,"href":"https:\/\/www.wp-crm.com\/wp-json\/wp\/v2\/docs\/14498\/revisions"}],"predecessor-version":[{"id":17058,"href":"https:\/\/www.wp-crm.com\/wp-json\/wp\/v2\/docs\/14498\/revisions\/17058"}],"wp:attachment":[{"href":"https:\/\/www.wp-crm.com\/wp-json\/wp\/v2\/media?parent=14498"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/www.wp-crm.com\/wp-json\/wp\/v2\/doc_category?post=14498"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.wp-crm.com\/wp-json\/wp\/v2\/doc_tag?post=14498"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}