JezK

Edit File: HelperFunctions.php

<?php
/**
 * Helper class for kirki project
 *
 * @package kirki
 */

namespace Kirki;

if (!defined('ABSPATH')) {
	exit; // Exit if accessed directly.
}

use DateTime;
use Kirki\Ajax\Collaboration\Collaboration;
use Kirki\Ajax\Page;
use Kirki\Ajax\RBAC;
use Kirki\Staging;
use Kirki\Ajax\Symbol;
use Kirki\Ajax\UserData;
use Kirki\Ajax\Users;
use Kirki\Ajax\WpAdmin;
use Kirki\API\ContentManager\ContentManagerHelper;
use Kirki\App\Supports\Facades\Page as FacadesPage;
use Kirki\App\Supports\FileHandler;
use Kirki\Frontend\Preview\DataHelper;
use Kirki\Frontend\Preview\Preview;
use WP_Post;
use WP_Query;
use WP_Term;
use WP_User;

/**
 * HelperFunctions Class
 */
class HelperFunctions
{

public static $custom_sections = [];
	public static $global_session_id = false;

private static $posts_where_filter_params = array();
	/**
	 * Load assets for Editor
	 *
	 * @param string $for TheFrontend | null.
	 * @return false || array
	 */
	public static function is_kirki_type_data($post_id = false, $staging_version = false)
	{
		if (!$post_id) {
			$post_id = self::get_post_id_if_possible_from_url();
			if (!$post_id)
				return false;
		}

if (!self::is_editor_mode_is_kirki($post_id)) {
			return false;
		}
		if ($staging_version) {
			return Staging::get_page_staging_data($post_id, $staging_version);
		}

$kirki_data = get_post_meta($post_id, 'kirki', true);
		if (!$kirki_data) {
			$kirki_data = array();
			$kirki_data['blocks'] = null;
		}

$styles = self::get_page_styleblocks($post_id, $staging_version);

$kirki_data['styles'] = isset($styles) ? $styles : '';

return $kirki_data;
	}

/**
	 * @deprecated
	 * @see \Kirki\App\Utils\PostUtil::get_post_id_from_url()
	 */
	public static function get_post_id_if_possible_from_url()
	{
		if (isset($GLOBALS['wp']->query_vars[KIRKI_CONTENT_MANAGER_PREFIX . '_child_post'])) {
			return $GLOBALS['wp']->query_vars[KIRKI_CONTENT_MANAGER_PREFIX . '_child_post'];
		} else if (isset($GLOBALS['wp']->query_vars[KIRKI_CONTENT_MANAGER_PREFIX . '_parent_post']) && false) {//disable content manager archive page logic
			return $GLOBALS['wp']->query_vars[KIRKI_CONTENT_MANAGER_PREFIX . '_parent_post'];
		}

$post_id = get_the_ID();
		$post_id = self::sanitize_text(isset($_GET['post_id']) ? $_GET['post_id'] : $post_id);
		$post_id = self::sanitize_text(isset($_POST['post_id']) ? $_POST['post_id'] : $post_id);
		$post_id = self::sanitize_text(isset($_GET['p']) ? $_GET['p'] : $post_id);

return (int) $post_id;
	}

/**
	 * Get author/user id if possible from url
	 */
	public static function get_user_id_if_possible_from_url()
	{
		if (isset($GLOBALS['wp']->query_vars[KIRKI_CONTENT_MANAGER_PREFIX . '_user'])) {
			return $GLOBALS['wp']->query_vars[KIRKI_CONTENT_MANAGER_PREFIX . '_user'];
		}

$user_id = '';
		if (isset($GLOBALS['wp']->query_vars['author_name'])) {
			$user = get_user_by('slug', $GLOBALS['wp']->query_vars['author_name']);
			if ($user instanceof WP_User) {
				$user_id = $user->ID;
			}
		} else {
			$user_id = get_current_user_id();
		}

return (int) $user_id;
	}

/**
	 * Get all user roles by access levels
	 * @param array $access_levels access levels => array(KIRKI_ACCESS_LEVELS['FULL_ACCESS'], KIRKI_ACCESS_LEVELS['CONTENT_ACCESS']);
	 *
	 * @return array roles => array ('editor', 'author');
	 */
	public static function get_all_user_roles_by_access_levels($access_levels = array())
	{
		$all_roles = RBAC::get_all_roles();
		$roles_with_access = RBAC::get_access_level($all_roles);

$filtered_roles = [];

$filtered_roles = array_filter($roles_with_access, function ($level) use ($access_levels) {
			return in_array($level, $access_levels);
		});

return array_keys($filtered_roles);
	}

/**
	 * Get term or tag id if possible from url
	 */
	public static function get_term_id_if_possible_from_url()
	{
		if (isset($GLOBALS['wp']->query_vars[KIRKI_CONTENT_MANAGER_PREFIX . '_term'])) {
			return $GLOBALS['wp']->query_vars[KIRKI_CONTENT_MANAGER_PREFIX . '_term'];
		}

// http://kirki.test/tag/wp-tag-2/
		$term_id = get_queried_object_id();
		$term = null;

if ($term_id) {
			$term = get_term($term_id);
		} else if (isset($GLOBALS['wp']->query_vars['tag'])) {
			$term = get_term_by('slug', $GLOBALS['wp']->query_vars['tag'], 'post_tag');
		}

if ($term instanceof WP_Term) {
			$term_id = $term->term_id;
		}

if (!$term_id) {
			// get all terms and return the first one
			$term = get_terms(array(
				'taxonomy' => 'category',
				'hide_empty' => false,
				'number' => 1,
			));

$term_id = isset($term[0], $term[0]->term_id) ? $term[0]->term_id : 1;
		}

return (int) $term_id;
	}

/**
	 * @deprecated
	 * @see Kirki\App\Services\PageService::save_page_data()
	 * @see \Kirki\App\Services\GlobalDataService::save_styles()
	 */
	public static function save_kirki_data_to_db($post_id, $page_data, $is_staging = false)
	{
		$version_where_saved = false;
		if ($is_staging) {
			$data = Staging::save_page_staging_data_to_db($post_id, $page_data);
			$page_data = $data['page_data'];
			$version_where_saved = $data['version'];
		}

if (isset($page_data['styles'])) {
			$global_style_blocks_for_collaboration = [];
			foreach ($page_data['styles'] as $key => $sb) {
				if ((isset($sb['isDefault']) && $sb['isDefault'] === true) || (isset($sb['isGlobal']) && $sb['isGlobal'] === true)) {
					if (isset($sb['fromStage'])) {
						unset($page_data['styles'][$key]['fromStage']);
						$global_style_blocks_for_collaboration[$key] = $page_data['styles'][$key];
					} else
						unset($page_data['styles'][$key]);
				}
			}
			if (count($global_style_blocks_for_collaboration) > 0) {
				$session_id = self::sanitize_text(isset($_REQUEST['session_id']) ? $_REQUEST['session_id'] : '');
				if ($session_id && $is_staging === false) {
					// cause template import also called this method without session_id
					$data = array(
						'type' => 'COLLABORATION_UPDATE_GLOBAL_STYLE',
						'payload' => array('styleBlock' => $global_style_blocks_for_collaboration),
					);
					Collaboration::save_action_to_db('global', 0, $data, 1, $session_id);
				}
			}

self::update_page_styleblocks($post_id, $page_data['styles']);
			unset($page_data['styles']);
		}

if (isset($page_data['usedStyles'])) {
			update_post_meta($post_id, KIRKI_META_NAME_FOR_USED_STYLE_BLOCK_IDS, $page_data['usedStyles']);
			unset($page_data['usedStyles']);
		}

if (isset($page_data['usedStyleIdsRandom'])) {
			update_post_meta($post_id, KIRKI_META_NAME_FOR_USED_STYLE_BLOCK_IDS . '_random', $page_data['usedStyleIdsRandom']);
			unset($page_data['usedStyleIdsRandom']);
		}

if (isset($page_data['usedFonts'])) {
			update_post_meta($post_id, KIRKI_META_NAME_FOR_USED_FONT_LIST, $page_data['usedFonts']);
			unset($page_data['usedFonts']);
		}

if (isset($page_data['customFonts'])) {
			//save others data if isset. this is for template import
			$custom_fonts = self::get_global_data_using_key(KIRKI_USER_CUSTOM_FONTS_META_KEY);
			foreach ($page_data['customFonts'] as $key => $cf) {
				$custom_fonts[$key] = $cf;
			}
			self::update_global_data_using_key(KIRKI_USER_CUSTOM_FONTS_META_KEY, $custom_fonts);
			unset($page_data['customFonts']);
		}

if (isset($page_data['viewportList'])) {
			//save others data if isset. this is for template import
			$controller_data = self::get_global_data_using_key(KIRKI_USER_CONTROLLER_META_KEY);
			if (!$controller_data) {
				$init = array(
					'active' => 'md',
					'defaults' => ["md", "tablet", "mobileLandscape", "mobile"],
					'list' => $page_data['viewportList'],
					'mdWidth' => 1200,
					"scale" => 1,
					"width" => 2484,
					"zoom" => 1
				);
				$controller_data = array('viewport' => $init);
			} else if (isset($controller_data['viewport'], $controller_data['viewport']['list'])) {
				$controller_data['viewport']['list'] = $page_data['viewportList'];
			}

HelperFunctions::update_global_data_using_key(KIRKI_USER_CONTROLLER_META_KEY, $controller_data);
			unset($page_data['viewportList']);
		}

if (isset($page_data['blocks'])) {
			update_post_meta($post_id, 'kirki', array('blocks' => $page_data['blocks']));
			// $data = array(
			// 	'type'    => 'COLLABORATION_PAGE_DATA',
			// 	'payload' => array( 'data' => $page_data['blocks'] ),
			// );
			//Collaboration::save_action_to_db( 'post', $post_id, $data, 1 );
		}

update_post_meta($post_id, KIRKI_META_NAME_FOR_POST_EDITOR_MODE, 'kirki');
		return $version_where_saved;
	}

/**
	 * 
	 */
	function abc()
	{

}

/**
	 * This function will return page style blocks from option meta and post meta
	 * post meta for migration and option meta for global style block
	 *
	 * @param int $post_id post id.
	 * @return object
	 * 
	 * @todo: 
	 * 
	 * @deprecated
	 * @see Kirki\App\Managers\PageManager::get_page_styleblocks()
	 */
	public static function get_page_styleblocks($post_id, $stage_version = false)
	{
		return FacadesPage::get_page_styleblocks($post_id, $stage_version);

// $random_style_blocks = get_post_meta($post_id, KIRKI_GLOBAL_STYLE_BLOCK_META_KEY . '_random', true);
		// $global_style_blocks = self::get_global_data_using_key(KIRKI_GLOBAL_STYLE_BLOCK_META_KEY);

// $random_style_blocks = self::fix_duplicate_class_name_from_random_sbs($random_style_blocks, $global_style_blocks);

// $merged_style_blocks = array();
		// if ($random_style_blocks) {
		// 	$merged_style_blocks = array_merge($merged_style_blocks, $random_style_blocks);
		// }
		// if ($global_style_blocks) {
		// 	$merged_style_blocks = array_merge($merged_style_blocks, $global_style_blocks);
		// }

// $published_version = Staging::get_published_stage_version($post_id);
		// if ($published_version && $stage_version !== $published_version) {
		// 	$staging_style_blocks = array();
		// 	$meta_key = Staging::get_staged_meta_name(KIRKI_GLOBAL_STYLE_BLOCK_META_KEY, $post_id, $stage_version);
		// 	$stage_style = get_post_meta($post_id, $meta_key, true);
		// 	if ($stage_style)
		// 		$staging_style_blocks = array_merge($staging_style_blocks, $stage_style);

// 	$meta_key = $meta_key . '_random';
		// 	$stage_style = get_post_meta($post_id, $meta_key, true);
		// 	if ($stage_style)
		// 		$staging_style_blocks = array_merge($staging_style_blocks, $stage_style);
		// 	if ($stage_version)
		// 		$merged_style_blocks = self::merge_style_blocks($merged_style_blocks, $staging_style_blocks);
		// 	else
		// 		$merged_style_blocks = self::merge_style_blocks($staging_style_blocks, $merged_style_blocks);
		// }

// return $merged_style_blocks;
	}

/**
	 * @deprecated
	 * @see Kirki\App\Managers\PageManager::merge_style_blocks()
	 */
	public static function merge_style_blocks($a, $b)
	{
		$names_in_a = [];
		foreach ($a as $val) {
			if (!empty($val['name']) && is_string($val['name'])) {
				$names_in_a[strtolower($val['name'])] = true;
			}
		}

$names_in_b = [];
		foreach ($b as $val) {
			if (!empty($val['name']) && is_string($val['name'])) {
				$names_in_b[strtolower($val['name'])] = true;
			}
		}

foreach ($b as $id_b => &$value_b) {
			if (empty($value_b['name']) || !is_string($value_b['name'])) {
				continue;
			}

$b_name = strtolower($value_b['name']);

// If same ID exists in A, remove it first (old behavior)
			if (isset($a[$id_b])) {
				unset($a[$id_b]);
				if (isset($names_in_a[$b_name])) {
					unset($names_in_a[$b_name]);
				}
			}

// If name already exists in A, make it unique
			if (isset($names_in_a[$b_name])) {
				$i = 1;
				while (isset($names_in_a[$b_name . '_' . $i]) || isset($names_in_b[$b_name . '_' . $i])) {
					$i++;
				}
				$new_name = $value_b['name'] . '_' . $i;

foreach ($b as &$v) {
					if (isset($v['name']) && is_array($v['name'])) {
						$v['name'] = array_map(fn($item) => $item === $value_b['name'] ? $new_name : $item, $v['name']);
					}
				}

$value_b['name'] = $new_name;
				unset($names_in_b[$b_name]);
				$names_in_b[strtolower($new_name)] = true;
			}
		}
		unset($value_b);

// Use array_merge to keep old semantics
		return array_merge($a, $b);
	}

/**
	 * @deprecated
	 * @see Kirki\App\Managers\PageManager::resolve_duplicate_current_style_block_names()
	 */
	private static function fix_duplicate_class_name_from_random_sbs($random_style_blocks, $global_style_blocks)
	{
		$global_class_names = [];
		$random_class_names = [];
		if ($global_style_blocks) {
			foreach ($global_style_blocks as $key => $value) {
				if (isset($value['name']) && is_string($value['name'])) {
					$global_class_names[self::get_class_name_from_string($value['name'])] = true;
				}
			}
		}
		if ($random_style_blocks) {
			foreach ($random_style_blocks as $key => $value) {
				if (isset($value['name']) && is_string($value['name'])) {
					$random_class_names[self::get_class_name_from_string($value['name'])] = true;
				}
			}
		}

$class_match = [];
		foreach ($random_class_names as $key => $value) {
			if (isset($global_class_names[$key])) {
				$class_match[$key] = true;
			}
		}

$class_match = self::check_or_generate_new_class_names($class_match, $global_class_names, $random_class_names);

if (count($class_match) > 0) {
			foreach ($random_style_blocks as $key => $value) {
				if (isset($value['name']) && is_string($value['name'])) {
					$class_name = self::get_class_name_from_string($value['name']);
					if (isset($class_match[$class_name])) {
						$random_style_blocks[$key]['name'] = $class_match[$class_name];
					}
				} else if (isset($value['name']) && is_array($value['name'])) {
					//array
					foreach ($value['name'] as $key2 => $v2) {
						$class_name = self::get_class_name_from_string($v2);
						if (isset($class_match[$class_name])) {
							$random_style_blocks[$key]['name'][$key2] = $class_match[$class_name];
						}
					}
				}
			}
		}
		return $random_style_blocks;
	}

/**
	 * @deprecated
	 * @see Kirki\App\Managers\PageManager::make_duplicate_classes_to_unique()
	 */
	private static function check_or_generate_new_class_names($class_match, $global_class_names, $random_class_names)
	{
		foreach ($class_match as $key => $value) {
			$temp_class = $key;
			$found = true;
			while ($found) {
				if (isset($global_class_names[$temp_class]) || isset($random_class_names[$temp_class])) {
					$temp_class = $temp_class . '-copy';
				} else {
					$found = false;
				}
			}
			$class_match[$key] = $temp_class;
		}
		return $class_match;
	}

/**
	 * @deprecated
	 * @see Kirki\App\Managers\PageManager::normalize_style_block_name()
	 */
	public static function get_class_name_from_string($s)
	{
		$s = strtolower(str_replace(' ', '-', $s));
		return $s;
	}

public static function get_selector_from_sb_name($name)
	{
		if (!$name)
			return '';
		$class_name = '';
		if (is_string($name)) {
			$class_name = '.' . self::get_class_name_from_string($name);
		} else {
			foreach ($name as $key2 => $cn) {
				$class_name .= '.' . self::get_class_name_from_string($cn);
			}
		}
		return $class_name;
	}

/**
	 * This function will update page style blocks into option meta and post meta
	 * post meta for migration and option meta for global style block
	 *
	 * @param int    $post_id post id.
	 * @param object $style_blocks styleblocks.
	 * 
	 * @deprecated the method is not used anymore. handle separately in GlobalDataManager and PageManager
	 */
	public static function update_page_styleblocks($post_id, $style_blocks)
	{
		$prev_style_blocks = self::get_page_styleblocks($post_id);
		$style_blocks = array_merge($prev_style_blocks, $style_blocks);

$global_style_blocks = array();
		foreach ($style_blocks as $key => $sb) {
			if ((isset($sb['isDefault']) && $sb['isDefault'] === true) || (isset($sb['isGlobal']) && $sb['isGlobal'] === true)) {
				$global_style_blocks[$sb['id']] = $sb;
				unset($style_blocks[$key]);
			}
		}

self::save_global_style_blocks($global_style_blocks);
		self::save_random_style_blocks($post_id, $style_blocks);
	}

/**
	 * Save global style blocks in option table. Also save collaboration data.
	 *
	 * @param array $style //take styleblocs if isDefault and isGlobal key is true.
	 * @return void
	 * @deprecated
	 * @see Kirki\App\Managers\GlobalDataManager::update_deprecated_global_style_blocks()
	 */
	public static function save_global_style_blocks($style)
	{
		// $session_id = self::sanitize_text(isset($_REQUEST['session_id']) ? $_REQUEST['session_id'] : '');
		self::update_global_data_using_key(KIRKI_GLOBAL_STYLE_BLOCK_META_KEY, $style);

// if($session_id){
		// 	// cause template import also called this method without session_id
		// 	$data = array(
		// 		'type'    => 'COLLABORATION_UPDATE_GLOBAL_STYLE',
		// 		'payload' => array( 'styleBlock' => $style ),
		// 	);
		// 	Collaboration::save_action_to_db( 'global', 0, $data, 1, $session_id);
		// }
	}

/**
	 * Save post related random style blocks in option table. Also save collaboration data.
	 *
	 * @param array $post_id //current post id.
	 * @param array $style //take styleblocs if not isDefault and isGlobal key is true.
	 * @return void
	 * @deprecated
	 * @see Kirki\App\Managers\PageManager::save_style_blocks()
	 */
	public static function save_random_style_blocks($post_id, $style)
	{
		update_post_meta($post_id, KIRKI_GLOBAL_STYLE_BLOCK_META_KEY . '_random', $style);
		// $data = array(
		// 	'type'    => 'COLLABORATION_UPDATE_GLOBAL_STYLE',
		// 	'payload' => array( 'styleBlock' => $style ),
		// );
		//Collaboration::save_action_to_db( 'post', $post_id, $data, 1 );
	}

/**
	 * Save staged style blocks for a specific post and staged meta key.
	 *
	 * @param int    $post_id   Post ID.
	 * @param string $meta_key  Staged meta key (can be normal or random).
	 * @param array  $styles    Styles array to save.
	 * 
	 * @deprecated
	 * @see \Kirki\App\Managers\PageManager::save_deprecated_global_style_blocks()
	 * @see \Kirki\App\Managers\PageManager::save_style_blocks()
	 */
	public static function save_staged_style_blocks($post_id, $meta_key, $styles)
	{
		update_post_meta($post_id, $meta_key, $styles);
		// $data = array(
		// 	'type'    => 'COLLABORATION_UPDATE_GLOBAL_STYLE',
		// 	'payload' => array('styleBlock' => $styles),
		// );
		// Collaboration::save_action_to_db('post', $post_id, $data, 1);
	}

/**
	 * No module import this method right now
	 *
	 * @return array
	 */
	public static function get_custom_code_block_element()
	{
		return array(
			'name' => 'custom-code',
			'title' => 'Code',
			'visibility' => true,
			'properties' => array(
				'tag' => 'div',
				'content' => '',
				'data-type' => 'code',
			),
			'styleIds' => array(),
			'className' => '',
			'id' => 'kirki' . uniqid(),
			'parentId' => 'body',
		);
	}
	/**
	 * Get current editor mode is kirki or others
	 *
	 * @param int $post_id post id.
	 * @return bool true if kirki.
	 * @deprecated 
	 * @see Kirki\App\Managers\PageManager::is_kirki_editor_mode()
	 */
	public static function is_editor_mode_is_kirki($post_id)
	{
		$editor_mode = get_post_meta($post_id, KIRKI_META_NAME_FOR_POST_EDITOR_MODE, true);
		if ('kirki' === $editor_mode) {
			return true;
		}
		return false;
	}

/**
	 * Get post url arr from post id
	 * preview_url, iframe_url, post_url
	 *
	 * @param int $post_id post id.
	 * @return array
	 * 
	 * @deprecated
	 * @see \Kirki\App\Supports\PageUrl::class
	 */
	public static function get_post_url_arr_from_post_id($post_id, $options = array())
	{
		$post_perma_link = self::get_page_perma_url($post_id);

$obj = ['post_url' => $post_perma_link, 'post_id' => $post_id];
		if (isset($options['ajax_url']) && $options['ajax_url']) {
			$protocol = strpos(home_url(), 'https://') !== false ? 'https' : 'http';
			$obj['ajax_url'] = admin_url('admin-ajax.php', $protocol);
		}

if (isset($options['preview_url']) && $options['preview_url']) {
			$preview_url = self::get_page_preview_url($post_id);
			$obj['preview_url'] = $preview_url;
		}

if (isset($options['editor_url']) && $options['editor_url']) {
			$obj['editor_url'] = add_query_arg(
				array(
					'action' => KIRKI_EDITOR_ACTION,
				),
				$post_perma_link
			);

if (HelperFunctions::is_api_call_from_editor_preview() && HelperFunctions::is_api_header_post_editor_preview_token_valid()) {
				$headers = self::getallheaders();
				$obj['editor_url'] = add_query_arg(
					array(
						'editor-preview-token' => isset($headers['Editor-Preview-Token']) ? $headers['Editor-Preview-Token'] : null,
					),
					$obj['editor_url']
				);
			}
		}
		if (isset($options['iframe_url']) && $options['iframe_url']) {
			$iframe_url_params = array(
				'action' => KIRKI_EDITOR_ACTION,
				'load_for' => 'kirki-iframe',
				'post_id' => $post_id,
			);
			if (isset($_GET['editor-preview-token'])) {
				$iframe_url_params['editor-preview-token'] = self::sanitize_text($_GET['editor-preview-token']);
			}
			$obj['iframe_url'] = add_query_arg(
				$iframe_url_params,
				$post_perma_link
			);
		}

if (isset($options['nonce']) && $options['nonce']) {
			$obj['nonce'] = wp_create_nonce('wp_rest');
		}

if (isset($options['editor_preview_token']) && $options['editor_preview_token']) {
			$obj['editor_preview_token'] = isset($_GET['editor-preview-token']) ? self::sanitize_text($_GET['editor-preview-token']) : false;
		}

if (isset($options['site_url']) && $options['site_url']) {
			$obj['site_url'] = get_site_url();
		}

if (isset($options['admin_url']) && $options['admin_url']) {
			$obj['admin_url'] = get_admin_url();
		}

if (isset($options['core_plugin_url']) && $options['core_plugin_url']) {
			$obj['core_plugin_url'] = KIRKI_CORE_PLUGIN_URL;
		}

if (isset($options['rest_url']) && $options['rest_url']) {
			try {
				$rest_url = rest_url();
				$obj['rest_url'] = $rest_url;
			} catch (\Throwable $th) {
				$obj['rest_url'] = '';
			}
		}

return $obj;
	}

/**
	 * @deprecated
	 * @see \Kirki\App\Supports\PageUrl::get_preview_url()
	 */
	private static function get_page_preview_url($post_id)
	{
		$post = get_post($post_id);
		if ($post && $post->post_type === 'kirki_template') {
			$conditions = get_post_meta($post->ID, 'kirki_template_conditions', true);

$d = self::get_collection_items_from_conditions($conditions);
			if ($d['type'] === 'post' && count($d['data']) > 0) {
				return self::get_page_perma_url($d['data'][0]['ID']);
			}
			if ($d['type'] === 'user' && count($d['data']) > 0) {
				return get_author_posts_url($d['data'][0]['ID']);
			}
			if ($d['type'] === 'term' && count($d['data']) > 0) {
				return get_term_link($d['data'][0]['ID']);
			}
		}
		return self::get_page_perma_url($post_id);
	}

/**
	 * @deprecated
	 * @see \Kirki\App\Supports\PageUrl::get_page_permalink()
	 */
	private static function get_page_perma_url($post_id)
	{
		$post_perma_link = get_permalink($post_id);
		$protocol = strpos(home_url(), 'https://') !== false ? 'https' : 'http';
		if ($protocol === 'https') {
			$post_perma_link = str_replace('http://', 'https://', $post_perma_link);
		} else {
			$post_perma_link = str_replace('https://', 'http://', $post_perma_link);
		}

return $post_perma_link;
	}

/**
	 * @deprecated
	 * @see \Kirki\App\Supports\CollectionItem::get_items_from_condition()
	 */
	public static function get_collection_items_from_conditions($conditions, $query = '')
	{
		$data = [];
		$type = 'post';
		$post_type = 'post';
		$role = '';

if (is_array($conditions) && count($conditions) > 0) {
			if (isset($conditions[0]['type'])) {
				$type = $conditions[0]['type'];

if ($type === 'post') {
					$post_type = $conditions[0]['post_type'];

// if the conditions has from key then it is term. then it will be term type.
					if (isset($conditions[0]['from']) && $conditions[0]['from'] === 'term') {
						$type = 'term';
					}
				}
				if ($type === 'user') {
					$role = $conditions[0]['to'];
				}
			} else {
				//legacy support
				$post_type = $conditions[0]['category'];
			}
		}

$numberposts = 20;
		$post_status = array('publish', 'draft', 'future');

if ($type === 'post' && HelperFunctions::user_has_post_edit_access()) { // type will be wordpress post type
			$arg = array(
				'post_type' => $post_type,
				'post_status' => $post_status,
				'numberposts' => $numberposts,
				'orderby' => 'ID',
				'order' => 'DESC',
			);
			if ($query) {
				$arg['s'] = $query;
			}
			$posts = get_posts($arg);
			foreach ($posts as $key => $post) {
				$data[] = array(
					'ID' => $post->ID,
					'title' => $post->post_title,
				);
			}
		}

if ($type === 'user' && HelperFunctions::user_has_post_edit_access()) {
			// get all users
			$arg = array(
				'role' => $role === '*' ? '' : $role,
				'number' => $numberposts,
				'orderby' => 'ID',
				'order' => 'DESC',
			);

if ($query) {
				$arg['search'] = '*' . $query . '*';
			}

$users = get_users($arg);
			foreach ($users as $key => $user) {
				$data[] = array(
					'ID' => $user->ID,
					'title' => $user->display_name,
				);
			}
		}

if ($type === 'term' && HelperFunctions::user_has_post_edit_access()) {
			// conditions 
			$taxonomy = [];

foreach ($conditions as $key => $condition) {
				if ($condition['from'] === 'term') {
					$taxonomy[] = $condition['where'];
				}
			}

$arg = array(
				'taxonomy' => $taxonomy,
				'number' => $numberposts,
				'orderby' => 'ID',
				'order' => 'DESC',
			);

if ($query) {
				$arg['search'] = $query;
			}

$terms = get_terms($arg);

if (!is_wp_error($terms) && is_array($terms)) {
				foreach ($terms as $term) {
					// Handle both object and array cases safely
					$term_id = is_object($term) ? $term->term_id : ($term['term_id'] ?? null);
					$term_name = is_object($term) ? $term->name : ($term['name'] ?? null);

$data[] = [
						'ID' => $term_id,
						'title' => $term_name,
					];
				}
			}
		}

return ['data' => $data, 'type' => $type];
	}
	/**
	 * Get post content from content value. like => id, title, description, content
	 *
	 * @param string $content_value for post dynamic content.
	 * @param object $post post object.
	 *
	 * @return string
	 */
	public static function get_post_dynamic_content($content_value, $post = null, $meta_name = '', $dynamic_options = [])
	{
		if (isset($post) && !empty($post)) {
			$post_id = $post->ID;
		}

if (empty($post_id)) {
			$post_id = self::get_post_id_if_possible_from_url();
		}

$content = null;

switch ($content_value) {
			case 'post_id': {
				$content = $post_id;
				break;
			}

case 'post_title': {
				$content = get_the_title($post_id);
				break;
			}

case 'post_excerpt': {

// Excerpt length global variable is only for kirki editor but not for the frontend.
				if (isset($GLOBALS['kirki_post_excerpt_length']) && $GLOBALS['kirki_post_excerpt_length'] > 0) {
					$content = wp_trim_words(get_the_excerpt($post_id), $GLOBALS['kirki_post_excerpt_length'], '[...]');
				} else {
					$content = get_the_excerpt($post_id);
				}
				break;
			}

case 'post_author': {
				$post = get_post($post_id);
				if (!$post)
					return "";
				$content = get_the_author_meta('display_name', $post->post_author);
				break;
			}

case 'post_date': {
				$content = get_the_date('', $post_id);
				if (isset($dynamic_options['format'])) {
					$content = HelperFunctions::format_date($content, $dynamic_options['format']);
				}
				break;
			}

case 'post_time': {
				$content = get_the_time('', $post_id);
				if (isset($dynamic_options['timeFormat'])) {
					$content = HelperFunctions::convert_time_format($content, $dynamic_options['timeFormat']);
				}
				break;
			}

case 'post_content': {
				$content = self::retrieve_post_content($post_id);
				break;
			}

case 'post_status': {
				$content = get_post_status($post_id);
				break;
			}

case 'featured_image': {
				$content = array(
					'wp_attachment_id' => get_post_thumbnail_id($post_id),
					'src' => get_the_post_thumbnail_url($post_id)
				);
				break;
			}

case 'site_name': {
				$content = get_bloginfo('name');
				break;
			}
			case 'site_description': {
				$content = get_bloginfo('description');
				break;
			}
			case 'site_url': {
				$content = get_site_url();
				break;
			}

case 'site_logo': {
				$content = '';

// Try site icon first
				$site_icon_id = get_option('site_icon');
				if ($site_icon_id) {
					$content = wp_get_attachment_url($site_icon_id);
				}

// If no site icon, try get_site_icon_url()
				if (!$content) {
					$content = get_site_icon_url(512);
				}

// If still nothing, try custom logo
				if (!$content) {
					$custom_logo_id = get_theme_mod('custom_logo');
					if ($custom_logo_id) {
						$imgs = wp_get_attachment_image_src($custom_logo_id, 'full');
						if ($imgs && isset($imgs[0])) {
							$content = $imgs[0];
						}
					}
				}

break;
			}

case 'author_profile_picture': {
				$post = get_post($post_id);

if (!empty($post)) {
					$post_author = $post->post_author;
					$content = get_avatar_url($post_author);
				} else {
					$content = 'Something wrong!';
				}

break;
			}

case 'user_profile_picture': {
				$content = get_avatar_url(get_current_user_id());
				break;
			}

case 'post_page_link': {
				$url = \get_permalink($post_id);
				$content = !empty($url) ? $url : '';
				break;
			}

case 'author_posts_page_link': {
				$post = \get_post($post_id);
				$url = \get_author_posts_url($post->post_author);
				$content = !empty($url) ? $url : '';
				break;
			}

case 'post_meta': {
				if (!empty($meta_name)) {
					$meta = get_post_meta($post_id, $meta_name, true);

// For now, only string is supported!
					if (is_string($meta)) {
						// Post meta is arbitrary, low-privilege-authored data: always escape.
						$content = self::escape_post_meta_value($meta);
					}
				}

break;
			}

default: {
				$post = get_post($post_id);
				if (isset($post) && 0 !== strpos(KIRKI_CONTENT_MANAGER_PREFIX, $post->post_type)) {
					$meta_key = ContentManagerHelper::get_child_post_meta_key_using_field_id($post->post_parent, $content_value);
					$content = get_post_meta($post->ID, $meta_key, true);
					$fields = ContentManagerHelper::get_post_type_custom_field_keys($post->post_parent);

if (!$content && isset($fields[$content_value], $fields[$content_value]['default_value'])) {
						$content = $fields[$content_value]['default_value'];
					}

if (isset($fields[$content_value]) && $fields[$content_value]['type'] === 'date') {
						$content = self::format_date($content, $fields[$content_value]['default_format']); //TODO: need to check with editor format
					}
					if (isset($fields[$content_value]['type']) && $fields[$content_value]['type'] === 'image') {
						$content = array(
							'wp_attachment_id' => $content['id'] ?? '',
							'src' => $content['url'] ?? '',
						);
					}
					if (isset($fields[$content_value]['type']) && $fields[$content_value]['type'] === 'time') {
						$time = "";

if (isset($fields[$content_value], $fields[$content_value]['default_value']) && $fields[$content_value]['default_value']) {
							$default_time = $fields[$content_value]['default_value'];

$value = isset($default_time['value']) ? $default_time['value'] : '00:00';
							$unit = isset($default_time['unit']) ? strtolower($default_time['unit']) : 'am';

$time = $value . ' ' . $unit;
						}

$content = $content ? $content['value'] . ' ' . $content['unit'] : $time;

if (isset($dynamic_options['timeFormat']) && $dynamic_options['timeFormat']) {
							$content = HelperFunctions::convert_time_format($content, $dynamic_options['timeFormat']);
						}
					}

} else {
					$content = 'Not Implemented';
				}

break;
			}
		}

return $content ? $content : '';
	}

/**
	 * The function `get_user_dynamic_content` retrieves specific dynamic content related to a user based
	 * on the provided content value.
	 */
	public static function get_user_dynamic_content($content_value, $user_id = null, $meta_name = '', $dynamic_options = [])
	{
		$content = '';

// Get the user by ID
		$user = get_user_by('id', $user_id);

// fall back to the current user
		if (empty($user)) {
			$user = get_user_by('id', get_current_user_id());
		}

if (empty($user)) {
			return $content;
		}

// Switch statement to handle dynamic content based on the content_value
		switch ($content_value) {
			case 'display_name':
				return $user->display_name;

case 'user_email':
				return $user->user_email;

case 'user_nicename':
				return $user->user_nicename;

case 'registered_date': {
				$date = $user->user_registered;

if (isset($dynamic_options['format'])) {
					return HelperFunctions::format_date($date, $dynamic_options['format']);
				}

$date = new DateTime($date);

return $date->format('F j, Y');
			}

case 'registered_time': {
				$date = new DateTime($user->user_registered);
				return $date->format('H:i:a');
			}

case 'user_url':
				return get_author_posts_url($user->ID);

case 'profile_image':
				return get_avatar_url($user->ID);

case 'user_meta': {
				if (!empty($meta_name)) {
					$meta = get_user_meta($user->ID, $meta_name, true);

if (is_string($meta)) {
						return $meta;
					}
					return '';
				}
			}

case 'initials': {
				$first_name = isset($user->first_name) ? $user->first_name : '';
				$last_name = isset($user->last_name) ? $user->last_name : '';

$initials = '';
				if ($first_name) {
					$initials .= strtoupper(substr($first_name, 0, 1));
				}

if ($last_name) {
					$initials .= strtoupper(substr($last_name, 0, 1));
				}

// if initials are lenght 1 or empty, then the first two letters of the username
				if (empty($initials) || strlen($initials) < 2) {
					$username = isset($user->user_login) ? $user->user_login : '';
					$initials = strtoupper(substr($username, 0, 2));
				}

return $initials;
			}

default:
				return '';
		}
	}

private static function get_value($data, $key)
	{
		if (is_array($data)) {
			return $data[$key] ?? '';
		}

if (is_object($data)) {
			return $data->$key ?? '';
		}

return '';
	}

public static function get_term_dynamic_content($content_value, $term_id = null, $meta_name = '')
	{
		$term = get_term($term_id);

if (empty($term)) {
			return '';
		}

switch ($content_value) {
			case 'name':
				return self::get_value($term, 'name');

case 'description':
				return self::get_value($term, 'description');

case 'slug':
				return self::get_value($term, 'slug');

case 'count':
				return self::get_value($term, 'count');

case 'meta':
				if (!empty($meta_name)) {
					$term_id = self::get_value($term, 'term_id');
					$meta = get_term_meta($term_id, $meta_name, true);

return is_scalar($meta) ? (string) $meta : '';
				}
				return '';

default:
				return '';
		}
	}

public static function retrieve_post_content($post_id)
	{
		$content = apply_filters('the_content', get_the_content(null, false, $post_id));

$load_for = HelperFunctions::sanitize_text(isset($_GET['load_for']) ? $_GET['load_for'] : '');

if ($load_for !== 'kirki-iframe' && $kirki_data = HelperFunctions::is_kirki_type_data($post_id)) {
			$params = array(
				'blocks' => $kirki_data['blocks'],
				'style_blocks' => $kirki_data['styles'],
				'root' => 'root',
				'post_id' => $post_id,
			);
			$content = apply_filters('the_content', HelperFunctions::get_html_using_preview_script($params));
		}

return $content;
	}

/**
	 * This methos is for if Theme enque some style and css then it will remove those styel and css codes.
	 *
	 * @return void
	 */
	public static function remove_theme_style()
	{
		$theme = wp_get_theme();
		$parent_style = $theme->stylesheet . '-style';
		wp_dequeue_style($parent_style);
		wp_deregister_style($parent_style);
		wp_dequeue_style($parent_style . '-css');
		wp_deregister_style($parent_style . '-css');
	}

public static function dequeue_all_except_my_plugin()
	{

global $wp_scripts, $wp_styles, $kirki_editor_assets;

foreach ($wp_scripts->queue as $handle) {

// Keep WordPress media scripts
			if (
				str_starts_with($handle, 'media') ||
				str_starts_with($handle, 'wp-media') ||
				in_array($handle, ['underscore', 'backbone', 'jquery', 'wp-util'])
			) {
				continue;
			}

wp_dequeue_script($handle);
		}

foreach ($wp_styles->queue as $handle) {

// Keep media related styles
			if (
				str_starts_with($handle, 'media') ||
				in_array($handle, ['buttons', 'dashicons', 'imgareaselect'])
			) {
				continue;
			}

wp_dequeue_style($handle);
		}

if (!empty($kirki_editor_assets['scripts'])) {
			foreach ($kirki_editor_assets['scripts'] as $script_handle) {
				wp_enqueue_script($script_handle);
			}
		}

if (!empty($kirki_editor_assets['styles'])) {
			foreach ($kirki_editor_assets['styles'] as $style_handle) {
				wp_enqueue_style($style_handle);
			}
		}
	}

/**
	 * Generate html using Preview script.
	 *
	 * @param array  $data blocks.
	 * @param array  $style_blocks style_blocks.
	 * @param string $root data root.
	 * @param int    $id if need prefix like symbol or popup post_id.
	 * @return string  the html string.
	 */
	public static function get_html_using_preview_script(array $params = [])
	{

$blocks = $params['blocks'] ?? null;
		$style_blocks = $params['style_blocks'] ?? null;
		$root = $params['root'] ?? null;
		$options = $params['options'] ?? [];
		$post_id = $params['post_id'] ?? null;
		$get_style = $params['get_style'] ?? true;
		$get_variable = $params['get_variable'] ?? true;
		$should_take_app_script = $params['should_take_app_script'] ?? true;
		$prefix = $params['prefix'] ?? false;
		$get_all_style_forcefully_if_get_style_true = $params['get_all_style_forcefully_if_get_style_true'] ?? false;

if ($blocks) {
			$options['search_related_collection_ids'] = isset($params['search_related_collection_ids']) ? $params['search_related_collection_ids'] : self::collect_search_related_collection_ids($blocks);
		}

//set initial context data start
		if (!isset($options['post'])) {
			$post = get_post(get_the_ID());
			if ($post) {
				$options['post'] = $post;
				$options['itemType'] = 'post';
			}
		}
		if (!isset($options['user'])) {
			$user = get_user_by('id', get_current_user_id());
			if ($user) {
				$options['user'] = Users::get_format_single_user_data($user);
			}
		}
		//set initial context data end

$preview = new Preview($blocks, $style_blocks, $root, $post_id, $prefix);
		$html = $preview->getHtml($options);// this method need to call first cause after that only used style block array construct.
		$only_used_style_blocks = $get_all_style_forcefully_if_get_style_true ? $style_blocks : $preview->get_only_used_style_blocks();
		$s = '';

if ($get_style) {
			//style will be false when it calls from collection single item. only first item will generate style. others item will be same.
			$s .= $preview->getStyleTag($only_used_style_blocks);
		}

$s .= $preview->get_interaction_set_as_initial_css();

$s .= $html;
		$s .= $preview->getScriptTag($should_take_app_script);

$s = self::decode_entities_without_creating_markup($s);
		return $s;
	}

/**
	 * Decode HTML entities in already-rendered page markup without ever turning
	 * escaped text back into live tags.
	 *
	 * The rendered document mixes trusted markup (elements the builder emitted,
	 * including admin authored custom code) with escaped text nodes. A blanket
	 * html_entity_decode() over that mix undoes the escaping applied while
	 * rendering, so `&lt;script&gt;` stored in any text value — a visitor's
	 * comment, for instance — becomes an executable `<script>` tag.
	 *
	 * Angle-bracket entities are therefore held back while everything else is
	 * decoded as before, then restored verbatim. Entities such as `&amp;`,
	 * `&nbsp;` and named HTML5 entities keep decoding exactly as they used to;
	 * markup emitted by the renderer is unaffected because it contains literal
	 * `<`/`>`, not entities.
	 *
	 * @param string $content Rendered page markup.
	 * @return string
	 */
	private static function decode_entities_without_creating_markup( $content ) {
		if ( ! is_string( $content ) || '' === $content ) {
			return $content;
		}

$held = array();

// `&lt;` `&gt;` and their numeric/hex forms, in any zero-padded spelling.
		$content = preg_replace_callback(
			'/&(?:lt|gt|#0*(?:60|62)|#[xX]0*3[ceCE]);/i',
			function ( $matches ) use ( &$held ) {
				$key          = "\x02kirki-entity-" . count( $held ) . "\x03";
				$held[ $key ] = $matches[0];
				return $key;
			},
			$content
		);

$content = html_entity_decode( $content, ENT_NOQUOTES | ENT_HTML5, 'UTF-8' );

return strtr( $content, $held );
	}

private static function collect_search_related_collection_ids($data)
	{
		$result = array();
		foreach ($data as $item) {
			if (
				isset($item['properties']['dynamicContent']['related']) &&
				$item['properties']['dynamicContent']['related'] === true &&
				!empty($item['properties']['dynamicContent']['relatedCollection'])
			) {
				$result[$item['properties']['dynamicContent']['relatedCollection']] = true;
			}
		}
		return $result;
	}

public static function get_custom_fonts_tags()
	{
		$custom_fonts = HelperFunctions::get_global_data_using_key(KIRKI_USER_CUSTOM_FONTS_META_KEY);
		if ($custom_fonts) {
			$s = '';
			foreach ($custom_fonts as $key => $fonts_data) {
				$s .= self::getFontsHTMLMarkup($fonts_data);
			}
			return $s;
		}
	}

public static function getFontsHTMLMarkup($fonts_data)
	{
		if (isset($fonts_data['fontUrl'])) {
			$font_url = isset($fonts_data['localUrl']) ? $fonts_data['localUrl'] : $fonts_data['fontUrl'];
			//phpcs:ignore WordPress.WP.EnqueuedResources.NonEnqueuedStylesheet
			return '<link class="' . 'kirki-custom-fonts-link" href="' . $font_url . '" rel="stylesheet">';
		}
		return '';
	}

/**
	 * Generate new id and html string for: symbol, collection etc.
	 *
	 * @param array  $data blocks.
	 * @param array  $style_blocks style_blocks.
	 * @param string $root data root.
	 */
	public static function rec_update_data_id_then_return_new_html($data, $style_blocks, $root = 'body', $options = [], $get_style = true)
	{
		$data_helper = new DataHelper();
		$data_helper->rec_update_data_id_to_new_id($data, $style_blocks, $root, null);
		$data = $data_helper->temp_data;
		$style_blocks = $data_helper->temp_styles;
		$root = isset($data_helper->temp_ids[$root]) ? $data_helper->temp_ids[$root] : false;

$params = array(
			'blocks' => $data,
			'style_blocks' => $style_blocks,
			'root' => $root,
			'post_id' => null,
			'options' => $options,
			'get_style' => $get_style,
			'get_all_style_forcefully_if_get_style_true' => true,//this will generate collection first item all style 
		);

return self::get_html_using_preview_script($params);
	}

// hook
	public static function kirki_html_generator($s, $post_id, $staging_version = false)
	{
		$d = self::is_kirki_type_data($post_id, $staging_version);
		if ($d) {
			$params = array(
				'blocks' => $d['blocks'],
				'style_blocks' => $d['styles'],
				'root' => 'root',
				'post_id' => $post_id,
			);
			return self::get_html_using_preview_script($params);
		}
		return false;
	}

/**
	 * Find symbol for post id using condition
	 * it will find and return selected symbols html and css;
	 *
	 * @param string $type : post | user
	 * @param array $context : post object or user object
	 * @return symbol || bool(false)
	 */
	public static function find_template_for_this_context($type = 'post', $context = null)
	{
		$templates = Page::fetch_list('kirki_template', true, array('publish'));
		if (!$templates || !$context)
			return false;
		foreach ($templates as $key => $template) {
			if (isset($template['conditions'])) {
				$conditions = $template['conditions'];
				if ($type === 'user') {
					if (self::check_all_conditions_for_this_user($context, $conditions)) {
						return $template;
					}
				} else if ($type === 'post') {
					if (self::check_all_conditions_for_this_post($context, $conditions)) {
						return $template;
					}
				} else if ($type === 'term') {
					if (self::check_all_conditions_for_this_term($context, $conditions)) {
						return $template;
					}
				}
			}
		}
		return false;
	}

/**
	 * Generate popup html
	 *
	 * @return strint
	 */
	public static function get_page_popups_html()
	{
		global $post;
		if ($post) {
			$popups = self::get_page_popups();
			if (count($popups) > 0) {
				$s = '';
				foreach ($popups as $key => $popup) {
					$params = array(
						'blocks' => $popup['blocks'],
						'style_blocks' => $popup['styleBlocks'],
						'root' => $popup['root'],
						'post_id' => $popup['id'],
					);
					$s .= self::get_html_using_preview_script($params);
				}
				return do_shortcode($s);
			}
		}
		return '';
	}

/**
	 * Get Custom popups
	 * it will find and return selected popups;
	 *
	 * @return array
	 */
	public static function get_page_popups()
	{
		global $post;
		if ($post) {
			$popups = Page::fetch_list('kirki_popup', true, array('publish'));
			return self::find_popups_for_this_post($popups, $post);
		}
		return array();
	}

/**
	 * Find popups for post id using condition
	 * it will find and return selected popups arr;
	 *
	 * @param object $popups popup block object.
	 * @param object $post post object.
	 * @return popups || [];
	 */
	public static function find_popups_for_this_post($popups, $post)
	{
		$arr = array();
		$post_id = $post->ID;
		foreach ($popups as $key => $popup) {
			$popup = self::format_single_popup_data_for_html_print($popup);
			if (self::check_popup_pagearr_logic($popup, $post_id)) {
				$arr[] = $popup;
			}
		}
		return $arr;
	}

private static function format_single_popup_data_for_html_print($popup)
	{
		if (!$popup['blocks'])
			return $popup;
		$root = false;
		foreach ($popup['blocks'] as $key2 => &$b) {
			if ('root' === $b['parentId']) {
				$root = $b['id'];

if (isset($b['properties']['attributes'])) {
					$b['properties']['attributes']['popup-id'] = $popup['id'];
				} else {
					$b['properties']['attributes'] = array(
						'popup-id' => $popup['id'],
					);
				}
				$popup['root'] = $root;
			}
		}

return $popup;
	}

/**
	 * Check popup is active apply for this post or not.
	 *
	 * @param array $popup popup from Page::fetch_list.
	 * @param int   $post_id wp post id.
	 * @return bool
	 */
	private static function check_popup_pagearr_logic($popup, $post_id)
	{
		if (!isset($popup['root']))
			return false;
		$root = $popup['root'];
		if ($root && isset($popup['blocks'][$root]['properties']['popup']['visibilityConditions'])) {
			$conditions = $popup['blocks'][$root]['properties']['popup']['visibilityConditions'];
			$post = get_post($post_id);
			if (self::check_all_conditions_for_this_post($post, $conditions) || in_array($popup['id'], Preview::$only_used_popup_id_array, true)) {
				return true;
			}
		}
		return false;
	}

/**
	 * Check all conditon for this post
	 * This method will match all the condition and return true or false
	 * category = * || post_type
	 * taxonomy = 1=single post || * = all post || taxonomy slug
	 * apply[to] = * = all || id = post id || term id
	 * visibility = show || hide
	 *
	 * @param object $post post object.
	 * @param object $conditions symbol visibility condiotions object.
	 *
	 * @return Boolean
	 */
	public static function check_all_conditions_for_this_post($post, $conditions)
	{
		$show_flag = false;
		$hide_flag = false;

foreach ($conditions as $key => $condition) {
			if (!isset($condition['from'])) {
				$condition['from'] = 'post';
			}
			if ($condition['from'] === 'term') {
				return false;
			}
			if (isset($condition['category'])) {
				//legacy
				if ($condition['category'] === '*') {
					$condition['type'] = '*';
				} else {
					$condition['post_type'] = $condition['category'];
					$condition['type'] = 'post';
				}
			}

if (!isset($condition['visibility'])) {
				$condition['visibility'] = 'show';
			}

if ($condition['type'] === '*') {
				// Entire site
				$show_flag = $condition['visibility'] === 'show';
			} elseif ($condition['type'] === 'post') {
				if ($condition['post_type'] === $post->post_type) {
					// Post type related
					if ($condition['where'] == '*') {
						// All posts
						$show_flag = $condition['visibility'] === 'show';
					} elseif ($condition['where'] == 'single') {
						// Single post
						if ($condition['to'] === $post->ID) {
							$show_flag = $condition['visibility'] === 'show';
							$hide_flag = $condition['visibility'] === 'hide';
						}
					} else {
						// Taxonomy
						$taxonomy = $condition['where'];
						$term = $condition['to'];
						if ($term === '*') {
							// All terms
							$show_flag = $condition['visibility'] === 'show';
						} else {
							if (has_term($term, $taxonomy, $post->ID)) {
								$show_flag = $condition['visibility'] === 'show';
								$hide_flag = $condition['visibility'] === 'hide';
							}
						}
					}
				}
			}

// If hide flag is set, stop and return false
			if ($hide_flag) {
				return false;
			}
		}
		return $show_flag;
	}

public static function check_all_conditions_for_this_term($term, $conditions)
	{
		$show_flag = false;
		$hide_flag = false;
		foreach ($conditions as $key => $condition) {
			if (!isset($condition['visibility'])) {
				$condition['visibility'] = 'show';
			}
			if (!isset($condition['from'])) {
				$condition['from'] = 'post';
			}

if ($condition['from'] !== 'term') {
				return false;
			}

if ($condition['type'] === '*') {
				// Entire site
				$show_flag = $condition['visibility'] === 'show';
			} elseif ($condition['type'] === 'post') {

if ($condition['post_type'] === $term['post_type']) {
					// Post type related
					if ($condition['where'] == '*') {
						// All posts
						$show_flag = $condition['visibility'] === 'show';
					} else {
						// Taxonomy
						$taxonomy = $condition['where'];
						$con_term = $condition['to'];
						if ($con_term === '*') {
							// All terms
							$show_flag = $condition['visibility'] === 'show';
						} else {
							if ($term['taxonomy'] == $con_term) {
								$show_flag = $condition['visibility'] === 'show';
								$hide_flag = $condition['visibility'] === 'hide';
							}
						}
					}
				}
			}

// If hide flag is set, stop and return false
			if ($hide_flag) {
				return false;
			}
		}
		return $show_flag;
	}

public static function check_all_conditions_for_this_user($user, $conditions)
	{
		$show_flag = false;
		$hide_flag = false;
		foreach ($conditions as $key => $condition) {

if (isset($condition['category'])) {
				//legacy
				if ($condition['category'] === '*') {
					$condition['type'] = '*';
				} else {
					$condition['post_type'] = $condition['category'];
					$condition['type'] = 'post';
				}
			}

if (!isset($condition['visibility'])) {
				$condition['visibility'] = 'show';
			}

if ($condition['type'] === '*') {
				// Entire site
				$show_flag = $condition['visibility'] === 'show';
			} elseif ($condition['type'] === 'user') {
				if ($condition['where'] === '*') {
					$show_flag = $condition['visibility'] === 'show';
				} elseif ($condition['where'] === 'role') {
					$user_role = $condition['to'];

if ($user_role === '*') {
						$show_flag = $condition['visibility'] === 'show';
					} else {
						$curr_user = $user;
						if (in_array($user_role, $curr_user['roles'])) {
							$show_flag = $condition['visibility'] === 'show';
						}
					}
				}
			}

if ($hide_flag) {
				return false;
			}
		}

return $show_flag;
	}

private static function attribute_in_post_table($attr = '')
	{
		$post_table_attributes = array(
			'ID',
			'post_author',
			'post_date',
			'post_date_gmt',
			'post_content',
			'post_title',
			'post_excerpt',
			'post_status',
			'post_name',
			'post_type',
			'post_category',
			'term'
		);

return in_array($attr, $post_table_attributes, true);
	}

private static function sort_filters_by_relation($filter_items = array())
	{
		$sorted_array = array();

if (is_array($filter_items)) {
			array_walk($filter_items, function ($item) use (&$sorted_array) {
				$relation_raw = isset($item['relation']) ? $item['relation'] : 'OR';
				$relation = in_array(strtoupper($relation_raw), ['AND', 'OR'], true) ? strtoupper($relation_raw) : 'OR';

if (!isset($sorted_array[$relation])) {
					$sorted_array[$relation] = array();
				}

unset($item['relation']);

$sorted_array[$relation][] = $item;
			});
		}

return $sorted_array;
	}

/**
	 * text, number, date/time, options, switch
	 */
	private static function post_table_filter_query($filter_item, $data_type)
	{
		$field_name = $filter_item['id'];
		$sorted_array = self::sort_filters_by_relation($filter_item['items']);

$where_sql = '';

array_walk($sorted_array, function ($sorted_array_item, $condition) use ($data_type, $field_name, &$where_sql) {
			global $wpdb;

$conditions = array();
			$column_name = "$wpdb->posts.$field_name";

array_walk($sorted_array_item, function ($filter_condition_item) use ($data_type, $column_name, &$conditions) {
				switch ($data_type) {
					case 'text': {
						$conditions[] = PostsQueryUtils::post_table_text_query($column_name, $filter_condition_item['condition'], $filter_condition_item['value']);
						break;
					}

// case 'date': {
					// 	$conditions[] = PostsQueryUtils::post_table_text_query($column_name, $filter_condition_item['condition'], $filter_condition_item['value']);
					// 	break;
					// }

// case 'number': {
					// 	$conditions[] = PostsQueryUtils::post_table_number_query($column_name, $filter_condition_item['condition'], $filter_condition_item['value']);
					// 	break;
					// }

// case 'option': {
					// 	$conditions[] = PostsQueryUtils::post_table_options_query($column_name, $filter_condition_item['condition'], $filter_condition_item['value']);
					// 	break;
					// }

// case 'switch': {
					// 	$conditions[] = PostsQueryUtils::post_table_switch_query($column_name, $filter_condition_item['condition'], $filter_condition_item['value']);
					// 	break;
					// }

default: {
						break;
					}
				}
			});

if (empty($conditions)) {
				return;
			}

$condition_sql = implode(" {$condition} ", $conditions);

if ('OR' === $condition) {
				$condition_sql = "({$condition_sql})";
			}

/**
			 * A query to 
			 * [x start with 'JoomShaper' or 'IcoFont' or 'Kirki'
			 * and contains 'website' and ends with 'Ollyo']
			 * will be like below:
			 * 
			 * AND (x LIKE 'JoomShaper%' OR x LIKE 'IcoFont%' OR x LIKE 'Kirki%') AND x LIKE '%website%' AND x LIKE '%Ollyo'
			 */
			$where_sql .= " AND $condition_sql";
		});

if (empty($where_sql)) {
			return null;
		}

$callback = function ($where) use ($where_sql) {
			$where .= $where_sql;
			return $where;
		};

add_filter('posts_where', $callback);

return $callback;
	}

/**
	 * text, number, date/time, options, switch
	 * help: https://wordpress.stackexchange.com/questions/159426/meta-query-with-string-starting-like-pattern
	 */

private static function post_meta_table_filter_query($filter_item, $key, $data_type)
	{
		$sorted_array = self::sort_filters_by_relation($filter_item['items']);
		$meta_query = array();

array_walk($sorted_array, function ($sorted_array_item, $condition) use (&$meta_query, $key, $data_type) {
			if (count($sorted_array_item) > 0) {
				$condition_arr = array('relation' => $condition);

array_walk($sorted_array_item, function ($filter_condition_item) use (&$condition_arr, $key, $data_type) {

switch ($data_type) {
						case 'text': {
							$condition_arr[] = PostsQueryUtils::post_meta_table_text_query($key, $filter_condition_item['condition'], $filter_condition_item['value']);
							break;
						}

case 'date': {
							$condition_arr[] = PostsQueryUtils::post_meta_table_date_query($key, $filter_condition_item); // ['start-date' => '', 'end-date' => '']);
							break;
						}

case 'number': {
							$condition_arr[] = PostsQueryUtils::post_meta_table_number_query($key, $filter_condition_item['condition'], $filter_condition_item['value']);
							break;
						}

case 'option': {
							$condition_arr[] = PostsQueryUtils::post_meta_table_options_query($key, $filter_condition_item['condition'], $filter_condition_item['values']);
							break;
						}

case 'switch': {
							$condition_arr[] = PostsQueryUtils::post_meta_table_switch_query($key, $filter_condition_item['condition']);
							break;
						}

default: {
							break;
						}
					}
				});

$meta_query[] = $condition_arr;
			}
		});

return $meta_query;
	}

/**
	 * filter query for reference table
	 * 
	 * @param object $filter_item filter item.
	 * @param string $key field meta key.
	 * @param array  $args args.
	 *
	 * @return array args
	 */

private static function cm_reference_table_filter_query($filter_item, $key, $args)
	{
		global $wpdb;

$sorted_array = self::sort_filters_by_relation($filter_item['items']);

$post_ids_in = [];
		$post_ids_not_in = [];

$has_in_condition = false;
		$has_not_in_condition = false;

foreach ($sorted_array as $relation_str => $filters_by_relation) {
			foreach ($filters_by_relation as $filter_condition_item) {
				$condition = $filter_condition_item['condition'];
				$value = isset($filter_condition_item['value']) ? (int) $filter_condition_item['value'] : null;

if (!$value)
					continue;

$results = $wpdb->get_col($wpdb->prepare(
					"SELECT post_id FROM {$wpdb->prefix}kirki_cm_reference WHERE field_meta_key = %s AND ref_post_id = %d",
					$key,
					$value
				));

$results = array_map('intval', $results);

if ($condition === 'in') {
					$has_in_condition = true;
					if ($relation_str === 'AND') {
						$post_ids_in[] = $results;
					} else {
						$post_ids_in = array_merge($post_ids_in, $results);
					}
				} elseif ($condition === 'not-in') {
					$has_not_in_condition = true;
					if ($relation_str === 'AND') {
						$post_ids_not_in[] = $results;
					} else {
						$post_ids_not_in = array_merge($post_ids_not_in, $results);
					}
				}
			}
		}

// Handle post__in only if there was an 'in' condition
		if ($has_in_condition) {
			if (!empty($post_ids_in)) {
				$post_ids_in = is_array(reset($post_ids_in))
					? array_reduce($post_ids_in, 'array_intersect', array_shift($post_ids_in)) // ids-> [[1,2], [2,3]] -> array_reduce($ids, 'array_intersect', [1,2])
					: $post_ids_in;

$args['post__in'] = isset($args['post__in'])
					? array_intersect($args['post__in'], $post_ids_in)
					: $post_ids_in;

if (empty($args['post__in'])) {
					$args['post__in'] = [0];
				}
			} else {
				// 'in' condition was given, but returned nothing
				$args['post__in'] = [0];
			}
		}

// Handle post__not_in normally
		if ($has_not_in_condition && !empty($post_ids_not_in)) {
			$post_ids_not_in = is_array(reset($post_ids_not_in))
				? array_merge(...$post_ids_not_in)
				: $post_ids_not_in;

$args['post__not_in'] = isset($args['post__not_in'])
				? array_merge($args['post__not_in'], $post_ids_not_in)
				: $post_ids_not_in;
		}

return $args;
	}

/**
	 * handle legacy filter data
	 * 
	 * @param object $params filter array.
	 *
	 * @return array filter array
	 */
	public static function handle_legacy_filter_to_new_filter($filters)
	{
		$new_filters = array();

if (is_array($filters)) {
			foreach ($filters as $key => $item) {
				if (!isset($item['id']) && isset($item['type']) && $item['type']) {
					switch ($item['type']) {
						case 'date': {
							$new_filters[] = array(
								'type' => 'post_date',
								'id' => 'post_date',
								'title' => 'Post Date',
								'items' => [
									array(
										'start-date' => isset($item['start-date']) ? $item['start-date'] : '',
										'end-date' => isset($item['end-date']) ? $item['end-date'] : '',
										'relation' => 'OR',
									)
								],
							);

break;
						}

case 'author': {
							$new_filters[] = array(
								'type' => 'post_author',
								'id' => 'post_author',
								'title' => 'Author',
								'items' => [
									array(
										'condition' => 'in',
										'values' => $item['values'],
										'relation' => 'OR',
									)
								],
							);

break;
						}

case 'category': {
							$new_filters[] = array(
								'type' => 'post_category',
								'id' => 'post_category',
								'title' => 'Category',
								'items' => [
									array(
										'condition' => 'in',
										'values' => $item['values'],
										'relation' => 'OR',
									)
								],
							);
							break;
						}

default: {
							break;
						}
					}
				} else {
					$new_filters[] = $item;
				}
			}
		}
		return $new_filters;
	}

/**
	 * Static callback for posts_where filter to allow removal with remove_filter.
	 *
	 * @param string $where The WHERE clause.
	 * @return string Modified WHERE clause.
	 */
	public static function posts_where_filter_callback($where)
	{
		global $wpdb;

$params = self::$posts_where_filter_params;
		if (empty($params)) {
			return $where;
		}

$query = $params['query'];
		$reference_where_sql = $params['reference_where_sql'];
		$post_parent = $params['post_parent'];

$search = esc_sql($wpdb->esc_like($query));

$where .= $wpdb->prepare(
			" OR (
				({$wpdb->posts}.post_title LIKE %s OR {$wpdb->posts}.post_content LIKE %s)
				AND {$wpdb->posts}.post_parent = %d
			)",
			"%{$search}%",
			"%{$search}%",
			$post_parent
		);

if (!empty($reference_where_sql)) {
			$where .= " {$reference_where_sql}";
		}

return $where;
	}

