<?php
/**
 * WP-Members Email API Functions
 * 
 * This file is part of the WP-Members plugin by Chad Butler
 * You can find out more about this plugin at https://rocketgeek.com
 * Copyright (c) 2006-2026  Chad Butler
 * WP-Members(tm) is a trademark of butlerblog.com
 *
 * @package WP-Members
 * @subpackage WP-Members API Functions
 * @author Chad Butler 
 * @copyright 2006-2026
 */

/**
 * Returns the wp_mail from address (if set).
 *
 * @since 2.7
 * @since 3.1 Converted to use email var in object.
 *
 * @global object $wpmem
 * @return string $wpmem_mail_from|$email
 */
function wpmem_mail_from() {
	global $wpmem;
	return $wpmem->email->from;
}

/**
 * Returns the wp_mail from name (if set).
 *
 * @since 2.7
 * @since 3.1 Converted to use email var in object.
 *
 * @global object $wpmem
 * @return string $wpmem_mail_from_name|$name
 */
function wpmem_mail_from_name() {
	global $wpmem;
	return $wpmem->email->from_name;
}

/** 
 * Returns the wp_mail content type (if set).
 *
 * @since 3.4.0
 *
 * @global object $wpmem
 * @return string $wpmem_mail_content_type
 *
 * @note Currently checks for existing function. Advanced Options set up for
 *       backward compatibility could potentially load first if wp-members directory
 *       is named something other than "wp-members".
 */
if ( ! function_exists( 'wpmem_mail_content_type' ) ):
function wpmem_mail_content_type( $content_type = 'text/plain' ) {
	global $wpmem;
	return $wpmem->email->content_type( $content_type );
}
endif;

/**
 * Builds emails for the user.
 *
 * @since 3.2.3
 *
 * @global object $wpmem         The WP_Members object.
 * @param  mixed  $args {
 *     Settings arguments or The User's ID.
 *
 *     @type int    $user_id
 *     @type string $password     Password from the registration process.
 *     @type string $tag          Indicates the email being sent (newreg|newmod|appmod|repass|getuser).
 *     @type array  $wpmem_fields Array of the WP-Members fields (deprecated)
 *     @type array  $fields       Array of the registration data
 *     @type array  $custom {
 *          Settings for custom email if used (optional).
 *
 *          @type string $subj The email subject.
 *          @type string $body The email message body.
 *          @type string $tag  The email tag.
 *      }
 * }
 * @param  string $password      Password from the registration process.
 * @param  string $tag           Indicates the email being sent (newreg|newmod|appmod|repass|getuser).
 * @param  array  $wpmem_fields  Array of the WP-Members fields (defaults to false).
 * @param  array  $fields        Array of the registration data (defaults to false).
 * @param  array  $custom {
 *     Array of custom email information (defaults to false).
 *
 *     @type string $subj The email subject.
 *     @type string $body The email message body.
 *     @type string $tag  The email tag.
 * }
 *
 * @todo Will probably change the WP_Members_Email::to_user() arguments to just accept the array.
 */
function wpmem_email_to_user( $args, $password = null, $tag = null, $wpmem_fields = null, $field_data = null, $custom = null ) {
	global $wpmem;
	if ( is_array( $args ) ) {
		$user_id      = $args['user_id'];
		$tag          = $args['tag'];
		$password     = ( isset( $args['password']     ) ) ? $args['password']     : '';
		$wpmem_fields = ( isset( $args['wpmem_fields'] ) ) ? $args['wpmem_fields'] : false;
		$field_data   = ( isset( $args['field_data']   ) ) ? $args['field_data']   : false;
		$custom       = ( isset( $args['custom']       ) ) ? $args['custom']       : false;
	} else {
		$user_id = $args;
	}
	$wpmem->email->to_user( $user_id, $password, $tag, $wpmem_fields, $field_data, $custom );
	return;
}

if ( ! function_exists( 'wpmem_notify_admin' ) ):
/**
 * Builds the email for admin notification of new user registration.
 *
 * @since 2.3
 * @since 3.2.3 Changed inputs.
 *
 * @global object $wpmem                The WP_Members object.
 * @param  mixed  $args                 Settings arguments or The User's ID.
 * @param  array  $wpmem_fields         Array of the WP-Members fields (defaults to null).
 * @param  array  $field_data           Array of the registration data (defaults to null).
 */
function wpmem_notify_admin( $args, $wpmem_fields = null, $field_data = null ) {
	global $wpmem;
	if ( is_array( $args ) ) {
		$user_id      = $args['user_id'];
		$wpmem_fields = $args['wpmem_fields'];
		$field_data   = $args['field_data'];
	} else {
		$user_id = $args;
	}
	$wpmem->email->notify_admin( $user_id, $wpmem_fields, $field_data );
}
endif;

/**
 * Checks for default email vals.
 * 
 * @since 3.5.0
 */
function wpmem_get_email_settings( $tag ) {
	global $wpmem;
	// Are there settings for this email?
	$saved_settings = get_option( $tag );
	return ( $saved_settings ) ? $saved_settings : $wpmem->email->get_default_email( $tag );
}