KOK - MANAGER

Edit File: unitecreator_helper.class.php

<?php
/**
 * @package Unlimited Elements
 * @author unlimited-elements.com
 * @copyright (C) 2021 Unlimited Elements, All Rights Reserved.
 * @license GNU/GPLv3 http://www.gnu.org/licenses/gpl-3.0.html
 * */
if ( ! defined( 'ABSPATH' ) ) exit;

/**
 *
 * creator helper functions class
 *
 */
	class HelperUC extends UniteHelperBaseUC{

private static $db;
		public static $operations;
		private static $arrFontPanelData;
		private static $arrAdminNotices = array();
		private static $arrStickyAdminNotice = array();
		private static $isPutAnimations = false;
		private static $arrLogMemory = array();
		private static $arrHashCache = array();
		private static $arrRunOnceCache = array();
		private static $arrLocalText = array();
		private static $arrDebug;
		private static $hasOutput = false;
		public static $arrWidgetScripts = array();
		private static $arrUsedHTMLHandles = array();
		
		public static function a____GENERAL____(){}

/**
		 * heck if debug by url
		 */
		public static function isDebug(){

$debug = UniteFunctionsUC::getGetVar("ucdebug","",UniteFunctionsUC::SANITIZE_KEY);

if(empty($debug))
				return(false);

$debug = UniteFunctionsUC::strToBool($debug);

return($debug);
		}

/**
		 * validate plugin startup functionality
		 * Enter description here ...
		 */
		public static function validatePluginStartup(){

if(function_exists("simplexml_load_file") == false)
				UniteFunctionsUC::throwError("Your php missing SimpleXML Extension. The plugin can't work without this extension because it has many xml files to load. Please enable this extension in php.ini");

}

/**
		 * get the database
		 */
		public static function getDB(){

if(empty(self::$db))
				self::$db = new UniteCreatorDB();

return(self::$db);
		}

/**
		 * set local text object for text output
		 */
		public static function setLocalText($arrText){

self::$arrLocalText = array_merge(self::$arrLocalText, $arrText);

}

/**
		 * include all plugins
		 */
		public static function includeAllPlugins(){

$objUCPlugins = new UniteCreatorPlugins();
			$objUCPlugins->initPlugins();
		}

/**
		 * run provider function
		 */
		public static function runProviderFunc($func){

$args = func_get_args();
			array_shift($args);

$exists = method_exists("UniteProviderFunctionsUC",$func);

if(!$exists)
				return(false);

call_user_func_array(array("UniteProviderFunctionsUC",$func), $args);

}

/**
		 * get font panel fields
		 */
		public static function getFontPanelData(){

if(!empty(self::$arrFontPanelData))
				return(self::$arrFontPanelData);

self::$arrFontPanelData = require GlobalsUC::$pathSettings."font_panel_data.php";

return(self::$arrFontPanelData);
		}

/**
		 * get text by key
		 */
		public static function getText($textKey){

$searchKey = strtolower($textKey);

//search local text first
			if(array_key_exists($searchKey, self::$arrLocalText))
				return(self::$arrLocalText[$textKey]);

if(array_key_exists($searchKey, GlobalsUC::$arrServerSideText))
				return(GlobalsUC::$arrServerSideText[$textKey]);

if(array_key_exists($searchKey, GlobalsUC::$arrClientSideText))
				return(GlobalsUC::$arrClientSideText[$textKey]);

return($textKey);
		}

/**
		 * put text by key
		 */
		public static function putText($textKey){

echo esc_attr(self::getText($textKey));
		}

/**
		 * get settings object by name from settings folder
		 */
		public static function getSettingsObject($settingsName, $path=null){

$pathSettings = self::getPathSettings($settingsName, $path);

$objSettings = new UniteCreatorSettings();
			$objSettings->loadXMLFile($pathSettings);

return($objSettings);
		}

/**
		 * get current admin view
		 */
		public static function getAdminView(){

if(UniteProviderFunctionsUC::isAdmin() == false)
				return(null);

$view = UniteCreatorAdmin::getView();

return($view);
		}

/**
		 *
		 * get size related css from size css array
		 */
		public static function getCssMobileSize($arrSizeCss, $cssPrefix = ""){

$css = "";
			foreach($arrSizeCss as $size=>$cssSize){
				if(empty($cssSize))
					continue;

$cssSize = UniteFunctionsUC::addTabsToText($cssSize,"    ");
				$cssSize = HelperHtmlUC::wrapCssMobile($cssSize, $size);

if(!empty($css))
					$css .= "\n\n";

$css .= $cssSize;
			}

if(!empty($cssPrefix) && !empty($css))
				$css = $cssPrefix."\n\n".$css;

return($css);
		}

/**
		 * check if it's special addon type like shape or shape devider
		 */
		public static function isSpecialAddonType($type){

switch($type){
				case GlobalsUC::ADDON_TYPE_SHAPE_DEVIDER:
				case GlobalsUC::ADDON_TYPE_SHAPES:
				case GlobalsUC::ADDON_TYPE_BGADDON:
					return(true);
				break;
			}

return(false);
		}

/**
		 * tells if it's layout addon type or not
		 */
		public static function isLayoutAddonType($addonType){

$objAddonType = UniteCreatorAddonType::getAddonTypeObject($addonType);

$isLayout = $objAddonType->isLayout;

return($isLayout);
		}

/**
		 * get product from request
		 */
		public static function getProductFromRequest(){

$action = UniteFunctionsUC::getPostGetVariable("client_action", "", UniteFunctionsUC::SANITIZE_TEXT_FIELD);
			if(empty($action))
				return(null);

$data = UniteFunctionsUC::getPostGetVariable("data", "", UniteFunctionsUC::SANITIZE_NOTHING);
			$passData = UniteFunctionsUC::getVal($data, "manager_passdata");

if(empty($passData))
				return(null);

$product = UniteFunctionsUC::getVal($passData, "product");

return($product);
		}

/**
		 * get php variables info
		 */
		public static function getPHPInfo(){

if(function_exists("ini_get_all") == false)
				return(array());

$arrInfo = ini_get_all();

if(empty($arrInfo))
				return(array());

$arrKeys = array("memory_limit", "max_execution_time", "post_max_size", "upload_max_filesize");

$arrInfoComputed = array();
			foreach($arrKeys as $key){
				$arrValues = UniteFunctionsUC::getVal($arrInfo, $key);
				$localValue = UniteFunctionsUC::getVal($arrValues, "local_value");
				$arrInfoComputed[$key] = $localValue;
			}

return($arrInfoComputed);
		}

/**
		 * return true - need to run.
		 * used for run code once functionality
		 */
		public static function isRunCodeOnce($key){
			
			$isAlreadyRun = UniteFunctionsUC::getVal(self::$arrRunOnceCache, $key);
			
			//run the code anyway, if located inside hidden template content output
			
			if(!empty(GlobalsProviderUC::$renderTemplateID))
				$isAlreadyRun = false;
			
			if($isAlreadyRun === true){
				return(false);			//don't run the code
			}

self::$arrRunOnceCache[$key] = true;

return(true);		//run the code
		}

/**
		 * get records from sql query, don't allow to run other then select queries
		 */
		public static function getFromSql($query, $arg1 = null, $arg2 = null){

$lower = strtolower($query);
			if(strpos($lower, "select") !== 0)
				UniteFunctionsUC::throwError("get from sql error - the query should start with the word 'select'");

$query = sprintf($query, $arg1, $arg2);

$db = self::getDB();
			$response = $db->fetchSql($query);

return($response);
		}

/**
		 * check if there is permissions from query
		 * and it's logged in or local
		 */
		public static function hasPermissionsFromQuery($getvar){

$isEnabled = UniteFunctionsUC::getGetVar($getvar,"",UniteFunctionsUC::SANITIZE_TEXT_FIELD);
			$isEnabled = UniteFunctionsUC::strToBool($isEnabled);

if($isEnabled == false) {
				$data = UniteFunctionsUC::getPostGetVariable("data", "", UniteFunctionsUC::SANITIZE_NOTHING);
				if(empty($data))
					return(false);
				$isEnabled = UniteFunctionsUC::getVal($data, $getvar);
				$isEnabled = UniteFunctionsUC::strToBool($isEnabled);
			}

if($isEnabled == false)
				return(false);

if(GlobalsUC::$isLocal == true)
				return(true);
			
			if(UniteFunctionsWPUC::isCurrentUserHasPermissions() == true)
				return(true);

return(false);
		}
		
		/**
		 * check if there is permissions from query
		 * and it's logged in or local
		 */
		public static function getQueryVarWithPermission($getvar){

if(UniteFunctionsWPUC::isCurrentUserHasPermissions() == false)
				return(null);
			
			$value = UniteFunctionsUC::getGetVar($getvar,"",UniteFunctionsUC::SANITIZE_TEXT_FIELD);

if(empty($value))
				return(null);
			
			return($value);
		}
		
		
		/**
		 * get kses allowed html
		 */
		public static function getKsesAllowedHTML(){
			
			$allowedHtml = array(
			    'br' => array(),
				'a' => array(
			        'href'   => array(),
			        'title'  => array(),
			        'target' => array(),
			        'rel'    => array(),
				),
				"b"=>array()
			);					
			
			return($allowedHtml);
		}
		
		public static function a_______DEBUG________(){}

/**
		 * add debug text
		 */
		public static function addDebug($title, $content = null){

if(empty(self::$arrDebug))
				self::$arrDebug = array();

$name = HelperUC::convertTitleToHandle($title);

$item = array();
			$item["name"] = $name;
			$item["title"] = $title;
			$item["content"] = $content;

self::$arrDebug[] = $item;
		}

/**
		 * clear debug
		 */
		public static function clearDebug(){

self::$arrDebug = array();
		}

/**
		 * get debug data
		 */
		public static function getDebug(){

return(self::$arrDebug);
		}

/**
		 * show the debug
		 */
		public static function showDebug($type = null){

dmp("Showing Debug");

if(!empty($type))
				dmp("$type mode");

$arrDebug = HelperUC::getDebug();

if(empty($arrDebug)){
				dmp("no debug content found");
				return(false);
			}

foreach($arrDebug as $item){

$name = UniteFunctionsUC::getVal($item, "name");

if($type == "query"){

switch($name){
						case "getpostlist_values":
						case "getpostlist_param":
						case "post_filters":
						case "post_additions":
							continue(2);
						break;
					}
				}

$title = UniteFunctionsUC::getVal($item, "title");
				$content = UniteFunctionsUC::getVal($item, "content");

$titleOutput = $title;
				if(!empty($content))
					$titleOutput = "<b>$title:</b>";

dmp($titleOutput);
				dmp($content);

}

public static function a_______NOTICES________(){}

/**
		 * add notice that will be showen on plugin pages
		 */
		public static function addAdminNotice($strNotice){
			self::$arrAdminNotices[] = $strNotice;
		}

/**
		 * add notice that will be showen on plugin pages
		 */
		public static function getAdminNotices(){

$arrNotices = self::$arrAdminNotices;

self::$arrAdminNotices = array();	 //clear

return($arrNotices);
		}

public static function a__________MEMORY__________(){}

/**
		 * store memory log
		 * state - start, end
		 */
		public static function logMemoryUsage($operation, $isUpdateOption = false){

$usage = memory_get_usage();

$diff = 0;
			if(!empty(self::$arrLogMemory)){
				$lastArrUsage = self::$arrLogMemory[count(self::$arrLogMemory)-1];
				$lastUsage = $lastArrUsage["usage"];
				$diff = $usage - $lastUsage;
			}

$arrLogItem = array("oper"=>$operation,"usage"=>$usage,"diff"=>$diff, "time"=>time());

//log the page
			if(empty(self::$arrLogMemory)){
				$arrLogItem["current_page"] = GlobalsUC::$current_page_url;
			}

self::$arrLogMemory[] = $arrLogItem;

if($isUpdateOption == true)
				UniteProviderFunctionsUC::updateOption("unite_creator_memory_usage_log", self::$arrLogMemory);

}

/**
		 * get last memory usage
		 */
		public static function getLastMemoryUsage(){

$arrLog = UniteProviderFunctionsUC::getOption("unite_creator_memory_usage_log");

return($arrLog);
		}

public static function a_________STATE________(){}

/**
		 * remember state
		 */
		public static function setState($name, $value){

$optionName = "untecreator_state";

$arrState = UniteProviderFunctionsUC::getOption($optionName);
			if(empty($arrState) || is_array($arrState) == false)
				$arrState = array();

$arrState[$name] = $value;
			UniteProviderFunctionsUC::updateOption($optionName, $arrState);
		}

/**
		 * get remembered state
		 */
		public static function getState($name){

$optionName = "untecreator_state";

$arrState = UniteProviderFunctionsUC::getOption($optionName);
			$value = UniteFunctionsUC::getVal($arrState, $name, null);

return($value);
		}

public static function a________URL_AND_PATH_________(){}

/**
		 * convert url to full url
		 */
		public static function URLtoFull($url, $urlBase = null){

if(is_numeric($url))		//protection for image id
				return($url);

if(getType($urlBase) == "boolean")
				UniteFunctionsUC::throwError("the url base should be null or string");

if(is_array($url))
				UniteFunctionsUC::throwError("url can't be array");

$url = trim($url);

if(empty($url))
				return("");

$urlLower = strtolower($url);

if(strpos($urlLower, "http://") !== false || strpos($urlLower, "https://") !== false)
				return($url);

if(empty($urlBase))
				$url = GlobalsUC::$url_base.$url;
			else{

$convertUrl = GlobalsUC::$url_base;

//preserve old format:
				$filepath = self::pathToAbsolute($url);
				if(file_exists($filepath) == false)
					$convertUrl = $urlBase;

$url = $convertUrl.$url;
			}

$url = UniteFunctionsUC::cleanUrl($url);

return($url);
		}

/**
		 * convert some url to relative
		 */
		public static function URLtoRelative($url, $isAssets = false){

$replaceString = GlobalsUC::$url_base;
			if($isAssets == true)
				$replaceString = GlobalsUC::$url_assets;

//in case of array take "url" from the array
			if(is_array($url)){

$strUrl = UniteFunctionsUC::getVal($url, "url");
				if(empty($strUrl))
					return($url);

$url["url"] = str_replace($replaceString, "", $strUrl);

return($url);
			}

$url = str_replace($replaceString, "", $url);

return($url);
		}

/**
		 * change url to assets relative
		 */
		public static function URLtoAssetsRelative($url){

$url = str_replace(GlobalsUC::$url_assets, "", $url);

return($url);
		}

/**
		 * convert url to path, if wrong path, return null
		 */
		public static function urlToPath($url){

$urlRelative = self::URLtoRelative($url);
						
			$path = GlobalsUC::$path_base.$urlRelative;
			
			$path = UniteFunctionsUC::cleanPath($path);
						
			if(file_exists($path) == false)
				return(null);

return($path);
		}

/**
		 * convert url array to relative
		 */
		public static function arrUrlsToRelative($arrUrls, $isAssets = false){
			if(!is_array($arrUrls))
				return($arrUrls);

foreach($arrUrls as $key=>$url){
				$arrUrls[$key] = self::URLtoRelative($url, $isAssets);
			}

return($arrUrls);
		}

/**
		 * convert url's array to full
		 */
		public static function arrUrlsToFull($arrUrls){
			if(!is_array($arrUrls))
				return($arrUrls);

foreach($arrUrls as $key=>$url){
				$arrUrls[$key] = self::URLtoFull($url);
			}

return($arrUrls);
		}

/**
		 * strip base path part from the path
		 */
		public static function pathToRelative($path, $addDots = true){

$realpath = realpath($path);
		if(!$realpath)
			return ($path);

$isDir = is_dir($realpath);

$len = strlen($realpath);
		$realBase = realpath(GlobalsUC::$path_base);

if($realBase != "/")
			$relativePath = str_replace($realBase, "", $realpath);
		else
			$relativePath = $realpath;

//add dots
		if($addDots == true && strlen($relativePath) != strlen($realpath))
			$relativePath = ".." . $relativePath;

$relativePath = UniteFunctionsUC::pathToUnix($relativePath);

if($addDots == false)
			$relativePath = ltrim($relativePath, "/");

//add slash to end
		if($isDir == true)
			$relativePath = UniteFunctionsUC::addPathEndingSlash($relativePath);

return $relativePath;
	}

/**
	 * convert relative path to absolute path
	 */
	public static function pathToAbsolute($path){

$basePath = GlobalsUC::$path_base;
		$basePath = UniteFunctionsUC::pathToUnix($basePath);

$path = UniteFunctionsUC::pathToUnix($path);

$realPath = UniteFunctionsUC::realpath($path, false);

if(!empty($realPath))
			return ($path);

if(UniteFunctionsUC::isPathUnderBase($path, $basePath)){
			$path = UniteFunctionsUC::pathToUnix($path);

return ($path);
		}

$path = $basePath . "/" . $path;
		$path = UniteFunctionsUC::pathToUnix($path);

return ($path);
	}

/**
	 * turn path to relative url
	 */
	public static function pathToRelativeUrl($path){

$path = self::pathToRelative($path, false);

$url = str_replace('\\', '/', $path);

//remove starting slash
		$url = ltrim($url, '/');

return ($url);
	}

/**
	 * convert path to absolute url
	 */
	public static function pathToFullUrl($path){

if(empty($path))
			return ("");

$url = self::pathToRelativeUrl($path);

$url = self::URLtoFull($url);

return ($url);
	}

/**
	 * get details of the image by the image url.
	 */
	public static function getImageDetails($urlImage){

$info = UniteFunctionsUC::getPathInfo($urlImage);
		$urlDir = UniteFunctionsUC::getVal($info, "dirname");
		if(!empty($urlDir))
			$urlDir = $urlDir . "/";

$arrInfo = array();
		$arrInfo["url_full"] = GlobalsUC::$url_base . $urlImage;
		$arrInfo["url_dir_image"] = $urlDir;
		$arrInfo["url_dir_thumbs"] = $urlDir . GlobalsUC::DIR_THUMBS . "/";

$filepath = GlobalsUC::$path_base . urldecode($urlImage);
		$filepath = realpath($filepath);

$path = dirname($filepath) . "/";
		$pathThumbs = $path . GlobalsUC::DIR_THUMBS . "/";

$arrInfo["filepath"] = $filepath;
		$arrInfo["path"] = $path;
		$arrInfo["path_thumbs"] = $pathThumbs;

return ($arrInfo);
	}

/**
	 * convert title to handle
	 */
	public static function convertTitleToHandle($title, $removeNonAscii = true){

$handle = strtolower($title);

$handle = str_replace(array("ä", "Ä"), "a", $handle);
		$handle = str_replace(array("å", "Å"), "a", $handle);
		$handle = str_replace(array("ö", "Ö"), "o", $handle);

if($removeNonAscii == true){
			// Remove any character that is not alphanumeric, white-space, or a hyphen
			$handle = preg_replace("/[^a-z0-9\s\_]/i", " ", $handle);
		}

// Replace multiple instances of white-space with a single space
		$handle = preg_replace("/\s\s+/", " ", $handle);
		// Replace all spaces with underscores
		$handle = preg_replace("/\s/", "_", $handle);
		// Replace multiple underscore with a single underscore
		$handle = preg_replace("/\_\_+/", "_", $handle);
		// Remove leading and trailing underscores
		$handle = trim($handle, "_");

return ($handle);
	}

/**
	 * convert title to alias
	 */
	public static function convertTitleToAlias($title){
		
		$handle = self::convertTitleToHandle($title);
		
		$alias = str_replace("_", "-", $handle);

return ($alias);
	}

/**
	 * convert alias to title
	 */
	public static function convertAliasToTitle($alias){
		
	    $title = str_replace(array('-', '_'), ' ', $alias);
		
	    $title = ucwords($title);
	
	    return $title;		
	}
	
	/**
	 * get url handle
	 */
	public static function getUrlHandle($url, $addonName = null){

$urlNew = HelperUC::URLtoAssetsRelative($url);

if($urlNew != $url){  //is inside assets
			$urlNew = "uc_assets_" . $urlNew;

//make handle by file name and size
			$path = self::urlToPath($url);

if(!empty($path)){
				$arrInfo = pathinfo($path);
				$filename = UniteFunctionsUC::getVal($arrInfo, "basename");
				$filesize = filesize($path);

$urlNew = "ac_assets_file_" . $filename . "_" . $filesize;
			}
		}else{
			$urlNew = HelperUC::URLtoRelative($url);
			if($urlNew != $url)
				$urlNew = "uc_" . $urlNew;
			else
				$urlNew = $url;
		}

$url = strtolower($urlNew);
		$url = str_replace("https://", "", $url);
		$url = str_replace("http://", "", $url);

if(strpos($url, "uc_") !== 0)
			$url = "uc_" . $url;

$handle = self::convertTitleToHandle($url);

return ($handle);
	}

/**
	 * convert shortcode to url assets
	 */
	public static function convertFromUrlAssets($value, $urlAssets){

if(empty($urlAssets))
			return ($value);

if(is_string($value) == false)
			return ($value);

$value = str_replace("[url_assets]/", $urlAssets, $value);
		$value = str_replace("{{url_assets}}/", $urlAssets, $value);

return ($value);
	}

/**
	 * if the website is ssl - convert url to ssl
	 */
	public static function urlToSSLCheck($url){

if(GlobalsUC::$is_ssl == true)
			$url = UniteFunctionsUC::urlToSsl($url);

return ($url);
	}

/**
	 * download file given from some url to cache folder
	 * return filepath
	 */
	public static function downloadFileToCacheFolder($urlFile){

$info = pathinfo($urlFile);
		$filename = UniteFunctionsUC::getVal($info, "basename");
		if(empty($filename))
			UniteFunctionsUC::throwError("no file given");

$ext = $info["extension"];

if($ext != "zip")
			UniteFunctionsUC::throwError("wrong file given");

$pathCache = GlobalsUC::$path_cache;
		UniteFunctionsUC::mkdirValidate($pathCache, "cache folder");

$pathCacheImport = $pathCache . "import/";
		UniteFunctionsUC::mkdirValidate($pathCacheImport, "cache import folder");

$filepath = $pathCacheImport . $filename;

$content = UniteFunctionsUC::fileGetContents($urlFile);
		if(empty($content))
			UniteFunctionsUC::throwError("Can't dowonload file from url: $urlFile");

UniteFunctionsUC::writeFile($content, $filepath);

return ($filepath);
	}

/**
	 * get url content
	 */
	public static function getFileContentByUrl($url, $filterExtention = null){

if(!empty($filterExtention)){
			$info = pathinfo($url);
			$ext = UniteFunctionsUC::getVal($info, "extension");
			$ext = strtolower($ext);

if($ext != $filterExtention)
				return (null);
		}

$pathFile = self::urlToPath($url);

if(empty($pathFile))
			return (null);

if(file_exists($pathFile) == false)
			return (null);

$content = UniteFunctionsUC::fileGetContents($pathFile);

return ($content);
	}

public static function a________VIEW_TEMPLATE_____(){}

/**
	 * get ajax url for export
	 */
	public static function getUrlAjax($action, $params = ""){

$nonce = UniteProviderFunctionsUC::getNonce();

$url = UniteFunctionsUC::addUrlParams(GlobalsUC::$url_ajax_full, array(
			'action' => GlobalsUC::PLUGIN_NAME . '_ajax_action',
			'client_action' => $action,
			'nonce' => $nonce,
		));

if(!empty($params))
			$url = UniteFunctionsUC::addUrlParams($url, $params);

return $url;
	}

/**
	 *
	 * get url to some view.
	 */
	public static function getViewUrl($viewName, $urlParams = "", $isBlankWindow = false, $isFront = false){

$params = "view=" . $viewName;

if(!empty($urlParams))
			$params .= "&" . $urlParams;

if($isFront == false)
			$link = UniteFunctionsUC::addUrlParams(GlobalsUC::$url_component_admin, $params);
		else
			$link = UniteFunctionsUC::addUrlParams(GlobalsUC::$url_component_client, $params);

if($isBlankWindow == true)
			$link = UniteProviderFunctionsUC::convertUrlToBlankWindow($link);

$link = UniteProviderFunctionsUC::applyFilters(UniteCreatorFilters::FILTER_MODIFY_URL_VIEW, $link, $viewName, $params, $isBlankWindow, $isFront);

return ($link);
	}

/**
	 * get addons view url
	 */
	public static function getViewUrl_Addons($type = ""){

if(empty($type))
			return self::getViewUrl(GlobalsUC::VIEW_ADDONS_LIST);

$params = array();
		$type = urldecode($type);
		$params = "addontype=$type";

$urlView = self::getViewUrl(GlobalsUC::VIEW_ADDONS_LIST, $params);

return ($urlView);
	}

/**
	 * get addons view url
	 */
	public static function getViewUrl_Default($params = ""){

return self::getViewUrl(GlobalsUC::$view_default, $params);
	}

/**
	 * get addons view url
	 */
	public static function getViewUrl_TemplatesList($params = array(), $layoutType = null){

$urlParams = "";
		if(!empty($layoutType)){
			$params["layout_type"] = $layoutType;
			$urlParams = "layout_type=" . $layoutType;
		}

$url = self::getViewUrl(GlobalsUC::VIEW_TEMPLATES_LIST, $urlParams);

$url = UniteProviderFunctionsUC::applyFilters(UniteCreatorFilters::FILTER_URL_TEMPLATES_LIST, $url, $params, $layoutType);

return ($url);
	}

/**
	 * get addons view url
	 */
	public static function getViewUrl_LayoutsList($params = array(), $layoutType = ""){

$urlParams = "";
		if(!empty($layoutType)){
			$params["layout_type"] = $layoutType;
			$urlParams = "layout_type=" . $layoutType;
		}

$url = self::getViewUrl(GlobalsUC::VIEW_LAYOUTS_LIST, $urlParams);

$url = UniteProviderFunctionsUC::applyFilters(UniteCreatorFilters::FILTER_URL_LAYOUTS_LIST, $url, $params);

return ($url);
	}

/**
	 * get some object url
	 */
	private static function getUrlViewObject($view, $objectID, $optParams, $isBlankWindow = false){

$params = "";
		if(!empty($objectID))
			$params = "id=$objectID";

if(!empty($optParams)){
			if(!empty($params))
				$params .= "&";

$params .= $optParams;
		}

return (self::getViewUrl($view, $params, $isBlankWindow));
	}

/**
	 * get addons view url
	 */
	public static function getViewUrl_Layout($layoutID = null, $optParams = "", $layoutType = ""){

if(!empty($layoutType)){
			if(!empty($optParams))
				$optParams .= "&";

$optParams .= "layout_type=" . $layoutType;
		}

$url = self::getUrlViewObject(GlobalsUC::VIEW_LAYOUT, $layoutID, $optParams, true);

return $url;
	}

/**
	 * get addons view url
	 */
	public static function getViewUrl_Template($templateID = null, $templateType = "", $optParams = ""){

UniteFunctionsUC::validateNotEmpty($templateType);

if(!empty($optParams))
			$optParams .= "&";

$optParams .= "layout_type=" . $templateType;

return self::getViewUrl_Layout($templateID, $optParams);
	}

/**
	 * get addons view url
	 */
	public static function getViewUrl_LayoutPreviewTemplate(){

$urlTemplate = self::getViewUrl_LayoutPreview("[page]", true);

return ($urlTemplate);
	}

/**
	 * get addons view url
	 */
	public static function getViewUrl_LayoutPreview($layoutID, $isBlankWindow = false, $addParams = "", $isFront = true){

if($layoutID == "[page]"){
			$urlPreviewTemplate = UniteProviderFunctionsUC::applyFilters("get_layout_preview_byid", null, $layoutID);
			if(!empty($urlPreviewTemplate))
				return ($urlPreviewTemplate);
		}

$layoutID = (int)$layoutID;

UniteFunctionsUC::validateNotEmpty($layoutID, "layout id");

$urlPreview = null;
		$urlPreview = UniteProviderFunctionsUC::applyFilters("get_layout_preview_byid", $urlPreview, $layoutID);
		if(!empty($urlPreview))
			return ($urlPreview);

$params = "id=$layoutID";

if(!empty($addParams))
			$params .= "&" . $addParams;

$url = self::getViewUrl(GlobalsUC::VIEW_LAYOUT_PREVIEW, $params, $isBlankWindow, $isFront);

return ($url);
	}

/**
	 * get layout preview url
	 */
	public static function getUrlLayoutPreviewFront($layoutID, $addParams = null, $outputMode = null){

//add output mode
		if(!empty($outputMode)){
			if(empty($addParams))
				$addParams = "";

if(!empty($addParams))
				$addParams .= "&";

$addParams .= "outputmode=" . $outputMode;
		}

$url = HelperUC::getViewUrl_LayoutPreview($layoutID, true, $addParams, true);

$url = UniteProviderFunctionsUC::applyFilters(UniteCreatorFilters::FILTER_MODIFY_URL_LAYOUT_PREVIEW_FRONT, $url, $layoutID, $addParams);

return ($url);
	}

/**
	 * get addons view url
	 */
	public static function getViewUrl_EditAddon($addonID, $params = "", $hash = ""){

$addonID = (int)$addonID;

$strParams = "id={$addonID}";
		if(!empty($params))
			$strParams .= "&" . $params;

if(!empty($hash))
			$strParams .= "#" . $hash;

return (self::getViewUrl(GlobalsUC::VIEW_EDIT_ADDON, $strParams));
	}

/**
	 * get addons view url
	 */
	public static function getViewUrl_TestAddon($addonID, $optParams = ""){

$params = "id={$addonID}";
		if(!empty($optParams))
			$params .= "&" . $optParams;

return (self::getViewUrl(GlobalsUC::VIEW_TEST_ADDON, $params));
	}

/**
	 * get addons view url
	 */
	public static function getViewUrl_AddonDefaults($addonID, $optParams = ""){

$params = "id={$addonID}";
		if(!empty($optParams))
			$params .= "&" . $optParams;

return (self::getViewUrl(GlobalsUC::VIEW_ADDON_DEFAULTS, $params));
	}

/**
	 * get filename title from some url
	 * used to get item title from image url
	 */
	public static function getTitleFromUrl($url, $defaultTitle = "item"){

$info = pathinfo($url);
		$filename = UniteFunctionsUC::getVal($info, "filename");
		$filename = urldecode($filename);

$title = $defaultTitle;
		if(!empty($filename))
			$title = $filename;

return ($title);
	}

/**
	 * get file path
	 *
	 * @param  $filena
	 */
	private static function getPathFile($filename, $path, $defaultPath, $validateName, $ext = "php"){

if(empty($path))
			$path = $defaultPath;

$filepath = $path . $filename . "." . $ext;
		UniteFunctionsUC::validateFilepath($filepath, $validateName);

return ($filepath);
	}

/**
	 * require some template from "templates" folder
	 */
	public static function getPathTemplate($templateName, $path = null){

return self::getPathFile($templateName, $path, GlobalsUC::$pathTemplates, "Template");
	}

/**
	 * require some template from "templates" folder
	 */
	public static function getPathView($viewName, $path = null){

return self::getPathFile($viewName, $path, GlobalsUC::$pathViews, "View");
	}

/**
	 * require some template from "templates" folder
	 */
	public static function getPathViewObject($viewObjectName, $path = null){

return self::getPathFile($viewObjectName, $path, GlobalsUC::$pathViewsObjects, "View Object");
	}

/**
	 * get settings path
	 */
	public static function getPathSettings($settingsName, $path = null){

return self::getPathFile($settingsName, $path, GlobalsUC::$pathSettings, "Settings", "xml");
	}

/**
	 * get path provider template
	 */
	public static function getPathTemplateProvider($templateName){

return self::getPathFile($templateName, GlobalsUC::$pathProviderTemplates, "", "Provider Template");
	}

/**
	 * get path provider view
	 */
	public static function getPathViewProvider($viewName){

return self::getPathFile($viewName, GlobalsUC::$pathProviderViews, "", "Provider View");
	}

/**
	 * get font awesome url
	 */
	public static function getUrlFontAwesome($version = null){

if(empty($version))
			$version = "fa5";

if($version == "fa4")
			$url = GlobalsUC::$url_assets_libraries . "font-awsome/css/font-awesome.min.css";
		else    //fa5
			$url = GlobalsUC::$url_assets_libraries . "font-awesome6/fontawesome-all.min.css";

return ($url);
	}

public static function a______SCRIPTS______(){
	}

/**
	 * include ue animation styles
	 */
	public static function includeUEAnimationStyles(){

self::addStyleAbsoluteUrl(GlobalsUC::$url_assets_libraries . "animations/ue_animations.css", "ue_animations");
	}

/**
	 * put smooth scroll include
	 */
	public static function putSmoothScrollIncludes($putJSInit = false){

$urlSmoothScroll = GlobalsUC::$url_assets_libraries . "smooth-scroll/smooth-scroll.min.js";
		self::addScriptAbsoluteUrl($urlSmoothScroll, "smooth-scroll");

if($putJSInit == false)
			return (false);

$script = "
			window.addEventListener('load', function(){
				var g_ucSmoothScroll = new SmoothScroll('a[href*=\"#\"]',{speed:1000});
			});
		";

self::putCustomScript($script);
	}

/**
	 *
	 * register script helper function
	 *
	 * @param $scriptFilename
	 */
	public static function addScript($scriptName, $handle = null, $folder = "js", $inFooter = false){

if($handle == null)
			$handle = GlobalsUC::PLUGIN_NAME . "-" . $scriptName;

$url = GlobalsUC::$urlPlugin . $folder . "/" . $scriptName . ".js";

UniteProviderFunctionsUC::addScript($handle, $url, $inFooter);
	}

/**
	 * register script helper function
	 */
	public static function addScriptAbsoluteUrl($urlScript, $handle, $inFooter = false, $deps = array()){

UniteProviderFunctionsUC::addScript($handle, $urlScript, $inFooter, $deps);

if(GlobalsProviderUC::$isInsideEditor == true)
			self::$arrWidgetScripts[$handle] = $urlScript;

}

/**
	 *
	 * register script helper function
	 *
	 * @param $scriptFilename
	 */
	public static function addScriptAbsoluteUrl_widget($urlScript, $handle, $inFooter = false){

if(GlobalsProviderUC::$isInsideEditor == true)
			self::$arrWidgetScripts[$handle] = $urlScript;
		else
			UniteProviderFunctionsUC::addScript($handle, $urlScript, $inFooter);

}

/**
	 * add remote script
	 */
	public static function addRemoteControlsScript(){

UniteProviderFunctionsUC::addAdminJQueryInclude();
		
		$urlFiltersJS = GlobalsUC::$url_assets_libraries . "remote/ue-remote-controls.js";
		HelperUC::addScriptAbsoluteUrl($urlFiltersJS, "ue_remote_controls");

$isDebug = HelperUC::hasPermissionsFromQuery("ucremotedebug");
		
		//check if hide remote errors or not
		
		$isErrorsToAdmins = HelperProviderCoreUC_EL::getGeneralSetting("remote_error_admins");
		$isErrorsToAdmins = UniteFunctionsUC::strToBool($isErrorsToAdmins);
		
		$isHideErrors = false;
		
		if($isErrorsToAdmins == true){
			
			$hasPermissions = UniteFunctionsWPUC::isCurrentUserHasPermissions();
			
			//show only to regular users, not to admins
			
			$isHideErrors = ($hasPermissions == false);
		}
		
		if($isDebug == true)
			HelperUC::putCustomScript("var ucRemoteDebugEnabled=true;", false, "remote_controls_debug");
		
		if($isHideErrors == true)
			HelperUC::putCustomScript("var g_ucRemoteHideErrors=true;", false, "remote_controls_hide_errors");
		
	}

/**
	 * put script html, if the handle didn't used
	 */
	public static function putScriptHtml($url, $handle = null){
		
		if(empty($handle))
			$handle = self::convertTitleToHandle($url);
		
		if($handle == "jquery"){
			$isJQueryInPage = wp_script_is( 'jquery', 'enqueued' );
			if($isJQueryInPage == true){
				self::$arrUsedHTMLHandles[$handle] = true;
				return(false);
			}
		}
		
		
		if($handle != "jquery")
			$handle = "ue_js_{$handle}";
		
		if(isset(self::$arrUsedHTMLHandles[$handle]))
			return(false);	
		
		self::$arrUsedHTMLHandles[$handle] = true;
		
		$htmlInclude = HelperHtmlUC::getHtmlJsInclude($url, $handle);
		
		echo $htmlInclude."\n";		
	}
	
	
	/**
	 * put style html, if the handle didn't used
	 */
	public static function putStyleHtml($url, $handle = null){
		
		if(empty($handle))
			$handle = self::convertTitleToHandle($url);
		
		$handle = "ue_css_{$handle}";
		
		if(isset(self::$arrUsedHTMLHandles[$handle]))
			return(false);	
		
		self::$arrUsedHTMLHandles[$handle] = true;
		
		$htmlInclude = HelperHtmlUC::getHtmlCssInclude($url, $handle);
		
		echo $htmlInclude."\n";
		
	}
	
	
	/**
	 *
	 * register style helper function
	 *
	 * @param $styleFilename
	 */
	public static function addStyle($styleName, $handle = null, $folder = "css"){

if($handle == null)
			$handle = GlobalsUC::PLUGIN_NAME . "-" . $styleName;

UniteProviderFunctionsUC::addStyle($handle, GlobalsUC::$urlPlugin . $folder . "/" . $styleName . ".css");
	}

/**
	 * print custom script
	 */
	public static function putCustomScript($script, $hardCoded = false, $putOnceHandle = null){

UniteProviderFunctionsUC::printCustomScript($script, $hardCoded, false, $putOnceHandle, true);
	}

/**
	 * put inline style
	 */
	public static function putInlineStyle($css){

//prevent duplicates
		if(empty($css))
			return (false);

//allow print style only once
		$hash = md5($css);
		if(isset(self::$arrHashCache[$hash]))
			return (false);
		self::$arrHashCache[$hash] = true;

UniteProviderFunctionsUC::printCustomStyle($css);
	}

/**
	 *
	 * register style absolute url helper function
	 */
	public static function addStyleAbsoluteUrl($styleUrl, $handle, $deps = array()){

UniteProviderFunctionsUC::addStyle($handle, $styleUrl, $deps);
	}

/**
	 * output system message
	 */
	public static function outputNote($message){

$message = esc_html($message);

$message = "system note: <b>&nbsp;&nbsp;&nbsp;&nbsp;" . $message . "</b>";

?>
		<div class='unite-note'><?php
			echo esc_html($message) ?></div>;
		<?php
	}

/**
	 * output addon from storred data
	 */
	public static function outputAddonFromData($data){

$addons = new UniteCreatorAddons();
		$objAddon = $addons->initAddonByData($data);

$objOutput = new UniteCreatorOutput();
		$objOutput->initByAddon($objAddon);
		$html = $objOutput->getHtmlBody();
		$objOutput->processIncludes();

uelm_echo($html);
	}

/**
	 * get error message html
	 */
	public static function getHtmlErrorMessage($message, $trace = "", $prefix = null){

if(empty($prefix))
			$prefix = HelperUC::getText("addon_library") . " Error: ";

$message = $prefix . $message;

$html = self::$operations->getErrorMessageHtml($message, $trace);

return ($html);
	}

public static function a______ASSETS_PATH______(){
	}

/**
	 * get assets path
	 */
	public static function getAssetsPath($objAddonType = null){

if(empty($objAddonType))
			return (GlobalsUC::$pathAssets);

if(!empty($objAddonType->pathAssets))
			return ($objAddonType->pathAssets);

return (GlobalsUC::$pathAssets);
	}

/**
	 * get assets url according addons type
	 */
	public static function getAssetsUrl($objAddonType = null){

if(empty($objAddonType))
			return (GlobalsUC::$url_assets);

if(!empty($objAddonType->urlAssets))
			return ($objAddonType->urlAssets);

return (GlobalsUC::$url_assets);
	}

/**
	 * validate that path located under assets folder
	 */
	public static function validatePathUnderAssets($path, $objAddonType = null){

$isUnderAssets = self::isPathUnderAssetsPath($path, $objAddonType);
		if(!$isUnderAssets)
			UniteFunctionsUC::throwError("The path should be under assets folder");
	}

/**
	 * validate db tables exists
	 */
	public static function validateDBTablesExists(){

$db = self::getDB();

if($db->isTableExists(GlobalsUC::$table_categories . "," . GlobalsUC::$table_addons) == false)
			UniteFunctionsUC::throwError("Some DB table not exists");
	}

/**
	 * return true if some path under base path
	 */
	public static function isPathUnderAssetsPath($path, $objAddonType = null){

$assetsPath = self::getAssetsPath($objAddonType);

$path = self::pathToAbsolute($path);

$assetsPath = self::pathToAbsolute($assetsPath);

$isUnderAssets = UniteFunctionsUC::isPathUnderBase($path, $assetsPath);

return ($isUnderAssets);
	}

/**
	 * is url under assets
	 */
	public static function isUrlUnderAssets($url, $objAddonType = null){

$urlAssets = self::getAssetsUrl($objAddonType);

$url = self::URLtoFull($url);
		$url = strtolower($url);
		if(strpos($url, $urlAssets) !== false)
			return (true);

return (false);
	}

/**
	 * check if some path is assets path
	 */
	public static function isPathAssets($path, $objAddonType = null){

$assetsPath = self::getAssetsPath($objAddonType);

$assetsPath = self::pathToAbsolute($assetsPath);

$path = self::pathToAbsolute($path);

if(!empty($path) && $path === $assetsPath)
			return (true);

return (false);
	}

/**
	 * convert path to assets relative path
	 */
	public static function pathToAssetsRelative($path, $objAddonType = null){

$assetsPath = self::getAssetsPath($objAddonType);

$assetsPath = self::pathToAbsolute($assetsPath);

$path = self::pathToAbsolute($path);

$relativePath = UniteFunctionsUC::pathToRelative($path, $assetsPath);

return ($relativePath);
	}

/**
	 * path to assets absolute
	 *
	 * @param $path
	 */
	public static function pathToAssetsAbsolute($path, $objAddonType = null){

if(self::isPathUnderAssetsPath($path, $objAddonType) == true)
			return ($path);

$assetsPath = self::getAssetsPath($objAddonType);
		$path = UniteFunctionsUC::joinPaths($assetsPath, $path);

return ($path);
	}

public static function a______OUTPUT_LAYOUT______(){
	}

/**
	 * get default preview image by type
	 */
	public static function getDefaultPreviewImage($typeName){

$filenameDefaultPreview = "preview_$typeName.jpg";
		$urlPreview = GlobalsUC::$urlPlugin . "images/" . $filenameDefaultPreview;

return ($urlPreview);
	}

/**
	 * check if elementor pro active
	 */
	public static function isElementorProActive(){

if(defined("ELEMENTOR_PRO_VERSION"))
			return (true);

return (false);
	}

/**
	 * check if elementor edit mode
	 */
	public static function isElementorEditMode(){

if(isset($_GET["elementor-preview"]))
			return (true);

$argPost = UniteFunctionsUC::getPostGetVariable("post", "", UniteFunctionsUC::SANITIZE_KEY);
		$argAction = UniteFunctionsUC::getPostGetVariable("action", "", UniteFunctionsUC::SANITIZE_KEY);
		
		if($argAction == "elementor_render_widget" || $argAction == "elementor_ajax" || $argAction == "unlimitedelements_ajax_action")
			return (true);

if(!empty($argPost) && !empty($argAction))
			return (true);

return (false);
	}
	
	/**
	 * check if inside some ajax action
	 * if empty parameter - return true if it's under ajax action.
	 */
	public static function isAjaxAction($actionVar = "",$actionVar2 = ""){
		
		if(is_admin() == false)
			return(false);
		
		$action = UniteFunctionsUC::getPostGetVariable("action", "", UniteFunctionsUC::SANITIZE_KEY);
		if($action != "unlimitedelements_ajax_action")
			return(false);
		
		if(empty($actionVar) && empty($actionVar2))
			return(true);
			
		$clientAction = UniteFunctionsUC::getPostGetVariable("client_action", "", UniteFunctionsUC::SANITIZE_KEY); 
		
		if($actionVar === $clientAction)
			return(true);
		
		if(!empty($actionVar2) && $actionVar2 === $clientAction)
			return(true);
		
		return(false);
	}
	
	
	/**
	 * check if gutenberg edit mode
	 */
	public static function isGutenbergEditMode(){

if(function_exists("get_current_screen") === false)
			return false;
		
		$screen = get_current_screen();

if($screen === null)
			return false;
		
		$isBlockEditor = $screen->is_block_editor();
		
		return $isBlockEditor;
	}
	
	
	/**
	 * check if edit mode
	 */
	public static function isEditMode(){

return self::isElementorEditMode() || self::isGutenbergEditMode();
	}

/**
	 * start buffering widget output
	 */
	public static function startBufferingWidgetsOutput(){

UniteCreatorOutput::$isBufferingCssActive = true;
	}

/**
	 * output widgets css buffer
	 */
	public static function outputWidgetsCssBuffer(){

$htmlCssIncludes = UniteCreatorOutput::$bufferCssIncludes;

echo "\n";
		uelm_echo($htmlCssIncludes);

$css = UniteCreatorOutput::$bufferBodyCss;
		if(!empty($css)){
			echo "\n<style type='text/css'> \n";
			echo "\n/* Unlimited Elements Css */ \n\n";
			uelm_echo($css . "\n");
			echo "</style>\n";
		}

//clear the buffer
		UniteCreatorOutput::$bufferCssIncludes = "";
		UniteCreatorOutput::$bufferBodyCss = "";
	}

/**
	 * output template part
	 */
	public static function outputTemplatePart($layoutType){

try{
			$objLayouts = new UniteCreatorLayouts();
			$objLayout = $objLayouts->getActiveTempaltePart($layoutType);
		}catch(Exception $e){
			HelperHtmlUC::outputException($e);

return (false);
		}

if(empty($objLayout)){
			$typeTitle = $objLayouts->getLayoutTypeTitle($layoutType);
			$message = esc_html__("Template part", "unlimited-elements-for-elementor") . ": " . $typeTitle . esc_html__(" not found. Please create one in template parts page", "unlimited-elements-for-elementor");
			$html = HelperHtmlUC::getErrorMessageHtml($message);
			uelm_echo($html);

return (false);
		}

self::outputLayout($objLayout);
	}

/**
	 * output layout
	 */
	public static function outputLayout($layoutID, $getHtml = false, $outputFullPage = false, $mode = null){

try{
			if(is_numeric($layoutID)){
				$layoutID = UniteProviderFunctionsUC::sanitizeVar($layoutID, UniteFunctionsUC::SANITIZE_ID);

$layout = new UniteCreatorLayout();
				$layout->initByID($layoutID);
			}else
				$layout = $layoutID;    //if object passed

$outputLayout = new UniteCreatorLayoutOutput();
			$outputLayout->initByLayout($layout);

if(!empty($mode))
				$outputLayout->setOutputMode($mode);

if($getHtml == true){
				if($outputFullPage == false)
					$html = $outputLayout->getHtml();
				else
					$html = $outputLayout->getFullPreviewHtml();

return ($html);
			}

if($outputFullPage == false)
				$outputLayout->putHtml();
			else
				$outputLayout->putFullPreviewHtml();

return ($outputLayout);
		}catch(Exception $e){
			if($getHtml == true){
				throw $e;
			}else
				HelperHtmlUC::outputExceptionBox($e, HelperUC::getText("addon_library") . " Error");
		}
	}
		
	/**
	 * get active plugin versions
	 */
	public static function getActivePluginVersions() {
		
		$showDebug = false;
		
		$flagElementor = false;
		$flagGutenberg = false;

if(defined("UE_ENABLE_ELEMENTOR_SUPPORT"))
			$flagElementor = true;

if(defined("UE_ENABLE_GUTENBERG_SUPPORT"))
			$flagGutenberg = true;
		
		//some protection
		if($flagGutenberg == false)
			$flagElementor = true;
		
		$output = array();
		$output[GlobalsUC::VERSION_GUTENBERG] = $flagGutenberg;
		$output[GlobalsUC::VERSION_ELEMENTOR] = $flagElementor;
		
		if($showDebug == true){
			dmp($output);
			exit();
		}
		
		return $output;
	}

/**
	 * some test function for auto completion. keep empty
	 */
	public static function testFunc(){

}

//init the operations
HelperUC::$operations = new UCOperations();