1#@!#!123s

: / home / aramrprl / www / wp-content / plugins / wpforms-lite / src / Lite / Emails /
Filename : Summaries.php
back
<?php
namespace WPForms\Lite\Emails;

use WPForms\Lite\Reports\EntriesCount;
use WPForms\Emails\Summaries as BaseSummaries;

/**
 * Email Summaries.
 *
 * @since 1.8.8
 */
class Summaries extends BaseSummaries {

	/**
	 * Whether counting entries is allowed for Lite users.
	 *
	 * @since 1.8.8
	 *
	 * @var bool
	 */
	private $allow_entries_count_lite;

	/**
	 * Constructor for the class.
	 * Initializes the object and registers the Lite weekly entries count cron schedule.
	 *
	 * @since 1.8.8
	 */
	public function __construct() {

		// phpcs:disable WPForms.PHP.ValidateHooks.InvalidHookName

		// Disabling this filter will prevent entries submission count from being updated.
		/** This filter is documented in /lite/wpforms-lite.php */
		$this->allow_entries_count_lite = apply_filters( 'wpforms_dash_widget_allow_entries_count_lite', true );

		// phpcs:enable WPForms.PHP.ValidateHooks.InvalidHookName

		parent::__construct();

		// Register the Lite weekly entries count cron schedule.
		$this->register_entries_count_schedule();
	}

	/**
	 * Hooks.
	 *
	 * @since 1.8.8
	 */
	public function hooks() {

		parent::hooks();

		// The following schedule is essential for the Lite version.
		// Regardless of the "Weekly Summaries" feature being disabled or enabled,
		// it ensures that entries numbers are consistently updated.
		if ( ! $this->allow_entries_count_lite ) {
			return;
		}

		add_action( 'wpforms_weekly_entries_count_cron', [ $this, 'entries_count_cron' ] );
	}

	/**
	 * Adjusts the Lite weekly entries count cron schedule.
	 *
	 * This function modifies the Lite weekly entries count cron schedule by reducing the interval by 5 seconds.
	 *
	 * @since      1.8.8
	 * @deprecated 1.9.1
	 *
	 * @param array $schedules WP cron schedules.
	 *
	 * @return array
	 */
	public function weekly_entries_count( $schedules ) {

		_deprecated_function( __METHOD__, '1.9.1 of the WPForms plugin' );

		$schedules['wpforms_weekly_entries_count'] = [
			'interval' => $this->get_next_launch_time() - time(),
			'display'  => esc_html__( 'Calculate WPForms Lite Weekly Entries Count', 'wpforms-lite' ),
		];

		return $schedules;
	}

	/**
	 * Run the cron job to update entries count for Lite users.
	 *
	 * This function retrieves the current entries count for Lite users, calculates the count for the
	 * previous week, and updates the necessary post meta data for trend calculations.
	 *
	 * @since 1.8.8
	 */
	public function entries_count_cron() {

		// Get entries count for Lite users.
		$entries = ( new EntriesCount() )->get_by_form();

		// Exit if there are no form entries to update.
		if ( empty( $entries ) ) {
			return;
		}

		foreach ( $entries as $form_id => &$form ) {
			// Set total entries count to the current count.
			$form['total'] = $form['count'];

			// Retrieve the previous week's count data from post meta.
			$previous_week_count = get_post_meta( $form_id, 'wpforms_entries_count_previous_week', true );

			// Continue to the next form if the count data is not valid.
			if ( ! is_array( $previous_week_count ) || count( $previous_week_count ) !== 3 ) {
				$prev_count_previous_week = $form['total'];

				// Set the previous week's count zero "0" if the form was published less than or equal to 7 days ago.
				if ( $this->is_form_created_in_7days( $form_id ) ) {
					$prev_count_previous_week = 0;
				}

				update_post_meta( $form_id, 'wpforms_entries_count_previous_week', [ $form['total'], $form['total'], $prev_count_previous_week ] );

				continue;
			}

			list( $total_previous_week, $count_previous_week ) = $previous_week_count;

			// Calculate count, count_previous_week, and trends.
			$form['count'] = $form['total'] - $total_previous_week;

			if ( count( array_unique( $previous_week_count ) ) === 1 ) {
				// If the previous week's count is the same as the current count, skip trends calculation.
				update_post_meta( $form_id, 'wpforms_entries_count_previous_week_skip_trends', true );
			} else {
				// If the previous week's count is different from the current count, calculate trends.
				delete_post_meta( $form_id, 'wpforms_entries_count_previous_week_skip_trends' );
			}

			// Update post meta data for trend calculations.
			update_post_meta( $form_id, 'wpforms_entries_count_previous_week', [ $form['total'], $form['count'], $count_previous_week ] );
		}
	}

	/**
	 * Get form entries.
	 *
	 * @since 1.8.8
	 *
	 * @return array
	 */
	protected function get_entries(): array {

		return ( new EntriesCount() )->get_form_trends();
	}

	/**
	 * Register entries count schedule.
	 *
	 * @since 1.8.8
	 */
	private function register_entries_count_schedule() {

		if ( ! $this->allow_entries_count_lite && wp_next_scheduled( 'wpforms_weekly_entries_count_cron' ) ) {
			wp_clear_scheduled_hook( 'wpforms_weekly_entries_count_cron' );

			return;
		}

		if ( $this->allow_entries_count_lite && ! wp_next_scheduled( 'wpforms_weekly_entries_count_cron' ) ) {
			// Since v1.9.1 we use a single event and manually reoccur it
			// because a recurring event cannot guarantee
			// its firing at the same time during WP_CLI execution.
			wp_schedule_single_event( $this->get_next_launch_time(), 'wpforms_weekly_entries_count_cron' );
		}
	}

	/**
	 * Get next Monday midnight with WordPress offset.
	 *
	 * @since 1.9.1
	 *
	 * @return int
	 */
	protected function get_next_launch_time(): int {

		$datetime = date_create( 'next monday', wp_timezone() );

		if ( ! $datetime ) {
			return time() + WEEK_IN_SECONDS;
		}

		return absint( $datetime->getTimestamp() );
	}

	/**
	 * Check if the given form_id was published less than or equal to 7 days ago.
	 *
	 * @since 1.8.8
	 *
	 * @param int $form_id The ID of the form (post).
	 *
	 * @return bool
	 */
	private function is_form_created_in_7days( int $form_id ): bool {

		// Get the form (post) publish date.
		$date_created = get_post_field( 'post_date', $form_id, 'raw' );

		// If the form date is not available, return false.
		if ( empty( $date_created ) ) {
			return false;
		}

		// Calculate the time difference between the post date and the current date.
		$time_difference = time() - strtotime( $date_created );

		// Compare the time difference with 7 days in seconds.
		return $time_difference <= 7 * DAY_IN_SECONDS;
	}
}