<?php

namespace WP_STATISTICS;

use Exception;
use WP_STATISTICS;
use ErrorException;
use WP_Statistics\Components\DateRange;
use WP_Statistics\Models\PostsModel;
use WP_Statistics_Mail;
use WP_Statistics\Utils\Request;
use WP_Statistics\Utils\Signature;
use WP_Statistics\Components\DateTime;
use WP_Statistics\Service\Integrations\IntegrationHelper;

class Helper
{
    /**
     * Returns an array of site id's
     *
     * @return array
     */
    public static function get_wp_sites_list()
    {
        $site_list = array();
        $sites     = get_sites();
        foreach ($sites as $site) {
            $site_list[] = $site->blog_id;
        }
        return $site_list;
    }

    /**
     * What type of request is this?
     *
     * @param string $type admin, ajax, cron or frontend.
     * @return bool
     * @deprecated This method should move to WP_Statistics\Utils\Request::from()
     */
    public static function is_request($type)
    {
        switch ($type) {
            case 'admin':
                return is_admin();
            case 'ajax':
                return defined('DOING_AJAX');
            case 'cron':
                return defined('DOING_CRON');
            case 'wp-cli':
                return defined('WP_CLI') && WP_CLI;
            case 'frontend':
                return (!is_admin() || defined('DOING_AJAX')) && !defined('DOING_CRON') && !self::is_rest_request();
        }
    }

    /**
     * Returns true if the request is a non-legacy REST API request.
     *
     * @return bool
     */
    public static function is_rest_request()
    {
        if (empty($_SERVER['REQUEST_URI'])) {
            return false;
        }

        // Backward-Compatibility with Bypass Ad Blockers option
        if (self::isBypassAdBlockersRequest()) {
            return true;
        }

        $rest_prefix = trailingslashit(rest_get_url_prefix());
        return (false !== strpos($_SERVER['REQUEST_URI'], $rest_prefix)) or isset($_REQUEST['rest_route']);
    }

    /**
     * Returns true if the request belongs to "Bypass Ad Blockers" feature.
     *
     * @return  bool
     */
    public static function isBypassAdBlockersRequest()
    {
        return (Request::compare('action', 'wp_statistics_hit_record') || Request::compare('action', 'wp_statistics_online_check'));
    }

    /**
     * Check is Login Page
     *
     * @return bool
     */
    public static function is_login_page()
    {
        // Check From global WordPress
        if (isset($GLOBALS['pagenow']) and in_array($GLOBALS['pagenow'], array('wp-login.php', 'wp-register.php'))) {
            return true;
        }

        if (defined('WP_CLI') && WP_CLI) {
            return false;
        }

        // Backward compatibility
        if (empty($_SERVER['SERVER_PROTOCOL']) or empty($_SERVER['HTTP_HOST'])) {
            return false;
        }

        // Check Native php
        $protocol   = strpos(strtolower($_SERVER['SERVER_PROTOCOL']), 'https') === false ? 'http' : 'https';
        $host       = sanitize_text_field(wp_unslash($_SERVER['HTTP_HOST']));
        $script     = sanitize_text_field(wp_unslash($_SERVER['SCRIPT_NAME']));
        $currentURL = $protocol . '://' . $host . $script;
        $loginURL   = wp_login_url();

        if ($currentURL == $loginURL) {
            return true;
        }

        return false;
    }

    /**
     * Get Screen ID
     *
     * @return string
     */
    public static function get_screen_id()
    {
        $screen    = get_current_screen();
        $screen_id = $screen ? $screen->id : '';
        return $screen_id;
    }

    /**
     * Get File Path Of Plugins File
     *
     * @param $path
     * @return string
     */
    public static function get_file_path($path)
    {
        return wp_normalize_path(path_join(WP_STATISTICS_DIR, $path));
    }

    /**
     * Determine if a Cache Plugin is Active
     *
     * @return array
     */
    public static function checkActiveCachePlugin()
    {
        $use = array('status' => false, 'plugin' => '');

        // TODO: Optimize this function
        /* WordPress core */
        if (defined('WP_CACHE') && WP_CACHE) {
            $use = array('status' => true, 'plugin' => __('WordPress Object Cache', 'wp-statistics'), 'debug' => 'WordPress Object Cache');
        }

        /* WP Rocket */
        if (function_exists('get_rocket_cdn_url')) {
            $use = array('status' => true, 'plugin' => __('WP Rocket', 'wp-statistics'), 'debug' => 'WP Rocket');
        }

        /* WP Super Cache */
        if (function_exists('wpsc_init')) {
            $use = array('status' => true, 'plugin' => __('WP Super Cache', 'wp-statistics'), 'debug' => 'WP Super Cache');
        }

        /* Comet Cache */
        if (function_exists('___wp_php_rv_initialize')) {
            $use = array('status' => true, 'plugin' => __('Comet Cache', 'wp-statistics'), 'debug' => 'Comet Cache');
        }

        /* WP Fastest Cache */
        if (class_exists('WpFastestCache')) {
            $use = array('status' => true, 'plugin' => __('WP Fastest Cache', 'wp-statistics'), 'debug' => 'WP Fastest Cache');
        }

        /* Cache Enabler */
        if (defined('CE_MIN_WP')) {
            $use = array('status' => true, 'plugin' => __('Cache Enabler', 'wp-statistics'), 'debug' => 'Cache Enabler');
        }

        /* W3 Total Cache */
        if (defined('W3TC')) {
            $use = array('status' => true, 'plugin' => __('W3 Total Cache', 'wp-statistics'), 'debug' => 'W3 Total Cache');
        }

        /* WP-Optimize */
        if (class_exists('WP_Optimize')) {
            $use = array('status' => true, 'plugin' => __('WP-Optimize', 'wp-statistics'), 'debug' => 'WP-Optimize');
        }

        /* Speed Optimizer */
        if (class_exists('\SiteGround_Optimizer\Loader\Loader')) {
            $use = array('status' => true, 'plugin' => esc_html__('Speed Optimizer', 'wp-statistics'), 'debug' => 'Speed Optimizer');
        }

        /** LiteSpeed Cache */
        if (defined('LSCWP_V')) {
            $use = array('status' => true, 'plugin' => __('LiteSpeed Cache', 'wp-statistics'), 'debug' => 'LiteSpeed Cache');
        }

        return apply_filters('wp_statistics_cache_status', $use);
    }

    /**
     * Get WordPress Uploads DIR
     *
     * @param string $path
     * @return mixed
     * @default For WP Statistics Plugin is 'wp-statistics' dir
     */
    public static function get_uploads_dir($path = '')
    {
        $upload_dir = wp_upload_dir();
        return wp_normalize_path(path_join($upload_dir['basedir'], $path));
    }

