WP_Recovery_Mode_Email_Service

14#[AllowDynamicProperties]15final class WP_Recovery_Mode_Email_Service {16 17	const RATE_LIMIT_OPTION = 'recovery_mode_email_last_sent';18 19	/**20	 * Service to generate recovery mode URLs.21	 *22	 * @since 5.2.023	 * @var WP_Recovery_Mode_Link_Service24	 */25	private $link_service;26 27	/**28	 * WP_Recovery_Mode_Email_Service constructor.29	 *30	 * @since 5.2.031	 *32	 * @param WP_Recovery_Mode_Link_Service $link_service33	 */34	public function __construct( WP_Recovery_Mode_Link_Service $link_service ) {35		$this->link_service = $link_service;36	}37 38	/**39	 * Sends the recovery mode email if the rate limit has not been sent.40	 *41	 * @since 5.2.042	 *43	 * @param int   $rate_limit Number of seconds before another email can be sent.44	 * @param array $error      Error details from `error_get_last()`.45	 * @param array $extension {46	 *     The extension that caused the error.47	 *48	 *     @type string $slug The extension slug. The plugin or theme's directory.49	 *     @type string $type The extension type. Either 'plugin' or 'theme'.50	 * }51	 * @return true|WP_Error True if email sent, WP_Error otherwise.52	 */53	public function maybe_send_recovery_mode_email( $rate_limit, $error, $extension ) {54 55		$last_sent = get_option( self::RATE_LIMIT_OPTION );56 57		if ( ! $last_sent || time() > $last_sent + $rate_limit ) {58			if ( ! update_option( self::RATE_LIMIT_OPTION, time() ) ) {59				return new WP_Error( 'storage_error', __( 'Could not update the email last sent time.' ) );60			}61 62			$sent = $this->send_recovery_mode_email( $rate_limit, $error, $extension );63 64			if ( $sent ) {65				return true;66			}67 68			return new WP_Error(69				'email_failed',70				sprintf(71					/* translators: %s: mail() */72					__( 'The email could not be sent. Possible reason: your host may have disabled the %s function.' ),73					'mail()'74				)75			);76		}77 78		$err_message = sprintf(79			/* translators: 1: Last sent as a human time diff, 2: Wait time as a human time diff. */80			__( 'A recovery link was already sent %1$s ago. Please wait another %2$s before requesting a new email.' ),81			human_time_diff( $last_sent ),82			human_time_diff( $last_sent + $rate_limit )83		);84 85		return new WP_Error( 'email_sent_already', $err_message );86	}87 88	/**89	 * Clears the rate limit, allowing a new recovery mode email to be sent immediately.90	 *91	 * @since 5.2.092	 *93	 * @return bool True on success, false on failure.