public static function get_kirki_cms_inherit_post_filters( $filters, $related_post_parent, $post_parent ) {
		global $wpdb;

if ( empty( $related_post_parent ) ) {
			return $filters;
		}

$related_post_parent = (int) $related_post_parent;

$related_post_parent_obj = get_post($related_post_parent);
		if($related_post_parent_obj && str_contains( $related_post_parent_obj->post_type, 'kirki_cm_' )){
			$related_fields = ContentManagerHelper::get_post_type_custom_field_keys( $post_parent );

if ( empty( $related_fields ) || ! is_array( $related_fields ) ) {
				return $filters;
			}

if ( ! is_array( $filters ) ) {
				$filters = [];
			}

foreach ( $related_fields as $field ) {
				if ( ! isset( $field['type'] ) || ! in_array( $field['type'], [ 'multi-reference', 'reference' ], true ) ) {
					continue;
				}

$field_id = $field['id'] ?? null;
				if ( ! $field_id ) {
					continue;
				}

$meta_key = ContentManagerHelper::get_child_post_meta_key_using_field_id( $post_parent, $field_id );

$has_references = $wpdb->get_var(
					$wpdb->prepare(
						"SELECT COUNT(*) FROM {$wpdb->prefix}kirki_cm_reference WHERE field_meta_key = %s AND ref_post_id = %d",
						$meta_key,
						$related_post_parent
					)
				);

if ( empty( $has_references ) ) {
					continue;
				}

$filter_exists = false;
				$filter_index  = null;

foreach ( $filters as $index => $existing_filter ) {
					if ( isset( $existing_filter['id'] ) && $existing_filter['id'] === $field_id ) {
						$filter_exists = true;
						$filter_index  = $index;
						break;
					}
				}

if ( ! $filter_exists ) {
					$filters[] = [
						'type'  => $field['type'],
						'id'    => $field_id,
						'title' => $field['label'] ?? $field_id,
						'items' => [],
					];
					$filter_index = count( $filters ) - 1;
				}

if ( ! isset( $filters[ $filter_index ]['items'] ) || ! is_array( $filters[ $filter_index ]['items'] ) ) {
					$filters[ $filter_index ]['items'] = [];
				}

$new_item = [
					'condition' => 'in',
					'value'     => $related_post_parent,
					'relation'  => 'OR',
				];

$item_exists = false;
				foreach ( $filters[ $filter_index ]['items'] as $item ) {
					if (
						isset( $item['condition'], $item['value'], $item['relation'] ) &&
						$item['condition'] === $new_item['condition'] &&
						(int) $item['value'] === $new_item['value'] &&
						$item['relation'] === $new_item['relation']
					) {
						$item_exists = true;
						break;
					}
				}

if ( ! $item_exists ) {
					$filters[ $filter_index ]['items'][] = $new_item;
				}
			}
		}

return $filters;
	}

