Hook transactional email into custom order status

Sends a modified Order Completed email when order status changes to a specific status.

// Hook Into Order Status Change
add_action( 'woocommerce_order_status_changed',
	function( $order_id, $status_from, $status_to ) {

		// Only For Change To This Status
		if( $status_to != 'TARGET-ORDER-STATUS' ) {
			return;
		}

		// Get Woo Emails
		$mailer = WC()->mailer();
		$mails = $mailer->get_emails();
		if( empty( $mails ) ) {
			return;
		}

		foreach( $mails as $mail ) {

			// Get Completed Email
			if( $mail->id != 'customer_completed_order' ) {
				continue;
			}

			// Replace Subject Line
			add_filter(
				'woocommerce_email_subject_customer_completed_order',
				function( $subject ) {
					return 'NEW SUBJECT LINE GOES HERE';
				}
			);

			// Replace Heading
			remove_action(
				'woocommerce_email_header',
				[ WC()->mailer(), 'email_header' ]
			);
			add_action( 'woocommerce_email_header',
				function( $email_heading, $email ) {

				if( $email->id == 'customer_completed_order' ) {
					$email_heading = 'NEW EMAIL HEADING GOES HERE';
				}

				wc_get_template(
					'emails/email-header.php',
					[ 'email_heading' => $email_heading ]
				);

			}, 10, 2 );

			// Replace Content
			add_filter( 'gettext', function( $original ) {

				switch( $text ) {
					case 'We have finished processing your order.':
						return 'NEW BODY CONTENT GOES HERE';
				}

				return $original;

			} );

			// Send It
			$mail->trigger( $order_id );

		} // End Emails Loop

	}, 10, 3

);

Instructions for Hook transactional email into custom order status

  1. Log into a staging or locally hosted clone of your site.
  2. Install and activate Code Snippets plugin.
  3. WP Admin > Snippets > Add New
  4. Copy and paste the code from the section above.
  5. Check to ensure formatting came over properly.
  6. Customize the code as desired.
  7. Add a meaningful title.
  8. Select whether to run on front-end or back-end (or both).
  9. Click “Save and Activate”.
  10. Test your site to ensure it works.
  11. Disable if any problems, or recover.
  12. Repeat for live environment.

Need help modifying Hook transactional email into custom order status?

Contact me. I can help with fitting projects or refer to my partner.

License

All code snippets are licensed GPLv2 (or later) matching WordPress licensing.

Except when otherwise stated in writing the copyright holders and/or other parties provide the program as-is without warranty of any kind, either expressed or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose.

Disclaimer of warranty