/** * Get the data being exported * * @access public * @since 1.3 * @return array $data Data for Export */ public function get_data() { $args = array('status' => $this->status, 'number' => -1); $data = array(); $affiliates = affiliate_wp()->affiliates->get_affiliates($args); if ($affiliates) { foreach ($affiliates as $affiliate) { $data[] = array('affiliate_id' => $affiliate->affiliate_id, 'email' => affwp_get_affiliate_email($affiliate->affiliate_id), 'payment_email' => affwp_get_affiliate_payment_email($affiliate->affiliate_id), 'username' => affwp_get_affiliate_login($affiliate->affiliate_id), 'rate' => affwp_get_affiliate_rate($affiliate->affiliate_id), 'rate_type' => affwp_get_affiliate_rate_type($affiliate->affiliate_id), 'earnings' => $affiliate->earnings, 'referrals' => $affiliate->referrals, 'visits' => $affiliate->visits, 'status' => $affiliate->status, 'date_registered' => $affiliate->date_registered); } } $data = apply_filters('affwp_export_get_data', $data); $data = apply_filters('affwp_export_get_data_' . $this->export_type, $data); return $data; }
/** * Get the data being exported * * @access public * @since 1.0 * @return array $data Data for Export */ public function get_data() { $args = array('status' => 'unpaid', 'date' => !empty($this->date) ? $this->date : '', 'number' => -1); // Final data to be exported $data = array(); // The affiliates that have earnings to be paid $affiliates = array(); // The list of referrals that are possibly getting marked as paid $to_maybe_pay = array(); // Retrieve the referrals from the database $referrals = affiliate_wp()->referrals->get_referrals($args); // The minimum payout amount $minimum = !empty($_POST['minimum']) ? sanitize_text_field(affwp_sanitize_amount($_POST['minimum'])) : 0; if ($referrals) { foreach ($referrals as $referral) { if (in_array($referral->affiliate_id, $affiliates)) { // Add the amount to an affiliate that already has a referral in the export $amount = $data[$referral->affiliate_id]['amount'] + $referral->amount; $data[$referral->affiliate_id]['amount'] = $amount; } else { $email = affwp_get_affiliate_email($referral->affiliate_id); $data[$referral->affiliate_id] = array('email' => $email, 'amount' => $referral->amount, 'currency' => !empty($referral->currency) ? $referral->currency : affwp_get_currency()); $affiliates[] = $referral->affiliate_id; } // Add the referral to the list of referrals to maybe payout if (!array_key_exists($referral->affiliate_id, $to_maybe_pay)) { $to_maybe_pay[$referral->affiliate_id] = array(); } $to_maybe_pay[$referral->affiliate_id][] = $referral->referral_id; } // Now determine which affiliates are above the minimum payout amount if ($minimum > 0) { foreach ($data as $affiliate_id => $payout) { if ($payout['amount'] < $minimum) { unset($data[$affiliate_id]); unset($to_maybe_pay[$affiliate_id]); } } } // We now know which referrals should be marked as paid foreach ($to_maybe_pay as $referral_list) { foreach ($referral_list as $referral_id) { affwp_set_referral_status($referral_id, 'paid'); } } } $data = apply_filters('affwp_export_get_data', $data); $data = apply_filters('affwp_export_get_data_' . $this->export_type, $data); return $data; }
/** * Get the data being exported * * @access public * @since 1.0 * @return array $data Data for Export */ public function get_data() { $args = array('status' => $this->status, 'date' => !empty($this->date) ? $this->date : '', 'affiliate_id' => $this->affiliate, 'number' => -1); $data = array(); $affiliates = array(); $referral_ids = array(); $referrals = affiliate_wp()->referrals->get_referrals($args); if ($referrals) { foreach ($referrals as $referral) { $data[] = array('affiliate_id' => $referral->affiliate_id, 'email' => affwp_get_affiliate_email($referral->affiliate_id), 'payment_email' => affwp_get_affiliate_payment_email($referral->affiliate_id), 'amount' => $referral->amount, 'currency' => $referral->currency, 'campaign' => $referral->campaign, 'reference' => $referral->reference, 'context' => $referral->context, 'status' => $referral->status, 'date' => $referral->date); } } $data = apply_filters('affwp_export_get_data', $data); $data = apply_filters('affwp_export_get_data_' . $this->export_type, $data); return $data; }
/** * Plugin Name: AffiliateWP - Email Affiliate When Referral Paid * Plugin URI: http://affiliatewp.com * Description: Sends an email to the affiliate when a referral has been paid * Author: Andrew Munro * Author URI: http://affiliatewp.com * Version: 1.0 */ function affwp_eawrp_affiliate_referral_paid_email($referral_id, $new_status, $old_status) { if (!function_exists('affiliate_wp') || ('paid' != $new_status || 'unpaid' != $old_status)) { return; } $referral = affiliate_wp()->referrals->get_by('referral_id', $referral_id); $affiliate_id = $referral->affiliate_id; $affiliate_email = affwp_get_affiliate_email($affiliate_id); $amount = html_entity_decode(affwp_currency_filter($referral->amount), ENT_COMPAT, 'UTF-8'); $date = date_i18n(get_option('date_format'), strtotime($referral->date)); // email subject $subject = sprintf('Congratulations, your referral for %s has just been paid', $amount); // email body $message = affwp_eawrp_affiliate_referral_paid_email_body($affiliate_id, $amount, $date); // send mail affiliate_wp()->emails->send($affiliate_email, $subject, $message); }
/** * Store a pending referral when a new order is created * * @access public * @since 1.6 */ public function add_pending_referral($order_id, $cart, $order_totals, $user, $payment_type) { if ($this->was_referred()) { if (affwp_get_affiliate_email($this->affiliate_id) == $user->email) { return false; // Customers cannot refer themselves } if (affiliate_wp()->referrals->get_by('reference', $order_id, $this->context)) { return false; // Referral already created for this reference } $cart_shipping = $order_totals->shipping_total; $cart_tax = $order_totals->tax_total; $items = $cart->cart; // Calculate the referral amount based on product prices $amount = 0.0; foreach ($items as $cart_item) { if ($cart_item->has_affiliate_rule) { continue; // Referrals are disabled on this product } // The order discount has to be divided across the items $product_total = $cart_item->total_price; $shipping = 0; if ($cart_shipping > 0 && !affiliate_wp()->settings->get('exclude_shipping')) { $shipping = $cart_shipping / count($items); $product_total += $shipping; } if ($cart_tax > 0 && !affiliate_wp()->settings->get('exclude_tax')) { $tax = $cart_tax / count($items); $product_total += $tax; } if ($product_total <= 0) { continue; } $amount += $this->calculate_referral_amount($product_total, $order_id, $cart_item->product_id); } if (0 == $amount && affiliate_wp()->settings->get('ignore_zero_referrals')) { return false; // Ignore a zero amount referral } $description = $this->get_referral_description($cart->cart); $visit_id = affiliate_wp()->tracking->get_visit_id(); $referral_id = affiliate_wp()->referrals->add(apply_filters('affwp_insert_pending_referral', array('amount' => $amount, 'reference' => $order_id, 'description' => $description, 'affiliate_id' => $this->affiliate_id, 'visit_id' => $visit_id, 'context' => $this->context), $amount, $order_id, $description, $this->affiliate_id, $visit_id, array(), $this->context)); } }
/** * Email the affiliate * Referrals must be "paid" before they will count towards the total referral count */ function affwp_referral_progress_emails($referral_id, $new_status, $old_status) { // only count paid referrals if (!function_exists('affiliate_wp') || 'paid' != $new_status) { return; } // set up referral count goals // this would send an email on the 5th, 10th, 20th and 50th paid referral $referral_goals = array(5, 10, 20, 50); // get referral $referral = affwp_get_referral($referral_id); // get affiliate ID $affiliate_id = $referral->affiliate_id; // get the referral count for the affiliate $referral_count = affiliate_wp()->affiliates->get_column('referrals', $affiliate_id); // only send email if referral goal has been reached if (!in_array($referral_count, $referral_goals)) { return; } // return if no affiliate ID or no referral if (empty($affiliate_id) || empty($referral)) { return; } // set up email $emails = new Affiliate_WP_Emails(); $emails->__set('affiliate_id', $affiliate_id); $emails->__set('referral', $referral); // get the affiliate's email address $email = affwp_get_affiliate_email($affiliate_id); // get affiliate's name $name = affiliate_wp()->affiliates->get_affiliate_name($affiliate_id); // set the email subject $subject = sprintf(__('Woohoo! You have reached %s referrals!', 'affiliate-wp'), $referral_count); // set the message $message = sprintf(__('Congratulations %s!', 'affiliate-wp'), $name) . "\n\n"; $message .= sprintf(__('You\'ve reached a total of %s paid referrals! Keep going, you\'re doing great!', 'affiliate-wp'), $referral_count) . "\n\n"; $message .= sprintf(__('Log in to your affiliate area to check your progress: %s', 'affiliate-wp'), affiliate_wp()->login->get_login_url()) . "\n\n"; // send the email $emails->send($email, $subject, $message); }
/** * Plugin Name: AffiliateWP - Custom Admin Registration Email * Plugin URI: http://affiliatewp.com * Description: Adds the Affiliate's Email and Affiliate ID to the admin registration email * Author: Andrew Munro * Author URI: http://affiliatewp.com * Version: 1.0 */ function affwp_custom_registration_email($message, $args) { $user_info = get_userdata(affwp_get_affiliate_user_id($args['affiliate_id'])); $user_url = $user_info->user_url; $promotion_method = get_user_meta(affwp_get_affiliate_user_id($args['affiliate_id']), 'affwp_promotion_method', true); $message = "A new affiliate has registered on your site, " . home_url() . "\n\n"; $message .= sprintf(__('Name: %s', 'affiliate-wp'), $args['name']) . "\n\n"; // Affiliate's Email Address $message .= sprintf(__('Email: %s', 'affiliate-wp'), affwp_get_affiliate_email($args['affiliate_id'])) . "\n\n"; // Affiliate's ID $message .= sprintf(__('Affiliate ID: %s', 'affiliate-wp'), $args['affiliate_id']) . "\n\n"; if ($user_url) { $message .= __('Website URL: ', 'affiliate-wp') . esc_url($user_url) . "\n\n"; } if ($promotion_method) { $message .= __('Promotion method: ', 'affiliate-wp') . esc_attr($promotion_method) . "\n\n"; } if (affiliate_wp()->settings->get('require_approval')) { $message .= sprintf("Review pending applications: %s\n\n", admin_url('admin.php?page=affiliate-wp-affiliates&status=pending')); } return $message; }
<?php $affiliate_id = affwp_get_affiliate_id(); $user_email = affwp_get_affiliate_email($affiliate_id); $payment_email = affwp_get_affiliate_payment_email($affiliate_id, $user_email); // Fallback to user_email ?> <div id="affwp-affiliate-dashboard-profile" class="affwp-tab-content"> <h4><?php _e('Profile Settings', 'affiliate-wp'); ?> </h4> <form id="affwp-affiliate-dashboard-profile-form" class="affwp-form" method="post"> <div class="affwp-wrap affwp-payment-email-wrap"> <label for="affwp-payment-email"><?php _e('Your payment email', 'affiliate-wp'); ?> </label> <input id="affwp-payment-email" type="email" name="payment_email" value="<?php echo esc_attr($payment_email); ?> " /> </div> <div class="affwp-wrap affwp-send-notifications-wrap"> <input id="affwp-referral-notifications" type="checkbox" name="referral_notifications" value="1" <?php checked(true, get_user_meta(affwp_get_affiliate_user_id($affiliate_id), 'affwp_referral_notifications', true));
/** * Send email on new referrals * * @since 1.6 * @param int $affiliate_id The ID of the registered affiliate * @param array $referral */ function affwp_notify_on_new_referral($affiliate_id = 0, $referral) { $user_id = affwp_get_affiliate_user_id($affiliate_id); if (!get_user_meta($user_id, 'affwp_referral_notifications', true)) { return; } if (empty($affiliate_id)) { return; } if (empty($referral)) { return; } $emails = new Affiliate_WP_Emails(); $emails->__set('affiliate_id', $affiliate_id); $emails->__set('referral', $referral); $email = affwp_get_affiliate_email($affiliate_id); $subject = affiliate_wp()->settings->get('referral_subject', __('Referral Awarded!', 'affiliate-wp')); $message = affiliate_wp()->settings->get('referral_email', false); $amount = html_entity_decode(affwp_currency_filter($referral->amount), ENT_COMPAT, 'UTF-8'); if (!$message) { $message = sprintf(__('Congratulations %s!', 'affiliate-wp'), affiliate_wp()->affiliates->get_affiliate_name($affiliate_id)) . "\n\n"; $message .= sprintf(__('You have been awarded a new referral of %s on %s!', 'affiliate-wp'), $amount, home_url()) . "\n\n"; $message .= sprintf(__('log into your affiliate area to view your earnings or disable these notifications: %s', 'affiliate-wp'), affiliate_wp()->login->get_login_url()) . "\n\n"; } // $args is setup for backwards compatibility with < 1.6 $args = array('affiliate_id' => $affiliate_id, 'amount' => $referral->amount, 'referral' => $referral); $subject = apply_filters('affwp_new_referral_subject', $subject, $args); $message = apply_filters('affwp_new_referral_email', $message, $args); if (apply_filters('affwp_notify_on_new_referral', true, $referral)) { $emails->send($email, $subject, $message); } }
<div id="affwp-affiliate-dashboard-profile" class="affwp-tab-content p20 bg-white"> <h4><?php _e('Profile Settings', 'affiliate-wp'); ?> </h4> <form id="affwp-affiliate-dashboard-profile-form" class="affwp-form" method="post"> <div class="affwp-wrap affwp-payment-email-wrap"> <label for="affwp-payment-email"><?php _e('Your payment email', 'affiliate-wp'); ?> </label> <input id="affwp-payment-email" class="w-50" type="email" name="payment_email" value="<?php echo esc_attr(affwp_get_affiliate_email(affwp_get_affiliate_id())); ?> " /> </div> <div class="affwp-wrap affwp-send-notifications-wrap"> <input id="affwp-referral-notifications" type="checkbox" name="referral_notifications" value="1"<?php checked(true, get_user_meta(affwp_get_affiliate_user_id(affwp_get_affiliate_id()), 'affwp_referral_notifications', true)); ?> /> <label for="affwp-referral-notifications"><?php _e('Enable New Referral Notifications', 'affiliate-wp'); ?> </label> </div> <?php
function test_get_affiliate_email() { $this->assertEquals('*****@*****.**', affwp_get_affiliate_email($this->_affiliate_id)); $args = array('affiliate_id' => $this->_affiliate_id, 'payment_email' => '*****@*****.**'); affwp_update_affiliate($args); $this->assertEquals('*****@*****.**', affwp_get_affiliate_email($this->_affiliate_id)); }
/** * Determine if the passed email belongs to the affiliate * * Checks a given email address against the referring affiliate's * user email and payment email addresses to prevent customers from * referring themselves. * * @access public * @since 1.6 * @param string $email * @return bool */ public function is_affiliate_email($email) { $is_affiliate_email = false; // Get affiliate emails $user_email = affwp_get_affiliate_email($this->affiliate_id); $payment_email = affwp_get_affiliate_payment_email($this->affiliate_id); // True if the email is valid and matches affiliate user email or payment email, otherwise false $is_affiliate_email = is_email($email) && ($user_email === $email || $payment_email === $email); return (bool) apply_filters('affwp_is_customer_email_affiliate_email', $is_affiliate_email, $email, $this->affiliate_id); }
/** * Determine if the passed email belongs to the affiliate * * Checks a given email address against the referring affiliate's * user email and payment email addresses to prevent customers from * referring themselves. * * @access public * @since 1.6 * @param string $email * @return bool */ public function is_affiliate_email($email, $affiliate_id = 0) { $is_affiliate_email = false; // allow an affiliate ID to be passed in $affiliate_id = isset($affiliate_id) ? $affiliate_id : $this->get_affiliate_id(); // Get affiliate emails $user_email = affwp_get_affiliate_email($affiliate_id); $payment_email = affwp_get_affiliate_payment_email($affiliate_id); // True if the email is valid and matches affiliate user email or payment email, otherwise false $is_affiliate_email = is_email($email) && ($user_email === $email || $payment_email === $email); return (bool) apply_filters('affwp_is_customer_email_affiliate_email', $is_affiliate_email, $email, $affiliate_id); }
/** * Get the affiliate's gravatar * * @since 1.0.0 */ public function get_affiliate_gravatar() { $affiliate_id = $this->get_affiliate_id(); if ($affiliate_id) { $args = apply_filters('affwp_affiliate_info_gravatar_defaults', array('size' => 96, 'default' => '', 'alt' => $this->get_affiliate_name())); $email = affwp_get_affiliate_email($affiliate_id); return get_avatar(affwp_get_affiliate_user_id($affiliate_id), $args['size'], $args['default'], $args['alt']); } return false; }
/** * Retrieves the email address of the referring affiliate * * @access public * @since 1.0 * @return string */ public function get_affiliate_email() { return affwp_get_affiliate_email($this->get_affiliate_id()); }
/** * Retrieves the affiliate's payment email address * * @since 1.7 * @param object|int $affiliate * @return mixed */ function affwp_get_affiliate_payment_email($affiliate) { $affiliate = is_numeric($affiliate) ? affwp_get_affiliate($affiliate) : $affiliate; if (empty($affiliate->payment_email) || !is_email($affiliate->payment_email)) { return affwp_get_affiliate_email($affiliate); } return $affiliate->payment_email; }
/** * Email template tag: user_email * The affiliate's email * * @param int $affiliate_id * @return string email */ function affwp_email_tag_user_email($affiliate_id = 0) { return affwp_get_affiliate_email($affiliate_id); }
function test_get_affiliate_email() { $args = array('affiliate_id' => $this->_affiliate_id, 'account_email' => '*****@*****.**'); affwp_update_affiliate($args); $this->assertEquals('*****@*****.**', affwp_get_affiliate_email($this->_affiliate_id)); }