/**
	 * Get dynamic collection data
	 *
	 * @param object $params query object.
	 *
	 * @return array post array
	 */
	public static function get_posts($params)
	{
		$name = isset($params['name']) ? $params['name'] : null;
		$sorting = isset($params['sorting']) ? $params['sorting'] : null;
		$filters = isset($params['filters']) ? $params['filters'] : null;
		$inherit = (bool) ($params['inherit'] ?? false);
		$related = (bool) ($params['related'] ?? false);
		$post_parent = (int) ($params['post_parent'] ?? 0);
		$post_status = isset($params['post_status']) ? $params['post_status'] : 'publish';
		$query = isset($params['q']) ? $params['q'] : '';
		$IDs = isset($params['IDs']) ? $params['IDs'] : [];
		$related_post_parent = isset($params['related_post_parent']) ? $params['related_post_parent'] : self::get_post_id_if_possible_from_url();

// add new 
		$current_page = isset($params['current_page']) ? $params['current_page'] : 1;
		$item_per_page = isset($params['item_per_page']) ? $params['item_per_page'] : 3;
		$offset = isset($params['offset']) ? $params['offset'] : 0;
		$context = isset($params['context']) ? $params['context'] : null;
		$tax_query = [
			'relation' => 'AND',
		];

// Calculate the offset
		$offset = ($current_page - 1) * $item_per_page + $offset;

$args = array(
			'posts_per_page' => $item_per_page,
			'paged' => $current_page,
			'offset' => $offset,
			'post_type' => $name,
			'suppress_filters' => true,
			'post_status' => $post_status,
			's' => $query,
		);

if (!empty($query)) {
			self::search_posts_by_query($name, $query, $post_parent, $args);
		} else {
			remove_filter('posts_where', [HelperFunctions::class, 'posts_where_filter_callback']);
		}

$filters = self::handle_legacy_filter_to_new_filter($filters);
		if($inherit && $related_post_parent && str_contains( $name, 'kirki_cm_' )){
			$filters = self::get_kirki_cms_inherit_post_filters($filters, $related_post_parent, $post_parent);
		}
		$added_filters = array();

/**
		 * Combine search and filters with AND logic
		 * 
		 * When both search query and filters are present, we need to ensure they work together:
		 * - Search creates meta_query with 'OR' relation (matches any custom field)
		 * - Filters add additional conditions
		 * - Final structure: AND(search_conditions, filter_conditions)
		 * 
		 * This makes filters compulsory when searching, narrowing results further.
		 */
		$search_meta_query = isset($args['meta_query']) ? $args['meta_query'] : null;
		$has_search = !empty($query) && $search_meta_query !== null;
		$has_filters = !empty($filters) && is_array($filters);

// Reset meta_query if both search and filters exist to rebuild with AND relation
		if ($has_search && $has_filters) {
			$args['meta_query'] = [
				'relation' => 'AND',
				$search_meta_query, // Search conditions (with OR relation internally)
			];
		}

if (isset($filters) && is_array($filters)) {
			foreach ($filters as $filter_item) {
				if (isset($filter_item['parent']) && $filter_item['parent']) {
					$filter_item['id'] = 'term';
				}
				$field_name = isset($filter_item['id']) ? $filter_item['id'] : '';

if (!$field_name) {
					continue;
				}

if (self::attribute_in_post_table($filter_item['id']) && is_array($filter_item['items'])) {

switch ($field_name) {
						case 'post_excerpt':
						case 'post_content':
						case 'post_title': {
							$callback = self::post_table_filter_query($filter_item, 'text');
							if ($callback) {
								$added_filters[] = $callback;
							}
							break;
						}

case 'post_date':
						case 'post_date_gmt': {
							/**
							 * $filter_item['items'] max contain one array. 
							 * in array may contain start-date, end-date
							 * Like: [{"start-date": "2020-01-01","end-date": "2020-01-02"}]
							 */

if (isset($filter_item['items'], $filter_item['items'][0])) {
								$items = $filter_item['items'];
								$item = $items[0]; // Get first item in array.

$date_query = array('column' => $field_name);
								$date_query['inclusive'] = true;

if (!empty($item['start-date'])) {
									$date_query['after'] = $item['start-date'];
								}

if (!empty($item['end-date'])) {
									$date_query['before'] = $item['end-date'];
								}

$args['date_query'] = $date_query;
							}

break;
						}

case 'post_author': {

/**
							 * $filter_item['items'] must not contain more than 2 array of conditions. 
							 * 1 array may contain 'in' conditions and another for 'not-in' conditions
							 * And values of 'in' and 'not-in' conditions should not collide
							 * Like: the condition should not be author 'in' [1, 2, 3] and 'not-in' [2, 4, 5]
							 */
							$items = $filter_item['items'];

foreach ($items as $item) {
								if (isset($item['condition'], $item['values']) && is_array($item['values'])) {
									if ($item['condition'] === 'in') {
										$args['author__in'] = $item['values'];
									}

if ($item['condition'] === 'not-in') {
										$args['author__not_in'] = $item['values'];
									}
								}
							}

break;
						}

case 'term': {
							$items = $filter_item['items'];

foreach ($items as $item) {
								if (isset($item['condition'], $item['values']) && is_array($item['values'])) {

if ($item['condition'] === 'in' && !empty($item['values'])) {
										array_push($tax_query, [
											'taxonomy' => $filter_item['type'],
											'field' => 'term_id',
											'terms' => $item['values'],
											'operator' => 'IN',
										]);
									}

if ($item['condition'] === 'not-in' && !empty($item['values'])) {
										array_push($tax_query, [
											'taxonomy' => $filter_item['type'],
											'field' => 'term_id',
											'terms' => $item['values'],
											'operator' => 'NOT IN',
										]);
									}
								}
							}
							break;
						}
					}
				} else {
					$key = ContentManagerHelper::get_child_post_meta_key_using_field_id($post_parent, $field_name);
					$data_type = $filter_item['type'] ?? 'text';

if (!isset($args['meta_query'])) {
						$args['meta_query'] = array();
					} elseif (!is_array($args['meta_query'])) {
						$args['meta_query'] = array();
					}
					
					// Ensure meta_query has proper structure when combining search + filters
					if ($has_search && !isset($args['meta_query']['relation'])) {
						$args['meta_query']['relation'] = 'AND';
					}

switch ($data_type) {
						default:
						case 'rich_text':
						case 'text':
						case 'phone':
						case 'url':
						case 'email': {
							$args['meta_query'][] = self::post_meta_table_filter_query($filter_item, $key, 'text');
							break;
						}

case 'date': {
							$args['meta_query'][] = self::post_meta_table_filter_query($filter_item, $key, 'date');
							break;
						}

case 'number': {
							$args['meta_query'][] = self::post_meta_table_filter_query($filter_item, $key, 'number');
							break;
						}

case 'option': {
							$args['meta_query'][] = self::post_meta_table_filter_query($filter_item, $key, 'option');
							break;
						}

case 'switch': {
							$args['meta_query'][] = self::post_meta_table_filter_query($filter_item, $key, 'switch');
							break;
						}

case 'taxonomy': {
							if (empty($args['tax_query'])) {
								$tax_query = array(
									'relation' => 'AND'
								);
							}

if (
								isset($filter_item['taxonomy'], $filter_item['terms']) &&
								is_array($filter_item['terms'])
							) {
								$operators = array('NOT IN', 'IN');

$operator = 'IN';

if (isset($filter_item['operator']) && in_array($filter_item['operator'], $operators, true)) {
									$operator = $filter_item['operator'];
								}

array_push($tax_query, [
									'taxonomy' => $filter_item['taxonomy'],
									'field' => 'term_id', // So far this is fixed
									'terms' => $filter_item['terms'],
									'operator' => $operator,
								]);
							}
							break;
						}

case 'author': {
							if (isset($filter_item['condition'], $filter_item['values']) && is_array($filter_item['values'])) {
								if ($filter_item['condition'] === 'is-equal') {
									$args['author__in'] = $filter_item['values'];
								}

if ($filter_item['condition'] === 'is-not-equal') {
									$args['author__not_in'] = $filter_item['values'];
								}
							}
							break;
						}

case 'multi-reference':
						case 'reference': {
							$args = self::cm_reference_table_filter_query($filter_item, $key, $args);
							break;
						}
					}
				}
			}
		}

if (count($IDs) > 0) {
			$args['post__in'] = $IDs;
			unset($args['post_parent']);
			$args['post_type'] = 'any';
			$inherit = false;
			$post_parent = false;
		}

if (count($tax_query) > 1) {
			$args['tax_query'] = $tax_query;
		}

// Set default orderby and order if not explicitly specified
		$order = 'DESC';
		$orderby = 'date';

if (isset($sorting) && is_array($sorting) && !empty($sorting)) {
			if (!empty($sorting['order'])) {
				$order = $sorting['order'];
			} elseif (!empty($sorting['type'])) {
				$order = $sorting['type'];
			}

if (!empty($sorting['orderby'])) {
				$orderby = $sorting['orderby'];
			} elseif (!empty($sorting['value'])) {
				$orderby = $sorting['value'];
			}
		}

$args['order'] = $order;

if ('none' !== $orderby) {
			if (isset($name) && str_contains($name, KIRKI_CONTENT_MANAGER_PREFIX) && !in_array($orderby, KIRKI_WORDPRESS_SORT_BY_OPTIONS, true)) {
				$args['orderby'] = 'meta_value'; // Use 'meta_value' or 'meta_value_num' as needed
				$args['meta_key'] = ContentManagerHelper::get_child_post_meta_key_using_field_id($post_parent, $orderby);
			} elseif ('date' === $orderby) {
				$args['orderby'] = array('date' => $order, 'ID' => $order);
			} else {
				$args['orderby'] = $orderby;
			}
		}

if ($inherit || $post_parent) {
			//TODO: if terms page then show terms post only. like tag, category.
			$args['post_parent'] = $post_parent;
		}

if (!empty($context) && $inherit && isset( $args['post_type']) && !str_contains( $args['post_type'], 'kirki_cm') ) {
			if ($context['collectionType'] == 'user') {
				$args['author'] = $context['id'];
				unset($args['post_parent']);
			}
			if ($context['collectionType'] == 'term') {
				$args['tax_query'] = array(
					array(
						'taxonomy' => $context['taxonomy'], // Replace 'category' with your taxonomy
						'field' => 'term_id', // Use 'slug' if you want to query by slug
						'terms' => $context['id'],       // Replace 123 with your term ID
					)
				);
				unset($args['post_parent']);
			}
		}

if ($related) {
			$post = get_post($related_post_parent);

if ($post) {
				$args['post_type'] = $post->post_type;
				if (str_contains($post->post_type, 'kirki_cm_')) {
					// filter related posts for content manager post
					$referenced_post_ids = self::get_referenced_post_ids($post_parent, $post);
					$args['post__in'] = array_map('intval', $referenced_post_ids);
				} else {
					$args['tax_query'] = self::buildTaxonomyForRelatedPosts($post);
					$args['post__not_in'] = [$post->ID];
				}

}
		}

// Disable suppress_filters when post_table text filters (post_title, post_content, post_excerpt)
		// are present, since they rely on posts_where hooks to modify the SQL query.
		if (!empty($added_filters)) {
			$args['suppress_filters'] = false;
		}

// Run the WP_Query
		$query = new WP_Query($args);
		foreach ($added_filters as $callback) {
			remove_filter('posts_where', $callback);
		}

$posts = $query->posts;

$custom_logo_id = get_theme_mod('custom_logo');
		$image = wp_get_attachment_image_src($custom_logo_id, 'full');

$kirki_content_manager_post_type_fields = array();

if (isset($args['post_type']) && KIRKI_CONTENT_MANAGER_PREFIX === $args['post_type']) {
			$post_parent = $args['post_parent'];
			$kirki_content_manager_post_type_fields = ContentManagerHelper::get_post_type_custom_field_keys($post_parent);
		}

foreach ($posts as $key => &$post) {
			if (is_null($post)) {
				unset($posts[$key]);
				continue;
			}
			if (
				KIRKI_CONTENT_MANAGER_PREFIX === $post->post_type && is_array($kirki_content_manager_post_type_fields)
			) {
				foreach ($kirki_content_manager_post_type_fields as $field_key) {
					$meta_key = ContentManagerHelper::get_child_post_meta_key_using_field_id($post->post_parent, $field_key['id']);
					$post->{$field_key['id']} = get_post_meta($post->ID, $meta_key, true);

if (
						isset($field_key['type']) &&
						$field_key['type'] === 'image' &&
						$post->{$field_key['id']}
					) {
						$post->{$field_key['id']} = array(
							'wp_attachment_id' => $post->{$field_key['id']}['id'],
							'src' => $post->{$field_key['id']}['url'],
						);
					}
				}
			}

$post->post_id = $post->ID;
			$post->author_profile_picture = array(
				'src' => get_avatar_url($post->post_author)
			);
			$post->post_author = get_the_author_meta('display_name', $post->post_author);
			$post->post_time = get_the_time('', $post->ID);
			$post->featured_image = array(
				'wp_attachment_id' => get_post_thumbnail_id($post->ID),
				'src' => get_the_post_thumbnail_url($post->ID)
			);
			$post->site_logo = isset($image[0]) ? $image[0] : '';
			$post->post_page_link = \get_permalink($post->ID);
			$post->author_posts_page_link = \get_author_posts_url($post->post_author);

unset($post->post_excerpt);
		}
		;

// Get total posts and total pages for pagination
		$total_posts = $query->found_posts;
		$total_posts_updated = max(0, $total_posts - $offset);
		$total_pages = ceil($total_posts_updated / $item_per_page);

// Calculate previous and next page numbers
		$prev_page = ($current_page > 1) ? $current_page - 1 : null;
		$next_page = ($current_page < $total_pages) ? $current_page + 1 : null;

// Return the query and pagination info
		return array(
			'data' => $posts,
			'pagination' => array(
				'per_page' => $item_per_page,
				'current_page' => $current_page,
				'total_pages' => $total_pages,
				'total_count' => $total_posts,
				'previous' => $prev_page,
				'next' => $next_page,
			),
		);
	}

