JezK

Edit File: UserData.php

<?php
/**
 * Manager User data
 *
 * @package kirki
 */

namespace Kirki\Ajax;

use Exception;
use Kirki\HelperFunctions;

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

/**
 * UserData API Class
 * @deprecated
 */
class UserData {

/**
	 * Save user controller data
	 *
	 * @return void wp_send_json
	 * 
	 * @deprecated
	 * @see \Kirki\App\Managers\GlobalDataManager::update_global_ui_controller()
	 */
	public static function save_user_controller() {
		$user_id = get_current_user_id();
        //phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
		$data = isset( $_POST['data'] ) ? $_POST['data'] : null;
		$data = json_decode( stripslashes( $data ), true );
		if ( ! empty( $user_id ) ) {
			HelperFunctions::update_global_data_using_key( KIRKI_USER_CONTROLLER_META_KEY, $data );
			wp_send_json( array( 'status' => 'User controller data saved' ) );
		}
		die();
	}

/**
	 * Save user saved data
	 *
	 * @return void wp_send_json
	 * 
	 * @deprecated
	 * @see \Kirki\App\Managers\GlobalDataManager::update_global_ui_saved_data()
	 */
	public static function save_user_saved_data() {
		$user_id = get_current_user_id();
		//phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
		$data = isset( $_POST['data'] ) ? $_POST['data'] : null;
		$data = json_decode( stripslashes( $data ), true );
		if ( ! empty( $user_id ) ) {
			HelperFunctions::update_global_data_using_key( KIRKI_USER_SAVED_DATA_META_KEY, $data );
			wp_send_json( array( 'status' => 'User saved data saved' ) );
		}
		die();
	}

/**
	 * Save user custom fonts data
	 *
	 * @return void wp_send_json
	 * 
	 * @deprecated
	 * @see \Kirki\App\Managers\GlobalDataManager::update_global_custom_fonts()
	 */
	public static function save_user_custom_fonts_data() {
		$user_id = get_current_user_id();
		//phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
		$data = isset( $_POST['data'] ) ? $_POST['data'] : null;
		$data = json_decode( stripslashes( $data ), true );
		if ( ! empty( $user_id ) ) {
			HelperFunctions::update_global_data_using_key( KIRKI_USER_CUSTOM_FONTS_META_KEY, $data );
			wp_send_json( array( 'status' => 'User custom fonts data saved' ) );
		}
		die();
	}

/**
	 * Save the updated font data in global data
	 *
	 * @param object $font Font data.
	 * 
	 * @deprecated
	 * @see \Kirki\App\Services\FontService::save_google_font_into_global_custom_fonts()
	 */
	public static function save_the_font_global_data( $font ) {
		// first get the font data
		$custom_fonts = HelperFunctions::get_global_data_using_key( KIRKI_USER_CUSTOM_FONTS_META_KEY );

if ( empty( $custom_fonts ) ) {
			$custom_fonts = array();
		}

if ( isset( $font['family'] ) ) {
			// update the font data
			$custom_fonts[ $font['family'] ] = $font;

// save the font data
			HelperFunctions::update_global_data_using_key( KIRKI_USER_CUSTOM_FONTS_META_KEY, $custom_fonts );
		}
	}

/**
	 * Download google font in local
	 *
	 * Requirements => must be a google font
	 *
	 * @param object $font Font data.
	 *
	 * @return object
	 * @deprecated 
	 * @see \Kirki\App\Services\FontService::download_google_font()
	 */
	public static function make_google_font_offline() {
		 $font = isset( $_POST['font'] ) ? $_POST['font'] : null;
		$font  = json_decode( stripslashes( $font ), true );

$data = self::download_font_offline( $font );

if ( $data['status'] ) {
			// save the font data in global data
			self::save_the_font_global_data( $data['font'] );
		}

// return the response
		wp_send_json( $data );
	}

/**
	 * Download fonts
	 * @deprecated 
	 * @see \Kirki\App\Services\FontService::download_google_font()
	 */
	private static function download_font_offline( &$font ) {
		if ( empty( $font['family'] ) || empty( $font['fontUrl'] ) || strpos( $font['fontUrl'], 'fonts.googleapis.com' ) === false ) {
			return array(
				'font'    => $font,
				'status'  => false,
				'message' => "It's not a valid Google Font",
			);
		}

$font_family_slug = sanitize_title_with_dashes( $font['family'] );
		// Extra security: keep only a-z, 0-9, and hyphens
		$font_family_slug = preg_replace( '/[^a-z0-9\-]/i', '', $font_family_slug );

// Prevent empty value
		if ( empty( $font_family_slug ) ) {
			return array(
				'font'    => $font,
				'status'  => false,
				'message' => 'Not valid font family',
			);
		}
		// Prevent path traversal (..), though whitelist already blocks it
		if ( strpos( $font_family_slug, '..' ) !== false ) {
			return array(
				'font'    => $font,
				'status'  => false,
				'message' => 'Not valid font family',
			);
		}

$font_dir = WP_CONTENT_DIR . "/uploads/kirki-fonts/{$font_family_slug}";

$has_write_permission = HelperFunctions::get_upload_dir_has_write_permission();

// Check if the directory has upload or write permission
		if ( ! $has_write_permission ) {
			return array(
				'font'    => $font,
				'status'  => false,
				'message' => 'Font directory is not writable',
			);
		}

try {
			if ( ! is_dir( $font_dir ) ) {
				wp_mkdir_p( $font_dir );
			}

$css_file_path = $font_dir . "/{$font_family_slug}.css";

// Already downloaded
			if ( file_exists( $css_file_path ) ) {
				return array(
					'font'    => $font,
					'status'  => false,
					'message' => 'Font already downloaded',
				);
			}

$css = HelperFunctions::http_get( $font['fontUrl'] );

if ( ! $css ) {
				throw new Exception( 'Failed to fetch Google Fonts CSS' );
			}

if ( empty( $font['files'] ) || ! is_array( $font['files'] ) ) {
				throw new Exception( 'No font files provided.' );
			}
			// update font-weight to 400 from regular
			if ( isset( $font['files']['regular'] ) ) {
				$font['files']['400'] = $font['files']['regular'];
				unset( $font['files']['regular'] );
			}

$local_css = '';
			$formats   = array(
				'woff2' => 'woff2',
				'woff'  => 'woff',
				'ttf'   => 'truetype',
				'otf'   => 'opentype',
			);

foreach ( $font['files'] as $weight => $url ) {
				$allowed_ext = array( 'woff2', 'woff', 'ttf', 'otf' );
				$extension   = strtolower( pathinfo( $url, PATHINFO_EXTENSION ) );
				if ( ! in_array( $extension, $allowed_ext, true ) ) {
					throw new Exception( "Invalid or unsafe file extension: {$extension}" );
				}

$file_name = "{$weight}.{$extension}";
				$file_path = $font_dir . '/' . $file_name;

$font_data = HelperFunctions::http_get( $url );
				if ( ! $font_data ) {
					throw new Exception( 'Failed to fetch font file' );
				}
				file_put_contents( $file_path, $font_data );

$format     = $formats[ $extension ] ?? 'truetype';
				$local_css .= "@font-face {
						font-family: '{$font['family']}';
						font-style: normal;
						font-weight: {$weight};
						font-display: swap;
						src: url('{$file_name}') format('{$format}');
				}\n";
			}

if ( empty( $local_css ) ) {
				throw new Exception( 'No usable font files were downloaded.' );
			}

file_put_contents( $css_file_path, $local_css );
			$font['localUrl'] = content_url( "/uploads/kirki-fonts/{$font_family_slug}/{$font_family_slug}.css" );

return array(
				'font'    => $font,
				'status'  => true,
				'message' => 'Font downloaded successfully',
			);
		} catch ( Exception $e ) {
			// Clean up on failure
			if ( is_dir( $font_dir ) ) {
				HelperFunctions::delete_directory( $font_dir );
			}

return array(
				'font'    => $font,
				'status'  => false,
				'message' => 'Error: ' . $e->getMessage(),
			);
		}
	}

