laipower/wp-content/plugins/easy-digital-downloads/includes/emails/functions.php

411 lines
14 KiB
PHP
Raw Normal View History

<?php
/**
* Email Functions
*
* @package EDD
* @subpackage Emails
* @copyright Copyright (c) 2018, Easy Digital Downloads, LLC
* @license http://opensource.org/licenses/gpl-2.0.php GNU Public License
* @since 1.0
*/
// Exit if accessed directly
defined( 'ABSPATH' ) || exit;
/**
* Email the download link(s) and payment confirmation to the buyer in a
* customizable Purchase Receipt
*
* @since 1.0
* @since 2.8 - Add parameters for EDD_Payment and EDD_Customer object.
*
* @param int $payment_id Payment ID
* @param bool $admin_notice Whether to send the admin email notification or not (default: true)
* @param EDD_Payment $payment Payment object for payment ID.
* @param EDD_Customer $customer Customer object for associated payment.
* @return bool Whether the email was sent successfully.
*/
function edd_email_purchase_receipt( $payment_id, $admin_notice = true, $to_email = '', $payment = null, $customer = null ) {
if ( is_null( $payment ) ) {
$payment = edd_get_payment( $payment_id );
}
$payment_data = $payment->get_meta( '_edd_payment_meta', true );
$from_name = edd_get_option( 'from_name', wp_specialchars_decode( get_bloginfo( 'name' ), ENT_QUOTES ) );
$from_name = apply_filters( 'edd_purchase_from_name', $from_name, $payment_id, $payment_data );
$from_email = edd_get_option( 'from_email', get_bloginfo( 'admin_email' ) );
$from_email = apply_filters( 'edd_purchase_from_address', $from_email, $payment_id, $payment_data );
if ( empty( $to_email ) ) {
$to_email = $payment->email;
}
$subject = edd_get_option( 'purchase_subject', __( 'Purchase Receipt', 'easy-digital-downloads' ) );
$subject = apply_filters( 'edd_purchase_subject', wp_strip_all_tags( $subject ), $payment_id );
$subject = wp_specialchars_decode( edd_do_email_tags( $subject, $payment_id ) );
$heading = edd_get_option( 'purchase_heading', __( 'Purchase Receipt', 'easy-digital-downloads' ) );
$heading = apply_filters( 'edd_purchase_heading', $heading, $payment_id, $payment_data );
$heading = edd_do_email_tags( $heading, $payment_id );
$attachments = apply_filters( 'edd_receipt_attachments', array(), $payment_id, $payment_data );
$message = edd_do_email_tags( edd_get_email_body_content( $payment_id, $payment_data ), $payment_id );
$emails = EDD()->emails;
$emails->__set( 'from_name', $from_name );
$emails->__set( 'from_email', $from_email );
$emails->__set( 'heading', $heading );
$headers = apply_filters( 'edd_receipt_headers', $emails->get_headers(), $payment_id, $payment_data );
$emails->__set( 'headers', $headers );
$sent = $emails->send( $to_email, $subject, $message, $attachments );
if ( $admin_notice && ! edd_admin_notices_disabled( $payment_id ) ) {
do_action( 'edd_admin_sale_notice', $payment_id, $payment_data );
}
return $sent;
}
/**
* Email the download link(s) and payment confirmation to the admin accounts for testing.
*
* @since 1.5
* @return void
*/
function edd_email_test_purchase_receipt() {
$from_name = edd_get_option( 'from_name', wp_specialchars_decode( get_bloginfo( 'name' ), ENT_QUOTES ) );
$from_name = apply_filters( 'edd_purchase_from_name', $from_name, 0, array() );
$from_email = edd_get_option( 'from_email', get_bloginfo( 'admin_email' ) );
$from_email = apply_filters( 'edd_test_purchase_from_address', $from_email, 0, array() );
$subject = edd_get_option( 'purchase_subject', __( 'Purchase Receipt', 'easy-digital-downloads' ) );
$subject = apply_filters( 'edd_purchase_subject', wp_strip_all_tags( $subject ), 0 );
$subject = wp_specialchars_decode( edd_do_email_tags( $subject, 0 ) );
$heading = edd_get_option( 'purchase_heading', __( 'Purchase Receipt', 'easy-digital-downloads' ) );
$heading = edd_email_preview_template_tags( apply_filters( 'edd_purchase_heading', $heading, 0, array() ) );
$attachments = apply_filters( 'edd_receipt_attachments', array(), 0, array() );
$message = edd_email_preview_template_tags( edd_get_email_body_content( 0, array() ), 0 );
$emails = EDD()->emails;
$emails->__set( 'from_name' , $from_name );
$emails->__set( 'from_email', $from_email );
$emails->__set( 'heading' , $heading );
$headers = apply_filters( 'edd_receipt_headers', $emails->get_headers(), 0, array() );
$emails->__set( 'headers', $headers );
$emails->send( edd_get_admin_notice_emails(), $subject, $message, $attachments );
}
/**
* Sends the Admin Sale Notification Email
*
* @since 1.4.2
* @param int $payment_id Payment ID (default: 0)
* @param array $payment_data Payment Meta and Data
* @return void
*/
function edd_admin_email_notice( $payment_id = 0, $payment_data = array() ) {
$payment_id = absint( $payment_id );
if( empty( $payment_id ) ) {
return;
}
if( ! edd_get_payment_by( 'id', $payment_id ) ) {
return;
}
$from_name = edd_get_option( 'from_name', wp_specialchars_decode( get_bloginfo( 'name' ), ENT_QUOTES ) );
$from_name = apply_filters( 'edd_purchase_from_name', $from_name, $payment_id, $payment_data );
$from_email = edd_get_option( 'from_email', get_bloginfo( 'admin_email' ) );
$from_email = apply_filters( 'edd_admin_sale_from_address', $from_email, $payment_id, $payment_data );
$subject = edd_get_option( 'sale_notification_subject', sprintf( __( 'New download purchase - Order #%1$s', 'easy-digital-downloads' ), $payment_id ) );
$subject = apply_filters( 'edd_admin_sale_notification_subject', wp_strip_all_tags( $subject ), $payment_id );
$subject = wp_specialchars_decode( edd_do_email_tags( $subject, $payment_id ) );
$heading = edd_get_option( 'sale_notification_heading', __( 'New Sale!', 'easy-digital-downloads' ) );
$heading = apply_filters( 'edd_admin_sale_notification_heading', $heading, $payment_id, $payment_data );
$heading = edd_do_email_tags( $heading, $payment_id );
$attachments = apply_filters( 'edd_admin_sale_notification_attachments', array(), $payment_id, $payment_data );
$message = edd_get_sale_notification_body_content( $payment_id, $payment_data );
$emails = EDD()->emails;
$emails->__set( 'from_name', $from_name );
$emails->__set( 'from_email', $from_email );
$emails->__set( 'heading', $heading );
$headers = apply_filters( 'edd_admin_sale_notification_headers', $emails->get_headers(), $payment_id, $payment_data );
$emails->__set( 'headers', $headers );
$emails->send( edd_get_admin_notice_emails(), $subject, $message, $attachments );
}
add_action( 'edd_admin_sale_notice', 'edd_admin_email_notice', 10, 2 );
/**
* Retrieves the emails for which admin notifications are sent to (these can be
* changed in the EDD Settings)
*
* @since 1.0
* @return mixed
*/
function edd_get_admin_notice_emails() {
$emails = edd_get_option( 'admin_notice_emails', false );
$emails = strlen( trim( $emails ) ) > 0 ? $emails : get_bloginfo( 'admin_email' );
$emails = array_map( 'trim', explode( "\n", $emails ) );
return apply_filters( 'edd_admin_notice_emails', $emails );
}
/**
* Checks whether admin sale notices are disabled
*
* @since 1.5.2
*
* @param int $payment_id
* @return mixed
*/
function edd_admin_notices_disabled( $payment_id = 0 ) {
$ret = edd_get_option( 'disable_admin_notices', false );
return (bool) apply_filters( 'edd_admin_notices_disabled', $ret, $payment_id );
}
/**
* Get sale notification email text
*
* Returns the stored email text if available, the standard email text if not
*
* @since 1.7
* @author Daniel J Griffiths
* @return string $message
*/
function edd_get_default_sale_notification_email() {
$default_email_body = __( 'Hello', 'easy-digital-downloads' ) . "\n\n" . sprintf( __( 'A %s purchase has been made', 'easy-digital-downloads' ), edd_get_label_plural() ) . ".\n\n";
$default_email_body .= sprintf( __( '%s sold:', 'easy-digital-downloads' ), edd_get_label_plural() ) . "\n\n";
$default_email_body .= '{download_list}' . "\n\n";
$default_email_body .= __( 'Purchased by: ', 'easy-digital-downloads' ) . ' {name}' . "\n";
$default_email_body .= __( 'Amount: ', 'easy-digital-downloads' ) . ' {price}' . "\n";
$default_email_body .= __( 'Payment Method: ', 'easy-digital-downloads' ) . ' {payment_method}' . "\n\n";
$default_email_body .= __( 'Thank you', 'easy-digital-downloads' );
$message = edd_get_option( 'sale_notification', false );
$message = ! empty( $message ) ? $message : $default_email_body;
return $message;
}
/**
* Get various correctly formatted names used in emails
*
* @since 1.9
* @param $user_info
* @param $payment EDD_Payment for getting the names
*
* @return array $email_names
*/
function edd_get_email_names( $user_info, $payment = false ) {
$email_names = array();
$email_names['fullname'] = '';
if ( $payment instanceof EDD_Payment ) {
$email_names['name'] = $payment->email;
$email_names['username'] = $payment->email;
if ( $payment->user_id > 0 ) {
$user_data = get_userdata( $payment->user_id );
$email_names['name'] = $payment->first_name;
$email_names['fullname'] = trim( $payment->first_name . ' ' . $payment->last_name );
if ( ! empty( $user_data->user_login ) ) {
$email_names['username'] = $user_data->user_login;
}
} elseif ( ! empty( $payment->first_name ) ) {
$email_names['name'] = $payment->first_name;
$email_names['fullname'] = trim( $payment->first_name . ' ' . $payment->last_name );
$email_names['username'] = $payment->first_name;
}
} else {
if ( is_serialized( $user_info ) ) {
preg_match( '/[oO]\s*:\s*\d+\s*:\s*"\s*(?!(?i)(stdClass))/', $user_info, $matches );
if ( ! empty( $matches ) ) {
return array(
'name' => '',
'fullname' => '',
'username' => '',
);
} else {
$user_info = maybe_unserialize( $user_info );
}
}
if ( isset( $user_info['id'] ) && $user_info['id'] > 0 && isset( $user_info['first_name'] ) ) {
$user_data = get_userdata( $user_info['id'] );
$email_names['name'] = $user_info['first_name'];
$email_names['fullname'] = $user_info['first_name'] . ' ' . $user_info['last_name'];
$email_names['username'] = $user_data->user_login;
} elseif ( isset( $user_info['first_name'] ) ) {
$email_names['name'] = $user_info['first_name'];
$email_names['fullname'] = $user_info['first_name'] . ' ' . $user_info['last_name'];
$email_names['username'] = $user_info['first_name'];
} else {
$email_names['name'] = $user_info['email'];
$email_names['username'] = $user_info['email'];
}
}
return $email_names;
}
/**
* Handle installation and connection for Recapture via ajax
*
* @since 2.10.2
*/
function edd_recapture_remote_install_handler () {
if ( ! current_user_can( 'manage_shop_settings' ) || ! current_user_can( 'install_plugins' ) ) {
wp_send_json_error( array(
'error' => __( 'You do not have permission to do this.', 'easy-digital-downloads' )
) );
}
include_once ABSPATH . 'wp-admin/includes/plugin-install.php';
include_once ABSPATH . 'wp-admin/includes/file.php';
include_once ABSPATH . 'wp-admin/includes/class-wp-upgrader.php';
$plugins = get_plugins();
if( ! array_key_exists( 'recapture-for-edd/recapture.php', $plugins ) ) {
/*
* Use the WordPress Plugins API to get the plugin download link.
*/
$api = plugins_api( 'plugin_information', array(
'slug' => 'recapture-for-edd',
) );
if ( is_wp_error( $api ) ) {
wp_send_json_error( array(
'error' => $api->get_error_message(),
'debug' => $api
) );
}
/*
* Use the AJAX Upgrader skin to quietly install the plugin.
*/
$upgrader = new Plugin_Upgrader( new WP_Ajax_Upgrader_Skin() );
$install = $upgrader->install( $api->download_link );
if ( is_wp_error( $install ) ) {
wp_send_json_error( array(
'error' => $install->get_error_message(),
'debug' => $api
) );
}
$activated = activate_plugin( $upgrader->plugin_info() );
} else {
$activated = activate_plugin( 'recapture-for-edd/recapture.php' );
}
/*
* Final check to see if Recapture is available.
*/
if ( is_wp_error( $activated ) ) {
wp_send_json_error( array(
'error' => __( 'Something went wrong. Recapture for EDD was not installed correctly.', 'easy-digital-downloads' )
) );
}
wp_send_json_success();
}
add_action( 'wp_ajax_edd_recapture_remote_install', 'edd_recapture_remote_install_handler' );
/**
* Maybe adds a notice to abandoned payments if Recapture isn't installed.
*
* @since 2.10.2
*
* @param int $payment_id The ID of the abandoned payment, for which a Recapture notice is being thrown.
*/
function maybe_add_recapture_notice_to_abandoned_payment( $payment_id ) {
if ( ! class_exists( 'Recapture' )
&& 'abandoned' === edd_get_payment_status( $payment_id )
&& ! get_user_meta( get_current_user_id(), '_edd_try_recapture_dismissed', true )
) {
?>
<div class="notice notice-warning recapture-notice">
<p>
<?php
echo wp_kses_post(
sprintf(
/* Translators: %1$s - <strong> tag, %2$s - </strong> tag, %3$s - <a> tag, %4$s - </a> tag */
__( '%1$sRecover abandoned purchases like this one.%2$s %3$sTry Recapture for free%4$s.', 'easy-digital-downloads' ),
'<strong>',
'</strong>',
'<a href="https://recapture.io/abandoned-carts-easy-digital-downloads" rel="noopener" target="_blank">',
'</a>'
)
);
?>
</p>
<?php
echo wp_kses_post(
sprintf(
/* Translators: %1$s - Opening anchor tag, %2$s - The url to dismiss the ajax notice, %3$s - Complete the opening of the anchor tag, %4$s - Open span tag, %4$s - Close span tag */
__( '%1$s %2$s %3$s %4$s Dismiss this notice. %5$s', 'easy-digital-downloads' ),
'<a href="',
esc_url(
wp_nonce_url(
add_query_arg(
array(
'edd_action' => 'dismiss_notices',
'edd_notice' => 'try_recapture',
)
),
'edd_notice_nonce'
)
),
'" type="button" class="notice-dismiss">',
'<span class="screen-reader-text">',
'</span>
</a>'
)
);
?>
</div>
<?php
}
}
add_action( 'edd_view_order_details_before', 'maybe_add_recapture_notice_to_abandoned_payment' );