public static function search_posts_by_query($name, $query, $post_parent, &$args)
	{
		global $wpdb;

if (!str_contains($name, 'kirki_cm_')) {
			return;
		}

unset($args['s']);

$all_custom_fields = ContentManagerHelper::get_post_type_custom_field_keys($post_parent);
		$meta_query_args = ['relation' => 'OR'];
		$reference_where_sql = '';

foreach ($all_custom_fields as $data) {
			if (!$data)
				continue;

$meta_key = ContentManagerHelper::get_child_post_meta_key_using_field_id($post_parent, $data['id']);

if (in_array($data['type'], ['text'], true)) {
				$meta_query_args[] = [
					'key' => $meta_key,
					'value' => $query,
					'compare' => 'LIKE',
				];
			}

if (in_array($data['type'], ['reference'], true)) {
				$matched_post_ids = self::get_matched_post_ids_recursive($data['ref_collection'], $query);

if (!empty($matched_post_ids)) {
					$ids = implode(',', array_map('intval', $matched_post_ids));
					$reference_where_sql .= $wpdb->prepare(
						" OR {$wpdb->posts}.ID IN (
						SELECT post_id
						FROM {$wpdb->prefix}kirki_cm_reference
						WHERE field_meta_key = %s
						AND ref_post_id IN ($ids)
					)",
						$meta_key
					);
				}
			}
		}