/**
	 * Delete google font from local
	 *
	 * @param object $font Font data.
	 *
	 * @return object
	 * 
	 * @deprecated
	 * @see \Kirki\App\Services\FontService::remove_google_font()
	 */
	public static function remove_google_font_offline() {
		$font = isset( $_POST['font'] ) ? $_POST['font'] : null;
		$font = json_decode( stripslashes( $font ), true );

$font_family_slug = sanitize_title_with_dashes( basename( $font['family'] ) );
		$font_dir         = WP_CONTENT_DIR . "/uploads/kirki-fonts/{$font_family_slug}";

if ( is_dir( $font_dir ) ) {
			HelperFunctions::delete_directory( $font_dir );
		}

// remove the localUrl from font object and update the
		unset( $font['localUrl'] );

// save the font data in global data
		self::save_the_font_global_data( $font );

wp_send_json(
			array(
				'font'    => $font,
				'status'  => true,
				'message' => 'Font removed successfully',
			)
		);

die();
	}

/**
	 * Get user controller data
	 *
	 * @return void wp_send_json
	 * 
	 * @deprecated
	 * @see \Kirki\App\Managers\GlobalDataManager::get_global_ui_controller()
	 */
	public static function get_user_controller() {
		$control = HelperFunctions::get_global_data_using_key( KIRKI_USER_CONTROLLER_META_KEY );
		if ( $control ) {
			wp_send_json( $control );
		} else {
			wp_send_json( json_decode( '{}' ) );
		}
	}