    /**
     * Get Upload URL
     *
     * @return mixed|string
     */
    public static function get_upload_url()
    {
        $uploadDir = wp_get_upload_dir();
        $baseurl   = $uploadDir['baseurl'];

        // Check if baseurl is not https
        if (strpos($baseurl, 'http://') === 0) {
            $isSsl = function_exists('is_ssl') ? is_ssl() :
                (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off') ||
                (isset($_SERVER['SERVER_PORT']) && $_SERVER['SERVER_PORT'] == 443);

            if ($isSsl) {
                $baseurl = 'https://' . substr($baseurl, 7);
            }
        }

        return $baseurl;
    }

    /**
     * Get URL Query Parameters List
     *
     * @param string $type
     * @return array|bool|string
     */
    public static function get_query_params_allow_list($type = 'array')
    {
        # Set Default
        $list = [];

        if (Option::get('query_params_allow_list') !== false) {
            # Load from options
            $list = array_map('trim', explode("\n", Option::get('query_params_allow_list')));
        } else {
            # Load the default options
            $list = self::get_default_query_params_allow_list();
        }

        return ($type == "array" ? $list : implode("\n", $list));
    }


    /**
     * Get the default URL Query Parameters List
     * @param string $type
     * @return array|string
     */
    public static function get_default_query_params_allow_list($type = 'array')
    {
        include WP_STATISTICS_DIR . "includes/defines/query-params-allow-list.php";
        $list = isset($wps_query_params_allow_list_array) ? $wps_query_params_allow_list_array : [];
        return ($type == "array" ? $list : implode("\n", $list));
    }

    /**
     * Get Number Days From install this plugin
     * this method used for `ALL` Option in Time Range Pages
     */
    public static function get_date_install_plugin()
    {
        global $wpdb;

        //Create Empty default Option
        $first_day = '';

        //First Check Visitor Table , if not exist Web check Pages Table
        $list_tbl = array(
            'visitor' => array('order_by' => 'ID', 'column' => 'last_counter'),
            'pages'   => array('order_by' => 'page_id', 'column' => 'date'),
        );
        foreach ($list_tbl as $tbl => $val) {
            $first_day = $wpdb->get_var(
                $wpdb->prepare("SELECT %s FROM `" . WP_STATISTICS\DB::table($tbl) . "` ORDER BY %s ASC LIMIT 1", $val['column'], $val['order_by'])
            );
            if (!empty($first_day)) {
                break;
            }
        }

        //Calculate hit day if range is exist
        if (empty($first_day)) {
            return false;
        } else {
            return $first_day;
        }
    }

    /**
     * Check User Is Using Gutenberg Editor
     */
    public static function is_gutenberg()
    {
        $current_screen = get_current_screen();
        return ((method_exists($current_screen, 'is_block_editor') && $current_screen->is_block_editor()) || (function_exists('is_gutenberg_page')) && is_gutenberg_page());
    }

    /**
     * Get List WordPress Post Type
     *
     * @return array
     */
    public static function get_list_post_type()
    {
        // Get default post types which are public (exclude media post type)
        $post_types = get_post_types(array('public' => true, '_builtin' => true), 'names', 'and');
        $post_types = array_diff($post_types, ['attachment']);

        // Get custom post types which are public
        $custom_post_types = get_post_types(array('public' => true, '_builtin' => false), 'names', 'and');

        foreach ($custom_post_types as $name) {
            $post_types[] = $name;
        }

        return $post_types;
    }

    /**
     * Get Built-in Post Types List
     */
    public static function getDefaultPostTypes()
    {
        $postTypes = get_post_types(array('public' => true, '_builtin' => true), 'names', 'and');
        $postTypes = array_diff($postTypes, ['attachment']);

        return array_values($postTypes);
    }

    /**
     * Get Custom Post Types List
     */
    public static function getCustomPostTypes()
    {
        return array_values(get_post_types(array('public' => true, '_builtin' => false, 'publicly_queryable' => true), 'names', 'and'));
    }

    /**
     * Get all Post Types (built-in and custom)
     *
     * @return array
     */
    public static function getPostTypes()
    {
        return array_merge(self::getDefaultPostTypes(), self::getCustomPostTypes());
    }

    public static function get_updated_list_post_type()
    {
        return array_map(function ($postType) {
            return in_array($postType, ['post', 'page', 'product', 'attachment']) ? $postType : 'post_type_' . $postType;
        }, self::get_list_post_type());
    }

    /**
     * Check Url Scheme
     *
     * @param $url
     * @param array $accept
     * @return bool
     */
    public static function check_url_scheme($url, $accept = array('http', 'https'))
    {
        $scheme = @wp_parse_url($url, PHP_URL_SCHEME);
        return in_array($scheme, $accept);
    }

    /**
     * Get WordPress Version
     *
     * @return mixed|string
     */
    public static function get_wordpress_version()
    {
        return get_bloginfo('version');
    }

    /**
     * Convert Json To Array
     *
     * @param $json
     * @return bool|mixed
     */
    public static function json_to_array($json)
    {

        // Sanitize Slash Data
        $data = wp_unslash($json);

        // Check Validate Json Data
        if (!empty($data) && is_string($data) && is_array(json_decode($data, true)) && json_last_error() == 0) {
            return json_decode($data, true);
        }

        return false;
    }

    /**
     * Standard Json Encode
     *
     * @param $array
     * @return false|string
     */
    public static function standard_json_encode($array)
    {

        //Fixed entity decode Html
        foreach ((array)$array as $key => $value) {
            if (!is_scalar($value)) {
                continue;
            }
            $array[$key] = html_entity_decode((string)$value, ENT_QUOTES, 'UTF-8');
        }

        return wp_json_encode($array, JSON_UNESCAPED_SLASHES);
    }

    /**
     * Show Site Icon by Url
     *
     * @param $url
     * @param int $size
     * @param string $style
     * @return bool|string
     * @deprecated 14.10
     */
    public static function show_site_icon($url, $size = 16, $style = '')
    {
        $url = preg_replace('/^https?:\/\//', '', $url);
        if ($url != "") {
            $img_url = "https://www.google.com/s2/favicons?domain=" . $url;
            return '<img alt="favicon" src="' . $img_url . '" width="' . $size . '" height="' . $size . '" style="' . ($style == "" ? 'vertical-align: -3px;' : '') . '" />';
        }

        return false;
    }

    /**
     * Get Domain name from url
     * e.g : https://wp-statistics.com/add-ons/ -> wp-statistics.com
     *
     * @param $url
     * @return mixed
     */
    public static function get_domain_name($url)
    {
        //Remove protocol
        $url = preg_replace("(^https?://)", "", trim($url));
        //remove w(3)
        $url = preg_replace('#^(http(s)?://)?w{3}\.#', '$1', $url);
        //remove all Query
        $url = explode("/", $url);

        return $url[0];
    }

    /**
     * Get Site title By Url
     *
     * @param $url string e.g : wp-statistics.com
     * @return bool|string
     */
    public static function get_site_title_by_url($url)
    {

        //Get Body Page
        $html = Helper::get_html_page($url);
        if ($html === false) {
            return false;
        }

        //Get Page Title
        if (class_exists('DOMDocument')) {
            $dom            = new \DOMDocument;
            $internalErrors = libxml_use_internal_errors(true);
            @$dom->loadHTML($html);
            libxml_use_internal_errors($internalErrors);
            $title = '';
            if (isset($dom) and $dom->getElementsByTagName('title')->length > 0) {
                $title = $dom->getElementsByTagName('title')->item('0')->nodeValue;
            }
            return (wp_strip_all_tags($title) == "" ? false : wp_strip_all_tags($title));
        }

        return false;
    }

    /**
     * Get Html Body Page By Url
     *
     * @param $url string e.g : wp-statistics.com
     * @return bool
     */
    public static function get_html_page($url)
    {

        //sanitize Url
        $parse_url = wp_parse_url($url);
        $urls[]    = esc_url_raw($url);

        //Check Protocol Url
        if (!array_key_exists('scheme', $parse_url)) {
            $urls      = array();
            $url_parse = wp_parse_url($url);
            foreach (array('http://', 'https://') as $scheme) {
                $urls[] = preg_replace('/([^:])(\/{2,})/', '$1/', $scheme . path_join((isset($url_parse['host']) ? $url_parse['host'] : ''), (isset($url_parse['path']) ? $url_parse['path'] : '')));
            }
        }

        //Send Request for Get Page Html
        foreach ($urls as $page) {
            $response = wp_remote_get($page, array(
                'timeout'    => 30,
                'user-agent' => "Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/28.0.1500.71 Safari/537.36"
            ));
            if (is_wp_error($response)) {
                continue;
            }
            $data = wp_remote_retrieve_body($response);
            if (is_wp_error($data)) {
                continue;
            }
            return (wp_strip_all_tags($data) == "" ? false : $data);
        }

        return false;
    }

    /**
     * Generate Random String
     *
     * @param $num
     * @return string
     */
    public static function random_string($num = 50)
    {
        $characters   = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';
        $randomString = '';
        for ($i = 0; $i < $num; $i++) {
            $randomString .= $characters[wp_rand(0, strlen($characters) - 1)];
        }

        return $randomString;
    }

    /**
     * Get Post List From custom Post Type
     *
     * @param array $args
     * @area utility
     * @return mixed
     */
    public static function get_post_list($args = array())
    {

        //Prepare Arg
        $defaults = array(
            'post_type'      => 'page',
            'post_status'    => 'publish',
            'posts_per_page' => '-1',
            'order'          => 'ASC',
            'fields'         => 'ids'
        );
        $args     = wp_parse_args($args, $defaults);

        //Get Post List
        $query = new \WP_Query($args);
        $list  = array();
        foreach ($query->posts as $ID) {
            $list[$ID] = esc_html(get_the_title($ID));
        }

        return $list;
    }

    /**
     * Check WordPress Post is Published
     *
     * @param $ID
     * @return bool
     */
    public static function IsPostPublished($ID)
    {
        return get_post_status($ID) == 'public';
    }

    /**
     * Generate RGBA colors
     *
     * @param        $num
     * @param string $opacity
     * @param bool $quote
     * @return string
     */
    public static function GenerateRgbaColor($num, $opacity = '1', $quote = true)
    {
        $hash   = md5('color' . $num);
        $rgba   = "rgba(%s, %s, %s, %s)";
        $format = ($quote === true ? "'$rgba'" : $rgba);

        return sprintf($format,
            hexdec(substr($hash, 0, 2)),
            hexdec(substr($hash, 2, 2)),
            hexdec(substr($hash, 4, 2)),
            $opacity
        );
    }

    /**
     * Remove Query String From Url
     *
     * @param $url
     * @return bool|string
     */
    public static function RemoveQueryStringUrl($url)
    {
        return substr($url, 0, strrpos($url, "?"));
    }

    /**
     *
     * Filter certain query string in the URL based on Query Params Allowed List
     * @param string $url
     * @param array $allowedParams
     * @return string
     */
    public static function FilterQueryStringUrl($url, $allowedParams)
    {
        // Get query from the URL
        $urlQuery = strpos($url, '?');

        // Check if the URL has query strings
        if ($urlQuery !== false) {
            global $wp;
            $internalQueryParams = $wp->public_query_vars;
            $permalinkStructure  = get_option('permalink_structure');

            // Extract the URL path and query string
            $urlPath     = substr($url, 0, $urlQuery);
            $queryString = substr($url, $urlQuery + 1);

            // Parse the query string into an array
            parse_str($queryString, $parsedQuery);

            // Get the first query param key
            reset($parsedQuery);
            $firstKey = key($parsedQuery);

            // Loop through query params and unset ones not allowed, except the first one
            foreach ($parsedQuery as $key => $value) {
                $allowedQueryVars = $allowedParams;

                // If ugly permalink is enabled, ignore the first key if it's internal
                if (empty($permalinkStructure) && $key === $firstKey) {
                    $allowedQueryVars = array_merge($internalQueryParams, $allowedParams);
                }

                if (!in_array($key, $allowedQueryVars)) {
                    unset($parsedQuery[$key]);
                }
            }

            // Rebuild URL with allowed params, keeping the first query param
            if (!empty($parsedQuery)) {
                $filteredQuery = http_build_query($parsedQuery);
                $url           = $urlPath . '?' . $filteredQuery;
            } else {
                $url = $urlPath;
            }
        }

        return $url;
    }

    /**
     * Sort associative array
     *
     * @param $array
     * @param $subfield
     * @param int $type
     * @return void
     * @see https://stackoverflow.com/questions/1597736/how-to-sort-an-array-of-associative-arrays-by-value-of-a-given-key-in-php
     */
    public static function SortByKeyValue(&$array, $subfield, $type = SORT_DESC)
    {
        $sort_array = array();
        foreach ($array as $key => $row) {
            $sort_array[$key] = $row[$subfield];
        }
        array_multisort($sort_array, $type, $array);
    }

    /**
     * Format array for the datepicker
     *
     * @param $array_to_strip
     * @return array
     */
    public static function strip_array_indices($array_to_strip)
    {
        $NewArray = array();
        foreach ($array_to_strip as $objArrayItem) {
            $NewArray[] = $objArrayItem;
        }

        return ($NewArray);
    }

    /**
     * Set All Option For DatePicker
     *
     * @example add_filter( 'wp_statistics_days_ago_request', array( '', 'set_all_option_datepicker' ) );
     */
    public static function set_all_option_datepicker()
    {
        $first_day = Helper::get_date_install_plugin();
        return ($first_day === false ? 30 : (int)TimeZone::getNumberDayBetween($first_day));
    }

    /**
     * Url Decode
     *
     * @param $value
     * @return string
     */
    public static function getUrlDecode($value)
    {
        return mb_convert_encoding(urldecode($value), 'ISO-8859-1', 'UTF-8');
    }

    /**
     * Check is Assoc Array
     *
     * @param array $arr
     * @return bool
     */
    public static function isAssoc(array $arr)
    {
        if (array() === $arr) {
            return false;
        }
        return array_keys($arr) !== range(0, count($arr) - 1);
    }

    /**
     * Create Condition SQL
     *
     * @param array $args
     * @return string
     */
    public static function getConditionSQL($args = array())
    {

        // Create Empty SQL
        $sql = '';

        // Check Number Params
        if (self::isAssoc($args)) {
            $condition[] = $args;
        } else {
            $condition = $args;
        }

        // Add WHERE
        if (count($condition) > 0) {
            $sql .= ' WHERE ';
        }

        // Push To SQL
        $i = 0;
        foreach ($condition as $params) {
            if ($i > 0) {
                $sql .= ' AND ';
            }
            if ($params['compare'] == "BETWEEN") {
                $sql .= $params['key'] . " " . $params['compare'] . " " . (is_numeric($params['from']) ? $params['from'] : "'" . $params['from'] . "'") . " AND " . (is_numeric($params['to']) ? $params['to'] : "'" . $params['to'] . "'");
            } else {
                $sql .= $params['key'] . " " . $params['compare'] . " " . (is_numeric($params['value']) ? $params['value'] : "'" . $params['value'] . "'");
            }
            $i++;
        }

        return $sql;
    }

    /**
     * Send Email
     *
     * @param $to
     * @param $subject
     * @param $content
     * @param bool $email_template
     * @param array $args
     * @return bool
     */
    public static function send_mail($to, $subject, $content, $email_template = true, $args = array())
    {
        // Email Template
        if ($email_template) {
            $email_template = WP_STATISTICS_DIR . 'includes/admin/templates/emails/layout.php';
            $email_template = apply_filters('wp_statistics_email_template_layout', $email_template);
            $email_template = wp_normalize_path($email_template);
        }

        $schedule   = Option::get('time_report', false);
        $is_rtl     = is_rtl();
        $text_align = $is_rtl ? 'right' : 'left';
        $emailTitle = '<table style="font-family: -apple-system, BlinkMacSystemFont, Segoe UI, Roboto, Oxygen-Sans, Ubuntu, Cantarell, Helvetica Neue,sans-serif; width: 100%; text-align: ' . esc_attr($text_align) . ';font-size: 21px; font-weight: 500; line-height: 24.61px; color: #0C0C0D; padding: 0;"><tbody><tr><td>' . __('Your Website Performance Overview', 'wp-statistics') . '</td></tr></tbody></table>';

        if ($schedule && array_key_exists($schedule, Schedule::getSchedules())) {
            $schedule = Schedule::getSchedules()[$schedule];

            if ($schedule['interval'] === DAY_IN_SECONDS) {
                $report_date = esc_html(date_i18n(get_option('date_format', 'j F Y'), strtotime($schedule['start'])));
            } else {
                $report_date = sprintf(
                // translators: 1: Report start date - 2: Report end date.
                    __('%1$s - %2$s', 'wp-statistics'),
                    esc_html(date_i18n(get_option('date_format', 'j F Y'), strtotime($schedule['start']))),
                    esc_html(date_i18n(get_option('date_format', 'j F Y'), strtotime($schedule['end'])))
                );
            }

            if (!Helper::isAddOnActive('advanced-reporting')) {
                $emailTitle .= sprintf(
                    '<p style="margin-bottom: 12px;margin-top:4px;font-size: 14px; font-weight: 400; line-height: 16.41px; color: #56585A;">%1$s</p><p style="margin: 0"><a href="%2$s" title="%3$s" style="color: #56585A;font-size: 16px; font-weight: 500; line-height: 18.75px; text-decoration:none">%3$s</a></p>',
                    esc_html($report_date),
                    esc_url(get_site_url()),
                    esc_html(get_bloginfo('name'))
                );
            }
        } else {
            $schedule = null;
        }

        // E-mail header and footer
        $emailHeader = '';
        $emailFooter = '';
        $is_rtl      = is_rtl();
        $text_align  = $is_rtl ? 'right' : 'left';
        $dir         = $is_rtl ? 'rtl' : 'ltr';

        if (!empty(wp_strip_all_tags(Option::get('email_free_content_header', '')))) {
            $emailHeader = '<div style="direction:' . $dir . ';background: #D0DEF5; padding: 16px 32px; color: #0C0C0D; font-size: 16px; font-weight: 500; line-height: 18.75px; text-align: ' . $text_align . '; white-space: pre-wrap; ' . (!empty($content) ? 'border-radius: 0;' : 'border-radius: 0 0 12px 12px;') . '">' . wp_strip_all_tags(Option::get('email_free_content_header', '')) . '</div>';
        }
        if (!empty(wp_strip_all_tags(Option::get('email_free_content_footer', '')))) {
            $emailFooter = '<div style="direction:' . $dir . ';background: #D0DEF5; padding: 16px 32px; color: #0C0C0D; font-size: 16px; font-weight: 500; line-height: 18.75px; text-align:  ' . $text_align . '; white-space: pre-wrap; border-radius: 0 0 18px 18px;">' . wp_strip_all_tags(Option::get('email_free_content_footer', '')) . '</div>';
        }

        //Template Arg
        $template_arg = array(
            'title'        => $subject,
            'logo'         => '',
            'content'      => $content,
            'site_url'     => home_url(),
            'site_title'   => get_bloginfo('name'),
            'footer_text'  => '',
            'email_title'  => apply_filters('wp_statistics_email_title', $emailTitle),
            'logo_image'   => apply_filters('wp_statistics_email_logo', WP_STATISTICS_URL . 'assets/images/logo-statistics-header-blue.png'),
            'logo_url'     => apply_filters('wp_statistics_email_logo_url', get_bloginfo('url')),
            'copyright'    => apply_filters('wp_statistics_email_footer_copyright', Admin_Template::get_template('emails/copyright', array(), true)),
            'email_header' => apply_filters('wp_statistics_email_header', $emailHeader),
            'email_footer' => apply_filters('wp_statistics_email_footer', $emailFooter),
            'is_rtl'       => (is_rtl() ? true : false),
            'schedule'     => $schedule,
        );
        $arg          = wp_parse_args($args, $template_arg);

        /**
         * Send Email
         */
        try {

            WP_Statistics_Mail::init()
                ->setTo($to)
                ->setSubject($subject)
                ->setBody($content)
                ->setTemplate($email_template, $arg)
                ->send();

            return true;

        } catch (Exception $e) {
            \WP_Statistics::log($e->getMessage(), 'error');

            return false;
        }
    }

    /**
     * Send SMS With WP SMS Plugin
     *
     * @param $to
     * @param $text
     * @return bool
     */
    public static function send_sms($to, $text)
    {
        if (function_exists('wp_sms_send')) {
            $run = wp_sms_send($to, $text);
            return (is_wp_error($run) ? false : true);
        }

        return false;
    }

    /**
     * Get List Taxonomy
     *
     * @param bool $hide_empty
     * @return array
     */
    public static function get_list_taxonomy($hide_empty = false)
    {
        $taxonomies = array('category' => __("Category", "wp-statistics"), "post_tag" => __("Tags", "wp-statistics"));
        $get_tax    = get_taxonomies(array('public' => true, '_builtin' => false), 'objects', 'and');
        foreach ($get_tax as $object) {
            $object = get_object_vars($object);
            if ($hide_empty === true) {
                $count_term_in_tax = wp_count_terms($object['name']);
                if ($count_term_in_tax > 0 and isset($object['rewrite']['slug'])) {
                    $taxonomies[$object['name']] = $object['labels']->name;
                }
            } else {
                if (isset($object['rewrite']['slug'])) {
                    $taxonomies[$object['name']] = $object['labels']->name;
                }
            }
        }

        return $taxonomies;
    }

    /**
     * Checks if the given taxonomy is a custom taxonomy.
     *
     * @param string $taxonomy The taxonomy name to check.
     * @return bool True if the taxonomy is custom, false otherwise.
     */
    public static function isCustomTaxonomy($taxonomy)
    {
        $taxonomy = get_taxonomy($taxonomy);

        if (!empty($taxonomy)) {
            return !$taxonomy->_builtin;
        }

        return false;
    }


    /**
     * Checks if the given taxonomy is a custom taxonomy.
     *
     * @param string $taxonomy The taxonomy name to check.
     * @return bool True if the taxonomy is custom, false otherwise.
     */
    public static function isCustomPostType($postType)
    {
        $customPostTypes = self::getCustomPostTypes();
        return in_array($postType, $customPostTypes) ? true : false;
    }

    /**
     * Retrieves an array of post types associated with a given taxonomy.
     *
     * @param string $taxonomy The taxonomy to search for.
     * @return array An array of post types associated with the given taxonomy.
     */
    public static function getPostTypesByTaxonomy($taxonomy)
    {
        $taxonomyPostTypes = [];
        $postTypes         = self::getPostTypes();

        foreach ($postTypes as $postType) {
            $taxonomies = get_object_taxonomies($postType);

            if (in_array($taxonomy, $taxonomies)) {
                $taxonomyPostTypes[] = $postType;
            }
        }

        return $taxonomyPostTypes;
    }

    /**
     * Create Condition Where Time in MySql
     *
     * @param string $field : date column name in database table
     * @param string $time : Time return
     * @param array $range : an array contain two Date e.g : array('start' => 'xx-xx-xx', 'end' => 'xx-xx-xx', 'is_day' => true, 'current_date' => true)
     *
     * ---- Time Range -----
     * today
     * yesterday
     * week
     * month
     * year
     * total
     * “-x” (i.e., “-10” for the past 10 days)
     * ----------------------
     *
     * @return string|bool
     */
    public static function mysql_time_conditions($field = 'date', $time = 'total', $range = array())
    {
        //Get Current Date From WP
        $current_date = TimeZone::getCurrentDate('Y-m-d');

        //Create Field Sql
        $field_sql = function ($time) use ($current_date, $field, $range) {
            $is_current     = array_key_exists('current_date', $range);
            $getCurrentDate = TimeZone::getCurrentDate('Y-m-d', (int)$time);
            return "`$field` " . ($is_current === true ? '=' : 'BETWEEN') . " '{$getCurrentDate}'" . ($is_current === false ? " AND '{$current_date}'" : "");
        };

        //Check Time
        switch ($time) {
            case 'today':
                $where = "`$field` = '{$current_date}'";
                break;
            case 'day-before-yesterday':
                $date  = TimeZone::getTimeAgo(2, 'Y-m-d');
                $where = "`$field` = '{$date}'";
                break;
            case 'yesterday':
                $date  = TimeZone::getTimeAgo(1, 'Y-m-d');
                $where = "`$field` = '{$date}'";
                break;
            case 'this-week':
                $date  = TimeZone::calculateDateFilter('this_week');
                $where = "`$field` BETWEEN '{$date["from"]}' AND '{$date["to"]}'";
                break;
            case 'last-week':
                $date  = TimeZone::calculateDateFilter('last_week');
                $where = "`$field` BETWEEN '{$date["from"]}' AND '{$date["to"]}'";
                break;
            case 'week':
            case '7days':
                $where = $field_sql(-6);
                break;
            case 'week-ex-today':
                // Week, excluding today
                $fromDate = gmdate('Y-m-d', strtotime('-1 week'));
                $toDate   = TimeZone::getTimeAgo(1, 'Y-m-d');
                $where    = "`$field` BETWEEN '{$fromDate}' AND '{$toDate}'";
                break;
            case 'two-weeks':
            case '14days':
                $where = $field_sql(-13);
                break;
            case 'two-weeks-ex-today':
                $fromDate = gmdate('Y-m-d', strtotime('-2 week'));
                $toDate   = TimeZone::getTimeAgo(1, 'Y-m-d');
                $where    = "`$field` BETWEEN '{$fromDate}' AND '{$toDate}'";
                break;
            case 'last-two-weeks':
                $fromDate = TimeZone::getTimeAgo(28, 'Y-m-d');
                $toDate   = TimeZone::getTimeAgo(14, 'Y-m-d');
                $where    = "`$field` BETWEEN '{$fromDate}' AND '{$toDate}'";
                break;
            case '2-months-ago':
                $date  = TimeZone::calculateDateFilter('2months_ago');
                $where = "`$field` BETWEEN '{$date["from"]}' AND '{$date["to"]}'";
                break;
            case 'this-month':
                $date  = TimeZone::calculateDateFilter('this_month');
                $where = "`$field` BETWEEN '{$date["from"]}' AND '{$date["to"]}'";
                break;
            case 'last-month':
                $date  = TimeZone::calculateDateFilter('last_month');
                $where = "`$field` BETWEEN '{$date["from"]}' AND '{$date["to"]}'";
                break;
            case 'month':
            case '30days':
                $where = $field_sql(-29);
                break;
            case 'month-ex-today':
                // Month, excluding today
                $fromDate = gmdate('Y-m-d', strtotime('-30 days'));
                $toDate   = TimeZone::getTimeAgo(1, 'Y-m-d');
                $where    = "`$field` BETWEEN '{$fromDate}' AND '{$toDate}'";
                break;
            case '60days':
                $where = $field_sql(-59);
                break;
            case '90days':
                $where = $field_sql(-89);
                break;
            case '6months':
                $date  = TimeZone::calculateDateFilter('6months');
                $where = "`$field` BETWEEN '{$date["from"]}' AND '{$date["to"]}'";
                break;
            case 'this-year':
                $date  = TimeZone::calculateDateFilter('this_year');
                $where = "`$field` BETWEEN '{$date["from"]}' AND '{$date["to"]}'";
                break;
            case 'last-year':
                $date  = TimeZone::calculateDateFilter('last_year');
                $where = "`$field` BETWEEN '{$date["from"]}' AND '{$date["to"]}'";
                break;
            case 'year':
            case '12months':
                $date  = TimeZone::calculateDateFilter('year');
                $where = "`$field` BETWEEN '{$date["from"]}' AND '{$date["to"]}'";
                break;
            case 'year-ex-today':
                // Year, excluding today
                $fromDate = gmdate('Y-m-d', strtotime('-1 year'));
                $toDate   = TimeZone::getTimeAgo(1, 'Y-m-d');
                $where    = "`$field` BETWEEN '{$fromDate}' AND '{$toDate}'";
                break;
            case 'total':
                $where = "";
                break;
            default:
                if (array_key_exists('is_day', $range)) {
                    //Check a day
                    if (TimeZone::isValidDate($time)) {
                        $where = "`$field` = '{$time}'";
                    } else {
                        $getCurrentDate = TimeZone::getCurrentDate('Y-m-d', $time);
                        $where          = "`$field` = '{$getCurrentDate}'";
                    }
                } elseif (array_key_exists('start', $range) and array_key_exists('end', $range)) {
                    //Check Between Two Time
                    $getCurrentDate    = TimeZone::getCurrentDate('Y-m-d', '-0', strtotime($range['start']));
                    $getCurrentEndDate = TimeZone::getCurrentDate('Y-m-d', '-0', strtotime($range['end']));
                    $where             = "`$field` BETWEEN '{$getCurrentDate}' AND '{$getCurrentEndDate}'";
                } else {
                    //Check From a Date To Now
                    $where = $field_sql($time);
                }
        }

        return $where;
    }

    /**
     * Easy U-sort Array
     *
     * @param $a
     * @param $b
     * @return bool
     */
    public static function compare_uri_hits($a, $b)
    {
        return $a[1] < $b[1];
    }

    /**
     * Easy U-sort Array
     *
     * @param $a
     * @param $b
     * @return int
     */
    public static function compare_uri_hits_int($a, $b)
    {
        if ($b[1] == $a[1]) return 0;
        if ($b[1] > $a[1]) return 1;
        if ($b[1] < $a[1]) return -1;

    }

    /**
     * Return Number Posts in WordPress
     *
     * @return int
     */
    public static function getCountPosts()
    {
        $count_posts = wp_count_posts('post');

        $ret = 0;
        if (is_object($count_posts)) {
            $ret = $count_posts->publish;
        }
        return $ret;
    }

    /**
     * Get Count Pages WordPress
     *
     * @return int
     */
    public static function getCountPages()
    {
        $count_pages = wp_count_posts('page');

        $ret = 0;
        if (is_object($count_pages)) {
            $ret = $count_pages->publish;
        }
        return $ret;
    }

    /**
     * Get All WordPress Count
     *
     * @return mixed
     */
    public static function getCountComment()
    {
        global $wpdb;

        $countcomms = $wpdb->get_var("SELECT COUNT(*) FROM {$wpdb->comments} WHERE comment_approved = '1'");
        return $countcomms;
    }

    /**
     * Get Count Comment Spam
     *
     * @return mixed
     */
    public static function getCountSpam()
    {
        return number_format_i18n(get_option('akismet_spam_count'));
    }

    /**
     * Get Count All WordPress Users
     *
     * @return mixed
     */
    public static function getCountUsers()
    {
        $result = count_users();
        return $result['total_users'];
    }

    /**
     * Return the last date a post was published on your site.
     *
     * @return string
     */
    public static function getLastPostDate()
    {
        global $wpdb;

        $db_date     = $wpdb->get_var("SELECT post_date FROM {$wpdb->posts} WHERE post_type='post' AND post_status='publish' ORDER BY post_date DESC LIMIT 1");
        $date_format = get_option('date_format');
        return TimeZone::getCurrentDate_i18n($date_format, $db_date, false);
    }

    /**
     * Returns the average number of days between posts on your site.
     *
     * @param bool $days
     * @return float
     */
    public static function getAveragePost($days = false)
    {
        global $wpdb;

        $get_first_post = $wpdb->get_var("SELECT post_date FROM {$wpdb->posts} WHERE post_status = 'publish' ORDER BY post_date LIMIT 1");
        $get_total_post = $wpdb->get_var("SELECT COUNT(*) FROM {$wpdb->posts} WHERE post_status = 'publish' AND post_type = 'post'");

        $days_spend = intval(
            (time() - strtotime($get_first_post)) / 86400
        ); // 86400 = 60 * 60 * 24 = number of seconds in a day

        if ($days == true) {
            if ($get_total_post == 0) {
                $get_total_post = 1;
            } // Avoid divide by zero errors.

            return round($days_spend / $get_total_post, 0);
        } else {
            if ($days_spend == 0) {
                $days_spend = 1;
            } // Avoid divide by zero errors.

            return round($get_total_post / $days_spend, 2);
        }
    }

    /**
     * Returns the average number of days between comments on your site.
     *
     * @param bool $days
     * @return float
     */
    public static function getAverageComment($days = false)
    {

        global $wpdb;

        $get_first_comment = $wpdb->get_var("SELECT comment_date FROM {$wpdb->comments} ORDER BY comment_date LIMIT 1");
        $get_total_comment = $wpdb->get_var("SELECT COUNT(*) FROM {$wpdb->comments} WHERE comment_approved = '1'");

        $days_spend = intval(
            (time() - strtotime($get_first_comment)) / 86400
        ); // 86400 = 60 * 60 * 24 = number of seconds in a day

        if ($days == true) {
            if ($get_total_comment == 0) {
                $get_total_comment = 1;
            } // Avoid divide by zero errors.

            return round($days_spend / $get_total_comment, 0);
        } else {
            if ($days_spend == 0) {
                $days_spend = 1;
            } // Avoid divide by zero errors.

            return round($get_total_comment / $days_spend, 2);
        }
    }

    /**
     * Returns the average number of days between user registrations on your site.
     *
     * @param bool $days
     * @return float
     */
    public static function getAverageRegisterUser($days = false)
    {

        global $wpdb;

        $get_first_user = $wpdb->get_var("SELECT `user_registered` FROM {$wpdb->users} ORDER BY user_registered LIMIT 1");
        $get_total_user = $wpdb->get_var("SELECT COUNT(*) FROM {$wpdb->users}");

        $days_spend = intval(
            (time() - strtotime($get_first_user)) / 86400
        );

        if ($days == true) {
            if ($get_total_user == 0) {
                $get_total_user = 1;
            }

            return round($days_spend / $get_total_user, 0);
        } else {
            if ($days_spend == 0) {
                $days_spend = 1;
            }

            return round($get_total_user / $days_spend, 2);
        }
    }

    /**
     * Returns default parameters for hits request
     *
     * @return array
     */
    public static function getHitsDefaultParams()
    {
        // Create Empty Params Object
        $params = array();

        //Set Page Type
        $get_page_type          = Pages::get_page_type();
        $params['source_type']  = $get_page_type['type'];
        $params['source_id']    = $get_page_type['id'];
        $params['search_query'] = (isset($get_page_type['search_query']) ? base64_encode(esc_html($get_page_type['search_query'])) : '');

        // page url
        //$params['page_uri'] = base64_encode(Pages::get_page_uri());

        /**
         * Signature
         * @version 14.9
         */
        if (self::isRequestSignatureEnabled()) {
            $params['signature'] = Signature::generate([
                $get_page_type['type'],
                (int)$get_page_type['id']
            ]);
        }

        return $params;
    }

    /**
     * The version number will be anonymous using this function
     *
     * @param $version
     * @return string
     * @example 106.2.124.0 -> 106.0.0.0
     *
     */
    public static function makeAnonymousVersion($version)
    {
        $mainVersion         = substr($version, 0, strpos($version, '.'));
        $subVersion          = substr($version, strpos($version, '.') + 1);
        $anonymousSubVersion = preg_replace('/[0-9]+/', '0', $subVersion);

        return "{$mainVersion}.{$anonymousSubVersion}";
    }

    /**
     * Extracts the major version from a version string.
     *
     * If the version string starts with a dot (e.g. ".NK") meaning
     * no major version is present, the entire input string is returned.
     * If the input is empty or not a string, returns null.
     *
     * Examples:
     * - "1.2.3" => "1"
     * - ".NK"   => ".NK"
     * - ""      => null
     * - null    => null
     *
     * @param string|null $version Version string to extract from.
     * @return string|null Major version or full input if no major version, or null if invalid.
     */
    public static function getMajorVersionOnly($version)
    {
        if(empty($version)) {
            return null;
        }

        $parts = explode('.', $version);

        if ($parts[0] === '') {
            return $version;
        }

        return $parts[0];
    }

    /**
     * Do not track browser detection
     *
     * @return bool
     */
    public static function dntEnabled()
    {
        if (Option::get('do_not_track')) {
            return (isset($_SERVER['HTTP_DNT']) && $_SERVER['HTTP_DNT'] == 1) or (function_exists('getallheaders') && isset(getallheaders()['DNT']) && getallheaders()['DNT'] == 1);
        }

        return false;
    }

    public static function getRequestUri()
    {
        if (self::is_rest_request() and isset($_REQUEST['page_uri']) and is_string($_REQUEST['page_uri'])) {
            return sanitize_url(base64_decode($_REQUEST['page_uri']));
        }

        return sanitize_url(wp_unslash($_SERVER['REQUEST_URI']));
    }

    /**
     * Check whether an add-on is active or not
     *
     * @param string $slug
     * @return bool
     */
    public static function isAddOnActive($slug)
    {
        if (!function_exists('is_plugin_active')) {
            include_once(ABSPATH . 'wp-admin/includes/plugin.php');
        }

        $pluginName = sprintf('wp-statistics-%1$s/wp-statistics-%1$s.php', $slug);

        return is_plugin_active($pluginName);
    }

    public static function convertBytes($input)
    {
        $unit  = strtoupper(substr($input, -1));
        $value = (int)$input;
        switch ($unit) {
            case 'G':
                $value *= 1024;
            case 'M':
                $value *= 1024;
            case 'K':
                $value *= 1024;
        }
        return $value;
    }

    public static function checkMemoryLimit()
    {
        if (!function_exists('memory_get_peak_usage') or !function_exists('ini_get')) {
            return false;
        }

        $memoryLimit = ini_get('memory_limit');

        if (memory_get_peak_usage(true) > self::convertBytes($memoryLimit)) {
            return true;
        }

        return false;
    }

    public static function yieldARow($rows)
    {
        $i = 0;
        while ($row = current($rows)) {
            yield $row;
            unset($rows[$i]);
            $i++;
        }
    }

    public static function prepareArrayToStringForQuery($fields = array())
    {
        global $wpdb;

        foreach ($fields as &$value) {
            $value = $wpdb->prepare('%s', $value);
        }

        return implode(', ', $fields);
    }


    /**
     * Formats a number into a string with appropriate units (K, M, B, T).
     *
     * @param int|float $number The number to be formatted.
     * @param int $precision The number of decimal places to round the result to for numbers without units. Default is 0.
     * @return int|float|string Returns the original (or rounded) number if less than 1000, or a formatted string with a unit for numbers 1000 or greater.
     */
    public static function formatNumberWithUnit($number, $precision = 0)
    {
        if (!is_numeric($number)) {
            return 0;
        }

        if ($number < 1000) {
            $precision = empty($precision) ? 2 : $precision;
            $rounded = round($number, $precision);
            return (floor($rounded) == $rounded) ? (int)$rounded : $rounded;
        }

        $originalNumber = $number;
        $units = ['', 'K', 'M', 'B', 'T'];

        $exponent = (int)floor(log($number, 1000));
        $exponent = min($exponent, count($units) - 1);

        $number /= pow(1000, $exponent);
        $unit = $units[$exponent];

        // Choose precision factor
        $factor = ($originalNumber < 10000) ? 100 : 10;
        $number = floor($number * $factor) / $factor;

        // Remove trailing decimals
        $formatted = (floor($number) == $number) ? (int)$number : rtrim(rtrim(number_format($number, 2, '.', ''), '0'), '.');

        return $formatted . $unit;
    }

    /**
     * Filters an array by keeping only the keys specified in the second argument.
     *
     * @param array $arr The array to be filtered.
     * @param array $keys The keys to keep in the array.
     * @return array The filtered array.
     */
    public static function filterArrayByKeys($array, $keys)
    {
        return array_intersect_key($array, array_flip($keys));
    }


    /**
     * Divides two numbers.
     *
     * @param int|float $dividend The number to be divided.
     * @param int|float $divisor The number to divide by.
     * @param int $precision The number of decimal places to round the result to. Default is 1.
     * @return float The result of the division, rounded to the specified precision. Returns 0 if the divisor is 0.
     */
    public static function divideNumbers($dividend, $divisor, $precision = 1)
    {
        if ($divisor == 0) {
            return 0;
        }
        return round($dividend / $divisor, $precision);
    }


    /**
     * Calculates the difference between two dates.
     *
     * @param string $date1 The first date.
     * @param string $date2 The second date.
     */
    public static function calculateDateDifference($date1, $date2 = 'now')
    {
        // Convert dates to DateTime objects
        $datetime1 = new \DateTime($date1);
        $datetime2 = new \DateTime($date2);

        $interval = $datetime1->diff($datetime2);

        if ($interval->y > 0) {
            return _n('a year', sprintf('%d years', $interval->y), $interval->y, 'wp-statistics');
        } elseif ($interval->m > 0) {
            return _n('a month', sprintf('%d months', $interval->m), $interval->m, 'wp-statistics');
        } elseif ($interval->d >= 7) {
            $weeks = floor($interval->d / 7);
            return _n('a week', sprintf('%d weeks', $weeks), $weeks, 'wp-statistics');
        } else {
            return _n('a day', sprintf('%d days', $interval->d), $interval->d, 'wp-statistics');
        }
    }

    /**
     * Retrieves the name of a post type.
     *
     * @param string $postType The post type to retrieve the name for.
     * @param bool $singular Whether to retrieve the singular name or the plural name.
     *
     * @return string The name of the post type.
     */
    public static function getPostTypeName($postType, $singular = false)
    {
        $postTypeObj = get_post_type_object($postType);

        if (empty($postTypeObj)) return '';

        return $singular == true
            ? $postTypeObj->labels->singular_name
            : $postTypeObj->labels->name;
    }

    /**
     * Retrieves the name of a taxonomy.
     *
     * @param string $taxonomy The taxonomy to retrieve the name for.
     * @param bool $singular Whether to retrieve the singular name or the plural name.
     *
     * @return string The name of the taxonomy.
     */
    public static function getTaxonomyName($taxonomy, $singular = false)
    {
        $taxonomy = get_taxonomy($taxonomy);

        if (empty($taxonomy)) return '';

        return $singular == true
            ? $taxonomy->labels->singular_name
            : $taxonomy->labels->name;
    }


    /**
     * Retrieves the country code based on the timezone string.
     *
     * @return string The country code corresponding to the timezone.
     */
    public static function getTimezoneCountry()
    {
        $timezone    = get_option('timezone_string');
        $countryCode = TimeZone::getCountry($timezone);
        return $countryCode;
    }

    /**
     * Returns full DIR of a local URL.
     *
     * @param string $url
     *
     * @return string DIR. Empty on error.
     */
    public static function urlToDir($url)
    {
        // Ensure the URL is within the site scope
        if (stripos($url, home_url()) === false) {
            return '';
        }

        // Extract the plugin name from the URL (basename of the URL)
        $pluginName = basename($url);

        // Get the base directory from WP_PLUGIN_DIR
        $pluginDir = untrailingslashit(WP_PLUGIN_DIR);

        // Combine the plugin directory path with the plugin name
        return wp_normalize_path($pluginDir . '/' . $pluginName);
    }

    public static function getReportEmailTip()
    {
        $is_rtl             = is_rtl();
        $text_align         = $is_rtl ? 'right' : 'left';
        $text_align_reverse = $is_rtl ? 'left' : 'right';
        $tips               = [
            [
                'title'   => __('Optimize Your Content Strategy', 'wp-statistics'),
                'content' => sprintf(
                    __('For maximum accuracy, enable the cache compatibility mode on your website and check your filtering settings. By following these steps, traffic data becomes more accurate. <div style="margin-top: 16px">For more details, read <a href="%1$s" style="color:#5100FD;font-size:14px;line-height:16.41px;font-weight:500;border-bottom: 1px solid #5100FD;text-decoration: none" target="_blank">%2$s <img width="6.67" height="10.91" style="margin-' . $text_align . ':6px" src="%3$s" alt=""></a></div>', 'wp-statistics'),
                    'https://wp-statistics.com/resources/enhancing-data-accuracy/?utm_source=wp-statistics&utm_medium=email&utm_campaign=tips',
                    'Enhancing Data Accuracy',
                    esc_url(WP_STATISTICS_URL . '/assets/images/mail/arrow-blue-' . $text_align_reverse . '.png')
                ),
            ],
            [
                'title'   => __('Optimize Your Data Accuracy', 'wp-statistics'),
                'content' => __(sprintf('For maximum accuracy, enable the cache compatibility mode on your website and check your filtering settings. By following these steps, traffic data becomes more accurate. <div style="margin-top: 16px">For more details, read  <a href="https://wp-statistics.com/resources/enhancing-data-accuracy/?utm_source=wp-statistics&utm_medium=email&utm_campaign=tips" style="color:#5100FD;font-size:14px;line-height:16.41px;font-weight:500;border-bottom: 1px solid #5100FD;text-decoration: none" > %1$s. <img src="' . esc_url(WP_STATISTICS_URL . '/assets/images/mail/arrow-blue-' . $text_align_reverse . '.png') . '" width="6.67" height="10.91" style="margin-' . $text_align . ':6px" alt="Read more"></a></div>', 'Enhancing Data Accuracy '), 'wp-statistics'),
            ],
            [
                'title'   => __('Keep the plugin up-to-date', 'wp-statistics'),
                'content' => __('Ensure that your WP Statistics plugin is up-to-date in order to get the latest features and security improvements.', 'wp-statistics'),
            ],
            [
                'title'   => __('Maintain Privacy Compliance', 'wp-statistics'),
                'content' => __(sprintf('To ensure that your website complies with the latest privacy standards, use the Privacy Audit feature in WP Statistics. It provides actionable recommendations for improving your privacy compliance by assessing your WP Statistics\' current settings.<div style="margin-top: 16px"> For more information, refer to our <a href="https://wp-statistics.com/resources/privacy-audit/?utm_source=wp-statistics&utm_medium=email&utm_campaign=privacy" style="color:#5100FD;font-size:14px;line-height:16.41px;font-weight:500;border-bottom: 1px solid #5100FD;text-decoration: none">Privacy Audit Guide <img src="' . esc_url(WP_STATISTICS_URL . '/assets/images/mail/arrow-blue-' . $text_align_reverse . '.png') . '" width="6.67" height="10.91" style="margin-' . $text_align . ':6px" alt="Read more"></a></div>'), 'wp-statistics'),
            ],
            [
                'title'   => __('WordPress Export and Erasure', 'wp-statistics'),
                'content' => __(sprintf('If you record PII data with WP Statistics, use WordPress data export and erasure features to manage this information. This ensures compliance with privacy regulations like GDPR.<div style="margin-top: 16px"> For more details, see our <a href="https://wp-statistics.com/resources/compliant-with-wordpress-data-export-and-erasure/?utm_source=wp-statistics&utm_medium=email&utm_campaign=tips" style="color:#5100FD;font-size:14px;line-height:16.41px;font-weight:500;border-bottom: 1px solid #5100FD;text-decoration: none">Data Export and Erasure Guide <img src="' . esc_url(WP_STATISTICS_URL . '/assets/images/mail/arrow-blue-' . $text_align_reverse . '.png') . '" width="6.67" height="10.91" style="margin-' . $text_align . ':6px" alt="Read more"></a></div>'), 'wp-statistics'),
            ],
            [
                'title'   => __('Track Links and Downloads', 'wp-statistics'),
                'content' => __(sprintf('Track how users interact with your site\'s links and downloads using the Link and Download Tracker feature. You can use this information to improve content engagement and understand user behavior. <div style="margin-top: 16px"><a href="https://wp-statistics.com/add-ons/wp-statistics-data-plus/?utm_source=wp-statistics&utm_medium=email&utm_campaign=dp" style="color:#5100FD;font-size:14px;line-height:16.41px;font-weight:500;border-bottom: 1px solid #5100FD;text-decoration: none">Read more <img src="' . esc_url(WP_STATISTICS_URL . '/assets/images/mail/arrow-blue-' . $text_align_reverse . '.png') . '" width="6.67" height="10.91" style=" margin-' . $text_align . ':6px" alt="Read more"></a></div>'), 'wp-statistics'),
            ],
            [
                'title'   => __('Advanced Filtering', 'wp-statistics'),
                'content' => __(sprintf('Analyze specific query parameters, including UTM tags, for each piece of content. Tracking marketing campaigns and engagement allows you to refine your strategies and maximize their impact. <div style="margin-top: 16px"><a href="https://wp-statistics.com/add-ons/wp-statistics-data-plus/?utm_source=wp-statistics&utm_medium=email&utm_campaign=dp" style="color:#5100FD;font-size:14px;line-height:16.41px;font-weight:500;border-bottom: 1px solid #5100FD;text-decoration: none">Read more <img src="' . esc_url(WP_STATISTICS_URL . '/assets/images/mail/arrow-blue-' . $text_align_reverse . '.png') . '" width="6.67" height="10.91" style="margin-' . $text_align . ':6px" alt="Read more"></a></div>'), 'wp-statistics'),
            ],
            [
                'title'   => __('Weekly Performance Overview', 'wp-statistics'),
                'content' => __(sprintf('On the Overview page, the Weekly Performance Overview widget provides a quick snapshot of your main metrics. You can analyze traffic changes, identify trends, and make data-driven decisions to improve your site\'s performance with this feature. <div style="margin-top: 16px"><a href="https://wp-statistics.com/add-ons/wp-statistics-data-plus/?utm_source=wp-statistics&utm_medium=email&utm_campaign=dp" style="color:#5100FD;font-size:14px;line-height:16.41px;font-weight:500;border-bottom: 1px solid #5100FD;text-decoration: none">Read more <img src="' . esc_url(WP_STATISTICS_URL . '/assets/images/mail/arrow-blue-' . $text_align_reverse . '.png') . '" width="6.67" height="10.91" style="margin-' . $text_align . ':6px" alt="Read more"></a></div>'), 'wp-statistics'),
            ],
            [
                'title'   => __('Traffic by Hour Widget', 'wp-statistics'),
                'content' => __(sprintf('On the Overview page, the Traffic by Hour widget displays visitor patterns by hour. Ensure maximum engagement and efficiency by optimizing server resources and scheduling content releases for peak visitor times. <div style="margin-top: 16px"><a href="https://wp-statistics.com/add-ons/wp-statistics-data-plus/?utm_source=wp-statistics&utm_medium=email&utm_campaign=dp" style="color:#5100FD;font-size:14px;line-height:16.41px;font-weight:500;border-bottom: 1px solid #5100FD;text-decoration: none">Read more <img src="' . esc_url(WP_STATISTICS_URL . '/assets/images/mail/arrow-blue-' . $text_align_reverse . '.png') . '" width="6.67" height="10.91" style="margin-' . $text_align . ':6px" alt="Read more"></a></div>'), 'wp-statistics'),
            ],
            [
                'title'   => __('Content-Specific Analytics', 'wp-statistics'),
                'content' => __(sprintf('Analyze each piece of content in detail, including views, visitor locations, and online visitors. Based on user data, these insights can help you optimize content. <div style="margin-top: 16px"><a href="https://wp-statistics.com/add-ons/wp-statistics-data-plus/?utm_source=wp-statistics&utm_medium=email&utm_campaign=dp" style="color:#5100FD;font-size:14px;line-height:16.41px;font-weight:500;border-bottom: 1px solid #5100FD;text-decoration: none">Read more <img src="' . esc_url(WP_STATISTICS_URL . '/assets/images/mail/arrow-blue-' . $text_align_reverse . '.png') . '" width="6.67" height="10.91" style="margin-' . $text_align . ':6px" alt="Read more"></a></div>'), 'wp-statistics'),
            ],
            [
                'title'   => __('Custom Post Type Tracking', 'wp-statistics'),
                'content' => __(sprintf('Track all custom post types as well as posts and pages. This ensures complete analytics across all content types on your site. <div style="margin-top: 16px"><a href="https://wp-statistics.com/add-ons/wp-statistics-data-plus/?utm_source=wp-statistics&utm_medium=email&utm_campaign=dp" style="color:#5100FD;font-size:14px;line-height:16.41px;font-weight:500;border-bottom: 1px solid #5100FD;text-decoration: none">Read more <img src="' . esc_url(WP_STATISTICS_URL . '/assets/images/mail/arrow-blue-' . $text_align_reverse . '.png') . '" width="6.67" height="10.91" style="margin-' . $text_align . ':6px" alt="Read more"></a></div>'), 'wp-statistics'),
            ],
            [
                'title'   => __('Custom Taxonomy Analytics', 'wp-statistics'),
                'content' => __(sprintf('Track custom taxonomies along with default taxonomies like Categories and Tags to gain deeper insights into all taxonomies used on your site. <div style="margin-top: 16px"><a href="https://wp-statistics.com/add-ons/wp-statistics-data-plus/?utm_source=wp-statistics&utm_medium=email&utm_campaign=dp" style="color:#5100FD;font-size:14px;line-height:16.41px;font-weight:500;border-bottom: 1px solid #5100FD;text-decoration: none">Read more <img src="' . esc_url(WP_STATISTICS_URL . '/assets/images/mail/arrow-blue-' . $text_align_reverse . '.png') . '" width="6.67" height="10.91" style="margin-' . $text_align . ':6px" alt="Read more"></a></div>'), 'wp-statistics'),
            ],
            [
                'title'   => __('Real-Time Stats', 'wp-statistics'),
                'content' => __(sprintf('Monitor your website\'s traffic and activity in real time. Your WordPress statistics are displayed instantly, so you don\'t need to refresh your page every time someone visits your blog. Watch your website\'s performance live. <div style="margin-top: 16px"><a href="https://wp-statistics.com/add-ons/wp-statistics-realtime-stats/?utm_source=wp-statistics&utm_medium=email&utm_campaign=realtime" style="color:#5100FD;font-size:14px;line-height:16.41px;font-weight:500;border-bottom: 1px solid #5100FD;text-decoration: none">Read more <img src="' . esc_url(WP_STATISTICS_URL . '/assets/images/mail/arrow-blue-' . $text_align_reverse . '.png') . '" width="6.67" height="10.91" style="margin-' . $text_align . ':6px" alt="Read more"></a></div>'), 'wp-statistics'),
            ],
            [
                'title'   => __('Mini Chart', 'wp-statistics'),
                'content' => __(sprintf('Track your content\'s performance with mini charts. Quick access to traffic data is provided by an admin bar. The chart type and color can be customized according to your preferences. Analyze your content\'s performance and make informed decisions to enhance its success. <div style="margin-top: 16px"><a href="https://wp-statistics.com/add-ons/wp-statistics-mini-chart/?utm_source=wp-statistics&utm_medium=email&utm_campaign=mini-chart" style="color:#5100FD;font-size:14px;line-height:16.41px;font-weight:500;border-bottom: 1px solid #5100FD;text-decoration: none">Read more <img src="' . esc_url(WP_STATISTICS_URL . '/assets/images/mail/arrow-blue-' . $text_align_reverse . '.png') . '" width="6.67" height="10.91" style="margin-' . $text_align . ':6px" alt=""></a></div>'), 'wp-statistics'),
            ],
        ];

        return $tips[array_rand($tips)];
    }

    /**
     * Get the device category name
     * Remove device subtype, for example: mobile:smart -> mobile
     *
     * @param string $device
     *
     * @return string
     */
    public static function getDeviceCategoryName($device)
    {
        $device = $device ?? '';

        if (strpos($device, ':') !== false) {
            $device = explode(':', $device)[0];
        }

        return $device;
    }

    /**
     * Get default date format
     * @param bool $withTime
     * @return string
     */
    public static function getDefaultDateFormat($withTime = false, $excludeYear = false, $shortMonth = false, $dateTimeSeparator = ' ')
    {
        $dateFormat = get_option('date_format');
        $timeFormat = get_option('time_format');

        if (empty($dateFormat)) {
            $dateFormat = 'Y-m-d';
        }

        if (empty($timeFormat)) {
            $timeFormat = 'g:i a';
        }

        $dateTimeFormat = $withTime ? $dateFormat . $dateTimeSeparator . $timeFormat : $dateFormat;

        if ($excludeYear) {
            $dateTimeFormat = preg_replace('/(,\s?Y|Y\s?,|Y[, \/-]?|[, \/-]?Y)/i', '', $dateTimeFormat);
        }

        if ($shortMonth) {
            $dateTimeFormat = str_replace('F', 'M', $dateTimeFormat);
        }

        return $dateTimeFormat;
    }

    /**
     * Checks if the WordPress admin bar is showing and can current user see it?
     *
     * @return  boolean
     */
    public static function isAdminBarShowing()
    {
        $showAdminBar = (Option::get('menu_bar') && is_admin_bar_showing() && User::Access());

        /**
         * Filters whether to show the WordPress admin bar.
         *
         * @example add_filter('wp_statistics_show_admin_bar', '__return_false');
         */
        return apply_filters('wp_statistics_show_admin_bar', $showAdminBar);
    }

    /**
     * Calculates percentage difference between two numbers.
     *
     * @param int|float $firstNumber  The previous period value (baseline for comparison)
     * @param int|float $secondNumber The current period value
     * @param int $decimals
     * @param bool $abs
     *
     * @return float|null Returns null if firstNumber is 0 (no previous data to compare against)
     */
    public static function calculatePercentageChange($firstNumber, $secondNumber, $decimals = 2, $abs = false)
    {
        $firstNumber  = intval($firstNumber);
        $secondNumber = intval($secondNumber);
        
        if ($firstNumber == 0) {
            return null;
        }

        if ($firstNumber == $secondNumber) {
            return 0;
        }

        // Multiply the final result by -1 if the second number is smaller (decreasing change)
        $multiply = 1;
        if ($firstNumber > $secondNumber) {
            $multiply = -1;
        }

        // The first part of the formula depends on whether it's an increasing change or decreasing
        $change = $firstNumber > $secondNumber ? $firstNumber - $secondNumber : $secondNumber - $firstNumber;

        // Final part of the formula: ($change / $firstNumber) * 100
        $result = ($change / $firstNumber) * 100;
        $result *= $multiply;

        $result = round($result, $decimals);

        return $abs ? abs($result) : $result;
    }

    /**
     * Checks if "Anonymous Tracking" option is enabled and user hasn't given consent yet.
     *
     * In this case, we have to track user's information anonymously.
     *
     * @deprecated use `IntegrationHelper::shouldTrackAnonymously()` method
     *
     * @return  bool
     */
    public static function shouldTrackAnonymously()
    {
        $isConsentGiven    = IntegrationHelper::isConsentGiven();
        $anonymousTracking = IntegrationHelper::shouldTrackAnonymously();

        return !$isConsentGiven && $anonymousTracking;
    }

    /**
     * Checks if the WP Statistics request signature is enabled.
     *
     * This function uses the 'wp_statistics_request_signature_enabled' filter to determine if the request
     * signature feature in WP Statistics is enabled. By default, it returns true, but this can be modified
     * by using the filter in other parts of your theme or plugin.
     *
     * @return bool True if the request signature feature is enabled, otherwise false.
     */
    public static function isRequestSignatureEnabled()
    {
        return apply_filters('wp_statistics_request_signature_enabled', true);
    }

    /**
     * Verifies the hit request signature against the request data that is
     * actually recorded.
     *
     * The signed payload is read from the same source ($_REQUEST) that the
     * recording path uses, so the values that are authenticated are always the
     * values that get stored. Reading the signed fields from a different source
     * (for example WP_REST_Request::get_param(), which prefers a JSON body over
     * the query string) would let a request be authenticated with one identity
     * while a different identity is recorded.
     *
     * @return bool True when signatures are disabled or the signature is valid.
     */
    public static function verifyHitSignature()
    {
        if (!self::isRequestSignatureEnabled()) {
            return true;
        }

        $signature  = (isset($_REQUEST['signature']) && is_string($_REQUEST['signature'])) ? wp_unslash($_REQUEST['signature']) : '';
        $sourceType = (isset($_REQUEST['source_type']) && is_string($_REQUEST['source_type'])) ? wp_unslash($_REQUEST['source_type']) : '';
        $sourceId   = isset($_REQUEST['source_id']) ? (int) $_REQUEST['source_id'] : 0;

        return Signature::check([$sourceType, $sourceId], $signature);
    }

    /**
     * Generates a URL with the specified column as the `order_by` parameter and the current order as the `order` parameter.
     * @param string $orderBy The column name to sort by
     * @return string The generated URL.
     */
    public static function getTableColumnSortUrl($orderBy)
    {
        $order        = Request::get('order', 'desc');
        $reverseOrder = $order == 'desc' ? 'asc' : 'desc';

        return add_query_arg([
                'order_by' => $orderBy,
                'order'    => Request::compare('order_by', $orderBy) ? $reverseOrder : 'desc']
        );
    }

    /**
     * Checks if the given mini-chart option is set to the given value.
     *
     * @param string $optionName
     * @param string $value
     * @param string $default
     *
     * @return  bool    True if mini-chart add-on is enabled and `$optionName` is set to `$value`.
     */
    public static function checkMiniChartOption($optionName, $value, $default = null)
    {
        return Helper::isAddOnActive('mini-chart') && Option::getByAddon($optionName, 'mini_chart', $default) === $value;
    }

    /**
     * Provides a list of regular expression patterns for detecting SQL injection and XSS attacks.
     *
     * @return array The array of regular expression patterns.
     */
    public static function injectionPatterns()
    {
        $patterns = [
            '/[\'"\(](?:\s|%20)*UNION(?:\s|%20)*SELECT\b/i',    // ' " ( UNION SELECT
            '/[\'"\(](?:\s|%20)*INSERT(?:\s|%20)*INTO\b/i',     // ' " ( INSERT INTO
            '/[\'"\(](?:\s|%20)*UPDATE\b/i',                    // ' " ( UPDATE
            '/[\'"\(](?:\s|%20)*DELETE\b/i',                    // ' " ( DELETE
            '/[\'"\(](?:\s|%20)*SELECT\b/i',                    // ' " ( SELECT
            '/[\'"\(](?:\s|%20)*DROP\b/i',                      // ' " ( DROP
            '/[\'"\(](?:\s|%20)*ALTER\b/i',                     // ' " ( ALTER

            // Oracle injection
            '/DBMS_PIPE\.(RECEIVE_MESSAGE|SEND_MESSAGE)/i',

            // SQL comment injection
            '/[\'"\(](?:\s|%20)*--(?:\s|%20)*/i',               // ' " ( --
            '/[\'"\(](?:\s|%20)*#(?:\s|%20)*/i',                // ' " ( #

            // Logical operator based SQL injection
            '/[\'"\(](?:\s|%20)*OR(?:\s|%20)*\d+(?:\s|%20)*=(?:\s|%20)*\d+/i',  // ' " ( OR 1 = 1
            '/[\'"\(](?:\s|%20)*XOR(?:\s|%20)*/i',              // ' " ( XOR

            // Function-based SQL injection
            '/(?:\s|%20)*now\(/i',                                           // now(
            '/(?:\s|%20)*sysdate\(/i',                                       // sysdate(
            '/(?:\s|%20)*sleep\(/i',                                         // sleep(
            '/[\'"\(](?:\s|%20)*benchmark(?:\s|%20)*\(\d+,(?:\s|%20)*/i',   // ' " ( benchmark(10,

            // XSS patterns
            '/<script\b[^>]*>(.*?)<\/script>/is',               // <script>...</script>
            '/<[^>]+on[a-z]+\s*=\s*"[^"]*"/i',                  // <tag onEvent="...">
            '/<[^>]+on[a-z]+\s*=\s*\'[^\']*\'/i',               // <tag onEvent='...'>

            // URL-encoded attacks
            '/(?:%27|%22|%28)(?:\s|%20)*UNION(?:\s|%20)*SELECT/i',     // %27 %22 %28 UNION SELECT
            '/(?:%27|%22|%28)(?:\s|%20)*OR(?:\s|%20)*1(?:\s|%20)*=(?:\s|%20)*1/i',  // %27 %22 %28 OR 1 = 1
            '/(?:%27|%22|%28)(?:\s|%20)*XOR(?:\s|%20)*/i',             // %27 %22 %28 XOR
            '/(?:%27|%22|%28)(?:\s|%20)*SLEEP(?:\s|%20)*\(/i',         // %27 %22 %28 SLEEP(

            // XSS patterns
            '/<script\b[^>]*>(.*?)<\/script>/is',  // <script>...</script>
            '/<[^>]+on[a-z]+\s*=\s*"[^"]*"/i',     // <tag onEvent="...">
            '/<[^>]+on[a-z]+\s*=\s*\'[^\']*\'/i',  // <tag onEvent='...'>
        ];

        return apply_filters('wp_statistics_injection_patterns', $patterns);
    }

    /**
     * Validates the hit request parameters to prevent invalid requests from stats.
     *
     * @return bool True if the request is valid, throws an error otherwise.
     * @throws ErrorException If the request parameters are invalid.
     */
    public static function validateHitRequest()
    {
        $isValid = Request::validate([
            'page_uri'     => [
                'required'        => true,
                'nullable'        => true,
                'type'            => 'string',
                'encoding'        => 'base64',
                'invalid_pattern' => self::injectionPatterns()
            ],
            'search_query' => [
                'required'        => true,
                'nullable'        => true,
                'type'            => 'string',
                'encoding'        => 'base64',
                'invalid_pattern' => self::injectionPatterns()
            ],
            'source_id'    => [
                'type'     => 'number',
                'required' => true,
                'nullable' => false
            ],
            'referred'     => [
                'required' => true,
                'nullable' => true,
                'type'     => 'url',
                'encoding' => 'base64'
            ],
        ]);

        if (!$isValid) {
            /**
             * Trigger action after validating the hit request parameters.
             *
             * @param bool $isValid Indicates if the request parameters are valid.
             * @param string $ipAddress The IP address of the requester.
             */
            do_action('wp_statistics_invalid_hit_request', $isValid, IP::getIP());

            throw new ErrorException(esc_html__('Invalid hit/online request.', 'wp-statistics'));
        }

        return true;
    }

    public static function checkUrlForParams($url, $params)
    {
        // Parse the URL and extract the query string
        $queryString = wp_parse_url($url, PHP_URL_QUERY);

        // If there's no query string, return false
        if (!$queryString) {
            return false;
        }

        // Parse the query string into an array
        parse_str($queryString, $queryParams);

        foreach ($params as $param) {
            // If param is found, return true
            if (array_key_exists($param, $queryParams)) {
                return true;
            }
        }

        // If param is not found, return false
        return false;
    }

    /**
     * Gets the start of week string.
     *
     * This function returns the string value of the start of week day.
     *
     * @return string The start of week string (e.g. 'monday', 'tuesday', etc.)
     * @deprecated 14.11 Use WP_Statistics\Components\DateTime::getStartOfWeek instead.
     */
    public static function getStartOfWeek()
    {
        _deprecated_function(__METHOD__, '14.11', 'WP_Statistics\Components\DateTime::getStartOfWeek');

        return DateTime::getStartOfWeek();
    }

    /**
     * Returns the data needed for "Your performance at a glance" section (mostly used in e-mail reports).
     *
     * @param string $startDate Start date of the report in `Y-m-d` format.
     * @param string $endDate End date of the report in `Y-m-d` format. Default: today.
     *
     * @return array
     *
     * @deprecated 14.10.1 Use `WP_Statistics\Service\Admin\WebsitePerformance\WebsitePerformanceDataProvider()` instead.
     */
    public static function getWebsitePerformanceSummary($startDate, $endDate = '')
    {
        _deprecated_function(__METHOD__, '14.10.1', 'WP_Statistics\Service\Admin\WebsitePerformance\WebsitePerformanceDataProvider()');

        return [];
    }

    /**
     * Generates a link to an external GeoIP tool for IP information.
     *
     * @param string $ip The IP address to query.
     * @return string URL to the GeoIP tool with the IP parameter.
     */
    public static function geoIPTools($ip)
    {
        return "https://redirect.li/map/?ip={$ip}";
    }

    /**
     * Is the given string a JSON object?
     *
     * @param string $string
     *
     * @return bool
     */
    public static function isJson($string)
    {
        json_decode($string);

        return json_last_error() === JSON_ERROR_NONE;
    }

    /**
     * Get the date of the first published post on the site.
     *
     * @return string
     */
    public static function getInitialPostDate()
    {
        $postModel = new PostsModel();

        $initialDate = $postModel->getInitialPostDate();
        $initialDate = !empty($initialDate) ? $initialDate : 0;

        return DateTime::format($initialDate, ['date_format' => 'Y-m-d']);
    }

    /**
     * Check if the length of the given string is between the given minimum and maximum length.
     *
     * @param string $string
     * @param int $minLength
     * @param int $maxLength
     *
     * @return bool
     */
    public static function isStringLengthBetween($string, $minLength, $maxLength)
    {
        $length = strlen($string);
        return $length >= $minLength && $length <= $maxLength;
    }


    /**
     * Calculate the percentage of the given number based on total number.
     *
     * @param int $number
     * @param int $totalNumber
     *
     * @return float
     */
    public static function calculatePercentage($number, $totalNumber)
    {
        if ($totalNumber == 0) {
            return 0;
        }

        return round(($number / $totalNumber) * 100, 1);
    }

    /**
     * Get relative path for any post type or taxonomy term
     *
     * @param int $id The post ID or term ID
     * @param string $type Post type or taxonomy name
     * @return string Relative path or empty string
     */
    public static function getResourcePath($id, $type)
    {
        if (!$type || !$id) {
            return '';
        }

        if ($type === 'author') {
            $author = get_user_by('id', $id);

            if (!$author) {
                return '';
            }

            return wp_make_link_relative(get_author_posts_url($id));
        }

        if (taxonomy_exists($type)) {
            $term = get_term($id, $type);

            if (is_wp_error($term) || !$term) {
                return '';
            }

            return wp_make_link_relative(get_term_link($term));
        }

        if (post_type_exists($type)) {
            $post = get_post($id);

            if (is_wp_error($post) || !$post || $post->post_type !== $type) {
                return '';
            }

            return wp_make_link_relative(get_permalink($post));
        }

        return '';
    }

    /**
     * Relocates items from source indexes to a target position in an array
     *
     * @param array $array The original array
     * @param mixed $sourceIndex Array of source indexes to relocate
     * @param int $targetIndex The target position where items should be inserted
     * @return array The modified array with relocated items
     */
    public static function relocateArrayItems($array, $sourceIndex, $targetIndex)
    {
        // Extract the items to be relocated
        $itemToRelocate = [];

        if (isset($array[$sourceIndex])) {
            $itemToRelocate[] = $array[$sourceIndex];
            unset($array[$sourceIndex]);
        }

        // Reindex the array
        $array = array_values($array);

        // Reverse the items to maintain original order when inserted
        $itemsToRelocate = array_reverse($itemToRelocate);

        // Insert items at the target position
        array_splice($array, $targetIndex, 0, $itemsToRelocate);

        return $array;
    }

    public static function getNoDataMessage($date = '')
    {
        if (empty($date)) {
            $date = DateRange::get()['to'];
        }

        $isFutureDate = DateTime::isTodayOrFutureDate($date);

        $message = esc_html__('No data found for this date range.', 'wp-statistics');

        if ($isFutureDate) {
            $message = esc_html__('Data coming soon!', 'wp-statistics');
        }

        return $message;
    }

    /**
     * Return available schedules for report delivery.
     *
     * @return array
     */
    public static function getReportSchedules()
    {
        $schedules = Schedule::getSchedules();

        // Filter out non-report schedules
        $schedules = self::filterArrayByKeys($schedules, ['daily', 'weekly', 'biweekly', 'monthly']);

        return $schedules;
    }

    /**
     * Finds an item in an array that matches the given key and value.
     *
     * @param array $array The array to search in
     * @param string $key The key to search for
     * @param mixed $value The value to search for
     *
     * @return array|null The found item, or null if not found
     */
    public static function findInArray($array, $key, $value)
    {
        foreach ($array as $item) {
            if (isset($item[$key]) && $item[$key] === $value) {
                return $item;
            }
        }

        return null;
    }

    /**
     * Maps array keys based on a provided mapping array.
     *
     * @param array $array The arguments array to transform.
     * @param array $keyMap The mapping array where keys are old keys and values are new keys.
     * @return array The transformed arguments array.
     */
    public static function mapArrayKeys($array, $keyMap)
    {
        foreach ($keyMap as $oldKey => $newKey) {
            if (isset($array[$oldKey])) {
                $array[$newKey] = $array[$oldKey];
                unset($array[$oldKey]);
            }
        }

        return $array;
    }
}