if (count($meta_query_args) > 1) {
			$args['meta_query'] = $meta_query_args;
		}

// Store filter parameters for the callback
		self::$posts_where_filter_params = [
			'query' => $query,
			'reference_where_sql' => $reference_where_sql,
			'post_parent' => $post_parent,
		];

add_filter('posts_where', [__CLASS__, 'posts_where_filter_callback']);
	}

public static function get_matched_post_ids_recursive($post_parent, $query, $depth = 0, $max_depth = 5)
	{
		global $wpdb;

if ($depth > $max_depth) {
			return [];
		}

$post_type = 'kirki_cm_' . $post_parent;

$matched_post_ids = $wpdb->get_col(
			$wpdb->prepare(
				"SELECT ID FROM {$wpdb->posts}
				WHERE post_title LIKE %s
				AND post_status = 'publish'
				AND post_type = %s",
				'%' . $wpdb->esc_like($query) . '%',
				$post_type
			)
		);

$ref_custom_fields = ContentManagerHelper::get_post_type_custom_field_keys($post_parent);
		$meta_conditions = [];

foreach ($ref_custom_fields as $ref_field) {
			if (!$ref_field)
				continue;

if (in_array($ref_field['type'], ['text'], true)) {
				$ref_meta_key = ContentManagerHelper::get_child_post_meta_key_using_field_id($post_parent, $ref_field['id']);
				$meta_conditions[] = $wpdb->prepare(
					"(meta_key = %s AND meta_value LIKE %s)",
					$ref_meta_key,
					"%{$search}%"
				);
			}
		}

if (!empty($meta_conditions)) {
			$where_meta = implode(' OR ', $meta_conditions);
			$meta_post_ids = $wpdb->get_col("SELECT DISTINCT post_id FROM {$wpdb->postmeta} WHERE {$where_meta}"); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
			$matched_post_ids = array_merge($matched_post_ids, $meta_post_ids);
		}

foreach ($ref_custom_fields as $ref_field) {
			if (!$ref_field || !in_array($ref_field['type'], ['reference'], true)) {
				continue;
			}

$ref_post_parent = $ref_field['ref_collection'];
			$nested_matched_ids = self::get_matched_post_ids_recursive($ref_post_parent, $query, $depth + 1, $max_depth);

if (!empty($nested_matched_ids)) {
				$meta_key = ContentManagerHelper::get_child_post_meta_key_using_field_id($post_parent, $ref_field['id']);
				$ids = implode(',', array_map('intval', $nested_matched_ids));
				$ref_post_ids = $wpdb->get_col($wpdb->prepare("SELECT post_id FROM {$wpdb->prefix}kirki_cm_reference WHERE field_meta_key = %s AND ref_post_id IN ($ids)", $meta_key)); // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared, WordPress.DB.PreparedSQL.NotPrepared
				$matched_post_ids = array_merge($matched_post_ids, $ref_post_ids);
			}
		}

return array_unique(array_map('intval', $matched_post_ids));
	}

public static function get_referenced_post_ids($post_parent, $post)
	{
		global $wpdb;

$allData = ContentManagerHelper::get_post_type_custom_field_keys($post_parent);
		$post_ids = [];

foreach ($allData as $data) {
			if ($data && in_array($data['type'], ['reference', 'multi-reference'], true)) {
				$meta_key = 'kirki_cm_field_' . $post_parent . '_' . $data['id'];

$results = $wpdb->get_results(
					$wpdb->prepare(
						"SELECT ref_post_id FROM {$wpdb->prefix}kirki_cm_reference WHERE field_meta_key = %s AND post_id = %d",
						$meta_key,
						$post->ID
					),
					ARRAY_A
				);

foreach ($results as $id) {
					$related_posts = $wpdb->get_results(
						$wpdb->prepare(
							"SELECT post_id FROM {$wpdb->prefix}kirki_cm_reference WHERE field_meta_key = %s AND ref_post_id = %d",
							$meta_key,
							(int) $id['ref_post_id']
						),
						ARRAY_A
					);

foreach ($related_posts as $related) {
						$related_id = (int) $related['post_id'];

if ($related_id !== (int) $post->ID) {
							$post_ids[] = $related_id;
						}
					}

}
			}
		}
		$post_ids = array_values(array_unique($post_ids));

return !empty($post_ids) ? $post_ids : [0];
	}

public static function get_terms($params)
	{
		$terms_array = [];
		$current_page = isset($params['current_page']) ? (int) $params['current_page'] : 1;
		$item_per_page = isset($params['item_per_page']) ? (int) $params['item_per_page'] : 3;
		$offset = isset($params['offset']) ? (int) $params['offset'] : 0;

if (!empty($params['inherit'])) {
			$terms_array = get_the_terms($params['post_parent'], $params['taxonomy']);
			if (is_array($terms_array)) {
				// Convert WP_Term objects to arrays only if needed
				$terms_array = array_map(function ($term) {
					return is_object($term) && method_exists($term, 'to_array')
						? $term->to_array()
						: (array) $term;
				}, $terms_array);

$calculated_offset = (($current_page - 1) * $item_per_page) + $offset;
				$terms_array = array_slice($terms_array, $calculated_offset, $item_per_page);
			} else {
				$terms_array = [];
			}
		} else {
			$params['offset'] = (($current_page - 1) * $item_per_page) + $offset;
			$params['number'] = $item_per_page;

$terms_array = get_terms($params);

if (is_array($terms_array)) {
				foreach ($terms_array as &$item) {
					if (is_object($item) && method_exists($item, 'to_array')) {
						$item = $item->to_array();
					} elseif (is_object($item)) {
						$item = (array) $item;
					}
				}
			} else {
				$terms_array = [];
			}
		}

// Count total terms
		$total_terms = 0;
		if (!empty($params['inherit'])) {
			$t = get_the_terms($params['post_parent'], $params['taxonomy']);
			if (is_array($t)) {
				$total_terms = count($t);
			} else {
				$total_terms = wp_count_terms(['taxonomy' => $params['taxonomy']]);
			}
		} else {
			$total_terms = wp_count_terms(['taxonomy' => $params['taxonomy']]);
		}

$total_terms = is_numeric($total_terms) ? (int) $total_terms : 0;
		$total_pages = ($item_per_page > 0) ? ceil($total_terms / $item_per_page) : 1;
		$prev_page = ($current_page > 1) ? $current_page - 1 : null;
		$next_page = ($current_page < $total_pages) ? $current_page + 1 : null;

return [
			'data' => $terms_array,
			'pagination' => [
				'per_page' => $item_per_page,
				'current_page' => $current_page,
				'total_pages' => $total_pages,
				'total_count' => $total_terms,
				'previous' => $prev_page,
				'next' => $next_page,
			],
		];
	}

public static function buildTaxonomyForRelatedPosts(\WP_Post $post)
	{
		$taxonomies = get_object_taxonomies($post->post_type);
		$taxQuery = [
			'relation' => 'OR',
		];

foreach ($taxonomies as $taxonomy) {
			$taxQuery[] = [
				'taxonomy' => $taxonomy,
				'field' => 'slug',
				'terms' => array_filter(wp_get_object_terms($post->ID, $taxonomy, ['fields' => 'slugs']), function ($termSlug) {
					return strtolower($termSlug) !== 'uncategorized';
				}),
			];
		}

return $taxQuery;
	}

/**
	 * Get dynamic collectiond data
	 *
	 * @param object $params query object.
	 *
	 * @return array post array
	 */
	public static function get_comments($params)
	{
		$parent = (int) ($params['parent'] ?? 0);
		$post_id = (int) ($params['post_id'] ?? 0);
		$type = ($params['type'] ?? 'comment');
		$sorting = isset($params['sorting']) ? $params['sorting'] : null;
		$filters = isset($params['filters']) ? $params['filters'] : null;
		// add new 
		$current_page = isset($params['current_page']) ? $params['current_page'] : 1;
		$item_per_page = isset($params['item_per_page']) ? $params['item_per_page'] : 3;
		$offset = isset($params['offset']) ? $params['offset'] : 0;

// Calculate the offset
		$offset_cal = ($current_page - 1) * $item_per_page + $offset;

$args = array(
			'parent' => $parent,
			'post_id' => $post_id,
			'type' => $type,
			'status' => 'approve',
			'number' => $item_per_page,
			'paged' => $current_page,
			'offset' => $offset_cal,
			'count' => false
		);

if (isset($filters) && is_array($filters)) {
			foreach ($filters as $filter_item) {
				$field_name = isset($filter_item['id']) ? $filter_item['id'] : '';

if (!$field_name) {
					continue;
				}
				switch ($field_name) {
					case 'comment_date':
					case 'comment_date_gmt': {
						/**
						 * $filter_item['items'] max contain one array. 
						 * in array may contain start-date, end-date
						 * Like: [{"start-date": "2020-01-01","end-date": "2020-01-02"}]
						 */
						if (isset($filter_item['items'], $filter_item['items'][0])) {
							$items = $filter_item['items'];
							$item = $items[0]; // Get first item in array.

$date_query = array('column' => $field_name);
							$date_query['inclusive'] = true;

if (!empty($item['start-date'])) {
								$date_query['after'] = $item['start-date'];
							}

if (!empty($item['end-date'])) {
								$date_query['before'] = $item['end-date'];
							}

$args['date_query'] = $date_query;
						}

break;
					}

case 'comment_author': {
						$items = $filter_item['items']; // $items['items'] max contain one array.

foreach ($items as $item) {
							if (isset($item['condition'], $item['values']) && is_array($item['values'])) {
								if ($item['condition'] === 'in') {
									$args['author__in'] = $item['values'];
								}

if ($item['condition'] === 'not-in') {
									$args['author__not_in'] = $item['values'];
								}
							}
						}

break;
					}

case 'comment_approved': {
						$items = $filter_item['items']; //  $items['items'] max contain one array.

foreach ($items as $item) {
							if (isset($item['condition'], $item['values']) && is_array($item['values'])) {
								if ($item['condition'] === 'in') {
									$args['status'] = $item['values'];
								}
							}
						}
					}
				}
			}
		}

if (isset($sorting)) {
			// Set the sort order (ASC/DESC)
			if (isset($sorting['order'])) {
				$args['order'] = $sorting['order'];
			}

if (isset($sorting['orderby']) && !empty($sorting['orderby'])) {
				$args['orderby'] = $sorting['orderby'];
			}
		}

$comments = get_comments($args);
		unset($args['number']);
		unset($args['paged']);

if (is_array($comments)) {
			foreach ($comments as &$comment) {
				$comment = (object) (array) $comment;

$author_posts_page_link = $comment->comment_author_url;

if (!$author_posts_page_link) {
					$author_posts_page_link = \get_author_posts_url($comment->user_id);
				}

$comment->author_profile_picture = array(
					'src' => get_avatar_url($comment->user_id)
				);
				$comment->author_posts_page_link = $author_posts_page_link;
			}
		}

// Get total comments count
		$total_comments = get_comments(array_merge($args, array('count' => true)));
		$total_comments = $total_comments - $offset;

// Calculate total pages
		$total_pages = ceil($total_comments / $item_per_page);

// Calculate previous and next pages
		$prev_page = ($current_page > 1) ? $current_page - 1 : null;
		$next_page = ($current_page < $total_pages) ? $current_page + 1 : null;

// return $comments;
		return array(
			'data' => $comments,  // Raw comments data
			'pagination' => array(
				'per_page' => $item_per_page,
				'current_page' => $current_page,
				'total_pages' => $total_pages,
				'total_count' => $total_comments,
				'previous' => $prev_page,
				'next' => $next_page,
			),
		);
	}

