File Editor
Directories:
.. (Back)
block-editor
config-validator
css
js
swv
Files:
capabilities.php
contact-form-functions.php
contact-form-template.php
contact-form.php
controller.php
file.php
form-tag.php
form-tags-manager.php
formatting.php
functions.php
html-formatter.php
integration.php
l10n.php
mail-tag.php
mail.php
pipe.php
pocket-holder.php
rest-api.php
shortcodes.php
special-mail-tags.php
submission.php
upgrade.php
validation-functions.php
validation.php
Create New File
Create
Edit File: mail.php
<?php add_filter( 'wpcf7_mail_html_body', 'wpcf7_mail_html_body_autop', 10, 1 ); /** * Filter callback that applies auto-p to HTML email message body. */ function wpcf7_mail_html_body_autop( $body ) { if ( wpcf7_autop_or_not( array( 'for' => 'mail' ) ) ) { $body = wpcf7_autop( $body ); } return $body; } /** * Class that represents an attempt to compose and send email. */ class WPCF7_Mail { private static $current = null; private $name = ''; private $locale = ''; private $template = array(); private $component = ''; private $use_html = false; private $exclude_blank = false; /** * Returns the singleton instance of this class. */ public static function get_current() { return self::$current; } /** * Returns the name of the email template currently processed. * * Expected output: 'mail' or 'mail_2' */ public static function get_current_template_name() { $current = self::get_current(); if ( $current instanceof self ) { return $current->get_template_name(); } } /** * Returns the name of the email template component currently processed. * * Expected output: 'recipient', 'sender', 'subject', * 'additional_headers', 'body', or 'attachments' */ public static function get_current_component_name() { $current = self::get_current(); if ( $current instanceof self ) { return $current->get_component_name(); } } /** * Composes and sends email based on the specified template. * * @param array $template Array of email template. * @param string $name Optional name of the template, such as * 'mail' or 'mail_2'. Default empty string. * @return bool Whether the email was sent successfully. */ public static function send( $template, $name = '' ) { self::$current = new self( $name, $template ); return self::$current->compose(); } /** * The constructor method. * * @param string $name The name of the email template. * Such as 'mail' or 'mail_2'. * @param array $template Array of email template. */ private function __construct( $name, $template ) { $this->name = trim( $name ); $this->use_html = ! empty( $template['use_html'] ); $this->exclude_blank = ! empty( $template['exclude_blank'] ); $this->template = wp_parse_args( $template, array( 'subject' => '', 'sender' => '', 'body' => '', 'recipient' => '', 'additional_headers' => '', 'attachments' => '', ) ); if ( $submission = WPCF7_Submission::get_instance() ) { $contact_form = $submission->get_contact_form(); $this->locale = $contact_form->locale(); } } /** * Returns the name of the email template. */ public function name() { return $this->name; } /** * Returns the name of the email template. A wrapper method of name(). */ public function get_template_name() { return $this->name(); } /** * Returns the name of the email template component currently processed. */ public function get_component_name() { return $this->component; } /** * Retrieves a component from the email template. * * @param string $component The name of the component. * @param bool $replace_tags Whether to replace mail-tags * within the component. * @return string The text representation of the email component. */ public function get( $component, $replace_tags = false ) { $this->component = $component; $use_html = ( $this->use_html && 'body' === $component ); $exclude_blank = ( $this->exclude_blank && 'body' === $component ); $template = $this->template; $component = isset( $template[$component] ) ? $template[$component] : ''; if ( $replace_tags ) { $component = $this->replace_tags( $component, array( 'html' => $use_html, 'exclude_blank' => $exclude_blank, ) ); if ( $use_html ) { // Convert <example@example.com> to <example@example.com>. $component = preg_replace_callback( '/<(.*?)>/', static function ( $matches ) { if ( is_email( $matches[1] ) ) { return sprintf( '<%s>', $matches[1] ); } else { return $matches[0]; } }, $component ); if ( ! preg_match( '%<html[>\s].*</html>%is', $component ) ) { $component = $this->htmlize( $component ); } } } $this->component = ''; return $component; } /** * Creates HTML message body by adding the header and footer. * * @param string $body The body part of HTML. * @return string Formatted HTML. */ private function htmlize( $body ) { if ( $this->locale ) { $lang_atts = sprintf( ' %s', wpcf7_format_atts( array( 'dir' => wpcf7_is_rtl( $this->locale ) ? 'rtl' : 'ltr', 'lang' => str_replace( '_', '-', $this->locale ), ) ) ); } else { $lang_atts = ''; } $header = apply_filters( 'wpcf7_mail_html_header', '<!doctype html> <html xmlns="http://www.w3.org/1999/xhtml"' . $lang_atts . '> <head> <title>' . esc_html( $this->get( 'subject', true ) ) . '</title> </head> <body> ', $this ); $body = apply_filters( 'wpcf7_mail_html_body', $body, $this ); $footer = apply_filters( 'wpcf7_mail_html_footer', '</body> </html>', $this ); return $header . $body . $footer; } /** * Composes an email message and attempts to send it. * * @param bool $send Whether to attempt to send email. Default true. */ private function compose( $send = true ) { $components = array( 'subject' => $this->get( 'subject', true ), 'sender' => $this->get( 'sender', true ), 'body' => $this->get( 'body', true ), 'recipient' => $this->get( 'recipient', true ), 'additional_headers' => $this->get( 'additional_headers', true ), 'attachments' => $this->attachments(), ); $components = apply_filters( 'wpcf7_mail_components', $components, wpcf7_get_current_contact_form(), $this ); if ( ! $send ) { return $components; } $subject = wpcf7_strip_newline( $components['subject'] ); $sender = wpcf7_strip_newline( $components['sender'] ); $recipient = wpcf7_strip_newline( $components['recipient'] ); $body = $components['body']; $additional_headers = trim( $components['additional_headers'] ); $headers = "From: $sender\n"; if ( $this->use_html ) { $headers .= "Content-Type: text/html\n"; $headers .= "X-WPCF7-Content-Type: text/html\n"; } else { $headers .= "X-WPCF7-Content-Type: text/plain\n"; } if ( $additional_headers ) { $headers .= $additional_headers . "\n"; } $attachments = array_filter( (array) $components['attachments'], function ( $attachment ) { $path = path_join( WP_CONTENT_DIR, $attachment ); if ( ! wpcf7_is_file_path_in_content_dir( $path ) ) { wp_trigger_error( '', sprintf( /* translators: %s: Attachment file path. */ __( 'Failed to attach a file. %s is not in the allowed directory.', 'contact-form-7' ), $path ), E_USER_NOTICE ); return false; } if ( ! is_readable( $path ) or ! is_file( $path ) ) { wp_trigger_error( '', sprintf( /* translators: %s: Attachment file path. */ __( 'Failed to attach a file. %s is not a readable file.', 'contact-form-7' ), $path ), E_USER_NOTICE ); return false; } static $total_size = array(); if ( ! isset( $total_size[$this->name] ) ) { $total_size[$this->name] = 0; } $file_size = (int) @filesize( $path ); if ( 25 * MB_IN_BYTES < $total_size[$this->name] + $file_size ) { wp_trigger_error( '', __( 'Failed to attach a file. The total file size exceeds the limit of 25 megabytes.', 'contact-form-7' ), E_USER_NOTICE ); return false; } $total_size[$this->name] += $file_size; return true; } ); return wp_mail( $recipient, $subject, $body, $headers, $attachments ); } /** * Replaces mail-tags within the given text. */ public function replace_tags( $content, $options = '' ) { if ( true === $options ) { $options = array( 'html' => true ); } $options = wp_parse_args( $options, array( 'html' => false, 'exclude_blank' => false, ) ); return wpcf7_mail_replace_tags( $content, $options ); } /** * Creates an array of attachments based on uploaded files and local files. */ private function attachments( $template = null ) { if ( ! $template ) { $template = $this->get( 'attachments' ); } $attachments = array(); if ( $submission = WPCF7_Submission::get_instance() ) { $uploaded_files = $submission->uploaded_files(); foreach ( (array) $uploaded_files as $name => $paths ) { if ( false !== strpos( $template, "[{$name}]" ) ) { $attachments = array_merge( $attachments, (array) $paths ); } } } foreach ( explode( "\n", $template ) as $line ) { $line = trim( $line ); if ( '' === $line or '[' == substr( $line, 0, 1 ) ) { continue; } $attachments[] = path_join( WP_CONTENT_DIR, $line ); } if ( $submission = WPCF7_Submission::get_instance() ) { $attachments = array_merge( $attachments, (array) $submission->extra_attachments( $this->name ) ); } return $attachments; } } /** * Replaces all mail-tags within the given text content. * * @param string $content Text including mail-tags. * @param string|array $options Optional. Output options. * @return string Result of replacement. */ function wpcf7_mail_replace_tags( $content, $options = '' ) { $options = wp_parse_args( $options, array( 'html' => false, 'exclude_blank' => false, ) ); if ( is_array( $content ) ) { foreach ( $content as $key => $value ) { $content[$key] = wpcf7_mail_replace_tags( $value, $options ); } return $content; } $content = explode( "\n", $content ); foreach ( $content as $num => $line ) { $line = new WPCF7_MailTaggedText( $line, $options ); $replaced = $line->replace_tags(); if ( $options['exclude_blank'] ) { $replaced_tags = $line->get_replaced_tags(); if ( empty( $replaced_tags ) or array_filter( $replaced_tags, 'strlen' ) ) { $content[$num] = $replaced; } else { unset( $content[$num] ); // Remove a line. } } else { $content[$num] = $replaced; } } $content = implode( "\n", $content ); return $content; } add_action( 'phpmailer_init', 'wpcf7_phpmailer_init', 10, 1 ); /** * Adds custom properties to the PHPMailer object. */ function wpcf7_phpmailer_init( $phpmailer ) { $custom_headers = $phpmailer->getCustomHeaders(); $phpmailer->clearCustomHeaders(); $wpcf7_content_type = false; foreach ( (array) $custom_headers as $custom_header ) { $name = $custom_header[0]; $value = $custom_header[1]; if ( 'X-WPCF7-Content-Type' === $name ) { $wpcf7_content_type = trim( $value ); } else { $phpmailer->addCustomHeader( $name, $value ); } } if ( 'text/html' === $wpcf7_content_type ) { $phpmailer->msgHTML( $phpmailer->Body ); } elseif ( 'text/plain' === $wpcf7_content_type ) { $phpmailer->AltBody = ''; } } /** * Class that represents a single-line text including mail-tags. */ class WPCF7_MailTaggedText { private $html = false; private $callback = null; private $content = ''; private $replaced_tags = array(); /** * The constructor method. */ public function __construct( $content, $options = '' ) { $options = wp_parse_args( $options, array( 'html' => false, 'callback' => null, ) ); $this->html = (bool) $options['html']; if ( null !== $options['callback'] and is_callable( $options['callback'] ) ) { $this->callback = $options['callback']; } elseif ( $this->html ) { $this->callback = array( $this, 'replace_tags_callback_html' ); } else { $this->callback = array( $this, 'replace_tags_callback' ); } $this->content = $content; } /** * Retrieves mail-tags that have been replaced by this instance. * * @return array List of mail-tags replaced. */ public function get_replaced_tags() { return $this->replaced_tags; } /** * Replaces mail-tags based on regexp. */ public function replace_tags() { $regex = '/(\[?)\[[\t ]*' . '([a-zA-Z_][0-9a-zA-Z:._-]*)' // [2] = name . '((?:[\t ]+"[^"]*"|[\t ]+\'[^\']*\')*)' // [3] = values . '[\t ]*\](\]?)/'; return preg_replace_callback( $regex, $this->callback, $this->content ); } /** * Callback function for replacement. For HTML message body. */ private function replace_tags_callback_html( $matches ) { return $this->replace_tags_callback( $matches, true ); } /** * Callback function for replacement. */ private function replace_tags_callback( $matches, $html = false ) { // allow [[foo]] syntax for escaping a tag if ( $matches[1] == '[' and $matches[4] == ']' ) { return substr( $matches[0], 1, -1 ); } $tag = $matches[0]; $tagname = $matches[2]; $values = $matches[3]; $mail_tag = new WPCF7_MailTag( $tag, $tagname, $values ); $field_name = $mail_tag->field_name(); $submission = WPCF7_Submission::get_instance(); $submitted = $submission ? $submission->get_posted_data( $field_name ) : null; if ( $mail_tag->get_option( 'do_not_heat' ) ) { $submitted = wp_unslash( $_POST[$field_name] ?? '' ); } $replaced = $submitted; if ( null !== $replaced ) { if ( $format = $mail_tag->get_option( 'format' ) ) { $replaced = $this->format( $replaced, $format ); } $separator = ( 'body' === WPCF7_Mail::get_current_component_name() ) ? wp_get_list_item_separator() : ', '; $replaced = wpcf7_flat_join( $replaced, array( 'separator' => $separator, ) ); if ( $html ) { $replaced = esc_html( $replaced ); $replaced = wptexturize( $replaced ); } } if ( $form_tag = $mail_tag->corresponding_form_tag() ) { $type = $form_tag->type; $replaced = apply_filters( "wpcf7_mail_tag_replaced_{$type}", $replaced, $submitted, $html, $mail_tag ); } $replaced = apply_filters( 'wpcf7_mail_tag_replaced', $replaced, $submitted, $html, $mail_tag ); if ( null !== $replaced ) { $replaced = trim( $replaced ); $this->replaced_tags[$tag] = $replaced; return $replaced; } $special = apply_filters( 'wpcf7_special_mail_tags', null, $mail_tag->tag_name(), $html, $mail_tag ); if ( null !== $special ) { $this->replaced_tags[$tag] = $special; return $special; } return $tag; } /** * Formats string based on the formatting option in the form-tag. */ public function format( $original, $format ) { $original = (array) $original; foreach ( $original as $key => $value ) { if ( preg_match( '/^[0-9]{4}-[0-9]{2}-[0-9]{2}$/', $value ) ) { $datetime = date_create( $value, wp_timezone() ); if ( false !== $datetime ) { $original[$key] = wp_date( $format, $datetime->getTimestamp() ); } } } return $original; } }
Save Changes
Rename File
Rename