/**
	 * Get User Saved data
	 *
	 * @return void wp_send_json
	 * 
	 * @deprecated
	 * @see \Kirki\App\Managers\GlobalDataManager::get_global_ui_saved_data()
	 */
	public static function get_user_saved_data() {
		$saved_data = HelperFunctions::get_global_data_using_key( KIRKI_USER_SAVED_DATA_META_KEY );
		if ( ! $saved_data ) {
			$saved_data = array();
		}

$saved_data['variableData'] = self::get_kirki_variable_data();

wp_send_json( $saved_data );
	}

/**
	 * Get User login status
	 *
	 * @return void wp_send_json
	 * @deprecated
	 * @see \Kirki\Framework\Wordpress\User::is_logged_in()
	 */
	public static function check_user_login() {
		wp_send_json( is_user_logged_in() );
		die();
	}

/**
	 * @deprecated
	 * @see \Kirki\App\Managers\GlobalDataManager::normalize_variable_data()
	 */
	public static function normalize_variable_data( $raw_data ) {

if(isset( $raw_data['data'] ) && is_array( $raw_data['data'] ) && count($raw_data['data']) > 0 && isset($raw_data['data'][0]['key'])  ) {
			return $raw_data; // thats means already normalized.	
		}
		// Start from clean base
		$organized = self::initial_variable_data();

// Index groups by key for fast access
		$groups = [];
		foreach ( $organized['data'] as $index => $group ) {
			$groups[ $group['key'] ] = &$organized['data'][ $index ];
		}

foreach ( $raw_data['data'] as $section ) {

/* ---------------------------------
			* Merge modes (unique by key)
			* --------------------------------- */
			if ( ! empty( $section['modes'] ) ) {

foreach ( $groups as &$group ) {

$mode_index = [];

foreach ( $group['modes'] as $existing_mode ) {
						if ( isset( $existing_mode['key'] ) ) {
							$mode_index[ $existing_mode['key'] ] = true;
						}
					}

foreach ( $section['modes'] as $mode ) {
						if (
							isset( $mode['key'] ) &&
							! isset( $mode_index[ $mode['key'] ] )
						) {
							$group['modes'][] = $mode;
							$mode_index[ $mode['key'] ] = true;
						}
					}
				}
			}

/* ---------------------------------
			* Organize variables
			* --------------------------------- */
			if ( empty( $section['variables'] ) ) {
				continue;
			}

foreach ( $section['variables'] as $variable ) {

if ( empty( $variable['type'] ) ) {
					continue;
				}

$group_key = $variable['type'];

if ( ! isset( $groups[ $group_key ] ) ) {
					continue;
				}

$found = false;

foreach ( $groups[ $group_key ]['variables'] as &$existing ) {

if ( isset( $existing['id'], $variable['id'] ) && $existing['id'] === $variable['id'] ) {

// Merge values by mode
						$existing['value'] = array_merge(
							$existing['value'] ?? [],
							$variable['value'] ?? []
						);

$found = true;
						break;
					}
				}

if ( ! $found ) {
					$groups[ $group_key ]['variables'][] = $variable;
				}
			}
		}

return $organized;
	}