/**
	 * Remove all default assets
	 *
	 * @return void
	 */
	public static function remove_wp_assets()
	{
		/*
		// Remove all WordPress actions
		// remove_all_actions('wp_head');
		// remove_all_actions('wp_print_styles');
		// remove_all_actions('wp_print_head_scripts');
		// remove_all_actions('wp_footer');

// // Handle `wp_head`
		// add_action('wp_head', 'wp_enqueue_scripts', 1);
		// add_action('wp_head', 'wp_print_styles', 8);
		// add_action('wp_head', 'wp_print_head_scripts', 9);
		// add_action('wp_head', 'wp_site_icon');

// // Handle `wp_footer`
		// add_action('wp_footer', 'wp_print_footer_scripts', 20);

// // Handle `wp_enqueue_scripts`
		// remove_all_actions('wp_enqueue_scripts');

// // Also remove all scripts hooked into after_wp_tiny_mce.
		// remove_all_actions('after_wp_tiny_mce');
		*/
		// remove admin-bar.
		add_filter('show_admin_bar', '__return_false', PHP_INT_MAX);
	}

/**
	 * Get server protocol
	 * currently not in use
	 *
	 * @return string protocol name.
	 */
	public static function get_protocol()
	{
		$protocol = isset($_SERVER['HTTPS']) ? 'https' : 'http';
		return $protocol;
	}

/**
	 * Check if the current user has specific role ($role)
	 *
	 * @param string $role The role to check.
	 * @return boolean
	 */
	public static function user_is($role)
	{
		$user = wp_get_current_user();
		$roles = $user->roles;

return is_array($roles) && count($roles) && in_array($role, $roles, true) ? true : false;
	}

/**
	 * Check if the user has access to edit/create specific/all post
	 *
	 * @param int $post_id post id.
	 * @return boolean
	 * 
	 * @deprecated
	 * @see Kirki\App\Wordpress\User::has_edit_access()
	 */
	public static function user_has_post_edit_access()
	{
		return self::has_access(
			array(
				KIRKI_ACCESS_LEVELS['FULL_ACCESS'],
				KIRKI_ACCESS_LEVELS['CONTENT_ACCESS'],
			)
		);
	}

/**
	 * Check if the user has access to editor
	 *
	 * @return boolean
	 */
	public static function user_has_editor_access()
	{
		if (isset($_GET['editor-preview-token'])) {
			//phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
			$editor_preview_token = self::sanitize_text(isset($_GET['editor-preview-token']) ? $_GET['editor-preview-token'] : '');
			$is_valid_token = self::is_post_editor_preview_token_valid($editor_preview_token);

// Token rides in the URL for this one entry request (a clicked link
			// can't set headers) — stop it leaking onward via the Referer header
			// on any request this page makes to third-party resources.
			if ($is_valid_token && !headers_sent()) {
				header('Referrer-Policy: no-referrer', false);
			}

return $is_valid_token;
		}
		return self::has_access(
			array(
				KIRKI_ACCESS_LEVELS['FULL_ACCESS'],
				KIRKI_ACCESS_LEVELS['CONTENT_ACCESS'],
				KIRKI_ACCESS_LEVELS['VIEW_ACCESS'],
			)
		);
	}

public static function getallheaders()
	{
		$headers = [];

foreach ($_SERVER as $name => $value) {
			if (strpos($name, 'HTTP_') === 0) {
				$key = substr($name, 5);
			} elseif (in_array($name, ['CONTENT_TYPE', 'CONTENT_LENGTH', 'CONTENT_MD5'])) {
				$key = $name;
			} else {
				continue;
			}

// Convert HEADER_NAME → Header-Name
			$key = str_replace('_', ' ', strtolower($key));
			$key = ucwords($key);
			$key = str_replace(' ', '-', $key);

$headers[$key] = $value;
		}

return $headers;
	}

/**
	 * Check if the request is from the editor preview.
	 * 
	 * @deprecated Use Kirki\App\Supports\EditorPreview::has_valid_token
	 * @see \Kirki\App\Supports\EditorPreview::has_valid_token()
	 * @return bool
	 */
	public static function is_api_call_from_editor_preview()
	{
		// Check the Editor-Preview-Token header
		$headers = self::getallheaders();
		$editor_preview_token = isset($headers['Editor-Preview-Token']) ? $headers['Editor-Preview-Token'] : null;
		if ($editor_preview_token && HelperFunctions::is_post_editor_preview_token_valid($editor_preview_token)) {
			return true;
		}
		return false;
	}

/**
	 * Check if the Editor-Preview-Token header is valid
	 * 
	 * @deprecated Use Kirki\App\Supports\EditorPreview::has_valid_token
	 * @see Kirki\App\Supports\EditorPreview::has_valid_token()
	 * @return bool
	 */
	public static function is_api_header_post_editor_preview_token_valid()
	{
		// Check the Editor-Preview-Token header
		$headers = self::getallheaders();
		$editor_preview_token = isset($headers['Editor-Preview-Token']) ? $headers['Editor-Preview-Token'] : null;
		if (HelperFunctions::is_post_editor_preview_token_valid($editor_preview_token)) {
			return true;
		}
		return false;
	}

/**
	 * Check if the Editor-Preview-Token header is valid
	 * 
	 * @deprecated Use Kirki\App\Supports\EditorPreview::has_valid_token
	 * @see Kirki\App\Supports\EditorPreview::has_valid_token()
	 * @return bool
	 */
	public static function is_post_editor_preview_token_valid($token)
	{
		$status = HelperFunctions::get_global_data_using_key('kirki_editor_read_only_access_status');
		if ($status) {
			$kirki_editor_read_only_access_token = HelperFunctions::get_global_data_using_key('kirki_editor_read_only_access_token');
			if ($kirki_editor_read_only_access_token && hash_equals((string) $kirki_editor_read_only_access_token, (string) $token)) {
				return true;
			}
		}
		return false;
	}

/**
	 * Check if the current user has specific access
	 *
	 * @deprecated Use Kirki\App\Wordpress\User::has_access
	 * @see Kirki\App\Wordpress\User
	 * @param string|string[] $access_level The access level to check access.
	 * 
	 */
	public static function has_access($access_level)
	{
		if (!function_exists('wp_get_current_user')) {
			return false;
		}

$user = wp_get_current_user();
		$roles = $user->roles;
		$has_access = false;

if (is_array($access_level)) {
			foreach ($roles as $role) {
				$access = get_option('kirki_' . $role);
				if (!empty($access) && in_array($access, $access_level, true)) {
					$has_access = true;
					break;
				}
			}
		} elseif (is_string($access_level)) {
			foreach ($roles as $role) {
				$access = get_option('kirki_' . $role);
				if (!empty($access) && $access === $access_level) {
					$has_access = true;
					break;
				}
			}
		}

return $has_access;
	}

/**
	 * This method will collect license info from kirki.com
	 *
	 * @param string $license_key user license key.
	 * @return array license info.
	 */
	public static function get_my_license_info($license_key)
	{
		//phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
		$info = self::http_get(KIRKI_CORE_PLUGIN_URL . '/?license_key=' . $license_key . '&host=' . rawurlencode(self::sanitize_text(isset($_SERVER['HTTP_HOST']) ? $_SERVER['HTTP_HOST'] : null)));
		$info = json_decode($info, true);
		if ($info && isset($info['success'])) {
			return $info['data'];
		} else {
			return array('key' => $license_key);
		}
	}

/**
	 * HTTP get
	 *
	 * @param string $url api endpoint url.
	 * @return string|bool response.
	 * 
	 * @deprecated
	 * @see \Kirki\Framework\Supports\Facades\Http::get()
	 */
	public static function http_get($url, $args = array())
	{
		try {
			$response = wp_remote_get($url, $args);

if ((!is_wp_error($response)) && (200 === wp_remote_retrieve_response_code($response))) {
				$responseBody = $response['body'];

return $responseBody;
			}

return false;
		} catch (\Exception $ex) {
			return false;
		}
	}

/**
	 * HTTP post
	 *
	 * @param string $url api endpoint url.
	 * @param array  $options options.
	 * @return array|WP_Error response.
	 * 
	 * @deprecated
	 * @see \Kirki\Framework\Supports\Facades\Http::post()
	 */
	public static function http_post($url, $options)
	{
		$res = wp_remote_post($url, $options);
		return $res;
	}

/**
	 * Text domain load hooks
	 *
	 * @param string $handle kirki handle.
	 * @return void
	 */
	public static function load_script_text_domain($handle)
	{
		wp_set_script_translations($handle, 'kirki', KIRKI_PLUGIN_PATH . 'languages/');
	}

/**
	 * Delete kirki related meta if a post is deleted.
	 *
	 * @param int $post_id post id.
	 * @return void
	 */
	public static function delete_post_with_meta_key($post_id)
	{
		delete_post_meta($post_id, KIRKI_META_NAME_FOR_USED_STYLE_BLOCK_IDS);
		delete_post_meta($post_id, KIRKI_META_NAME_FOR_USED_STYLE_BLOCK_IDS . '_random');
		delete_post_meta($post_id, 'kirki');
		delete_post_meta($post_id, KIRKI_META_NAME_FOR_POST_EDITOR_MODE);
		delete_post_meta($post_id, KIRKI_GLOBAL_STYLE_BLOCK_META_KEY);
		delete_post_meta($post_id, KIRKI_GLOBAL_STYLE_BLOCK_META_KEY . '_random');
		delete_post_meta($post_id, KIRKI_META_NAME_FOR_USED_FONT_LIST);
	}
	/**
	 * Get the query string for the media type
	 *
	 * @param string $type media type.
	 * @return string The query string.
	 * @example  HelperFunctions::get_media_type_query_string('image') => 'image/jpeg, image/png, image/gif'
	 */
	public static function get_media_type_query_string($type)
	{
		return implode(
			', ',
			array_map(
				function ($v) {
					return "'" . $v . "'";
				},
				KIRKI_SUPPORTED_MEDIA_TYPES[$type]
			)
		);
	}

/**
	 * This is for component configuration/object javascript variable.
	 *
	 * @return string script tag
	 */
	public static function get_empty_variables()
	{
		$s = "<script id='kirki-elements-property-empty-vars'>";
		$s .= 'var ' . 'kirkiSliders = [], ' . 'kirkiMaps = [], ' . 'kirkiLotties = [], ' . 'kirkiPopups = [], ' . 'kirkiLightboxes = [], ' . 'kirkiReCaptchas = [], ' . 'kirkiVideos = [], ' . 'kirkiTabs = [], ' . 'kirkiInteractions = [], ' . 'kirkiCollections = [], ' . 'kirkiDropdown = [], ' . 'kirkiForms = [];';
		$s .= '</script>';
		return $s;
	}

/**
	 * Check kirki and kirki pro is active or not
	 *
	 * @param string $plugin_main_file plugin main PHP file name.
	 * @return boolean
	 */
	public static function is_plugin_activate($plugin_main_file)
	{
		if (in_array($plugin_main_file, apply_filters('active_plugins', get_option('active_plugins')), true)) {
			// plugin is activated.
			return true;
		}
		return false;
	}

/**
	 * This function will verify nonce
	 * ACT like API calls auth middleware
	 *
	 * @param string $action ajax action name.
	 *
	 * @return void
	 */
	public static function verify_nonce($action = -1)
	{
		//phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
		$headers = static::getallheaders();
		$header_nonce = isset($headers['X-Wp-Nonce']) ? static::sanitize_text($headers['X-Wp-Nonce']) : '';
		$nonce = $header_nonce ? $header_nonce : static::sanitize_text(isset($_GET['_wpnonce']) ? $_GET['_wpnonce'] : '');

if (!wp_verify_nonce($nonce, $action)) {
			wp_send_json_error('Not authorized');
			exit;
		}
	}

/**
	 * Unslash and sanitize text
	 *
	 * @param string $v text.
	 * @return string sanitized text.
	 */
	public static function sanitize_text($v)
	{
		return sanitize_text_field(wp_unslash($v));
	}

/**
	 * Get current WordPress session ID.
	 * This method generates a unique session ID if none exists.
	 *
	 * @deprecated
	 * @see \Kirki\App\Supports\Session::get_session_id()
	 *
	 * @return string Session ID.
	 */
	public static function get_session_id()
	{

// First, check if a session ID is already stored in the static variable.
		if (self::$global_session_id) {
			return self::$global_session_id;
		}

// Check if a session ID exists in a cookie.
		if (isset($_COOKIE['kirki_session_id'])) {
			self::$global_session_id = sanitize_text_field($_COOKIE['kirki_session_id']);
			return self::$global_session_id;
		}

// Generate a new session ID.
		self::$global_session_id = wp_generate_uuid4();
		// Set the session ID in a cookie.
		setcookie('kirki_session_id', self::$global_session_id, time() + (DAY_IN_SECONDS * 7), COOKIEPATH, COOKIE_DOMAIN, is_ssl(), true);

return self::$global_session_id;
	}

/**
	 * Get session data by key using WordPress transients.
	 *
	 * @deprecated
	 * @see \Kirki\App\Supports\Session::get()
	 *
	 * @param string $key The key of the session data to retrieve.
	 * @return mixed|null The session data if found, null otherwise.
	 */
	public static function get_session_data($key)
	{
		// Get the current session ID.
		$session_id = self::get_session_id();

// Retrieve the session data.
		$session_data = get_transient('kirki_session_' . $session_id);

if (isset($session_data[$key])) {
			return $session_data[$key];
		}

return null;
	}

/**
	 * Add or update session data using WordPress transients.
	 *
	 * @deprecated
	 * @see \Kirki\App\Supports\Session::put()
	 *
	 * @param string $key The key of the session data.
	 * @param mixed $value The value of the session data.
	 * @return void
	 */
	public static function set_session_data($key, $value)
	{
		// Get the current session ID.
		$session_id = self::get_session_id();

// Retrieve existing session data.
		$session_data = get_transient('kirki_session_' . $session_id) ?: array();

// Update the session data.
		$session_data[$key] = $value;

// Save the updated session data with a 24-hour expiration time.
		set_transient('kirki_session_' . $session_id, $session_data, DAY_IN_SECONDS);
	}

/**
	 * Delete session data by key using WordPress transients.
	 *
	 * @deprecated
	 * @see \Kirki\App\Supports\Session::forget()
	 *
	 * @param string $key The key of the session data to delete.
	 * @return void
	 */
	public static function delete_session_data($key)
	{
		// Get the current session ID.
		$session_id = self::get_session_id();

// Retrieve existing session data.
		$session_data = get_transient('kirki_session_' . $session_id);

if (isset($session_data[$key])) {
			unset($session_data[$key]);

// Save the updated session data or delete the transient if empty.
			if (!empty($session_data)) {
				set_transient('kirki_session_' . $session_id, $session_data, DAY_IN_SECONDS);
			} else {
				delete_transient('kirki_session_' . $session_id);
			}
		}
	}

