forbidals

Back Back Up Advanced Editor

<?php
/**
 * Summary email base class
 *
 * @since 6.7
 *
 * @package Formidable
 */

if ( ! defined( 'ABSPATH' ) ) {
	die( 'You are not allowed to call this page directly.' );
}

abstract class FrmEmailSummary {

/**
	 * Name of the file with the HTML content, without the file extension.
	 *
	 * @since 6.15
	 *
	 * @var string
	 */
	protected $template = 'base';

/**
	 * Is HTML email?
	 *
	 * @var bool
	 */
	protected $is_html = true;

/**
	 * Gets email subject.
	 *
	 * @return string
	 */
	abstract protected function get_subject();

/**
	 * Gets inner content.
	 *
	 * @since 6.15 Method isn't abstract anymore, returning an empty string by default.
	 *
	 * @return false|string
	 */
	protected function get_inner_content() {
		return '';
	}

/**
	 * Constructor.
	 */
	public function __construct() {
		/**
		 * Enables HTML for summary emails.
		 *
		 * @since 6.7
		 *
		 * @param bool $enable Set to `true` to enable.
		 */
		$this->is_html = apply_filters( 'frm_html_summary_emails', true );
	}

/**
	 * Gets recipients.
	 *
	 * @return string
	 */
	protected function get_recipients() {
		$recipients = FrmAppHelper::get_settings()->summary_emails_recipients;
		$recipients = str_replace( '[admin_email]', get_bloginfo( 'admin_email' ), $recipients );
		FrmEmailSummaryHelper::maybe_remove_recipients_from_api( $recipients );
		return $recipients;
	}

/**
	 * Gets email headers.
	 *
	 * @return string[]
	 */
	protected function get_headers() {
		return array(
			'Content-Type: ' . ( $this->is_html ? 'text/html; charset=UTF-8' : 'text/plain' ),
			'From: ' . get_bloginfo( 'name' ) . ' <' . FrmEmailHelper::get_default_from_email() . '>',
		);
	}

/**
	 * Gets email content.
	 *
	 * @since 6.8 This can return `false` to skip sending email.
	 *
	 * @return false|string
	 */
	protected function get_content() {
		$args = $this->get_content_args();

if ( false === $args ) {
			return false;
		}

ob_start();
		include $this->get_include_file( $this->template );
		$content = ob_get_clean();

return str_replace( '%%INNER_CONTENT%%', $this->get_inner_content(), $content );
	}

/**
	 * Gets include file path from the given file name.
	 *
	 * @param string $file_name File name.
	 *
	 * @return string
	 */
	protected function get_include_file( $file_name ) {
		$suffix = $this->is_html ? '' : '-plain';
		return $this->get_include_folder() . $file_name . $suffix . '.php';
	}

/**
	 * Gets the full path to the folder containing the email templates.
	 *
	 * @since 6.15
	 *
	 * @return string
	 */
	protected function get_include_folder() {
		return FrmAppHelper::plugin_path() . '/classes/views/summary-emails/';
	}

/**
	 * Gets content args.
	 *
	 * @since 6.8 This can return `false` to skip sending email.
	 *
	 * @return array|false
	 */
	protected function get_content_args() {
		$args = array(
			'subject'          => $this->get_subject(),
			'site_url'         => home_url( '/' ),
			'site_url_display' => home_url( '/' ),
			'unsubscribe_url'  => site_url() . '/wp-admin/admin.php?page=formidable-settings&t=misc_settings',
			'support_url'      => FrmEmailSummaryHelper::get_frm_url( 'new-topic', 'contact_support' ),
		);

/**
		 * Filters the summary email content args.
		 *
		 * @since 6.7
		 *
		 * @param array $args        Content args.
		 * @param array $filter_args Contains `email_obj`: summary email object.
		 */
		return apply_filters( 'frm_summary_email_content_args', $args, array( 'email_obj' => $this ) );
	}

/**
	 * Check if the email should be sent.
	 *
	 * @since 6.15
	 *
	 * @return bool
	 */
	protected function should_send() {
		return true;
	}

/**
	 * Sends email.
	 *
	 * @return bool
	 */
	public function send() {
		if ( ! $this->should_send() ) {
			return false;
		}

$recipients = $this->get_recipients();

if ( ! $recipients ) {
			// Return true to not try to send this email on the next day.
			return true;
		}

$content = $this->get_content();

if ( false === $content ) {
			return true;
		}

$subject = $this->get_subject();
		$headers = $this->get_headers();
		$sent    = wp_mail( $recipients, $subject, $content, $headers );

if ( ! $sent ) {
			$headers = implode( "\r\n", $headers );
			$sent    = mail( $recipients, $subject, $content, $headers );
		}

return $sent;
	}
}