Sending an email whenever you change the status of an order in WPPizza -> Orderhistory

send an email (or whatever else it is you would like to do) when you change the status of an order in the order history

wppizza_on_orderstatus_change

@param: array (order details)
@param: str (the status the order has been changed to – something like ‘REFUNDED’, ‘NEW’, ‘ACKNOWLEDGED’ etc)
@param: array (wppizza options set of the blog/site where the order was made. In a multisite setup – if you are displaying all orders from all sites in the “master” site – this might be different to the current site you are on. For the current sites blogoptions use global $wppizza_options; and use those)
@param: str (plaintext template of a selected template id if using filter below)
@param: str (html template of a selected template id if using filter below and template set to be html – @since wppizza 3.5.1)
@return: str (js alert after change was completed – empty to omit alert)

example:

add_filter('wppizza_on_orderstatus_change', 'myprefix_on_orderstatus_change', 10, 5);
function myprefix_on_orderstatus_change($order_details, $order_status, $blog_options, $plaintext_template, $html_template){
	/*
	 if in a multiste environment use global $wppizza_options; 
	 to get wppizza options of the site you are in. else $blog_options will do if you need them 
	*/
	
	/*
	 get the customers address
	 from order_details array
	 var_dump($order_details) to get all details
	*/
	$to_address = $order_details['customer']['cemail']['value'];


	/**if only dealing with latin character domains/emails do a quick validation,  else comment out**/
	if(!filter_var($to_address , FILTER_VALIDATE_EMAIL)){
		$js_alert = __('invalid email');/*alert if invalid email  | EDIT AS REQUIRED  */
		$js_alert .= PHP_EOL . $to_address;
	return $js_alert;
	}

	/*
		subject line
	*/
	$subject = 'The Subject';/* subject line  | EDIT AS REQUIRED */
	/*
		email body / message
	*/
	$message = __('hello');/*message | EDIT AS REQUIRED*/
	/* add plaintext email template of order underneath if exists - see filter below how to get this | EDIT AS REQUIRED */
	$message.= !empty($plaintext_template) ? PHP_EOL . $plaintext_template .PHP_EOL  : '' ;


	/*
		headers
	*/
	$headers   = array();
	$headers[] = "MIME-Version: 1.0";
	$headers[] = "Content-type: text/plain; charset=utf-8";
	$headers[] = "From: Sender Name <[email protected]>";/**who it's from | EDIT AS REQUIRED**/
	$headers[] = "X-Mailer: PHP/".phpversion();

	/*
		send the email, wrap message at 74 chars for maximum email client compatibility
	*/
	$mailSent = mail($to_address, $subject, wordwrap($message, 74, "\r\n"), implode("\r\n", $headers));

	/*
		set js alert after sending
	*/
	if($mailSent){
		$js_alert = __('Email sent to '.$to_address.''.PHP_EOL.'Status: '.$order_status.'');/*alert on successful sending | EDIT AS REQUIRED*/
	}else{
		$js_alert = __('Error sending email to '.$to_address.''); /*alert on error sending | EDIT AS REQUIRED*/
	}

return $js_alert;
}

wppizza_on_orderstatus_change_add_template

if you would like the markup of an email template as set in WPPizza->Templates->Emails available in your above filter as the 4th parameter, use the below filter example to select from one of the the id’s . If the template is set to be HTML the 5th parameter will contain the html markup.

@param: int (emails template id’s . default = false)
@return: int|false (selected email template id or false)

example:

add_filter('wppizza_on_orderstatus_change_add_template', 'myprefix_on_orderstatus_change_add_template');
function myprefix_on_orderstatus_change_add_template($selected_email_template_id){
	/* get plaintext email from template with id 1 for this order */
	$selected_email_template_id = 1;	
return $selected_email_template_id;
}

Add some javascript to order history to execute if order status changes

wppizza_filter_orderhistory_markup

@param: array (array of markup parts)
@return: array

add_filter('wppizza_filter_orderhistory_markup', 'my_custom_orderhistory_markup');
function my_custom_orderhistory_markup($markup){
	
	/*	
	add javascript to the end of the markup
	*/
	$markup['my_js_markup']= "<script type='text/javascript'>
        /* <![CDATA[ */
        jQuery(document).ready(function($){
        $(document).on('change', '.wppizza-orderhistory-order-status', function(e){
            var self=$(this);           
            var selId=self.attr('id').split('-').pop(-1);
            var selfVal=self.val();
			/* do things when you change the status to PROCESSED, in this case trigger the print button **/
            if(selfVal=='PROCESSED'){
                    var triggerTarget=$('#wppizza-orderhistory-print-order-'+selId+'');
                    triggerTarget.trigger('click');
            }
        });
        });
        /* ]]> */
    </script>";

return $markup;
}

Add some javascript to order history to execute if order status changes to “PROCESSED” and execute an ajax call passing on some js prompt

example:

add_filter('wppizza_filter_orderhistory_markup', 'my_custom_orderhistory_markup');
function my_custom_orderhistory_markup($markup){
	
	/*	
	add javascript to the end of the markup
	*/
	$markup['my_js_markup']= "<script type='text/javascript'>
        /* <![CDATA[ */
        jQuery(document).ready(function($){
        $(document).on('change', '.wppizza-orderhistory-order-status', function(e){
            var self=$(this);           
            var selId=self.attr('id').split('-').pop(-1);
            var selfVal=self.val();
            
            var order=selId.split('_');
            var blog_id=order[0];
            var order_id=order[1];
            
            
	/* do things when you change the status to PROCESSED - in this case adding a prompt and passing this on to an ajax call **/
        if(selfVal=='PROCESSED'){

         	var message = prompt('your message', 'default message');

				jQuery.post(ajaxurl , {action :'myprefix_admin_ajax',vars:{'type':'statusupdate', 'blog_id':blog_id, 'order_id':order_id, 'message':message}}, function(response) {
						alert('ok');
				},'text').error(function(jqXHR, textStatus, errorThrown) {alert('error : ' + errorThrown);});
            }
        });
        });
        /* ]]> */
    </script>";

return $markup;
}

/**
	admin ajax
**/
add_action('wp_ajax_myprefix_admin_ajax', 'myprefix_set_admin_ajax' );
function myprefix_set_admin_ajax(){
	// listen to type statusupdate being posted 	
	if($_POST['vars']['type'] == 'statusupdate'){
		
		/* blogid (if required) */
		$blog_id = (int)$_POST['vars']['blog_id'];// sanitise blog_id , just for good measure
		
		/* order */
		$order_id = (int)$_POST['vars']['order_id'];// sanitise order id , just for good measure
		$order = wppizza_get_completed_order($order_id);// get order details
		
		/* prompt message set  - you probably want to validate/sanitize this somewhat*/
		$message = $_POST['vars']['message'];
		
		/* 
		send email for example (as outlined above) or whetever you need to do 
		utisiling the variables you have available if needs be (like $order, $message) such as		

		 to get the customers address from order array ( var_dump($order) to get all order details)
		*/
		$to_address = $order['customer']['cemail']['value'];		
		
	}
die();//important
}