/**
	 * Escape a post meta value for safe output.
	 *
	 * The front-end content pipeline (TheFrontend::replace_content) applies a
	 * single html_entity_decode() pass after core has processed shortcodes,
	 * which would undo a plain esc_html(). Re-encoding the ampersands (with
	 * double_encode enabled) yields a single-escaped value in the final output
	 * while still neutralizing markup authored by low-privileged users.
	 *
	 * @param mixed $value The raw post meta value.
	 * @return string Escaped value.
	 */
	public static function escape_post_meta_value($value)
	{
		if (!is_scalar($value)) {
			return '';
		}

return htmlspecialchars(esc_html((string) $value), ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8', true);
	}

/**
	 * Is Pro user checking function.
	 *
	 * @return bool
	 */
	public static function is_pro_user()
	{
		$common_data = WpAdmin::get_common_data(true);

$bool = isset($common_data['license_key']['valid']) && boolval($common_data['license_key']['valid']) === true;

return $bool;
	}

/**
	 * Get all view port lists
	 *
	 * @return string viewports list variable in script markup.
	 */
	public static function get_view_port_lists()
	{
		$s = '';
		$list = UserData::get_view_port_list();
		if ($list) {
			$s .= "<script id='kirki-viewport-lists'>";
			$s .= 'var ' . 'kirkiViewports = ' . wp_json_encode($list) . ';';
			$s .= '</script>';
		}
		return $s;
	}

/**
	 * Get all css variables
	 *
	 * @return string variables in script markup.
	 */
	public static function get_kirki_css_variables_data()
	{
		$s = '';
		$variableData = UserData::get_kirki_variable_data();
		if ($variableData) {
			$s .= "<script id='kirki-variable-lists'>";
			$s .= 'var ' . 'kirkiCSSVariable = ' . wp_json_encode($variableData) . ';';
			$s .= '</script>';
		}
		return $s;
	}

/**
	 * Get smooth scroll script
	 *
	 * @return string script markup.
	 */
	public static function get_smooth_scroll_script()
	{
		$common_data = WpAdmin::get_common_data(true);
		$smooth_scroll_enabled = isset($common_data['smooth_scroll'], $common_data['smooth_scroll']['enabled']) ? $common_data['smooth_scroll']['enabled'] : false;

$smooth_scroll_value = isset($common_data['smooth_scroll'], $common_data['smooth_scroll']['value']) ? $common_data['smooth_scroll']['value'] : 1;

/**
		 * User value 1 to 200
		 * 
		 * Min duration 1s
		 * Max duration 12s
		 * 
		 */
		$duration = ceil(($smooth_scroll_value / 200) * 12);

$s = '';

if ($smooth_scroll_enabled) {
			$s .= "<script id='kirki-smooth-scroll'>";
			$s .= "
						window.document.addEventListener('DOMContentLoaded', function () {
							if (typeof KirkiSmoothScroll !== 'undefined') {
								const params = {
									autoRaf: true,
									anchors: true,
									allowNestedScroll: true,
									duration: $duration,
								};

const kirkiSmoothScroll = new KirkiSmoothScroll(params);

kirkiSmoothScroll.on('scroll');
							}
						});
					";
			$s .= '</script>';
		}

return $s;
	}

/**
	 * Format the date with date format
	 *
	 * @return string
	 */
	public static function format_date($date, $format)
	{
		if ($date && $format) {
			$date_formats_arr = [
				'DD/MM/YYYY' => 'd/m/Y',
				'DD-MM-YYYY' => 'd-m-Y',
				'DD.MM.YYYY' => 'd.m.Y',
				'MM/DD/YYYY' => 'm/d/Y',
				'MM-DD-YYYY' => 'm-d-Y',
				'MM.DD.YYYY' => 'm.d.Y',
				'MMMM DD, YYYY' => 'F j, Y',
				'MMM DD, YYYY' => 'M j, Y',
				'YYYY-MM-DD' => 'Y-m-d',
				'YYYY/MM/DD' => 'Y/m/d',
				'YY.MM.DD' => 'y.m.d',
				'YY/MM/DD' => 'y/m/d',
				'YY-MM-DD' => 'y-m-d',
			];

$timestamp = strtotime($date);
			if ($timestamp === false) {
				return $date; // fallback (avoid fatal)
			}

$datetime = (new \DateTime())->setTimestamp($timestamp);
			return $datetime->format($date_formats_arr[$format] ?? $format);
		}

return $date;
	}

/**
	 * Format the time with time format
	 *
	 * @return string
	 */
	public static function convert_time_format($timeString, $format = 'h:i a')
	{
		$dateTime = null;

try {
			$dateTime = new \DateTime($timeString);
			if ($dateTime && $timeString) {
				return $dateTime->format($format);
			}
		} catch (\Exception $e) {
			// if timeString is an invalid time format
			$parts = explode(' ', $timeString);
			if (count($parts) > 1) {
				// Remove the last part (am/pm)
				$time_value = $parts[0];
				try {
					$dateTime = new \DateTime($time_value);
					if ($dateTime && $timeString) {
						return $dateTime->format($format);
					}
				} catch (\Exception $e2) {
					return $timeString;
				}
			}
			return $timeString;
		}

return $timeString;
	}

/**
	 * Get single post if has a kirki type post
	 *
	 * @return object|bool
	 */
	public static function get_last_edited_kirki_editor_type_page()
	{
		$args = array(
			'post_type' => 'page', // Change to 'post' if you want to search for posts
			'post_status' => ['publish', 'draft'],
			'numberposts' => 1,      // Number of results to retrieve (change as needed)
			'meta_key' => 'kirki_editor_mode',
			'meta_value' => 'kirki',
			'orderby' => 'modified', // Order by post date
			'order' => 'DESC',  // Sort in descending order
		);

$pages = get_posts($args);
		if (count($pages) > 0) {
			return $pages[0];
		}
		return false;
	}

public static function get_kirki_version_from_db()
	{
		$version = wp_cache_get('kirki_version', 'kirki');

if (false === $version) {
			$version = get_option('kirki_version', '');

if (!empty($version)) {
				wp_cache_set('kirki_version', $version, 'kirki');
			}
		}

return $version;
	}

public static function set_kirki_version_in_db()
	{
		$version = self::get_kirki_version_from_db();

if ($version && version_compare($version, KIRKI_VERSION, '==')) {
			// No need to update the version if it's already equal to the current version.
			return;
		}

update_option('kirki_version', KIRKI_VERSION, false);
		wp_cache_set('kirki_version', KIRKI_VERSION, 'kirki');
	}

public static function accepted_file_types_by_plugin($accepted_media_types = KIRKI_SUPPORTED_MEDIA_TYPES)
	{
		$result = array();

foreach ($accepted_media_types as $value) {
			if (is_array($value)) {
				$result = array_merge($result, self::accepted_file_types_by_plugin($value));
			} else {
				$result[] = $value;
			}
		}

return $result;
	}

public static function content_manager_link_filter($dynamic_content = array(), $href = "#")
	{
		$current_post = get_post(self::get_post_id_if_possible_from_url());

if ($current_post->post_type === KIRKI_CONTENT_MANAGER_PREFIX) {
			$fields = ContentManagerHelper::get_post_type_custom_field_keys($current_post->post_parent);

if (isset($fields[$dynamic_content['value']]) && is_array($fields[$dynamic_content['value']])) {
				if ('email' === $fields[$dynamic_content['value']]['type']) {
					$href = "mailto:$href";
				} else if ('phone' === $fields[$dynamic_content['value']]['type']) {
					$href = "tel:$href";
				}
			}
		}

return $href;
	}

public static function check_string_has_this_tags($string, $tag)
	{
		// Check if the string contains either a <p> tag or an <h1> tag
		return preg_match("/<" . $tag . "[^>]*>/i", $string) === 1;
	}

/**
	 * @deprecated
	 * @see Kirki\App\Managers\GlobalDataManager::get_post_id()
	 */
	private static function get_global_data_post_id()
	{
		$post_id = get_option('KIRKI_GLOBAL_DATA_POST_TYPE_ID', get_option('DROIP_GLOBAL_DATA_POST_TYPE_ID', false));
		if ($post_id) {
			return $post_id;
		} else {
			//this block will run only once
			$posts = get_posts(array(
				'post_type' => KIRKI_GLOBAL_DATA_POST_TYPE_NAME,
				'numberposts' => 1,
			));
			if ($posts) {
				$post_id = $posts[0]->ID;
			} else {
				//create new post
				$post = array(
					'post_title' => KIRKI_GLOBAL_DATA_POST_TYPE_NAME,
					'post_type' => KIRKI_GLOBAL_DATA_POST_TYPE_NAME,
					'post_status' => 'draft'
				);
				$post_id = wp_insert_post($post);
			}
			update_option('KIRKI_GLOBAL_DATA_POST_TYPE_ID', $post_id, true);
		}

return $post_id;
	}

/**
	 * Get global data using key
	 * 
	 * @deprecated
	 * @see Kirki\App\Managers\GlobalDataManager::get()
	 */
	public static function get_global_data_using_key($key)
	{
		//first get post using KIRKI_GLOBAL_DATA_POST_TYPE_NAME post_type name. if not found then create new one.
		$post_id = self::get_global_data_post_id();
		if (metadata_exists('post', $post_id, $key)) {
			return get_post_meta($post_id, $key, true);
		}

// this block will run only once for a legacy option key.
		$value = get_option($key, null);
		if (null !== $value) {
			update_post_meta($post_id, $key, $value);
			delete_option($key);
		}

return $value;
	}

/**
	 * Get global data using key
	 * 
	 * @deprecated
	 * @see Kirki\App\Managers\GlobalDataManager::update()
	 */
	public static function update_global_data_using_key($key, $value)
	{
		$post_id = self::get_global_data_post_id();
		update_post_meta($post_id, $key, $value);

}

public static function get_template_data_if_current_page_is_kirki_template()
	{
		$custom_data = get_query_var('kirki_custom_data');
		$data = false;
		$builder_div = '';
		if ($custom_data && isset($custom_data['kirki_template_content'])) {
			$action = HelperFunctions::sanitize_text(isset($_GET['action']) ? $_GET['action'] : null);
			$load_for = HelperFunctions::sanitize_text(isset($_GET['load_for']) ? $_GET['load_for'] : '');

if ($action === KIRKI_EDITOR_ACTION && $load_for === 'kirki-iframe' && !str_contains($custom_data['kirki_template_content'], 'kirki-builder')) {
				$template_edit_url = HelperFunctions::get_post_url_arr_from_post_id($custom_data['kirki_template_id'], ['editor_url' => true])['editor_url'];
				$builder_div = '<div id="' . 'kirki-builder' . '" template-error="' . $template_edit_url . '"></div>';
			}

$data = array(
				'content' => $custom_data['kirki_template_content'] . $builder_div,
				'template_id' => $custom_data['kirki_template_id']
			);
		}
		return $data;
	}

public static function get_custom_data_if_current_page_is_kirki_custom_post()
	{
		$custom_data = get_query_var('kirki_custom_data');
		$data = false;
		$builder_div = '';
		if ($custom_data && isset($custom_data['kirki_custom_post_content'])) {
			$action = HelperFunctions::sanitize_text(isset($_GET['action']) ? $_GET['action'] : null);
			$load_for = HelperFunctions::sanitize_text(isset($_GET['load_for']) ? $_GET['load_for'] : '');

if ($action === KIRKI_EDITOR_ACTION && $load_for === 'kirki-iframe' && !str_contains($custom_data['kirki_custom_post_content'], 'kirki-builder')) {
				$template_edit_url = HelperFunctions::get_post_url_arr_from_post_id($custom_data['kirki_custom_post_id'], ['editor_url' => true])['editor_url'];
				$builder_div = '<div id="' . 'kirki-builder' . '" template-error="' . $template_edit_url . '"></div>';
			}

$data = array(
				'content' => $custom_data['kirki_custom_post_content'] . $builder_div,
				'post_id' => $custom_data['kirki_custom_post_id']
			);
		}
		return $data;
	}

/**
	 * Validate slug for a post.
	 * 
	 * @param int|null $post_id
	 * @param string $post_type
	 * @param string $post_name
	 * @return bool
	 * 
	 * @deprecated Use Kirki\App\Supports\ContentManager::validate_slug() instead.
	 * @see Kirki\App\Supports\ContentManager
	 */
	public static function validate_slug($post_id, $post_type, $post_name)
	{
		global $wpdb;
		// Execute the query
		$result = $wpdb->get_var($wpdb->prepare("SELECT ID FROM $wpdb->posts WHERE post_name = %s AND post_type = %s AND ID != %d", $post_name, $post_type, $post_id ? $post_id : 0));

// If a post with the same slug exists, return false
		if ($result) {
			return false;
		}

// If no post with the same slug exists, return true
		return true;
	}

/**
	 * Summary of find_utility_page_for_this_context
	 * @param mixed $type
	 * @param mixed $get_by id | type.
	 * @return mixed
	 */
	public static function find_utility_page_for_this_context($value = '404', $get_by = 'type')
	{
		$utility_pages = Page::fetch_list('kirki_utility', true, array('publish'));
		if (count($utility_pages) > 0) {
			foreach ($utility_pages as $key => $page) {
				if ($get_by === 'type') {
					if ($page['utility_page_type'] === $value) {
						return $page;
					}
				} else if ($get_by === 'id') {
					if ($page['id'] === (int) $value) {
						return $page;
					}
				}
			}
		}
		return false;
	}
	public static function get_current_page_context()
	{
		$context = array(); // {id, type}

$obj = get_queried_object();

if (is_404()) {
			$context['type'] = '404';
		} else if ($obj instanceof WP_Post) {
			$context['id'] = $obj->ID;
			$context['type'] = 'post';
		} else if ($obj instanceof WP_User) {
			$context['id'] = $obj->ID;
			$context['type'] = 'user';
		} elseif ($obj instanceof WP_Term) {
			$context['id'] = $obj->term_id;
			$context['type'] = 'term';
		}
		// elseif ($obj instanceof WP_Post_Type) {
		// 		echo 'This is a WP_Post_Type object';
		// } elseif (is_null($obj)) {
		// 		echo 'No queried object (null)';
		// }
		else {
			$kirki_utility_page_type = get_query_var('kirki_utility_page_type');
			$kirki_utility_page_id = get_query_var('kirki_utility_page_id');
			if (!empty($kirki_utility_page_type)) {
				if (!self::check_utility_page_visibility_condition($kirki_utility_page_type)) {
					$context['type'] = '404';
				} else {
					$context['type'] = 'kirki_utility';
					$context['kirki_utility_page_type'] = $kirki_utility_page_type;
					$context['kirki_utility_page_id'] = $kirki_utility_page_id;
				}
			}
		}
		return $context;
	}

/**
	 * Get utility page slug using type.
	 * { type: 'login', title: 'Login' },
	 * { type: 'sign_up', title: 'Registration' },
	 * { type: 'forgot_password', title: 'Forgot Password' },
	 * { type: 'reset_password', title: 'Reset Password' },
	 * { type: 'retrive_username', title: 'Retrive Username' },
	 * { type: '404', title: '404' },
	 * 
	 * @param string $type //utility page type.
	 * @return string||bool //string or false.
	 */
	public static function get_utility_page_url($type)
	{
		$utility_pages = Page::fetch_list('kirki_utility', true, array('publish'));
		foreach ($utility_pages as $key => $page) {
			$utility_page_type = $page['utility_page_type'];

$slug = $page['slug'];
			if ($utility_page_type === $type) {
				return home_url('/' . $slug);
			}
		}
		return false;
	}
	public static function check_utility_page_visibility_condition($type)
	{
		if ($type === 'login' || $type === 'sign_up' || $type === 'forgot_password' || $type === 'reset_password' || $type === 'retrive_username') {
			// Check if the user is already logged in
			if (is_user_logged_in()) {
				return false; // User is logged in, so the page should not be visible
			}
			// Add other conditions based on the type if needed
			if ($type === 'signup') {
				// Example: Check if registrations are enabled in WordPress
				if (!get_option('users_can_register')) {
					return false; // Registration is disabled
				}
			}
			// If the user is not logged in and other conditions pass, allow the page to be visible
			return true;
		}
		// If the type is not 'login' or 'signup', return false by default
		return true;
	}

/**
	 * @deprecated
	 * @see \Kirki\Framework\Supports\Facades\File::delete()
	 */
	public static function delete_directory($dirname)
	{
		global $wp_filesystem;
		if (empty($wp_filesystem)) {
			require_once ABSPATH . 'wp-admin/includes/file.php';
			WP_Filesystem();
		}

if ($wp_filesystem->exists($dirname)) {
			return $wp_filesystem->delete($dirname, true);
		}

return false;
	}

/**
	 * @deprecated
	 * @see \Kirki\App\Supports\FileHandler::get_temp_folder_path()
	 */
	public static function get_temp_folder_path()
	{
		$upload_dir = wp_upload_dir();
		$temp_folder = 'kirki_temp';
		$temp_folder_path = $upload_dir['basedir'] . '/' . $temp_folder;

return $temp_folder_path;
	}

/**
	 * @deprecated
	 * @see \Kirki\App\Managers\GlobalDataManager::get_initial_viewports()
	 */
	public static function get_initial_view_ports()
	{
		return json_decode('{
   "active":"md",
   "scale":1,
   "zoom":1,
   "width":1200,
   "mdWidth":"",
   "defaults":[
      "md",
      "tablet",
      "mobileLandscape",
      "mobile"
   ],
   "list":{
      "md":{
         "value":1200,
         "scale":1,
         "minWidth":1200,
         "maxWidth":1200,
         "title":"Desktop",
         "icon":"desktop",
         "activeIcon":"desktop-hover"
      },
      "tablet":{
         "value":991,
         "scale":1,
         "minWidth":991,
         "maxWidth":991,
         "title":"Tablet",
         "icon":"tablet-default",
         "activeIcon":"tablet-hover"
      },
      "mobileLandscape":{
         "value":767,
         "scale":1,
         "minWidth":767,
         "maxWidth":767,
         "title":"Landscape",
         "icon":"phone-hr-default",
         "activeIcon":"phone-hr-hover"
      },
      "mobile":{
         "value":575,
         "scale":1,
         "minWidth":575,
         "maxWidth":575,
         "title":"Mobile",
         "icon":"phone-vr-default",
         "activeIcon":"phone-vr-hover"
      }
   }
}', true);
	}

/**
	 * @deprecated 
	 * @see \Kirki\App\Supports\FileHandler::download_zip_from_remote()
	 */
	public static function download_zip_from_remote($remote_file, $new_name)
	{
		return FileHandler::download_zip_from_remote($remote_file, $new_name);
		// $file_ext = explode('.', $remote_file); // ['file', 'ext']
		// $file_ext = strtolower(end($file_ext)); // 'ext'
		// $allowed = ['zip'];
		// if (!in_array($file_ext, $allowed)) {
		// 	return false;
		// }

// try {
		// 	// error_reporting(E_ALL);
		// 	// ini_set('display_errors', 1);
		// 	// Download the file from the remote server.
		// 	// Create a stream context to disable SSL verification
		// 	$options = [
		// 		"http" => [
		// 			"method" => "GET",
		// 			"header" => "User-Agent: WordPress\r\n"
		// 		],
		// 		"ssl" => [
		// 			"verify_peer" => false,      // Disable verification of the peer's certificate
		// 			"verify_peer_name" => false // Disable verification of the peer's name
		// 		]
		// 	];
		// 	$context = stream_context_create($options);
		// 	$file_contents = file_get_contents($remote_file, false, $context);

// 	// Save the file locally.
		// 	if ($file_contents !== false) {
		// 		// Local path to save the downloaded file.
		// 		$local_file = wp_upload_dir()['basedir'] . '/' . $new_name;
		// 		file_put_contents($local_file, $file_contents);
		// 		return $local_file;
		// 	}
		// } catch (\Throwable $th) {
		// 	// throw $th;
		// }
		// return false;
	}

public static function filterZipFile($zip, $zip_file_path)
	{
		// Temporary filtered ZIP path
		$filtered_zip_path = sys_get_temp_dir() . '/filtered.zip';
		$filtered_zip = new \ZipArchive;

if ($filtered_zip->open($filtered_zip_path, \ZipArchive::CREATE | \ZipArchive::OVERWRITE) === TRUE) {
			// Loop through all files in the archive
			for ($i = 0; $i < $zip->numFiles; $i++) {
				$filename = $zip->getNameIndex($i);
				$file_path = 'zip://' . $zip_file_path . '#' . $filename;

// Get MIME type based on file extensioncm_f
				$file_mime = self::getMimeTypeByExtension($filename);

// Additional JSON validation
				if ($file_mime === 'application/json' && !self::isJsonFile($file_path)) {
					$file_mime = 'text/plain'; // Fallback if not valid JSON
				}

// Check if the file MIME type matches supported types
				$is_supported = false;
				foreach (KIRKI_SUPPORTED_MEDIA_TYPES as $types) {
					if (in_array($file_mime, $types)) {
						$is_supported = true;
						break;
					}
				}

// Add the file to the filtered archive if supported
				if ($is_supported) {
					$file_contents = $zip->getFromIndex($i);
					$filtered_zip->addFromString($filename, $file_contents);
				}
			}

$filtered_zip->close();
			return $filtered_zip_path;
		} else {
			return false;
		}
	}

// Helper function to get MIME type by file extension
	private static function getMimeTypeByExtension($filename)
	{
		$extension_to_mime = [
			'json' => 'application/json',
			'jpg' => 'image/jpeg',
			'jpeg' => 'image/jpeg',
			'png' => 'image/png',
			'gif' => 'image/gif',
			'webp' => 'image/webp',
			'svg' => 'image/svg+xml',
			'pdf' => 'application/pdf',
			'mp4' => 'video/mp4',
			'ogg' => 'audio/ogg',
			'lottie' => 'text/plain',
			'mov' => 'video/quicktime',
			'mp3' => 'audio/mpeg',
			'wav' => 'audio/wav',

// Add more extensions as needed
		];

$ext = pathinfo($filename, PATHINFO_EXTENSION);
		return $extension_to_mime[strtolower($ext)] ?? 'application/octet-stream';
	}

// Helper function to validate JSON file content
	private static function isJsonFile($file_path)
	{
		$file_contents = @file_get_contents($file_path);
		$trimmed = trim($file_contents);
		return $trimmed[0] === '{' || $trimmed[0] === '[';
	}

public static function is_remote_url($url)
	{
		// Parse the URL to get components
		$parsed_url = wp_parse_url($url);
		return isset($parsed_url['scheme']);
	}

public static function is_element_accessible($access)
	{
		switch ($access) {
			case 'all':
				return true; // Accessible to everyone

case 'guest':
				return !is_user_logged_in();

case 'logged-in':
				return is_user_logged_in(); // Accessible to any logged-in user

case 'admin':
				// Administrators and Super Admins
				return current_user_can('manage_options');

case 'editor':
				// Editors, Admins, and Super Admins can see this
				return current_user_can('edit_pages');

case 'author':
				// Authors, Editors, Admins, etc.
				return current_user_can('publish_posts');

case 'subscriber':
				// Subscribers and EVERY logged-in user above them
				return current_user_can('read');

default:
				return false; // Safely hide if the access rule is unrecognized
		}
	}

/**
	 * Find symbol for post id using condition
	 * it will find and return selected symbols html and css;
	 *
	 * @param string $type : symbol type.
	 * @param string $post : post object.
	 * @return symbol || bool(false)
	 */
	public static function find_symbol_for_this_page($type)
	{
		$all_symbols = Symbol::fetch_list(true, false);
		foreach ($all_symbols as $key => $symbol) {
			if (isset($symbol['setAs']) && $symbol['setAs'] === $type) {
				return $symbol;
			}
		}
		return false;
	}
	/**
	 * Get Custom Header
	 * it will find and return selected symbols html and css;
	 *
	 * @param string $type stymbol type header|footer.
	 * @param string $html if true the function will return html otherwise return symbol object.
	 * @return string|object custom section html or stymbol object.
	 */
	public static function get_page_custom_section($type, $html = true)
	{
		$show = apply_filters('kirki_show_custom_section_' . $type, true);
		if (!$show) {
			return '';
		}

$symbol = self::find_symbol_for_this_page($type);
		if (!$html) {
			return $symbol;
		}

if (isset(self::$custom_sections[$type])) {
			return self::$custom_sections[$type];
		}

$s = self::isShowWPThemeHeaderFooter() ? '' : ' '; // this is for disableing theme header footer forcefully if is_show_wp_theme_header_footer is false

if ($symbol) {
			$action = HelperFunctions::sanitize_text(isset($_GET['action']) ? $_GET['action'] : '');
			$symbol_data = $symbol['symbolData'];
			$set_as = isset($symbol['setAs']) ? $symbol['setAs'] : '';

$post_id = self::get_post_id_if_possible_from_url();
			$template_data = self::get_template_data_if_current_page_is_kirki_template();
			if ($template_data)
				$post_id = $template_data['template_id'];

$custom_page_data = self::get_custom_data_if_current_page_is_kirki_custom_post();
			if ($custom_page_data)
				$post_id = $custom_page_data['post_id'];

$is_page_symbol_disabled = get_post_meta($post_id, KIRKI_META_NAME_FOR_PAGE_HF_SYMBOL_DISABLE_STATUS, true);
			if (isset($is_page_symbol_disabled) && is_array($is_page_symbol_disabled) && isset($is_page_symbol_disabled[$type])) {
				$is_page_symbol_disabled = $is_page_symbol_disabled[$type];
			} else {
				$is_page_symbol_disabled = false;
			}

$params = array(
				'blocks' => $symbol_data['data'],
				'style_blocks' => $symbol_data['styleBlocks'],
				'root' => $symbol_data['root'],
				'post_id' => $symbol['id'],
				'options' => [],
				'get_style' => true,
				'get_variable' => false,
				'should_take_app_script' => false,
				'prefix' => 'kirki-s' . $symbol['id']
			);
			if ($action === KIRKI_EDITOR_ACTION) {
				$extra_attr_for_hf_symbol = '';
				if ($is_page_symbol_disabled)
					$extra_attr_for_hf_symbol = ' style="display:none;"';
				$s = '<' . $type . $extra_attr_for_hf_symbol . ' data-kirki-symbol_set_as="' . $set_as . '" data-kirki-symbol="' . $symbol['id'] . '" data-kirki="' . $type . '">' . self::get_html_using_preview_script($params) . '</' . $type . '>'; //added data-kirki="$type" => We removed theme header and footer using preg_replace in TheFrontendHooks.php file
			} else if (!$is_page_symbol_disabled) {
				$params['should_take_app_script'] = true;
				$params['get_variable'] = true;
				$s = self::get_html_using_preview_script($params);
			} else if ($is_page_symbol_disabled) {
				$s = '';
			}
		}

$s = do_shortcode($s);

self::$custom_sections[$type] = $s;

return $s;
	}

public static function isShowWPThemeHeaderFooter()
	{
		$common_data = WpAdmin::get_common_data(true);
		return $common_data['is_show_wp_theme_header_footer'];
	}

/**
	 * Check if a value is considered true or false.
	 *
	 * @param mixed $value The value to check.
	 * @return bool Returns true if the value is considered "truthy", otherwise false.
	 * 
	 * @deprecated
	 * @see function \Kirki\App\is_truthy()
	 */
	public static function isTruthy($value): bool
	{
		return filter_var($value, FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE) ?? false;
	}

/**
	 * Get the upload directory path has upload or write permission.
	 * 
	 * @deprecated 
	 * @see Kirki\Framework\Supports\Facades\File::is_writable()
	 * @see function Kirki\App\get_upload_directory()
	 */
	public static function get_upload_dir_has_write_permission()
	{
		if (!function_exists('request_filesystem_credentials')) {
			require_once ABSPATH . 'wp-admin/includes/file.php';
		}

if (WP_Filesystem()) {
			global $wp_filesystem;
			$upload_dir = wp_upload_dir();
			return $wp_filesystem->is_writable($upload_dir['basedir']);
		}

return false;
	}

/**
	 * $name = [] or string
	 * @deprecated 
	 * @see Kirki\App\Supports\Template::add_prefix_to_class_name()
	 */
	public static function add_prefix_to_class_name($prefix, $name)
	{
		if (is_array($name)) {
			foreach ($name as $key => $c) {
				$c = strtolower($c);
				if (in_array($c, KIRKI_PRESERVED_CLASS_LIST)) {
					$name[$key] = $c;
				} else {
					$name[$key] = $prefix ? strtolower($prefix) . '-' . $c : $c;
				}
			}
		} else {
			$name = strtolower($name);
			if (!in_array($name, KIRKI_PRESERVED_CLASS_LIST)) {
				$name = $prefix ? strtolower($prefix) . '-' . $name : $name;
			}
		}
		return $name;
	}

public static function checkVisibilityConditions($element, $options)
	{
		$conditions = $element['properties']['visibilityConditions'] ?? [];
		if (!count($conditions))
			return true;
		foreach ($conditions as $and_group) {
			$and_result = true;
			foreach ($and_group as $condition) {
				$source = (string) ($condition['source'] ?? 'kirki');
				$condition_result = apply_filters('kirki_visibility_condition_check_' . $source, false, $condition, $options);
				if (!$condition_result) {
					$and_result = false;
					break; // If any condition fails in AND group
				}
			}
			if ($and_result) {
				return true; // If any OR group passes
			}
		}
		return false; // No group passed
	}

private static function update_slider_style_blocks($blocks, $styles)
	{

$slider_mask_styleIds = [];
		$slider_item_styleIds = [];

// slider_item
		foreach ($blocks as $id => $block) {
			// Check if the block has a 'name' key
			if (isset($block['name'])) {
				if (isset($block['name']) && $block['name'] === 'slider_mask') {
					// Loop through each item in $block['styleIds']
					foreach ($block['styleIds'] as $styleId) {
						// Check if the styleId is NOT already in the $slider_mask_styleIds array
						if (!in_array($styleId, $slider_mask_styleIds)) {
							// If not present, push it into the array
							$slider_mask_styleIds[] = $styleId;
						}
					}
				}

if (isset($block['name']) && $block['name'] === 'slider_item') {
					// Loop through each item in $block['styleIds']
					foreach ($block['styleIds'] as $styleId) {
						// Check if the styleId is NOT already in the $slider_item_styleIds array
						if (!in_array($styleId, $slider_item_styleIds)) {
							// If not present, push it into the array
							$slider_item_styleIds[] = $styleId;
						}
					}
				}
			}
		}

if (count($slider_mask_styleIds) > 0) {
			foreach ($slider_mask_styleIds as $styleId) {
				if ($styles[$styleId]) {
					$style = $styles[$styleId];
					$style_variants = $style['variant'];

$styleVariants = [];

if ($style_variants && count($style_variants) > 0) {
						foreach ($style_variants as $key => $css) {
							$css = preg_replace('/overflow\s*:\s*hidden;?/', '', $css);
							$css = preg_replace('/pointer-events\s*:\s*none;?/', '', $css);

$css = trim($css);
							$styleVariants[$key] = $css;
						}
					}
					$styles[$styleId]['variant'] = $styleVariants;
				}
			}
		}

if (count($slider_item_styleIds) > 0) {
			foreach ($slider_item_styleIds as $styleId) {
				$style = $styles[$styleId];
				$style_variants = $style['variant'];

$styleVariants = [];

if ($style_variants && count($style_variants) > 0) {
					foreach ($style_variants as $key => $css) {
						$css = preg_replace('/position\s*:\s*absolute;?/', '', $css);
						$css = preg_replace('/display\s*:\s*none;?/', '', $css);

$css = trim($css);
						$styleVariants[$key] = $css;
					}

$styles[$styleId]['variant'] = $styleVariants;
				}
			}
		}

return $styles;
	}

public static function handle_legacy_slider_class()
	{
		$data = Page::get_all_data_by_kirki_meta_key();

foreach ($data as $key => $value) {
			$post_id = $value['post_id'];       // ID of the post
			$meta_key = $value['meta_key'];     // Meta key name
			$meta_value = $value['meta_value']; // Serialized meta value

$meta_value = unserialize($meta_value, ['allowed_classes' => false]); // Convert serialized data to array

// If the meta value has a 'blocks' key, handle it as a full page data
			if (isset($meta_value['blocks'])) {
				$blocks = $meta_value['blocks']; // Get the blocks array
				$styles = self::get_page_styleblocks($post_id);
				$updated_styles = self::update_slider_style_blocks($blocks, $styles); // Update block names

self::update_page_styleblocks($post_id, $updated_styles);
			} else {
				// If no 'blocks' key, treat entire value as blocks array
				$blocks = $meta_value;
				$post = get_post($post_id);

if (isset($post->post_type) && $post->post_type === 'kirki_symbol') {
					$styles = $blocks['styleBlocks'];
					$updated_styles = self::update_slider_style_blocks($blocks['data'], $styles);
					$blocks['styleBlocks'] = $updated_styles;

update_post_meta($post_id, $meta_key, $blocks);
				}
			}
		}
	}

public static function handle_legacy_slider_default_class()
	{
		$styles = self::get_global_data_using_key(KIRKI_GLOBAL_STYLE_BLOCK_META_KEY);
		if (!$styles) {
			$styles = array();
		}
		if (count($styles) > 0) {
			if (isset($styles['kirki_slider_slide'])) {
				// Handle kirki_slider_mask
				if (isset($styles['kirki_slider_mask'])) {
					$variants = $styles['kirki_slider_mask']['variant'];
					if (count($variants) > 0) {
						$styleVariants = [];
						foreach ($variants as $key => $css) {
							$css = preg_replace('/overflow\s*:\s*hidden;?/', '', $css);
							$css = preg_replace('/pointer-events\s*:\s*none;?/', '', $css);
							$css = trim($css);
							$styleVariants[$key] = $css;
						}
						$styles['kirki_slider_mask']['variant'] = $styleVariants;
					}
				}

// Handle kirki_slider_slide
				if (isset($styles['kirki_slider_slide'])) {
					$variants = $styles['kirki_slider_slide']['variant'];
					if (count($variants) > 0) {
						$styleVariants = [];
						foreach ($variants as $key => $css) {
							$css = preg_replace('/position\s*:\s*absolute;?/', '', $css);
							$css = preg_replace('/display\s*:\s*none;?/', '', $css);
							$css = trim($css);
							$styleVariants[$key] = $css;
						}
						$styles['kirki_slider_slide']['variant'] = $styleVariants;
					}
				}
			}
		}

}

public static function get_current_item_index($index, $options)
	{
		$pagination = isset($options['pagination']) ? $options['pagination'] : false;
		$items_per_page = isset($options['items_per_page']) ? $options['items_per_page'] : 3;
		$page_no = isset($options['page_no']) ? $options['page_no'] : 1;

if ($pagination && $items_per_page > 0 && $page_no > 0) {
			// Calculate the start index based on the current page and items per page
			$index = (($page_no - 1) * $items_per_page) + $index;
		}

return $index;
	}

public static function convertToBytes($val)
	{
		$val = trim($val);
		$last = strtolower($val[strlen($val) - 1]);
		$val = (int) $val;
		switch ($last) {
			case 'g':
				$val *= 1024;
			case 'm':
				$val *= 1024;
			case 'k':
				$val *= 1024;
		}
		return $val;
	}

/**
	 * @deprecated
	 * @see Kirki\App\Supports\Canvas::get_full_canvas_template_path()
	 */
	public static function get_kirki_full_canvas_template_path()
	{
		return self::normalize_kirki_full_canvas_template_path(KIRKI_FULL_CANVAS_TEMPLATE_PATH);
	}

/**
	 * @deprecated
	 * @see Kirki\App\Supports\Canvas::normalize_full_canvas_template_path()
	 */
	public static function normalize_kirki_full_canvas_template_path($path)
	{
		// replace if has kirki-pro => kirki
		if (strpos($path, 'kirki-pro') !== false) {
			$path = str_replace('kirki-pro', 'kirki', $path);
		}
		return $path;
	}
	public static function normalize_variable_mode($mode)
	{
		if (!$mode) {
			return ['color' => 'inherit', 'size' => 'inherit', 'text-style' => 'inherit', 'font-family' => 'inherit'];
		}
		// if v is string
		if (is_string($mode)) {
			return ['color' => $mode, 'size' => $mode, 'text-style' => $mode, 'font-family' => $mode];
		}
		if (is_array($mode)) {
			return $mode;
		}
		return $mode;
	}

/**
	 * Whether the target url is a safe, externally reachable http(s) URL.
	 *
	 * Rejects loopback, private, link-local and cloud-metadata addresses so a
	 * planted form config cannot be used to probe the server's own network.
	 *
	 * @param string $url The URL.
	 * @return bool
	 */
	/**
	 * Whether a host points at the machine the site itself runs on.
	 *
	 * @param string $host
	 * @return bool
	 */
	public static function is_localhost($host) {
		if (!is_string($host) || '' === $host) {
			return false;
		}

$host = strtolower($host);

if (in_array($host, array('localhost', '127.0.0.1', '::1', '[::1]'), true)) {
			return true;
		}

// The site's own host, e.g. a Herd/Valet `.test` domain pointing at 127.0.0.1.
		$site_host = wp_parse_url(home_url(), PHP_URL_HOST);

if (is_string($site_host) && '' !== $site_host && $host === strtolower($site_host)) {
			return true;
		}

return false;
	}

public static function is_safe_url($url) {
		if (!is_string($url) || filter_var($url, FILTER_VALIDATE_URL) === false) {
			return false;
		}

$scheme = wp_parse_url($url, PHP_URL_SCHEME);
		$host = wp_parse_url($url, PHP_URL_HOST);

if (!is_string($scheme) || !in_array(strtolower($scheme), array('http', 'https'), true)) {
			return false;
		}

if (!is_string($host) || '' === $host) {
			return false;
		}

if (self::is_localhost($host)) {
			return true;
		}

if (filter_var($host, FILTER_VALIDATE_IP)) {
			return (bool) filter_var($host, FILTER_VALIDATE_IP, FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE);
		}

$ip = gethostbyname($host);

if (!filter_var($ip, FILTER_VALIDATE_IP) || $ip === $host) {
			return false;
		}

return (bool) filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE);
	}
}