/**
	 * @deprecated
	 * @see \Kirki\App\Managers\GlobalDataManager::sort_variable_data()
	 */
	public static function sort_variable_data( $data ) {
		// Enforce deterministic group order: Color, Number, Text style, Font family
		$order_map = array(
			'color'       => 0,
			'size'        => 1,
			'text-style'  => 2,
			'font-family' => 3,
		);

usort(
			$data['data'],
			function ( $a, $b ) use ( $order_map ) {
				$a_order = isset( $order_map[ $a['key'] ] ) ? $order_map[ $a['key'] ] : 99;
				$b_order = isset( $order_map[ $b['key'] ] ) ? $order_map[ $b['key'] ] : 99;
				return $a_order - $b_order;
			}
		);

return $data;
	}

/**
	 * @deprecated
	 * @see \Kirki\App\Managers\GlobalDataManager::initial_variable_data()
	 */
	public static function initial_variable_data() {
		// return json_decode( '{"data":[]}', true );
		return array(
			'data' => array(
				array(
					'title'     => 'Colors',
					'key'       => 'color',
					'modes'     => array(
						array(
							'title' => 'Default',
							'key'   => 'default',
						),
					),
					'variables' => array(),
				),
				array(
					'title'     => 'Numbers',
					'key'       => 'size',
					'modes'     => array(
						array(
							'title' => 'Default',
							'key'   => 'default',
						),
					),
					'variables' => array(),
				),
				array(
					'title'     => 'Text Styles',
					'key'       => 'text-style',
					'modes'     => array(
						array(
							'title' => 'Default',
							'key'   => 'default',
						),
					),
					'variables' => array(),
				),
				array(
					'title'     => 'Font Family',
					'key'       => 'font-family',
					'modes'     => array(
						array(
							'title' => 'Default',
							'key'   => 'default',
						),
					),
					'variables' => array(),
				),
			),

);
	}

/**
	 * @deprecated
	 * @see Kirki\App\Managers\GlobalDataManager::get_variable_data()
	 */
	public static function get_kirki_variable_data() {
		$saved_data = HelperFunctions::get_global_data_using_key( KIRKI_USER_SAVED_DATA_META_KEY );

if ( $saved_data && ! empty( $saved_data['variableData']['data'] ) ) {
			$variables = self::normalize_variable_data( $saved_data['variableData'] );
		} else {
			$variables = self::initial_variable_data();
		}

$variables = self::normalize_old_variable_data(	$variables );

// sort variable data
		$variables = self::sort_variable_data( $variables );

return $variables;
	}

