automatewoo/includes/Actions/Send_Email_Plain_Text.php
fei-source 47d3c9a8b6 Update to v6.2.2
Source: GrootMade/Festinger Vault
2026-03-15 08:31:15 +08:00

133 lines
3.6 KiB
PHP

<?php
namespace AutomateWoo;
use AutomateWoo\Exceptions\Exception;
use WP_Error;
defined( 'ABSPATH' ) || exit;
/**
* Action_Send_Email_Plain_Text class.
*
* @since 4.4.0
*/
class Action_Send_Email_Plain_Text extends Action_Send_Email_Abstract {
/**
* Get the email type.
*
* @return string
*/
public function get_email_type() {
return 'plain-text';
}
/**
* Load admin props.
*/
public function load_admin_details() {
parent::load_admin_details();
$this->title = __( 'Send Email - Plain Text', 'automatewoo' );
$this->description = __( 'This action sends a plain text email. It will contain no HTML which means open tracking and click tracking will not work. Some variables may display unexpectedly due to having HTML removed. If necessary, an unsubscribe link will be added after the email content.', 'automatewoo' );
}
/**
* Load action fields.
*/
public function load_fields() {
parent::load_fields();
$text = new Fields\Text_Area();
$text->set_name( 'email_content' );
$text->set_title( __( 'Email content', 'automatewoo' ) );
$text->set_description( __( 'All HTML will be removed from this field when sending. Variables that use HTML may display unexpectedly because of this.', 'automatewoo' ) );
$text->set_variable_validation();
$text->set_rows( 14 );
$this->add_field( $text );
}
/**
* Generates the HTML content for the email.
*
* @return string|\WP_Error
*/
public function get_preview() {
$content = $this->get_option( 'email_content', true );
$current_user = wp_get_current_user();
// When the user_id value is 0, it's a session for a logged-out user
// see https://wordpress.org/support/topic/sessions-with-user-id-0/
// phpcs:ignore
wp_set_current_user( 0 ); // no user should be logged in
$email_body = $this->get_workflow_email_object( $current_user->get( 'user_email' ), $content )
->get_email_body();
// convert new lines to HTML breaks for preview only
return nl2br( $email_body, false );
}
/**
* Run the action as a test.
*
* @param array $args Optionally add args for the test.
*
* @return true|WP_Error
*/
public function run_test( array $args = [] ) {
try {
$this->validate_test_args( $args );
$content = $this->get_option( 'email_content', true );
foreach ( $args['recipients'] as $recipient ) {
$sent = $this->get_workflow_email_object( $recipient, $content )->send();
if ( is_wp_error( $sent ) ) {
return $sent;
}
}
} catch ( Exception $e ) {
return new WP_Error( 'exception', $e->getMessage() );
}
return true;
}
/**
* Run the action.
*/
public function run() {
$content = $this->get_option( 'email_content', true );
$recipients = $this->get_option( 'to', true );
$cc = $this->get_option( 'cc', true );
$bcc = $this->get_option( 'bcc', true );
$recipients = Emails::parse_recipients_string( $recipients );
$cc_recipients = Emails::parse_recipients_string( $cc );
$bcc_recipients = Emails::parse_recipients_string( $bcc );
foreach ( $recipients as $recipient_email => $recipient_args ) {
$email = $this->get_workflow_email_object( $recipient_email, $content );
if ( ! empty( $recipient_args['notracking'] ) ) {
$email->set_tracking_enabled( false );
}
// Add CC recipients
if ( ! empty( $cc_recipients ) ) {
$email->set_cc( array_keys( $cc_recipients ) );
}
// Add BCC recipients
if ( ! empty( $bcc_recipients ) ) {
$email->set_bcc( array_keys( $bcc_recipients ) );
}
$sent = $email->send();
$this->add_send_email_result_to_workflow_log( $sent );
}
}
}