/**
	 * @deprecated
	 * @see Kirki\App\Managers\GlobalDataManager::normalize_old_variable_data()
	 */
	private static function normalize_old_variable_data( $variables ) {
		// Check if data needs normalization
		if ( ! isset( $variables['data'] ) || ! is_array( $variables['data'] ) ) {
			return $variables;
		}

// Check if already normalized (has the 4 standard groups with correct keys)
		$expected_keys = array( 'color', 'size', 'text-style', 'font-family' );
		$actual_keys = array_column( $variables['data'], 'key' );
		
		if ( count( $actual_keys ) === 4 && empty( array_diff( $expected_keys, $actual_keys ) ) ) {
			// Already normalized, return as-is
			return $variables;
		}

// Create fresh groups
		$normalized = array(
			'data' => array(
				array(
					'title'     => 'Colors',
					'key'       => 'color',
					'modes'     => array(),
					'variables' => array(),
				),
				array(
					'title'     => 'Numbers',
					'key'       => 'size',
					'modes'     => array(),
					'variables' => array(),
				),
				array(
					'title'     => 'Text Styles',
					'key'       => 'text-style',
					'modes'     => array(),
					'variables' => array(),
				),
				array(
					'title'     => 'Font Family',
					'key'       => 'font-family',
					'modes'     => array(),
					'variables' => array(),
				),
			),
		);

// Index for quick access
		$groups = array();
		foreach ( $normalized['data'] as $index => &$group ) {
			$groups[ $group['key'] ] = &$normalized['data'][ $index ];
		}

// Track modes per type
		$modes_per_type = array(
			'color'       => array(),
			'size'        => array(),
			'text-style'  => array(),
			'font-family' => array(),
		);

// Single pass: process all variables
		foreach ( $variables['data'] as $section ) {
			if ( empty( $section['variables'] ) ) {
				continue;
			}

foreach ( $section['variables'] as $variable ) {
				// Determine correct group based on variable's type
				$var_type = isset( $variable['type'] ) ? $variable['type'] : null;
				
				if ( ! $var_type || ! isset( $groups[ $var_type ] ) ) {
					continue;
				}

// Add variable to correct group (move if in wrong section)
				$groups[ $var_type ]['variables'][] = $variable;

// Collect modes for this type
				if ( isset( $variable['value'] ) && is_array( $variable['value'] ) ) {
					foreach ( array_keys( $variable['value'] ) as $mode_key ) {
						if ( ! isset( $modes_per_type[ $var_type ][ $mode_key ] ) ) {
							$modes_per_type[ $var_type ][ $mode_key ] = array(
								'key'   => $mode_key,
								'title' => ucfirst( $mode_key ),
							);
						}
					}
				}
			}
		}

// Assign collected modes to groups
		foreach ( $modes_per_type as $type => $modes ) {
			if ( isset( $groups[ $type ] ) ) {
				$groups[ $type ]['modes'] = array_values( $modes );
				// Ensure default mode exists
				if ( empty( $groups[ $type ]['modes'] ) ) {
					$groups[ $type ]['modes'][] = array(
						'key'   => 'default',
						'title' => 'Default',
					);
				}
			}
		}

return $normalized;
	}

/**
	 * Get user custom fonts data
	 *
	 * @return void wp_send_json
	 * 
	 * @deprecated
	 * @see \Kirki\App\Managers\GlobalDataManager::get_global_custom_fonts()
	 */
	public static function get_user_custom_fonts_data() {
		$custom_fonts = HelperFunctions::get_global_data_using_key( KIRKI_USER_CUSTOM_FONTS_META_KEY );
		if ( $custom_fonts ) {
			wp_send_json( $custom_fonts );
		} else {
			wp_send_json( json_decode( '{}' ) );
		}
	}

/**
	 * Get View port list.
	 * this method only for front end. not for editor. cause list data not completed data.
	 *
	 * @return array
	 * 
	 * @deprecated
	 * @see \Kirki\App\Managers\GlobalDataManager::get_view_port_list()
	 */
	public static function get_view_port_list() {
		$control = HelperFunctions::get_global_data_using_key( KIRKI_USER_CONTROLLER_META_KEY );
		if ( ! $control || ! isset( $control['viewport'], $control['viewport']['list'] ) ) {
			return self::sort_viewport_list( HelperFunctions::get_initial_view_ports()['list'] );
		}
		return self::sort_viewport_list( $control['viewport']['list'] );
	}

/**
	 * Sort view port list
	 *
	 * @param array $arr list of view port list.
	 * @return array
	 * 
	 * @deprecated
	 * @see \Kirki\App\Managers\GlobalDataManager::sort_viewport_list()
	 */
	private static function sort_viewport_list( $arr ) {
		$arr  = (array) $arr;
		$list = array();
		array_multisort( array_column( $arr, 'minWidth' ), SORT_ASC, SORT_NUMERIC, $arr );
		$flag = false;
		foreach ( $arr as $key => $value ) {
			if ( $flag ) {
				$list[ $key ]         = $value;
				$list[ $key ]['type'] = 'min';
				$list[ $key ]['id']   = $key;
			}
			if ( $key === 'md' ) {
				$flag                 = true;
				$list[ $key ]         = $value;
				$list[ $key ]['id']   = $key;
				$list[ $key ]['type'] = 'max';
			}
		}
		$flag = false;
		foreach ( array_reverse( $arr ) as $key => $value ) {
			if ( $flag ) {
				$list[ $key ]         = $value;
				$list[ $key ]['type'] = 'max';
				$list[ $key ]['id']   = $key;
			}
			if ( $key === 'md' ) {
				$flag = true;
			}
		}
		return $list;
	}
}