<?php
/**
 * @package   Essential_Grid
 * @author    ThemePunch <info@themepunch.com>
 * @link      https://www.essential-grid.com/
 * @copyright 2025 ThemePunch
 */

if (!defined('ABSPATH')) exit();

class Essential_Grid_Base
{
	/**
	 * @return mixed
	 */
	public static function getValid() {
		return get_option('tp_eg_valid', 'false');
	}
	
	/**
	 * @param string $status  can be true or false
	 * @return bool
	 */
	public static function setValid($status) {
		if (!in_array($status, ['true', 'false'])) $status = 'false';
		return update_option('tp_eg_valid', $status);
	}

	/**
	 * @return bool
	 */
	public static function isValid() {
		return get_option('tp_eg_valid', 'false') === 'true';
	}

	/**
	 * @return mixed
	 */
	public static function getValidNotice() {
		return get_option('tp_eg_valid-notice', 'true');
	}

	/**
	 * @param string $status  can be true or false
	 * @return bool
	 */
	public static function setValidNotice($status) {
		if (!in_array($status, ['true', 'false'])) $status = 'false';
		return update_option('tp_eg_valid-notice', $status);
	}
	
	/**
	 * @return mixed
	 */
	public static function getCode() {
		return get_option('tp_eg_code', '');
	}

	/**
	 * @param string $code
	 * @return bool
	 */
	public static function setCode($code) {
		return update_option('tp_eg_code', $code);
	}

	/**
	 * @return string
	 */
	public static function getLatestVersion() {
		return get_option('tp_eg_latest-version', ESG_REVISION);
	}

	/**
	 * @param string $value
	 * @return bool
	 */
	public static function setLatestVersion($value) {
		return update_option('tp_eg_latest-version', $value);
	}
	
	/**
	 * @return array
	 */
	public static function getExcludePostTypes() {
		$exclude_post_types = get_option('tp_eg_exclude_post_types', '');
		if (!empty($exclude_post_types)) $exclude_post_types = explode(',', $exclude_post_types); else $exclude_post_types = [];
		
		return $exclude_post_types;
	}

	/**
	 * @param string|array $post_types
	 * @return bool
	 */
	public static function setExcludePostTypes($post_types) {
		if (is_array($post_types)) $post_types = implode(',', $post_types);
		return update_option('tp_eg_exclude_post_types', $post_types);
	}

	/**
	 * validate if passed value is 'true' or 'false' string
	 * 
	 * @param mixed $v
	 * @param string $default
	 * @return string
	 */
	public static function validateTrueFalse($v, $default = 'false') {
		if ($default != 'true' && $default != 'false') $default = 'false';
		if ($v != 'true' && $v != 'false') $v = $default;
		return $v;
	}

	/**
	 * @return string
	 */
	public static function getUseCache() {
		$cache = apply_filters('essgrid_caching', get_option('tp_eg_use_cache', 'false'));
		return self::validateTrueFalse($cache);
	}

	/**
	 * @return bool
	 */
	public static function isUseCache() {
		return self::getUseCache() === 'true';
	}
	
	/**
	 * @return string
	 */
	public static function getCpt($default = 'false') {
		$cpt = apply_filters('essgrid_set_cpt', get_option('tp_eg_enable_custom_post_type', $default));
		return self::validateTrueFalse($cpt, $default);
	}

	/**
	 * @return string
	 */
	public static function getPostDateOption() {
		return get_option('tp_eg_post_date', 'post_date_gmt');
	}
	
	/**
	 * @param array|object $post
	 * @param string $format
	 * @return string
	 */
	public static function getPostDate( $post, $format = '' ) {
		$dateField = self::getPostDateOption();
		
		switch ($dateField) {
			case 'post_date':
				$date = self::getVar( $post, $dateField );
				if ( !empty( $format ) ) {
					$date = date_i18n( $format, strtotime( $date ) );
				}
				break;
				
			case 'post_date_gmt':
			default:
				$date = get_date_from_gmt( self::getVar( $post, $dateField ) );
				if ( !empty( $format ) ) {
					$date = gmdate( $format, strtotime( $date ) );
				}
		}
		
		return $date;
	}

	/**
	 * @return mixed
	 */
	public static function getJsToFooter() {
		return apply_filters( 'essgrid_get_js_to_footer', get_option( 'tp_eg_js_to_footer', 'false' ) );
	}

	/**
	 * @param string $status  can be true or false
	 * @return bool
	 */
	public static function setJsToFooter($status) {
		if (!in_array($status, ['true', 'false'])) $status = 'false';
		return update_option('tp_eg_js_to_footer', $status);
	}

	/**
	 * @return bool
	 */
	public static function isJsToFooter() {
		return self::getJsToFooter() === 'true';
	}

	/**
	 * Get REQUEST Parameter
	 *
	 * @param string $key
	 * @param string $default
	 * @param string $type
	 * @return mixed
	 */
	public static function getRequestVar($key, $default = '', $type = '') {
		// phpcs:ignore WordPress.Security.NonceVerification.Recommended, WordPress.Security.NonceVerification.Missing -- wp_nonce is not required here
		$source = (array_key_exists($key, $_POST)) ? $_POST : $_GET;
		return self::getVar($source, $key, $default, $type);
	}

	/**
	 * Get $_GET Parameter
	 *
	 * @param string $key
	 * @param string $default
	 * @param string $type
	 * @return mixed
	 */
	public static function getGetVar($key, $default = "", $type = "") {
		// phpcs:ignore WordPress.Security.NonceVerification.Recommended -- wp_nonce is not required here
		$val = self::getVar($_GET, $key, $default, $type);
		return apply_filters('essgrid_getGetVar', $val, $key, $default, $type);
	}

	/**
	 * Get $_POST Parameter
	 *
	 * @param string $key
	 * @param string $default
	 * @param string $type
	 * @return mixed
	 */
	public static function getPostVar($key, $default = "", $type = "") {
		// phpcs:ignore WordPress.Security.NonceVerification.Missing -- wp_nonce is not required here
		$val = self::getVar($_POST, $key, $default, $type);
		return apply_filters('essgrid_getPostVar', $val, $key, $default, $type);
	}
	
	public static function varToType($val, $type = '') {
		//scalar = int, float, string и bool
		if(!is_scalar($val)) return esg_stripslashes_deep( $val );
		
		switch ($type) {
			case 'i': //int
				$val = intval($val);
				break;
			case 'f': //float
				$val = floatval($val);
				break;
			case 'r': //raw meaning, do nothing
				break;
			default:
				$val = esg_stripslashes_deep( $val );
				break;
		}
		
		return $val;
	}

	public static function getVar($arr, $key, $default = '', $type = '') {
		//scalar = int, float, string и bool
		if(is_scalar($arr)) return $default;
		//convert obj to array 
		if(is_object($arr)) $arr = (array)$arr;
		//if key is string, check immediately 
		if(!is_array($key)) {
			$val = (isset($arr[$key])) ? $arr[$key] : $default;
			return self::varToType($val, $type);
		}
		
		//loop through keys
		foreach($key as $v){
			if(is_object($arr)) $arr = (array)$arr;
			if(isset($arr[$v])) {
				$arr = $arr[$v];
			} else {
				return $default;
			}
		}
		
		return self::varToType($arr, $type);
	}

	public static function varToBool($v) {
		if($v === 'false' || $v === false || $v === 'off' || $v ===	NULL || $v === 0 || $v === -1){
			$v = false;
		}elseif($v === 'true' || $v === true || $v === 'on'){
			$v = true;
		}

		return $v;
	}

	/**
	 * get text intro, limit by number of words
	 */
	public static function get_text_intro($text, $limit, $type = 'words')
	{
		$intro = $text;
		if ( !empty( $text ) ) {
			if ($type == 'words') {
				$arrIntro = explode(' ', $text);
				if (count($arrIntro) > $limit) {
					$arrIntro = array_slice($arrIntro, 0, $limit);
					$intro = trim(implode(" ", $arrIntro));
					if (!empty($intro))
						$intro .= '...';
				} else {
					$intro = implode(" ", $arrIntro);
				}
			} elseif ($type == 'chars') {
				$text = wp_strip_all_tags($text);
				$intro = mb_substr($text, 0, $limit, 'utf-8');
				if (strlen($text) > $limit) $intro .= '...';
			} elseif ($type == 'sentence') {
				$text = wp_strip_all_tags($text);
				$intro = esg_bac_variable_length_excerpt($text, $limit);
			}
		}
		
		if ( !empty( $intro ) ) {
			$intro = preg_replace( '`\[[^\]]*\]`', '', $intro );
		}

		return apply_filters('essgrid_get_text_intro', $intro, $text, $limit, $type);
	}

	/**
	 * Get all images sizes + custom added sizes
	 * since: 1.0.2
	 */
	public function get_all_image_sizes() {
		$custom_sizes = [];
		$added_image_sizes = get_intermediate_image_sizes();
		if (!empty($added_image_sizes) && is_array($added_image_sizes)) {
			foreach ($added_image_sizes as $img_size_handle) {
				$custom_sizes[$img_size_handle] = ucwords(str_replace('_', ' ', $img_size_handle));
			}
		}
		$img_orig_sources = [
			'full' => esc_attr__('Original Size', 'essential-grid'),
			'thumbnail' => esc_attr__('Thumbnail', 'essential-grid'),
			'medium' => esc_attr__('Medium', 'essential-grid'),
			'large' => esc_attr__('Large', 'essential-grid')
		];

		return apply_filters('essgrid_get_all_image_sizes', array_merge($img_orig_sources, $custom_sizes));
	}

	/**
	 * Create Multilanguage for JavaScript
	 */
	public static function get_javascript_multilanguage() {
		$lang = [
			'aj_please_wait' => esc_attr__('Please wait...', 'essential-grid'),
			'aj_ajax_error' => esc_attr__('Ajax Error!!!', 'essential-grid'),
			'aj_success_must' => esc_attr__('The \'success\' param is a must!', 'essential-grid'),
			'aj_error_not_found' => esc_attr__('Ajax Error! Action not found!', 'essential-grid'),
			'aj_empty_response' => esc_attr__('Empty ajax response!', 'essential-grid'),
			'aj_wrong_alias' => esc_attr__('Wrong ajax alias!', 'essential-grid'),
			'delete_item_skin' => esc_attr__('Really delete choosen Item Skin?', 'essential-grid'),
			'delete_grid' => esc_attr__('Really delete the Grid?', 'essential-grid'),
			'choose_image' => esc_attr__('Choose Image', 'essential-grid'),
			'select_choose' => esc_attr__('--- choose ---', 'essential-grid'),
			'new_element' => esc_attr__('New Element', 'essential-grid'),
			'bottom_on_hover' => esc_attr__('Bottom on Hover', 'essential-grid'),
			'top_on_hover' => esc_attr__('Top on Hover', 'essential-grid'),
			'hidden' => esc_attr__('Hidden', 'essential-grid'),
			'full_price' => esc_attr__('$99 $999', 'essential-grid'),
			'regular_price' => esc_attr__('$99', 'essential-grid'),
			'regular_price_no_cur' => esc_attr__('99', 'essential-grid'),
			'top' => esc_attr__('Top', 'essential-grid'),
			'right' => esc_attr__('Right', 'essential-grid'),
			'bottom' => esc_attr__('Bottom', 'essential-grid'),
			'left' => esc_attr__('Left', 'essential-grid'),
			'hide' => esc_attr__('Hide', 'essential-grid'),
			'single' => esc_attr__('Add Single Image', 'essential-grid'),
			'bulk' => esc_attr__('Add Bulk Images', 'essential-grid'),
			'choose_images' => esc_attr__('Choose Images', 'essential-grid'),
			'import_demo_post_heavy_loading' => esc_attr__('The following demo data will be imported: Ess. Grid Posts, Custom Meta, PunchFonts. This can take a while, please do not leave the site until the import is finished', 'essential-grid'),
			'import_demo_grids_210' => esc_attr__('The following demo data will be imported: Grids of the 2.1.0 update. This can take a while, please do not leave the site until the import is finished', 'essential-grid'),
			'save_settings' => esc_attr__('Save Settings', 'essential-grid'),
			'add_element' => esc_attr__('Add Element', 'essential-grid'),
			'edit_element' => esc_attr__('Edit Element', 'essential-grid'),
			'update_element' => esc_attr__('Update without Refresh', 'essential-grid'),
			'update_element_refresh' => esc_attr__('Update & Refresh Grid', 'essential-grid'),
			'globalcoloractive' => esc_attr__('Color Skin Active', 'essential-grid'),
			'editskins' => esc_attr__('Edit Skins', 'essential-grid'),
			'remove_this_element' => esc_attr__('Really remove this element?', 'essential-grid'),
			'choose_skins' => esc_attr__('Choose Skins', 'essential-grid'),
			'add_selected' => esc_attr__('Add Selected', 'essential-grid'),
			'deleting_nav_skin_message' => esc_attr__('Deleting a Navigation Skin may result in missing Skins in other Grids. Proceed?', 'essential-grid'),
			'add_meta' => esc_attr__('Add Meta', 'essential-grid'),
			'backtooverview' => esc_attr__('Back to Overview', 'essential-grid'),
			'openimportdgrid' => esc_attr__('Open Imported Grid', 'essential-grid'),
			'add_widget_area' => esc_attr__('Add Widget Area', 'essential-grid'),
			'add_font' => esc_attr__('Add Google Font', 'essential-grid'),
			'save_post_meta' => esc_attr__('Save Post Meta', 'essential-grid'),
			'really_change_widget_area_name' => esc_attr__('Are you sure the change the Widget Area name?', 'essential-grid'),
			'really_delete_widget_area' => esc_attr__('Really delete this Widget Area? This can\'t be undone and if may affect existing Posts/Pages that use this Widget Area.', 'essential-grid'),
			'really_delete_meta' => esc_attr__('Really delete this meta? This can\'t be undone.', 'essential-grid'),
			'really_change_meta_effects' => esc_attr__('If you change this settings, it may affect current Posts that use this meta, proceed?', 'essential-grid'),
			'really_change_font_effects' => esc_attr__('If you change this settings, it may affect current Posts that use this Font, proceed?', 'essential-grid'),
			'handle_and_name_at_least_3' => esc_attr__('The handle and name has to be at least three characters long!', 'essential-grid'),
			'handle_already_exists' => esc_attr__('Handle already exists!', 'essential-grid'),
			'layout_settings' => esc_attr__('Layout Settings', 'essential-grid'),
			'close' => esc_attr__('Close', 'essential-grid'),
			'reset_nav_skin' => esc_attr__('Reset from Template', 'essential-grid'),
			'create_nav_skin' => esc_attr__('Create Navigation Skin', 'essential-grid'),
			'save_nav_skin' => esc_attr__('Save Navigation Skin', 'essential-grid'),
			'apply_changes' => esc_attr__('Save Changes', 'essential-grid'),
			'new_element_sanitize' => esc_attr__('new-element', 'essential-grid'),
			'really_delete_element_permanently' => esc_attr__('This will delete this element permanently, really proceed?', 'essential-grid'),
			'element_name_exists_do_overwrite' => esc_attr__('Element with chosen name already exists. Really overwrite the Element?', 'essential-grid'),
			'element_was_not_changed' => esc_attr__('Element was not created/changed', 'essential-grid'),
			'not_selected' => esc_attr__('Not Selected', 'essential-grid'),
			'class_name' => esc_attr__('Class:', 'essential-grid'),
			'class_name_short' => esc_attr__('Class', 'essential-grid'),
			'save_changes' => esc_attr__('Save Changes', 'essential-grid'),
			'add_category' => esc_attr__('Add Category', 'essential-grid'),
			'category_already_exists' => esc_attr__('The Category existing already.', 'essential-grid'),
			'edit_category' => esc_attr__('Edit Category', 'essential-grid'),
			'update_category' => esc_attr__('Update Category', 'essential-grid'),
			'delete_category' => esc_attr__('Delete Category', 'essential-grid'),
			'select_skin' => esc_attr__('Select Skin Template', 'essential-grid'),
			'enter_position' => esc_attr__('Enter a Position', 'essential-grid'),
			'leave_not_saved' => esc_attr__('By leaving now, all changes since the last saving will be lost. Really leave now?', 'essential-grid'),
			'please_enter_unique_item_name' => esc_attr__('Please enter a unique item name', 'essential-grid'),
			'fontello_icons' => esc_attr__('Choose Icon', 'essential-grid'),
			'please_enter_unique_element_name' => esc_attr__('Please enter a unique element name', 'essential-grid'),
			'please_enter_unique_skin_name' => esc_attr__('Please enter a unique Navigation Skin name', 'essential-grid'),
			'item_name_too_short' => esc_attr__('Item name too short', 'essential-grid'),
			'skin_name_too_short' => esc_attr__('Navigation Skin name too short', 'essential-grid'),
			'skin_name_already_registered' => esc_attr__('Navigation Skin with choosen name already exists, please choose a different name', 'essential-grid'),
			'withvimeo' => esc_attr__('Vimeo', 'essential-grid'),
			'withyoutube' => esc_attr__('YouTube', 'essential-grid'),
			'withwistia' => esc_attr__('Wistia', 'essential-grid'),
			'withimage' => esc_attr__('Image', 'essential-grid'),
			'withthtml5' => esc_attr__('HTML5 Video', 'essential-grid'),
			'withsoundcloud' => esc_attr__('SoundCloud', 'essential-grid'),
			'withoutmedia' => esc_attr__('Without Media', 'essential-grid'),
			'withblank' => esc_attr__('Blank Item', 'essential-grid'),
			'selectyouritem' => esc_attr__('Select Your Item', 'essential-grid'),
			'add_at_least_one_element' => esc_attr__('Please add at least one element in Custom Grid mode', 'essential-grid'),
			'dontforget_title' => esc_attr__('Please set a Title for the Grid', 'essential-grid'),
			'dontforget_alias' => esc_attr__('Please set an Alias for the Grid', 'essential-grid'),
			'script_will_try_to_load_last_working' => esc_attr__('Ess. Grid will now try to go to the last working version of this grid', 'essential-grid'),
			'save_rules' => esc_attr__('Save Rules', 'essential-grid'),
			'discard_changes' => esc_attr__('Discard Changes', 'essential-grid'),
			'really_discard_changes' => esc_attr__('Really discard changes?', 'essential-grid'),
			'reset_fields' => esc_attr__('Reset Fields', 'essential-grid'),
			'really_reset_fields' => esc_attr__('Really reset fields?', 'essential-grid'),
			'meta_val' => esc_attr__('(Meta)', 'essential-grid'),
			'deleting_this_cant_be_undone' => esc_attr__('Deleting this can\'t be undone, continue?', 'essential-grid'),
			'shortcode' => esc_attr__('ShortCode', 'essential-grid'),
			'filter' => esc_attr__('Filter', 'essential-grid'),
			'skin' => esc_attr__('Skin', 'essential-grid'),
			'custom_filter' => esc_attr__('--- Custom Filter ---', 'essential-grid'),
			'delete_this_element' => esc_attr__('Are you sure you want to delete this element?', 'essential-grid'),
			'editnavinfo' => esc_attr__('Edit the selected navigation skin style', 'essential-grid'),
			'editnavinfodep' => esc_attr__('Nav. Skin deprecated. Edit or reset from template!', 'essential-grid'),
			'select_skin_template' => esc_attr__('Select Navigation Template', 'essential-grid'),
			'pagination_autoplay_notice' => esc_attr__('Autoplay allowed only with Pagination or Navigation Arrows!', 'essential-grid'),
			'select_items_export' => esc_attr__('Please select item(s) to export!', 'essential-grid'),
			'select' => esc_attr__('Select ', 'essential-grid'),
			'unselect' => esc_attr__('Unselect ', 'essential-grid'),
			'show' => esc_attr__('Show', 'essential-grid'),
			'per_page' => esc_attr__('per page', 'essential-grid'),
			'cannotbeundone' => esc_attr__('This action can not be undone !!', 'essential-grid'),
			'grids' => esc_attr__('grid(s)', 'essential-grid'),
			'withselectedgrids' => esc_attr__('With "0" selected...', 'essential-grid'),
			'selectgrids' => esc_attr__('Please select at least one grid', 'essential-grid'),
			'deletegrid' => esc_attr__('Delete Grid(s)', 'essential-grid'),
			'areyousuretodelete' => esc_attr__('Are you sure you want to delete ', 'essential-grid'),
			'yesdelete' => esc_attr__('Yes, Delete Grid(s)', 'essential-grid'),
			'cancel' => esc_attr__('Cancel', 'essential-grid'),
			'embedgrid' => esc_attr__('Embed Grid', 'essential-grid'),
			'copy' => esc_attr__('Copy', 'essential-grid'),
			'copytoclipboard' => esc_attr__('Click on button below to copy shortcode to clipboard', 'essential-grid'),
			'shortcodecopied' => esc_attr__('Shortcode copied to clipboard', 'essential-grid'),
			'update' => __('Update', 'essential-grid'),
			'updateplugin' => __('Update Plugin', 'essential-grid'),
			'areyousureupdateplugin' => __('Do you want to start the Update process?', 'essential-grid'),
			'updatingtakes' => __('Updating the Plugin may take a few moments.', 'essential-grid'),
			'tryagainlater' => __('Please try again later', 'essential-grid'),
			'updatepluginfailure' => __('Essential Grid Plugin updated Failure:', 'essential-grid'),
			'updatepluginfailed' => __('Updating Plugin Failed', 'essential-grid'),
			'updatepluginsuccesssubtext' => __('Essential Grid Plugin updated Successfully to', 'essential-grid'),
			'reloadpage' => __('Reload Page', 'essential-grid'),
			'reLoading' => __('Page is reloading...', 'essential-grid'),
			'licenseissue' => __('License validation issue Occured. Please contact our Support.', 'essential-grid'),
			'leave' => __('Back to Overview', 'essential-grid'),
			'blank_page_added' => __('Blank Page Created', 'essential-grid'),
			'blank_page_created' => __('Blank page has been created:', 'essential-grid'),
			'visit_page' => __('Visit Page', 'essential-grid'),
			'edit_page' => __('Edit Page', 'essential-grid'),
			'closeandstay' => __('Close', 'essential-grid'),
			/* ADDONS */
			'addon' => esc_attr__('Add-On', 'essential-grid'),
			'installingaddon' => esc_attr__('Installing Add-On', 'essential-grid'),
			'updatingaddon' => esc_attr__('Updating Add-On', 'essential-grid'),
			'enableaddon' => esc_attr__('Enable Add-On', 'essential-grid'),
			'enablingaddon' => esc_attr__('Enabling Add-On', 'essential-grid'),
			'disableaddon' => esc_attr__('Disable Add-On', 'essential-grid'),
			'disablingaddon' => esc_attr__('Disabling Add-On', 'essential-grid'),
			'activateaddon' => esc_attr__('Activate Add-On', 'essential-grid'),
			'activatingaddon' => esc_attr__('Activating Add-On', 'essential-grid'),
			'enableglobaladdon' => esc_attr__('Enable Global Add-On', 'essential-grid'),
			'disableglobaladdon' => esc_attr__('Disable Global Add-On', 'essential-grid'),
			'activateglobaladdon' => esc_attr__('Activate Global Add-On', 'essential-grid'),
			'err_slug_missing' => esc_attr__('Add-On slug is missing!', 'essential-grid'),
			'fix' => esc_attr__('Fix', 'essential-grid'),
			'fix_addons_title_missing_desc' => esc_attr__('These Essential Grid addons are deactivated or not installed:', 'essential-grid'),
			'fix_addons_title_updated_desc' => esc_attr__('These Essential Grid addons require updating:', 'essential-grid'),
			'fix_addons_missing_desc' => esc_attr__('Press the button below to install & activate all required addons', 'essential-grid'),
			'fix_addons_updated_desc' => esc_attr__('Press the button below to update all required addons', 'essential-grid'),
			/* LIBRARY */
			'library_install_grid' => esc_attr__('Install Grid', 'essential-grid'),
			'library_install_grid_addons' => esc_attr__('Install Grid & Addon(s)', 'essential-grid'),
			/* SHORTCODE */
			'essential_grid_shortcode_creator' => esc_attr__('Essential Grid Shortcode Creator', 'essential-grid'),
			'shortcode_generator' => esc_attr__('Shortcode Creator', 'essential-grid'),
			'no_pregrid_selected' => esc_attr__('No Predefined Essential Grid has been selected !', 'essential-grid'),
			'insert_shortcode' => esc_attr__('Insert / Update', 'essential-grid'),
			'read_shortcode' => esc_attr__('Read Shortcode', 'essential-grid'),
			'import_shortcode' => esc_attr__('Import Shortcode', 'essential-grid'),
			'edit_custom_item' => esc_attr__('Edit Custom Item', 'essential-grid'),
			'quickbuilder' => esc_attr__('Quick Builder', 'essential-grid'),
			'please_add_at_least_one_layer' => esc_attr__('Please add at least one Layer.', 'essential-grid'),
			'shortcode_parsing_successfull' => esc_attr__('Shortcode parsing successfull. Items can be found in step 3', 'essential-grid'),
			'shortcode_could_not_be_correctly_parsed' => esc_attr__('Shortcode could not be parsed.', 'essential-grid'),
		];

		return apply_filters('essgrid_get_javascript_multilanguage', $lang);
	}

	/**
	 * get grid animations
	 */
	public static function get_grid_animations()
	{
		$animations = [
			'fade' => esc_attr__('Fade', 'essential-grid'),
			'scale' => esc_attr__('Scale', 'essential-grid'),
			'rotatescale' => esc_attr__('Rotate Scale', 'essential-grid'),
			'fall' => esc_attr__('Fall', 'essential-grid'),
			'rotatefall' => esc_attr__('Rotate Fall', 'essential-grid'),
			'horizontal-slide' => esc_attr__('Horizontal Slide', 'essential-grid'),
			'vertical-slide' => esc_attr__('Vertical Slide', 'essential-grid'),
			'horizontal-flip' => esc_attr__('Horizontal Flip', 'essential-grid'),
			'vertical-flip' => esc_attr__('Vertical Flip', 'essential-grid'),
			'horizontal-flipbook' => esc_attr__('Horizontal Flipbook', 'essential-grid'),
			'vertical-flipbook' => esc_attr__('Vertical Flipbook', 'essential-grid')
		];
		
		return apply_filters('essgrid_get_grid_animations', $animations);
	}

	/**
	 * get grid animations
	 */
	public static function get_start_animations()
	{
		$animations = [
			'none' => esc_attr__('None', 'essential-grid'),
			'reveal' => esc_attr__('Reveal', 'essential-grid'),
			'fade' => esc_attr__('Fade', 'essential-grid'),
			'scale' => esc_attr__('Scale', 'essential-grid'),
			'slideup' => esc_attr__('Slide Up (short)', 'essential-grid'),
			'covergrowup' => esc_attr__('Slide Up (long)', 'essential-grid'),
			'slideleft' => esc_attr__('Slide Left', 'essential-grid'),
			'slidedown' => esc_attr__('Slide Down', 'essential-grid'),
			'flipvertical' => esc_attr__('Flip Vertical', 'essential-grid'),
			'fliphorizontal' => esc_attr__('Flip Horizontal', 'essential-grid'),
			'flipup' => esc_attr__('Flip Up', 'essential-grid'),
			'flipdown' => esc_attr__('Flip Down', 'essential-grid'),
			'flipright' => esc_attr__('Flip Right', 'essential-grid'),
			'flipleft' => esc_attr__('Flip Left', 'essential-grid'),
			'skewleft' => esc_attr__('Skew', 'essential-grid'),
			'zoomin' => esc_attr__('Rotate Zoom', 'essential-grid'),
			'flyleft' => esc_attr__('Fly Left', 'essential-grid'),
			'flyright' => esc_attr__('Fly Right', 'essential-grid')
		];

		return apply_filters('essgrid_get_grid_start_animations', $animations);
	}

	/**
	 * get grid item animations, since 2.1.6.2
	 */
	public static function get_grid_item_animations()
	{
		$animations = [
			'none' => esc_attr__('None', 'essential-grid'),
			'zoomin' => esc_attr__('Zoom In', 'essential-grid'),
			'zoomout' => esc_attr__('Zoom Out', 'essential-grid'),
			'fade' => esc_attr__('Fade Out', 'essential-grid'),
			'blur' => esc_attr__('Blur', 'essential-grid'),
			'shift' => esc_attr__('Shift', 'essential-grid'),
			'rotate' => esc_attr__('Rotate', 'essential-grid')
		];

		return apply_filters('essgrid_get_grid_item_animations', $animations);
	}

	/**
	 * get grid animations
	 */
	public static function get_hover_animations($inout = false)
	{
		if (!$inout) {
			$animations = [
				'none' => esc_attr__(' None', 'essential-grid'),
				'fade' => esc_attr__('Fade', 'essential-grid'),
				'flipvertical' => esc_attr__('Flip Vertical', 'essential-grid'),
				'fliphorizontal' => esc_attr__('Flip Horizontal', 'essential-grid'),
				'flipup' => esc_attr__('Flip Up', 'essential-grid'),
				'flipdown' => esc_attr__('Flip Down', 'essential-grid'),
				'flipright' => esc_attr__('Flip Right', 'essential-grid'),
				'flipleft' => esc_attr__('Flip Left', 'essential-grid'),
				'turn' => esc_attr__('Turn', 'essential-grid'),
				'slide' => esc_attr__('Slide', 'essential-grid'),
				'scaleleft' => esc_attr__('Scale Left', 'essential-grid'),
				'scaleright' => esc_attr__('Scale Right', 'essential-grid'),
				'slideleft' => esc_attr__('Slide Left', 'essential-grid'),
				'slideright' => esc_attr__('Slide Right', 'essential-grid'),
				'slideup' => esc_attr__('Slide Up', 'essential-grid'),
				'slidedown' => esc_attr__('Slide Down', 'essential-grid'),
				'slideshortleft' => esc_attr__('Slide Short Left', 'essential-grid'),
				'slideshortright' => esc_attr__('Slide Short Right', 'essential-grid'),
				'slideshortup' => esc_attr__('Slide Short Up', 'essential-grid'),
				'slideshortdown' => esc_attr__('Slide Short Down', 'essential-grid'),
				'skewleft' => esc_attr__('Skew Left', 'essential-grid'),
				'skewright' => esc_attr__('Skew Right', 'essential-grid'),
				'rollleft' => esc_attr__('Roll Left', 'essential-grid'),
				'rollright' => esc_attr__('Roll Right', 'essential-grid'),
				'falldown' => esc_attr__('Fall Down', 'essential-grid'),
				'rotatescale' => esc_attr__('Rotate Scale', 'essential-grid'),
				'zoomback' => esc_attr__('Zoom from Back', 'essential-grid'),
				'zoomfront' => esc_attr__('Zoom from Front', 'essential-grid'),
				'flyleft' => esc_attr__('Fly Left', 'essential-grid'),
				'flyright' => esc_attr__('Fly Right', 'essential-grid'),
				'covergrowup' => esc_attr__('Cover Grow', 'essential-grid'),
				'collapsevertical' => esc_attr__('Collapse Vertical', 'essential-grid'),
				'collapsehorizontal' => esc_attr__('Collapse Horizontal', 'essential-grid'),
				'linediagonal' => esc_attr__('Line Diagonal', 'essential-grid'),
				'linehorizontal' => esc_attr__('Line Horizontal', 'essential-grid'),
				'linevertical' => esc_attr__('Line Vertical', 'essential-grid'),
				'spiralzoom' => esc_attr__('Spiral Zoom', 'essential-grid'),
				'circlezoom' => esc_attr__('Circle Zoom', 'essential-grid')
			];
		} else {
			$animations = [
				'none' => esc_attr__(' None', 'essential-grid'),
				'fade' => esc_attr__('Fade In', 'essential-grid'),
				'fadeout' => esc_attr__('Fade Out', 'essential-grid'),
				'flipvertical' => esc_attr__('Flip Vertical In', 'essential-grid'),
				'flipverticalout' => esc_attr__('Flip Vertical Out', 'essential-grid'),
				'fliphorizontal' => esc_attr__('Flip Horizontal In', 'essential-grid'),
				'fliphorizontalout' => esc_attr__('Flip Horizontal Out', 'essential-grid'),
				'flipup' => esc_attr__('Flip Up In Out', 'essential-grid'),
				'flipupout' => esc_attr__('Flip Up Out', 'essential-grid'),
				'flipdown' => esc_attr__('Flip Down In', 'essential-grid'),
				'flipdownout' => esc_attr__('Flip Down Out', 'essential-grid'),
				'flipright' => esc_attr__('Flip Right In', 'essential-grid'),
				'fliprightout' => esc_attr__('Flip Right Out', 'essential-grid'),
				'flipleft' => esc_attr__('Flip Left In', 'essential-grid'),
				'flipleftout' => esc_attr__('Flip Left Out', 'essential-grid'),
				'turn' => esc_attr__('Turn In', 'essential-grid'),
				'turnout' => esc_attr__('Turn Out', 'essential-grid'),
				'slideleft' => esc_attr__('Slide Left In', 'essential-grid'),
				'slideleftout' => esc_attr__('Slide Left Out', 'essential-grid'),
				'slideright' => esc_attr__('Slide Right In', 'essential-grid'),
				'sliderightout' => esc_attr__('Slide Right Out', 'essential-grid'),
				'slideup' => esc_attr__('Slide Up In', 'essential-grid'),
				'slideupout' => esc_attr__('Slide Up Out', 'essential-grid'),
				'slidedown' => esc_attr__('Slide Down In', 'essential-grid'),
				'slidedownout' => esc_attr__('Slide Down Out', 'essential-grid'),
				'slideshortleft' => esc_attr__('Slide Short Left In', 'essential-grid'),
				'slideshortleftout' => esc_attr__('Slide Short Left Out', 'essential-grid'),
				'slideshortright' => esc_attr__('Slide Short Right In', 'essential-grid'),
				'slideshortrightout' => esc_attr__('Slide Short Right Out', 'essential-grid'),
				'slideshortup' => esc_attr__('Slide Short Up In', 'essential-grid'),
				'slideshortupout' => esc_attr__('Slide Short Up Out', 'essential-grid'),
				'slideshortdown' => esc_attr__('Slide Short Down In', 'essential-grid'),
				'slideshortdownout' => esc_attr__('Slide Short Down Out', 'essential-grid'),
				'skewleft' => esc_attr__('Skew Left In', 'essential-grid'),
				'skewleftout' => esc_attr__('Skew Left Out', 'essential-grid'),
				'skewright' => esc_attr__('Skew Right In', 'essential-grid'),
				'skewrightout' => esc_attr__('Skew Right Out', 'essential-grid'),
				'rollleft' => esc_attr__('Roll Left In', 'essential-grid'),
				'rollleftout' => esc_attr__('Roll Left Out', 'essential-grid'),
				'rollright' => esc_attr__('Roll Right In', 'essential-grid'),
				'rollrightout' => esc_attr__('Roll Right Out', 'essential-grid'),
				'falldown' => esc_attr__('Fall Down In', 'essential-grid'),
				'falldownout' => esc_attr__('Fall Down Out', 'essential-grid'),
				'rotatescale' => esc_attr__('Rotate Scale In', 'essential-grid'),
				'rotatescaleout' => esc_attr__('Rotate Scale Out', 'essential-grid'),
				'zoomback' => esc_attr__('Zoom from Back In', 'essential-grid'),
				'zoombackout' => esc_attr__('Zoom from Back Out', 'essential-grid'),
				'zoomfront' => esc_attr__('Zoom from Front In', 'essential-grid'),
				'zoomfrontout' => esc_attr__('Zoom from Front Out', 'essential-grid'),
				'flyleft' => esc_attr__('Fly Left In', 'essential-grid'),
				'flyleftout' => esc_attr__('Fly Left Out', 'essential-grid'),
				'flyright' => esc_attr__('Fly Right In', 'essential-grid'),
				'flyrightout' => esc_attr__('Fly Right Out', 'essential-grid'),
				'covergrowup' => esc_attr__('Cover Grow In', 'essential-grid'),
				'covergrowupout' => esc_attr__('Cover Grow Out', 'essential-grid'),
				'collapsevertical' => esc_attr__('Collapse Vertical', 'essential-grid'),
				'collapsehorizontal' => esc_attr__('Collapse Horizontal', 'essential-grid'),
				'linediagonal' => esc_attr__('Line Diagonal', 'essential-grid'),
				'linehorizontal' => esc_attr__('Line Horizontal', 'essential-grid'),
				'linevertical' => esc_attr__('Line Vertical', 'essential-grid'),
				'spiralzoom' => esc_attr__('Spiral Zoom', 'essential-grid'),
				'circlezoom' => esc_attr__('Circle Zoom', 'essential-grid')
			];
		}
		asort($animations);

		return apply_filters('essgrid_get_hover_animations', $animations);
	}

	/**
	 * get media animations (only out animations!)
	 */
	public static function get_media_animations()
	{
		$media_anim = [
			'none' => esc_attr__(' None', 'essential-grid'),
			'flipverticalout' => esc_attr__('Flip Vertical', 'essential-grid'),
			'fliphorizontalout' => esc_attr__('Flip Horizontal', 'essential-grid'),
			'fliprightout' => esc_attr__('Flip Right', 'essential-grid'),
			'flipleftout' => esc_attr__('Flip Left', 'essential-grid'),
			'flipupout' => esc_attr__('Flip Up', 'essential-grid'),
			'flipdownout' => esc_attr__('Flip Down', 'essential-grid'),
			'shifttotop' => esc_attr__('Shift To Top', 'essential-grid'),
			'turnout' => esc_attr__('Turn', 'essential-grid'),
			'3dturnright' => esc_attr__('3D Turn Right', 'essential-grid'),
			'pressback' => esc_attr__('Press Back', 'essential-grid'),
			'zoomouttocorner' => esc_attr__('Zoom Out To Side', 'essential-grid'),
			'zoomintocorner' => esc_attr__('Zoom In To Side', 'essential-grid'),
			'zoomtodefault' => esc_attr__('Zoom To Default', 'essential-grid'),
			'zoomdefaultblur' => esc_attr__('Zoom Default Blur', 'essential-grid'),
			'mediazoom' => esc_attr__('Zoom', 'essential-grid'),
			'blur' => esc_attr__('Blur', 'essential-grid'),
			'fadeblur' => esc_attr__('Fade Blur', 'essential-grid'),
			'grayscalein' => esc_attr__('GrayScale In', 'essential-grid'),
			'grayscaleout' => esc_attr__('GrayScale Out', 'essential-grid'),
			'zoomblur' => esc_attr__('Zoom Blur', 'essential-grid'),
			'zoombackout' => esc_attr__('Zoom to Back', 'essential-grid'),
			'zoomfrontout' => esc_attr__('Zoom to Front', 'essential-grid'),
			'zoomandrotate' => esc_attr__('Zoom And Rotate', 'essential-grid')
		];

		return apply_filters('essgrid_get_media_animations', $media_anim);
	}

	/**
	 * set basic columns if empty
	 */
	public static function set_basic_columns($columns)
	{
		return apply_filters( 'essgrid_set_basic_columns', self::fill_from_devices_array( $columns, 'columns' ) );
	}

	/**
	 * set basic columns if empty
	 */
	public static function set_basic_columns_custom($columns)
	{
		$new_columns = self::set_basic_columns($columns);
		return apply_filters('essgrid_set_basic_columns_custom', $new_columns);
	}

	/**
	 * set basic columns width if empty
	 */
	public static function set_basic_columns_width($columns_width = null)
	{
		return apply_filters('essgrid_set_basic_columns_width', self::fill_from_devices_array( $columns_width, 'width' ) );
	}

	/**
	 * set basic columns width if empty
	 */
	public static function set_basic_masonry_content_height($mas_con_height)
	{
		return apply_filters('essgrid_set_basic_masonry_content_height', self::fill_columns_height_array( $mas_con_height ) );
	}

	/**
	 * set basic columns height if empty
	 * @since: 2.0.4
	 */
	public static function set_basic_columns_height($columns_height)
	{
		return apply_filters('essgrid_set_basic_columns_height', self::fill_columns_height_array( $columns_height ) );
	}

	/**
	 * @param mixed $height
	 * @return array
	 */
	public static function fill_columns_height_array( $height )
	{
		if ( !is_array( $height ) ) $height = ( array ) $height;
		$amount = count( self::get_basic_devices() );
		for ( $i = 0; $i < $amount; $i++ ) {
			if ( !isset( $height[$i] ) || intval( $height[$i] ) == 0 ) $height[$i] = 0;
		}

		return $height;
	}

	/**
	 * @param mixed $data
	 * @param string $devices_column
	 * @return array
	 */
	public static function fill_from_devices_array( $data, $devices_column )
	{
		if ( !is_array( $data ) ) $data = ( array ) $data;
		$devices = self::get_basic_devices();
		foreach ( $devices as $i => $v ) {
			if ( !isset( $data[$i] ) || intval( $data[$i] ) == 0 ) $data[$i] = $v[ $devices_column ];
		}
		
		return $data;
	}

	/**
	 * get advanced columns from parameters
	 * @since: 3.0.14
	 * @param array $params
	 * @param bool | array $columns
	 * @return array
	 */
	public static function get_advanced_columns($params, $columns = false)
	{
		$result = [];
		
		//if columns passed, prepend advanced columns with columns
		if (is_array($columns)) {
			$result[] = $columns;
		}
		
		for ($i = 0; $i <= 8; $i++) {
			$result[] = self::getVar($params, 'columns-advanced-rows-' . $i);
		}

		return apply_filters('essgrid_get_advanced_columns', $result);
	}

	/**
	 * get basic devices names
	 * @since: 2.0.4
	 * @return array
	 */
	public static function get_basic_devices()
	{
		$devices = [
			[
				'label' => 'Desktop XL',
				'plural' => 'XL desktop screens',
				'width' => 1900,
				'columns' => 5,
			],
			[
				'label' => 'Desktop Large',
				'plural' => 'large desktop screens',
				'width' => 1400,
				'columns' => 5,
			],
			[
				'label' => 'Desktop Medium',
				'plural' => 'medium sized desktop screens',
				'width' => 1170,
				'columns' => 4,
			],
			[
				'label' => 'Desktop Small',
				'plural' => 'small sized desktop screens',
				'width' => 1024,
				'columns' => 4,
			],
			[
				'label' => 'Tablet Landscape',
				'plural' => 'tablets in landscape view',
				'width' => 960,
				'columns' => 3,
			],
			[
				'label' => 'Tablet',
				'plural' => 'tablets in portrait view',
				'width' => 778,
				'columns' => 3,
			],
			[
				'label' => 'Mobile Landscape',
				'plural' => 'mobiles in landscape view',
				'width' => 640,
				'columns' => 3,
			],
			[
				'label' => 'Mobile',
				'plural' => 'mobiles in portrait view',
				'width' => 480,
				'columns' => 1,
			],
		];

		return apply_filters('essgrid_get_basic_devices', $devices);
	}

	/**
	 * Get url to secific view.
	 */
	public static function getViewUrl($viewName = "", $urlParams = "", $slug = "")
	{
		$params = "";
		$plugin = Essential_Grid::get_instance();
		if ($slug == "") $slug = $plugin->get_plugin_slug();
		if ($viewName != "") $params = "&view=" . $viewName;
		$params .= (!empty($urlParams)) ? "&" . $urlParams : "";
		$link = admin_url("admin.php?page=" . $slug . $params);

		return apply_filters('essgrid_getViewUrl', $link, $viewName, $urlParams, $slug);
	}

	/**
	 * Get url to secific view.
	 */
	public static function getSubViewUrl($viewName = "", $urlParams = "", $slug = "")
	{
		$params = "";
		$plugin = Essential_Grid::get_instance();
		if ($slug == "") $slug = $plugin->get_plugin_slug();
		if ($viewName != "") $params = "-" . $viewName;
		$params .= (!empty($urlParams)) ? "&" . $urlParams : "";
		$link = admin_url("admin.php?page=" . $slug . $params);

		return apply_filters('essgrid_getSubViewUrl', $link, $viewName, $urlParams, $slug);
	}

	/**
	 * Get Post Types + Custom Post Types
	 */
	public static function getPostTypesAssoc($arrPutToTop = [])
	{
		$arrBuiltIn = ["post" => "post", "page" => "page"];
		$arrCustomTypes = get_post_types(['_builtin' => false]);

		//top items validation - add only items that in the customtypes list
		$arrPutToTopUpdated = [];
		foreach ($arrPutToTop as $topItem) {
			if (in_array($topItem, $arrCustomTypes)) {
				$arrPutToTopUpdated[$topItem] = $topItem;
				unset($arrCustomTypes[$topItem]);
			}
		}

		$arrPostTypes = array_merge($arrPutToTopUpdated, $arrBuiltIn, $arrCustomTypes);

		//update label
		foreach ($arrPostTypes as $key => $type) {
			$objType = get_post_type_object($type);

			if (empty($objType)) {
				$arrPostTypes[$key] = $type;
				continue;
			}

			// Remove NextGen Post Types from the list
			if (!strpos($objType->labels->singular_name, 'extGEN')) {
				$arrPostTypes[$key] = $objType->labels->singular_name;
			} else {
				unset($arrPostTypes[$key]);
			}
		}
		
		// remove excluded
		$exclude_post_types = Essential_Grid_Base::getExcludePostTypes();
		foreach ($exclude_post_types as $key) unset($arrPostTypes[$key]);

		/**
		 * @param array $arrPostTypes  Post Types + Custom Post Types
		 * @param array $arrPutToTop  contain post types that you want to put on the top of list
		 */
		return apply_filters('essgrid_getPostTypesAssoc', $arrPostTypes, $arrPutToTop);
	}

	/**
	 * Get post types with categories.
	 */
	public static function getPostTypesWithCatsForClient()
	{
		$arrPostTypes = self::getPostTypesWithCats();
		$globalCounter = 0;
		$arrOutput = [];
		foreach ($arrPostTypes as $postType => $arrTaxWithCats) {
			$arrCats = [];
			foreach ($arrTaxWithCats as $tax) {
				$taxName = $tax["name"];
				$taxTitle = $tax["title"];
				$globalCounter++;
				$arrCats["option_disabled_" . $globalCounter] = "---- " . $taxTitle . " ----";
				foreach ($tax["cats"] as $catID => $catTitle) {
					$id = apply_filters('essgrid_get_taxonomy_id', $catID, $taxName);
					$arrCats[$taxName . "_" . $id] = $catTitle;
				}
			}//loop tax
			$arrOutput[$postType] = $arrCats;
		}//loop types

		return apply_filters('essgrid_getPostTypesWithCatsForClient', $arrOutput);
	}

	/**
	 * get array of post types with categories (the taxonomies is between).
	 * get only those taxomonies that have some categories in it.
	 */
	public static function getPostTypesWithCats()
	{
		$arrPostTypes = self::getPostTypesWithTaxomonies();
		$arrPostTypesOutput = [];
		foreach ($arrPostTypes as $name => $arrTax) {
			$arrTaxOutput = [];
			foreach ($arrTax as $taxName => $taxTitle) {
				$cats = self::getCategoriesAssoc($taxName);
				if (empty($cats)) continue;
				$arrTaxOutput[] = [
					"name" => $taxName,
					"title" => $taxTitle,
					"cats" => $cats
				];
			}
			$arrPostTypesOutput[$name] = $arrTaxOutput;
		}

		return apply_filters('essgrid_getPostTypesWithCats', $arrPostTypesOutput);
	}

	/**
	 * get current language code
	 */
	public static function get_current_lang_code()
	{
		$langTag = get_bloginfo('language');
		$data = explode('-', $langTag);
		$code = $data[0];
		return apply_filters('essgrid_get_current_lang_code', $code);
	}

	/**
	 * get post types array with taxomonies
	 */
	public static function getPostTypesWithTaxomonies()
	{
		$arrPostTypes = self::getPostTypesAssoc();
		foreach ($arrPostTypes as $postType => $title) {
			$arrTaxomonies = self::getPostTypeTaxomonies($postType);
			$arrPostTypes[$postType] = $arrTaxomonies;
		}

		return apply_filters('essgrid_getPostTypesWithTaxomonies', $arrPostTypes);
	}

	/**
	 * get post categories list assoc - id / title
	 */
	public static function getCategoriesAssoc($taxonomy = "category")
	{
		if (strpos($taxonomy, ",") !== false) {
			$arrTax = explode(",", $taxonomy);
			$arrCats = [];
			foreach ($arrTax as $tax) {
				$cats = self::getCategoriesAssoc($tax);
				$arrCats = array_merge($arrCats, $cats);
			}
		} else {
			$args = ["taxonomy" => $taxonomy];
			$cats = get_categories($args);
			$arrCats = [];
			foreach ($cats as $cat) {
				$id = apply_filters('essgrid_get_taxonomy_id', $cat->cat_ID, $cat->taxonomy);
				$arrCats[$id] = sprintf(
					'%s (%d %s) [slug: %s]', 
					$cat->name,
					$cat->count,
					($cat->count == 1 ? 'item' : 'items'),
					$cat->slug
				);
			}
		}

		return apply_filters('essgrid_getCategoriesAssoc', $arrCats, $taxonomy);
	}

	/**
	 * get post type taxomonies
	 */
	public static function getPostTypeTaxomonies($postType)
	{
		$arrTaxonomies = get_object_taxonomies(['post_type' => $postType], 'objects');
		$arrNames = [];
		foreach ($arrTaxonomies as $objTax) {
			$arrNames[$objTax->name] = $objTax->labels->name;
		}

		return apply_filters('essgrid_getPostTypeTaxomonies', $arrNames, $postType);
	}

	/**
	 * set category by post type, with specific name (can be regular or woocommerce)
	 */
	public static function setCategoryByPostTypes($postTypes, $postTypesWithCats)
	{
		//update the categories list by the post types
		if (strpos($postTypes, ",") !== false)
			$postTypes = explode(",", $postTypes);
		else
			$postTypes = [$postTypes];

		$arrCats = [];
		foreach ($postTypes as $postType) {
			if (empty($postTypesWithCats[$postType])) continue;
			$arrCats = array_merge($arrCats, $postTypesWithCats[$postType]);
		}

		return apply_filters('essgrid_setCategoryByPostTypes', $arrCats, $postTypes, $postTypesWithCats);
	}

	/**
	 * function return the custom query.
	 *
	 * @since 3.0.13
	 * @global Object $wpdb WordPress db object.
	 * @param string $search Search query.
	 * @param object $wp_query WP query.
	 * @return string $search Search query.
	 */
	public static function esg_custom_query($search, $wp_query)
	{
		global $wpdb;

		if (empty($wp_query->is_search) || empty($wp_query->get('s'))) {
			return $search; // Do not proceed if search does not match our search conditions.
		}

		$q = $wp_query->query_vars;
		if (empty($q['search_terms'])) $q['search_terms'] = [];
		if (!is_array($q['search_terms'])) $q['search_terms'] = (array)$q['search_terms'];
		
		$search  = '';
		$search_operator = '';

		foreach ($q['search_terms'] as $term) {

			$term = '%' . $wpdb->esc_like( $term ) . '%';

			$search .= $search_operator;
			$search .= $wpdb->prepare(
				" (
					$wpdb->posts.post_title LIKE %s
					OR $wpdb->posts.post_content LIKE %s
					OR $wpdb->posts.post_excerpt LIKE %s
					OR EXISTS (
						SELECT 1 FROM $wpdb->term_relationships tr 
						JOIN $wpdb->term_taxonomy tt ON tr.term_taxonomy_id = tt.term_taxonomy_id
						JOIN $wpdb->terms t ON tt.term_id = t.term_id
						WHERE tr.object_id = $wpdb->posts.ID 
						AND t.name LIKE %s
					)", 
				$term, $term, $term, $term
			);

			// post meta search
			$meta = new Essential_Grid_Meta();
			$m = $meta->get_all_meta(false);
			if (!empty($m)) {
				foreach ($m as $me) {
					$search .= $wpdb->prepare( ' OR (esg_pm.meta_key = %s AND esg_pm.meta_value LIKE %s)', 'eg-'.$me['handle'], $term );
				}
			}

			$search .= ')';

			$search_operator = " OR ";
		}

		if ( ! empty( $search ) ) {
			$search = " AND ({$search}) ";
			if ( ! is_user_logged_in() ) {
				$search .= " AND ($wpdb->posts.post_password = '') ";
			}
		}

		// Join Table.
		add_filter( 'posts_join_request', ['Essential_Grid_Base', 'esg_custom_query_join_table']);

		// Request distinct results.
		add_filter( 'posts_distinct_request', ['Essential_Grid_Base', 'esg_custom_query_distinct']);

		/**
		 * Filter search query return by plugin.
		 *
		 * @since 1.0.1
		 * @param string $search SQL query.
		 * @param object $wp_query global wp_query object.
		 */
		return apply_filters( 'essgrid_posts_search', $search, $wp_query );
	}

	/**
	 * Join tables.
	 *
	 * @since 1.0
	 * @global Object $wpdb WPDB object.
	 * @param string $join query for join.
	 * @return string $join query for join.
	 */
	public static function esg_custom_query_join_table( $join ) {
		global $wpdb;

		// join post meta table.
		$join .= " LEFT JOIN $wpdb->postmeta esg_pm ON ($wpdb->posts.ID = esg_pm.post_id) ";

		return $join;
	}

	/**
	 * Request distinct results.
	 *
	 * @since 1.0
	 * @param string $distinct DISTINCT Keyword.
	 * @return string $distinct
	 */
	public static function esg_custom_query_distinct( $distinct ) {
		return 'DISTINCT';
	}

	/**
	 * get posts by categorys/tags
	 */
	public static function getPostsByCategory( $grid_id, $catID, $postTypes = "any", $taxonomies = "category", $pages = [], $sortBy = 'ID', $direction = 'DESC', $numPosts = - 1, $arrAddition = [], $relation = 'OR' ) {
		// Filter to modify search query.
		$enable_extended_search = get_option( 'tp_eg_enable_extended_search', 'false' );
		if ( 'true' === $enable_extended_search ) {
			add_filter( 'posts_search', [ 'Essential_Grid_Base', 'esg_custom_query' ], 500, 2 );
		}

		//get post types
		$postTypes = explode( ",", $postTypes );
		if ( empty( $postTypes ) || in_array("any", $postTypes)) {
			$postTypes = [ "any" ];
		}
		$postTypes = array_map( 'trim', $postTypes );

		if ( strpos( $catID, "," ) !== false ) {
			$catID = explode( ",", $catID );
		} else {
			$catID = [ $catID ];
		}

		$query = [
			'order'          => $direction,
			'posts_per_page' => $numPosts,
			'post_status'    => 'publish',
			'post_type'      => $postTypes,
		];

		if ( strpos( $sortBy, 'eg-' ) === 0 ) {
			$meta = new Essential_Grid_Meta();
			$m    = $meta->get_all_meta( false );
			if ( ! empty( $m ) ) {
				foreach ( $m as $me ) {
					if ( 'eg-' . $me['handle'] == $sortBy ) {
						$sortBy = ( isset( $me['sort-type'] ) && $me['sort-type'] == 'numeric' ) ? 'meta_num_' . $sortBy : 'meta_' . $sortBy;
						break;
					}
				}
			}
		} elseif ( strpos( $sortBy, 'egl-' ) === 0 ) {
			//change to meta_num_ or meta_ depending on setting
			$sortfound = false;
			$link_meta = new Essential_Grid_Meta_Linking();
			$m         = $link_meta->get_all_link_meta();
			if ( ! empty( $m ) ) {
				foreach ( $m as $me ) {
					if ( 'egl-' . $me['handle'] == $sortBy ) {
						$sortBy    = ( isset( $me['sort-type'] ) && $me['sort-type'] == 'numeric' ) ? 'meta_num_' . $me['original'] : 'meta_' . $me['original'];
						$sortfound = true;
						break;
					}
				}
			}
			if ( ! $sortfound ) {
				$sortBy = 'none';
			}
		}

		//add sort by (could be by meta)
		if ( strpos( $sortBy, "meta_num_" ) === 0 ) {
			$metaKey          = str_replace( "meta_num_", "", $sortBy );
			$query["orderby"] = "meta_value_num";
			// phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key
			$query["meta_key"] = $metaKey;
		} else if ( strpos( $sortBy, "meta_" ) === 0 ) {
			$metaKey          = str_replace( "meta_", "", $sortBy );
			$query["orderby"] = "meta_value";
			// phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key
			$query["meta_key"] = $metaKey;
		} else {
			$query["orderby"] = $sortBy;
		}

		if ( $query["orderby"] == "likespost" ) {
			$query["orderby"] = "meta_value";
			// phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key
			$query["meta_key"] = "eg_votes_count";
		}

		if ( isset( $query['meta_key'] ) ) {
			// phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key
			$query['meta_key'] = ( $query['meta_key'] === 'stock' ) ? '_stock' : $query['meta_key'];
		}

		// add taxonomies to the query
		if ( ! empty( $taxonomies ) ) {
			if ( strpos( $taxonomies, "," ) !== false ) {
				$taxonomies = explode( ",", $taxonomies );
			} else {
				$taxonomies = [ $taxonomies ];
			}

			$taxQuery = [];
			if ( count( $taxonomies ) ) {
				$taxQuery['relation'] = $relation;
			}
			
			foreach ( $taxonomies as $t ) {
				$taxQuery[] = [
					'taxonomy' => $t,
					'field'    => 'term_id',
					'terms'    => $catID
				];
			}
			
			// phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_tax_query
			$query['tax_query'] = $taxQuery;
		}

		$query['suppress_filters'] = false;

		if ( ! empty( $arrAddition ) && is_array( $arrAddition ) ) {
			foreach ( $arrAddition as $han => $val ) {
				if ( strlen( $val ) >= 5 && strtolower( substr( $val, 0, 5 ) ) == 'array' ) {
					$val                 = explode( ',', str_replace( [ '(', ')' ], '', substr( $val, 5 ) ) );
					$arrAddition[ $han ] = $val;
				}
			}
			$query = array_merge( $query, $arrAddition );
			if ( isset( $arrAddition['offset'] ) ) {
				if ( isset( $query['posts_per_page'] ) && ( $query['posts_per_page'] == '-1' || $query['posts_per_page'] == - 1 ) ) {
					$query['posts_per_page'] = '9999';
					$query['showposts']      = '9999';
				}
			}
		}

		if ( $query['orderby'] == 'none' ) {
			$query['orderby'] = 'post__in';
		}

		if ( empty( $grid_id ) ) {
			$grid_id = time();
		}

		$query_type = get_option( 'tp_eg_query_type', 'wp_query' );
		$query = apply_filters( 'essgrid_get_posts', $query, $grid_id );
		if ( $query_type == 'wp_query' ) {
			$wp_query = new WP_Query();
			$wp_query->parse_query( $query );
			$objQuery = $wp_query->get_posts();
		} else {
			$objQuery = get_posts( $query );
		}

		// select again the pages
		// since pages should be selected by IDs and that might not fit in previous query conditions
		if ( in_array( 'page', $postTypes ) ) {

			// delete category/tag filtering
			unset( $query['tax_query'] ); 
			
			$query['post_type'] = 'page';
			$query['post__in'] = $pages;

			if ( $query_type == 'wp_query' ) {
				$wp_query = new WP_Query();
				$wp_query->parse_query( $query );
				$objQueryPages = $wp_query->get_posts();
			} else {
				$objQueryPages = get_posts( $query );
			}
			$objQuery = array_merge( $objQuery, $objQueryPages );

			if ( ! empty( $objQuery ) ) {
				// remove duplicates
				$fIDs = [];
				foreach ( $objQuery as $objID => $objPost ) {
					if ( isset( $fIDs[ $objPost->ID ] ) ) {
						unset( $objQuery[ $objID ] );
						continue;
					}
					$fIDs[ $objPost->ID ] = true;
				}
			}
		}

		$arrPosts = $objQuery;

		//check if we should rnd the posts
		if ( $sortBy == 'rand' && ! empty( $arrPosts ) ) {
			shuffle( $arrPosts );
		}

		if ( ! empty( $arrPosts ) ) {
			foreach ( $arrPosts as $key => $post ) {

				if ( method_exists( $post, "to_array" ) ) {
					$arrPost = $post->to_array();
				} else {
					$arrPost = (array) $post;
				}

				if ( $arrPost['post_type'] == 'page' ) {
					if ( ! empty( $pages ) ) {
						//filter to pages if array is set
						$delete = true;
						foreach ( $pages as $page ) {
							if ( ! empty( $page ) ) {
								$wpml_page_id = apply_filters( 'essgrid_get_taxonomy_id', $arrPost['ID'], $arrPost['post_type'] );
								if ( $arrPost['ID'] == $page || $wpml_page_id == $page ) {
									$delete = false;
									break;
								}
							}
						}
						if ( $delete ) {
							//if not wanted, go to next
							unset( $arrPosts[ $key ] );
							continue;
						}
					}
				}
				$arrPosts[ $key ] = $arrPost;
			}
		}

		// remove filter to modify search query.
		if ( 'true' === $enable_extended_search ) {
			remove_filter( 'posts_search', [ 'Essential_Grid_Base', 'esg_custom_query' ], 500 );
		}

		return apply_filters( 'essgrid_modify_posts', $arrPosts, $grid_id );
	}

	/**
	 * Get taxonomies by post ID
	 */
	public static function get_custom_taxonomies_by_post_id($post_id)
	{
		// get post by post id
		$post = get_post($post_id);

		// get post type by post
		$post_type = $post->post_type;

		// get post type taxonomies
		$taxonomies = get_object_taxonomies($post_type, 'objects');

		$terms = [];
		foreach ($taxonomies as $taxonomy_slug => $taxonomy) {
			// get the terms related to post
			$c_terms = get_the_terms($post->ID, $taxonomy_slug);

			if (!empty($c_terms)) {
				$terms = array_merge($terms, $c_terms);
			}
		}

		return apply_filters('essgrid_get_custom_taxonomies_by_post_id', $terms, $post_id);
	}

	/**
	 * Receive all Posts by given IDs
	 */
	public static function get_posts_by_ids($ids, $sort_by = 'none', $sort_order = 'DESC')
	{
		$query = [
			'post__in' => $ids,
			'post_type' => array_keys( self::getPostTypesAssoc() ),
			'order' => $sort_order,
			'numberposts' => count($ids)
		];

		if (strpos($sort_by, 'eg-') === 0) {
			$meta = new Essential_Grid_Meta();
			$m = $meta->get_all_meta(false);
			if (!empty($m)) {
				foreach ($m as $me) {
					if ('eg-' . $me['handle'] == $sort_by) {
						$sort_by = (isset($me['sort-type']) && $me['sort-type'] == 'numeric') ? 'meta_num_' . $sort_by : 'meta_' . $sort_by;
						break;
					}
				}
			}
		} elseif (strpos($sort_by, 'egl-') === 0) {
			//change to meta_num_ or meta_ depending on setting
			$sortfound = false;
			$link_meta = new Essential_Grid_Meta_Linking();
			$m = $link_meta->get_all_link_meta();
			if (!empty($m)) {
				foreach ($m as $me) {
					if ('egl-' . $me['handle'] == $sort_by) {
						$sort_by = (isset($me['sort-type']) && $me['sort-type'] == 'numeric') ? 'meta_num_' . $me['original'] : 'meta_' . $me['original'];
						$sortfound = true;
						break;
					}
				}
			}
			if (!$sortfound) {
				$sort_by = 'none';
			}
		}

		//add sort by (could be by meta)
		if (strpos($sort_by, "meta_num_") === 0) {
			$metaKey = str_replace("meta_num_", "", $sort_by);
			$query["orderby"] = "meta_value_num";
			// phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key
			$query["meta_key"] = $metaKey;
		} else if (strpos($sort_by, "meta_") === 0) {
			$metaKey = str_replace("meta_", "", $sort_by);
			$query["orderby"] = "meta_value";
			// phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key
			$query["meta_key"] = $metaKey;
		} else {
			$query["orderby"] = $sort_by;
		}

		if ($query['orderby'] == 'none') $query['orderby'] = 'post__in';
		$query = apply_filters('essgrid_get_posts_by_ids_query', $query, $ids);

		$objQuery = get_posts($query);
		$arrPosts = $objQuery;
		foreach ($arrPosts as $key => $post) {
			if (method_exists($post, "to_array"))
				$arrPost = $post->to_array();
			else
				$arrPost = (array)$post;
			$arrPosts[$key] = $arrPost;
		}

		return apply_filters('essgrid_get_posts_by_ids', $arrPosts);
	}

	/**
	 * Receive all Posts
	 * @since: 3.0.17
	 */
	public static function get_wp_posts($max_posts = 100, $post_type = "any", $orderby = "date", $filter = "latest")
	{
		$current_post_id = get_the_ID();
		$my_posts = [];
		$args = [
			'post_type' => $post_type,
			'posts_per_page' => $max_posts,
			'suppress_filters' => 0,
			// phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key
			'meta_key' => '_thumbnail_id',
			'orderby' => $orderby,
			'order' => 'DESC',
		];
		$args = apply_filters('essgrid_get_' . $filter . '_posts_query', $args, $current_post_id);

		$posts = get_posts($args);
		foreach ($posts as $post) {
			if ($post->ID == $current_post_id) continue;
			
			if (method_exists($post, "to_array"))
				$my_posts[] = $post->to_array();
			else
				$my_posts[] = (array)$post;
		}

		return apply_filters('essgrid_get_' . $filter . '_posts', $my_posts);
	}
	

	/**
	 * Receive all Posts that are related to the current post
	 * @since: 1.2.0
	 * changed: 3.0.8 (added distinction between categories or tags or both)
	 * changed: 3.0.17 (works with all post types and taxonomies)
	 */

	public static function get_related_posts($max_posts = 20, $related_by = "both")
	{
		$my_posts = [];
		$current_post_id = get_the_ID();
		$exclude = [ $current_post_id ];
		$max_posts++; 
		
		if (in_array($related_by, ["both", "tags"])) {
			$tags_string = '';
			$post_tags = get_the_tags();
			if ($post_tags) {
				foreach ($post_tags as $post_tag) {
					$tags_string .= $post_tag->slug . ',';
				}
			}

			$query = [
				'numberposts' => $max_posts,
				'tag' => $tags_string
			];

			$get_relateds = apply_filters('essgrid_get_related_posts', $query, $current_post_id);
			$tag_related_posts = get_posts($get_relateds);
		} else {
			$tag_related_posts = [];
		}

		if ($related_by == "categories" || ($related_by == "both" && count($tag_related_posts) < $max_posts)) {
			foreach ($tag_related_posts as $tag_related_post) {
				$exclude[] = $tag_related_post->ID;
			}
			$article_categories = get_the_category($current_post_id);
			$category_string = '';
			foreach ($article_categories as $category) {
				$category_string .= $category->cat_ID . ',';
			}
			$max = $max_posts - count($tag_related_posts);

			$query = [
				'numberposts' => $max,
				'category' => $category_string
			];

			$get_relateds = apply_filters('essgrid_get_related_posts_query', $query, $current_post_id);
			$cat_related_posts = get_posts($get_relateds);
			$tag_related_posts = $tag_related_posts + $cat_related_posts;
		}

		foreach ($tag_related_posts as $post) {
			if ( in_array( $post->ID, $exclude ) ) continue;
			
			if (method_exists($post, "to_array"))
				$the_post = $post->to_array();
			else
				$the_post = (array)$post;

			$my_posts[] = $the_post;
		}

		return apply_filters('essgrid_get_related_posts', $my_posts);
	}

	/**
	 * get cats and taxanomies data from the category id's
	 */
	public static function getCatAndTaxData($catIDs)
	{
		if (empty($catIDs)) return ['tax' => '', 'cats' => ''];
		if (is_string($catIDs)) {
			$catIDs = explode(",", trim($catIDs));
		}

		$arrCats = $arrTax = [];
		foreach ($catIDs as $cat) {
			if (strpos($cat, "option_disabled") === 0) continue;

			list($taxName, $catID) = esg_split_taxonomy_string($cat);
			$id = apply_filters('essgrid_get_taxonomy_id', $catID, $taxName);

			$arrCats[$id] = $id;
			$arrTax[$taxName] = $taxName;
		}

		return ['tax' => implode(',', $arrTax), 'cats' => implode(',', $arrCats)];
	}
	
	public static function getPreparedCatAndTaxData($post_category)
	{
		$cat_tax = self::getCatAndTaxData($post_category);

		$cats = [];
		if ( !empty( $cat_tax['cats'] ) )
			$cats = explode( ',', $cat_tax['cats'] );

		$taxes = ['post_tag'];
		if ( !empty( $cat_tax['tax'] ) )
			$taxes = explode( ',', $cat_tax['tax'] );
		
		return [ $cats, $taxes ];
	}

	/**
	 * get categories list, copy the code from default wp functions
	 */
	public static function get_categories_html_list($catIDs, $do_type, $seperator = ',', $tax = false)
	{
		global $wp_rewrite;

		$categories = self::get_categories_by_ids($catIDs, $tax);
		$rel = (is_object($wp_rewrite) && $wp_rewrite->using_permalinks()) ? 'rel="category tag"' : 'rel="category"';
		$thelist = '';
		if (!empty($categories)) {
			foreach ($categories as $key => $category) {
				if ($key > 0) $thelist .= $seperator;
				switch ($do_type) {
					case 'none':
						$thelist .= $category->name;
						break;
					case 'filter':
						$thelist .= '<a href="#" class="eg-triggerfilter" data-filter="filter-' . $category->slug . '">' . $category->name . '</a>';
						break;
					case 'link':
					default:
						if ($tax !== false) {
							$url = get_term_link($category, $tax);
							if (is_wp_error($url)) $url = '';
						} else {
							$url = get_category_link($category->term_id);
						}
						/* translators: %s: Category Name. */
						$title = sprintf(esc_attr__('View all posts in %s', 'essential-grid'), $category->name);
						$thelist .= '<a href="' . esc_url($url) . '" title="' . esc_attr($title) . '" ' . $rel . '>' . $category->name . '</a>';
						break;
				}
			}
		}

		return apply_filters('essgrid_get_categories_html_list', $thelist, $catIDs, $do_type, $seperator, $tax);
	}

	/**
	 * get categories by id's
	 */
	public static function get_categories_by_ids($arrIDs, $tax = false)
	{
		if (empty($arrIDs))
			return ([]);
		$strIDs = implode(',', $arrIDs);
		$args['include'] = $strIDs;
		if ($tax !== false)
			$args['taxonomy'] = $tax;
		$arrCats = get_categories($args);

		return apply_filters('essgrid_get_categories_by_ids', $arrCats, $arrIDs, $tax);
	}

	/**
	 * get categories by id's
	 */
	public static function get_create_category_by_slug($cat_slug, $cat_name, $create_taxonomies = 'off')
	{
		$cat = term_exists($cat_slug, $cat_name);
		if ($cat !== 0 && $cat !== null) {
			if (is_array($cat))
				return $cat['term_id'];
			else
				return $cat;
		}

		if ($create_taxonomies == 'off') return false;
		
		//create category if possible
		$new_name = ucwords(str_replace('-', ' ', $cat_slug));
		$category_array = wp_insert_term(
			$new_name,
			$cat_name,
			[
				'description' => '',
				'slug' => $cat_slug
			]
		);

		$category_array = apply_filters('essgrid_get_create_category_by_slug', $category_array, $cat_slug, $cat_name);
		if (is_array($category_array) && !empty($category_array))
			return $category_array['term_id'];

		return false;
	}

	/**
	 * get post taxonomies html list
	 */
	public static function get_tax_html_list($postID, $taxonomy, $seperator = ',', $do_type = 'link', $taxmax = false)
	{
		$taxList = [];
		if (empty($seperator)) $seperator = '&nbsp;';
		
		$terms = get_the_terms($postID, $taxonomy);
		if (!empty($terms) && !is_wp_error($terms)) {
			foreach ($terms as $term) {
				$taxList[] = '<a href="' . get_term_link($term->term_id) . '" class="esg-display-inline">' . $term->name . '</a>';
			}
			if ($taxmax && !empty($taxList) && is_array($taxList) && count($taxList) >= $taxmax) {
				$taxList = array_slice($taxList, 0, $taxmax, true);
			}
			switch ($do_type) {
				case 'none':
					$taxList = implode($seperator, $taxList);
					$taxList = wp_strip_all_tags($taxList);
					break;
				case 'filter':
					$text = '';
					if (!empty($taxList)) {
						foreach ($taxList as $key => $tax) {
							if ($key > 0) $text .= $seperator;
							$tax = wp_strip_all_tags($tax);
							$text .= '<a href="#" class="eg-triggerfilter" data-filter="filter-' . $tax . '">' . sanitize_title($tax) . '</a>';
						}
					}
					$taxList = $text;
					break;
				case 'link':
					$taxList = implode($seperator, $taxList);
					break;
			}
		}
		
		return apply_filters('essgrid_get_tax_html_list', $taxList, $postID, $seperator, $do_type);
	}

	/**
	 * get post tags html list
	 */
	public static function get_tags_html_list($postID, $seperator = ',', $do_type = 'link', $tagmax = false)
	{
		if (empty($seperator)) $seperator = '&nbsp;';

		$tagList = get_the_tag_list("", $seperator, "", $postID);
		if (!empty($tagList) && !is_wp_error($tagList)) {
			if ($tagmax) {
				$tags = explode($seperator, $tagList);
				$tags = array_slice($tags, 0, $tagmax, true);
				$tagList = implode($seperator, $tags);
			}

			switch ($do_type) {
				case 'none':
					$tagList = wp_strip_all_tags($tagList);
					break;
				case 'filter':
					$tags = wp_strip_all_tags($tagList);
					$tags = explode($seperator, $tags);

					$text = '';
					if (!empty($tags)) {
						foreach ($tags as $key => $tag) {
							if ($key > 0) $text .= $seperator;
							$text .= '<a href="#" class="eg-triggerfilter" data-filter="filter-' . $tag . '">' . sanitize_title($tag) . '</a>';
						}
					}
					$tagList = $text;
					break;
				case 'link':
					//return tagList as it is
					break;
			}
		}

		return apply_filters('essgrid_get_tags_html_list', $tagList, $postID, $seperator, $do_type);
	}

	/**
	 * output the demo skin html
	 */
	public static function output_demo_skin_html($data)
	{
		$data = apply_filters('essgrid_output_demo_skin_html_pre', $data);
		$grid = new Essential_Grid();
		$base = new Essential_Grid_Base();
		$item_skin = new Essential_Grid_Item_Skin();

		$preview = '';
		$preview_type = ($data['postparams']['source-type'] == 'custom') ? 'custom' : 'preview';
		$grid_id = (isset($data['id']) && intval($data['id']) > 0) ? intval($data['id']) : '-1';

		ob_start();

		// validate post type and post categories
		if ( 'post' === $data['postparams']['source-type'] ) {
			$grid_orig = Essential_Grid_Db::get_entity('grids')->get_grid_by_id( $grid_id );
			if ( ! empty( $grid_orig ) ) {
				if ( 
					$data['postparams']['post_types'] !== $grid_orig['postparams']['post_types'] 
					&& empty( $data['postparams']['post_types'] )
				) {
					// missing post type
					echo '<div class="preview-notice esg-margin-b-15">'
						. esc_html__( 'Post type is empty! Please check grid source settings!', 'essential-grid' )
						. '<br/>'
						. '<a id="go-to-source" class="esg-btn esg-purple" href="#">'
						. esc_html__('Check Settings', 'essential-grid')
						.'</a>'
						. '</div>';
				}

				if (
					$data['postparams']['post_category'] !== $grid_orig['postparams']['post_category']
					&& empty( $data['postparams']['post_category'] )
				) {
					// missing post categories
					echo '<div class="preview-notice esg-margin-b-15">'
						. esc_html__( 'Preview version does not reflect the frontend. The database record contains selected categories, but the preview receives none. This typically indicates deleted or mismatched category data and can result in empty output on the frontend. Please verify grid "Source" settings!', 'essential-grid' )
						. '<br/><br/>'
						. esc_html__( 'If the categories were cleared on purpose, save the grid to update the database record and hide the warning.', 'essential-grid' )

						. '</div>';
				}

				
			}
		}

		$grid->output_essential_grid($grid_id, $data, $preview_type);
		
		$html = ob_get_clean();

		$skin = $base->getVar($data, ['params', 'entry-skin'], 0, 'i');
		if ($skin > 0) {
			ob_start();
			$item_skin->init_by_id($skin);
			$item_skin->output_item_skin('custom');
			$preview = ob_get_clean();
		}

		return apply_filters('essgrid_output_demo_skin_html_post', ['html' => $html, 'preview' => $preview], $grid);
	}

	/**
	 * return all custom element fields
	 */
	public function get_custom_elements_for_javascript()
	{
		$meta = new Essential_Grid_Meta();
		$item_elements = new Essential_Grid_Item_Element();

		$elements = [
			['name' => 'custom-soundcloud', 'type' => 'input'],
			['name' => 'custom-vimeo', 'type' => 'input'],
			['name' => 'custom-youtube', 'type' => 'input'],
			['name' => 'custom-wistia', 'type' => 'input'],
			['name' => 'custom-html5-mp4', 'type' => 'input'],
			['name' => 'custom-html5-ogv', 'type' => 'input'],
			['name' => 'custom-html5-webm', 'type' => 'input'],
			['name' => 'custom-image', 'type' => 'image'],
			['name' => 'custom-text', 'type' => 'textarea'],
			['name' => 'custom-ratio', 'type' => 'select'],
			['name' => 'post-link', 'type' => 'input'],
			['name' => 'custom-filter', 'type' => 'input']
		];

		$custom_meta = $meta->get_all_meta(false);
		if (!empty($custom_meta)) {
			foreach ($custom_meta as $cmeta) {
				if ($cmeta['type'] == 'text') $cmeta['type'] = 'input';
				$elements[] = ['name' => 'eg-' . $cmeta['handle'], 'type' => $cmeta['type'], 'default' => @$cmeta['default']];
			}
		}

		$def_ele = $item_elements->getElementsForDropdown();
		foreach ($def_ele as $element) {
			foreach ($element as $handle => $name) {
				$elements[] = ['name' => $handle, 'type' => 'input'];
			}
		}

		return apply_filters('essgrid_get_custom_elements_for_javascript', $elements);
	}

	/**
	 * return all media data of post that we may need
	 * 
	 * @param int $post_id
	 * @param string $image_type
	 * @param array $media_sources
	 * @param array $image_size
	 * @return array
	 */
	public function get_post_media_source_data($post_id, $image_type, $media_sources, $image_size = [])
	{
		$sources = apply_filters('essgrid_post_media_sources', $media_sources);
		
		$ret = [];
		$io = Essential_Grid_Image_Optimization::get_instance();
		$c_post = get_post($post_id);
		$attachment_id = get_post_thumbnail_id($post_id);
		
		$ret['featured-image']  = '';
		if (in_array('featured-image', $sources)) {
			if (!empty($image_size)) $io->generate_thumbnails($attachment_id, $image_size);
			
			$media = $io->get_media_source_src($attachment_id, $image_type, $image_size);

			$ret['featured-image'] = ($media['x1'] !== false) ? $media['x1']['0'] : '';
			$ret['featured-image-' . $io->get_retina_ext()] = ($media['x2'] !== false) ? $media['x2']['0'] : '';
			$ret['featured-image-width'] = ($media['x1'] !== false) ? $media['x1']['1'] : '';
			$ret['featured-image-height'] = ($media['x1'] !== false) ? $media['x1']['2'] : '';
			$ret['featured-image-alt'] = get_post_meta($attachment_id, '_wp_attachment_image_alt', true);
			$ret['featured-image-title'] = get_post_field('post_title', $attachment_id);
			
			if ( 'full' != $image_type ) {
				$feat_img_full = wp_get_attachment_image_src($attachment_id, 'full');
			} else {
				$feat_img_full = $media['x1'];
			}
			$ret['featured-image-full'] = ($feat_img_full !== false) ? $feat_img_full['0'] : '';
			$ret['featured-image-full-width'] = ($feat_img_full !== false) ? $feat_img_full['1'] : '';
			$ret['featured-image-full-height'] = ($feat_img_full !== false) ? $feat_img_full['2'] : '';
		}

		$ret['content-image'] = '';
		$ret['content-image-alt'] = '';
		$ret['content-image-title'] = '';
		if (in_array('content-image', $sources)) {
			$content_image = $this->get_first_content_image(-1, $c_post);
			$content_id = attachment_url_to_postid($content_image);

			if (empty($content_id) && !empty($content_image)) {
				// attempt to strip dimensions from image url
				$content_image_clean = preg_replace('/-\d+x\d+(?=\.\w+$)/', '', $content_image);
				$content_id = attachment_url_to_postid($content_image_clean);
			}
			
			if (!empty($content_id)) {
				if (!empty($image_size)) $io->generate_thumbnails($attachment_id, $image_size);

				$media = $io->get_media_source_src($content_id, $image_type, $image_size);
				$ret['content-image'] = ($media['x1'] !== false) ? $media['x1']['0'] : '';
				$ret['content-image-' . $io->get_retina_ext()] = ($media['x2'] !== false) ? $media['x2']['0'] : '';
				$ret['content-image-alt'] = get_post_meta($content_id, '_wp_attachment_image_alt', true);
				$ret['content-image-title'] = get_post_field('post_title', $content_id);
			}
		}

		$ret['content-iframe'] = '';
		if (in_array('content-iframe', $sources)) {
			$ret['content-iframe'] = $this->get_first_content_iframe(-1, $c_post);
		}

		//get Post Metas
		$values = get_post_custom($post_id);

		$ret['youtube'] = '';
		if (in_array('youtube', $sources)) {
			$ret['youtube'] = isset($values['eg_sources_youtube']) ? esc_attr($values['eg_sources_youtube'][0]) : '';
		}
		$ret['content-youtube'] = '';
		if (in_array('content-youtube', $sources)) {
			$ret['content-youtube'] = $this->get_first_content_youtube(-1, $c_post);
		}
		
		$ret['vimeo'] = '';
		if (in_array('vimeo', $sources)) {
			$ret['vimeo'] = isset($values['eg_sources_vimeo']) ? esc_attr($values['eg_sources_vimeo'][0]) : '';
		}
		$ret['content-vimeo'] = '';
		if (in_array('content-vimeo', $sources)) {
			$ret['content-vimeo'] = $this->get_first_content_vimeo(-1, $c_post);
		}
		
		$ret['wistia'] = '';
		if (in_array('wistia', $sources)) {
			$ret['wistia'] = isset($values['eg_sources_wistia']) ? esc_attr($values['eg_sources_wistia'][0]) : '';
		}
		$ret['content-wistia'] = '';
		if (in_array('content-wistia', $sources)) {
			$ret['content-wistia'] = $this->get_first_content_wistia(-1, $c_post);
		}

		$ret['alternate-image'] = '';
		$ret['alternate-image-alt'] = '';
		$ret['alternate-image-title'] = '';
		if (in_array('alternate-image', $sources) && isset($values['eg_sources_image'])) {
			if (!empty($image_size)) $io->generate_thumbnails($values['eg_sources_image'][0], $image_size);

			$media = $io->get_media_source_src($values['eg_sources_image'][0], $image_type, $image_size);
			
			$ret['alternate-image'] = ($media['x1'] !== false) ? $media['x1']['0'] : '';
			$ret['alternate-image-' . $io->get_retina_ext()] = ($media['x2'] !== false) ? $media['x2']['0'] : '';
			$ret['alternate-image-width'] = ($media['x1'] !== false) ? $media['x1']['1'] : '';
			$ret['alternate-image-height'] = ($media['x1'] !== false) ? $media['x1']['2'] : '';
			$ret['alternate-image-alt'] = get_post_meta($values['eg_sources_image'][0], '_wp_attachment_image_alt', true);
			$ret['alternate-image-title'] = get_post_field('post_title', $values['eg_sources_image'][0]);

			if ( 'full' != $image_type ) {
				$alt_img_full = wp_get_attachment_image_src($values['eg_sources_image'][0], 'full');
			} else {
				$alt_img_full = $media['x1'];
			}
			$ret['alternate-image-full'] = ($alt_img_full !== false) ? $alt_img_full['0'] : '';
			$ret['alternate-image-full-width'] = ($alt_img_full !== false) ? $alt_img_full['1'] : '';
			$ret['alternate-image-full-height'] = ($alt_img_full !== false) ? $alt_img_full['2'] : '';
		}

		$ret['iframe'] = isset($values['eg_sources_iframe']) ? esc_attr($values['eg_sources_iframe'][0]) : '';

		$ret['soundcloud'] = '';
		if (in_array('soundcloud', $sources)) {
			$ret['soundcloud'] = isset($values['eg_sources_soundcloud']) ? esc_attr($values['eg_sources_soundcloud'][0]) : '';
		}
		$ret['content-soundcloud'] = '';
		if (in_array('content-soundcloud', $sources)) {
			$ret['content-soundcloud'] = $this->get_first_content_soundcloud(-1, $c_post);
		}

		$ret['html5']['mp4'] = isset($values['eg_sources_html5_mp4']) ? esc_attr($values['eg_sources_html5_mp4'][0]) : '';
		$ret['html5']['ogv'] = isset($values['eg_sources_html5_ogv']) ? esc_attr($values['eg_sources_html5_ogv'][0]) : '';
		$ret['html5']['webm'] = isset($values['eg_sources_html5_webm']) ? esc_attr($values['eg_sources_html5_webm'][0]) : '';

		$ret['image-fit'] = isset($values['eg_image_fit']) && $values['eg_image_fit'][0] != '-1' ? esc_attr($values['eg_image_fit'][0]) : '';
		$ret['image-repeat'] = isset($values['eg_image_repeat']) && $values['eg_image_repeat'][0] != '-1' ? esc_attr($values['eg_image_repeat'][0]) : '';
		$ret['image-align-horizontal'] = isset($values['eg_image_align_h']) && $values['eg_image_align_h'][0] != '-1' ? esc_attr($values['eg_image_align_h'][0]) : '';
		$ret['image-align-vertical'] = isset($values['eg_image_align_v']) && $values['eg_image_align_v'][0] != '-1' ? esc_attr($values['eg_image_align_v'][0]) : '';

		$ret['content-html5']['mp4'] = '';
		$ret['content-html5']['ogv'] = '';
		$ret['content-html5']['webm'] = '';
		$content_video = $this->get_first_content_video(-1, $c_post);
		if ($content_video !== false) {
			$ret['content-html5']['mp4'] = @$content_video['mp4'];
			$ret['content-html5']['ogv'] = @$content_video['ogv'];
			$ret['content-html5']['webm'] = @$content_video['webm'];
		}

		$ret['revslider'] = isset($values['eg_sources_revslider']) ? esc_attr($values['eg_sources_revslider'][0]) : '';
		$ret['essgrid'] = isset($values['eg_sources_essgrid']) ? esc_attr($values['eg_sources_essgrid'][0]) : '';

		return apply_filters('essgrid_modify_media_sources', $ret, $post_id);
	}

	/**
	 * return all media data of custom element that we may need
	 * 
	 * @param array $values
	 * @param string $image_type
	 * @param array $image_size
	 * @return array
	 */
	public function get_custom_media_source_data($values, $image_type, $image_size = [])
	{
		$ret = [];
		$io = Essential_Grid_Image_Optimization::get_instance();
		
		if (!empty($values['custom-image']) || !empty($values['custom-image-url'])) {
			if (!empty($values['custom-image'])) {
				if (!empty($image_size)) $io->generate_thumbnails($values['custom-image'], $image_size);
				
				$media = $io->get_media_source_src($values['custom-image'], $image_type, $image_size);
				
				$alt_img = $media['x1'];
				$alt_img_retina = $media['x2'];
				$alt_img_full = wp_get_attachment_image_src($values['custom-image'], 'full');
				$alt_img_text = get_post_meta($values['custom-image'], '_wp_attachment_image_alt', true);
				$alt_img_title = get_post_field('post_title', $values['custom-image']);
			} else {
				$alt_img = $values['custom-image-url'];
				if (!empty($values['custom-image-url-full']))
					$alt_img_full = $values['custom-image-url-full'];
				else
					$alt_img_full = $values['custom-image-url'];
				$alt_img_text = '';
				$alt_img_title = '';
			}
			
			$ret['featured-image'] = ($alt_img !== false && isset($alt_img['0'])) ? $alt_img['0'] : '';
			$ret['featured-image-' . $io->get_retina_ext()] = (!empty($alt_img_retina)) ? $alt_img_retina['0'] : '';
			$ret['featured-image-width'] = ($alt_img !== false && isset($alt_img['1'])) ? $alt_img['1'] : '';
			$ret['featured-image-height'] = ($alt_img !== false && isset($alt_img['2'])) ? $alt_img['2'] : '';
			$ret['featured-image-alt'] = $alt_img_text;
			$ret['featured-image-title'] = $alt_img_title;
			
			$ret['featured-image-full'] = ($alt_img_full !== false && isset($alt_img_full['0'])) ? $alt_img_full['0'] : '';
			$ret['featured-image-full-width'] = ($alt_img_full !== false && isset($alt_img_full['1'])) ? $alt_img_full['1'] : '';
			$ret['featured-image-full-height'] = ($alt_img_full !== false && isset($alt_img_full['2'])) ? $alt_img_full['2'] : '';
			
			$ret['alternate-image-preload-url'] = (isset($values['custom-preload-image-url'])) ? $values['custom-preload-image-url'] : '';
		}

		if (isset($values['eg-alternate-image']) && $values['eg-alternate-image'] !== '') {
			if (!empty($image_size)) $io->generate_thumbnails($values['eg-alternate-image'], $image_size);

			$media = $io->get_media_source_src($values['eg-alternate-image'], $image_type, $image_size);
			
			$ret['alternate-image'] = ($media['x1'] !== false) ? $media['x1']['0'] : '';
			$ret['alternate-image-' . $io->get_retina_ext()] = ($media['x2'] !== false) ? $media['x2']['0'] : '';
			$ret['alternate-image-width'] = ($media['x1'] !== false) ? $media['x1']['1'] : '';
			$ret['alternate-image-height'] = ($media['x1'] !== false) ? $media['x1']['2'] : '';
			$ret['alternate-image-alt'] = get_post_meta($values['eg-alternate-image'], '_wp_attachment_image_alt', true);
			$ret['alternate-image-title'] = get_post_field('post_title', $values['eg-alternate-image']);

			$alt_img_full = wp_get_attachment_image_src(esc_attr($values['eg-alternate-image']), 'full');
			$ret['alternate-image-full'] = ($alt_img_full !== false && isset($alt_img_full['0'])) ? $alt_img_full['0'] : '';
			$ret['alternate-image-full-width'] = ($alt_img_full !== false) ? @$alt_img_full['1'] : '';
			$ret['alternate-image-full-height'] = ($alt_img_full !== false) ? @$alt_img_full['2'] : '';

		}

		$ret['image-fit'] = isset($values['image-fit']) && $values['image-fit'] != '-1' ? esc_attr($values['image-fit']) : '';
		$ret['image-repeat'] = isset($values['image-repeat']) && $values['image-repeat'] != '-1' ? esc_attr($values['image-repeat']) : '';
		$ret['image-align-horizontal'] = isset($values['image-align-horizontal']) && $values['image-align-horizontal'] != '-1' ? esc_attr($values['image-align-horizontal']) : '';
		$ret['image-align-vertical'] = isset($values['image-align-vertical']) && $values['image-align-vertical'] != '-1' ? esc_attr($values['image-align-vertical']) : '';

		$ret['youtube'] = isset($values['custom-youtube']) ? esc_attr($values['custom-youtube']) : '';
		$ret['vimeo'] = isset($values['custom-vimeo']) ? esc_attr($values['custom-vimeo']) : '';
		$ret['wistia'] = isset($values['wistia']) ? esc_attr($values['wistia']) : '';

		$ret['soundcloud'] = isset($values['custom-soundcloud']) ? esc_attr($values['custom-soundcloud']) : '';

		$ret['html5']['mp4'] = isset($values['custom-html5-mp4']) ? esc_attr($values['custom-html5-mp4']) : '';
		$ret['html5']['ogv'] = isset($values['custom-html5-ogv']) ? esc_attr($values['custom-html5-ogv']) : '';
		$ret['html5']['webm'] = isset($values['custom-html5-webm']) ? esc_attr($values['custom-html5-webm']) : '';

		$ret['iframe'] = isset($values['iframe']) ? esc_attr($values['iframe']) : '';
		$ret['revslider'] = isset($values['revslider']) ? esc_attr($values['revslider']) : '';
		$ret['essgrid'] = isset($values['essgrid']) ? esc_attr($values['essgrid']) : '';

		return apply_filters('essgrid_get_custom_media_source_data', $ret);
	}

	/**
	 * set basic Order List for Main Media Source
	 */
	public static function get_media_source_order()
	{
		$media = ['featured-image' => ['name' => esc_attr__('Featured Image', 'essential-grid'), 'type' => 'picture'],
			'youtube' => ['name' => esc_attr__('YouTube Video', 'essential-grid'), 'type' => 'video'],
			'vimeo' => ['name' => esc_attr__('Vimeo Video', 'essential-grid'), 'type' => 'video'],
			'wistia' => ['name' => esc_attr__('Wistia Video', 'essential-grid'), 'type' => 'video'],
			'html5' => ['name' => esc_attr__('HTML5 Video', 'essential-grid'), 'type' => 'video'],
			'soundcloud' => ['name' => esc_attr__('SoundCloud', 'essential-grid'), 'type' => 'play-circled'],
			'alternate-image' => ['name' => esc_attr__('Alternate Image', 'essential-grid'), 'type' => 'picture'],
			'iframe' => ['name' => esc_attr__('iFrame Markup', 'essential-grid'), 'type' => 'align-justify'],
			'content-image' => ['name' => esc_attr__('First Content Image', 'essential-grid'), 'type' => 'picture'],
			'content-iframe' => ['name' => esc_attr__('First Content iFrame', 'essential-grid'), 'type' => 'align-justify'],
			'content-html5' => ['name' => esc_attr__('First Content HTML5 Video', 'essential-grid'), 'type' => 'video'],
			'content-youtube' => ['name' => esc_attr__('First Content YouTube Video', 'essential-grid'), 'type' => 'video'],
			'content-vimeo' => ['name' => esc_attr__('First Content Vimeo Video', 'essential-grid'), 'type' => 'video'],
			'content-wistia' => ['name' => esc_attr__('First Content Wistia Video', 'essential-grid'), 'type' => 'video'],
			'content-soundcloud' => ['name' => esc_attr__('First Content SoundCloud', 'essential-grid'), 'type' => 'play-circled']
		];

		return apply_filters('essgrid_set_media_source_order', apply_filters('essgrid_get_media_source_order', $media));
	}

	/**
	 * set basic Order List for Lightbox Source
	 */
	public static function get_lb_source_order()
	{
		$media = ['featured-image' => ['name' => esc_attr__('Featured Image', 'essential-grid'), 'type' => 'picture'],
			'youtube' => ['name' => esc_attr__('YouTube Video', 'essential-grid'), 'type' => 'video'],
			'vimeo' => ['name' => esc_attr__('Vimeo Video', 'essential-grid'), 'type' => 'video'],
			'wistia' => ['name' => esc_attr__('Wistia Video', 'essential-grid'), 'type' => 'video'],
			'html5' => ['name' => esc_attr__('HTML5 Video', 'essential-grid'), 'type' => 'video'],
			'alternate-image' => ['name' => esc_attr__('Alternate Image', 'essential-grid'), 'type' => 'picture'],
			'content-image' => ['name' => esc_attr__('First Content Image', 'essential-grid'), 'type' => 'picture'],
			'post-content' => ['name' => esc_attr__('Post Content', 'essential-grid'), 'type' => 'doc-inv'],
			'revslider' => ['name' => esc_attr__('Slider Revolution', 'essential-grid'), 'type' => 'arrows-ccw'],
			'essgrid' => ['name' => esc_attr__('Essential Grid', 'essential-grid'), 'type' => 'th-large'],
			'soundcloud' => ['name' => esc_attr__('SoundCloud', 'essential-grid'), 'type' => 'soundcloud'],
			'iframe' => ['name' => esc_attr__('iFrame', 'essential-grid'), 'type' => 'link']
		];

		return apply_filters('essgrid_set_lb_source_order', apply_filters('essgrid_get_lb_source_order', $media));
	}

	/**
	 * set basic Order List for Lightbox Source
	 */
	public static function get_lb_button_order()
	{
		$buttons = ['share' => ['name' => esc_attr__('Social Share', 'essential-grid'), 'type' => 'forward'],
			'slideShow' => ['name' => esc_attr__('Play / Pause', 'essential-grid'), 'type' => 'play'],
			'thumbs' => ['name' => esc_attr__('Thumbnails', 'essential-grid'), 'type' => 'th'],
			'zoom' => ['name' => esc_attr__('Zoom/Pan', 'essential-grid'), 'type' => 'search'],
			'download' => ['name' => esc_attr__('Download Image', 'essential-grid'), 'type' => 'download'],
			'arrowLeft' => ['name' => esc_attr__('Left Arrow', 'essential-grid'), 'type' => 'left'],
			'arrowRight' => ['name' => esc_attr__('Right Arrow', 'essential-grid'), 'type' => 'right'],
			'close' => ['name' => esc_attr__('Close Button', 'essential-grid'), 'type' => 'cancel']
		];

		return apply_filters('essgrid_set_lb_button_order', apply_filters('essgrid_get_lb_button_order', $buttons));
	}

	/**
	 * set basic Order List for Ajax loading
	 * @since: 1.5.0
	 */
	public static function get_aj_source_order()
	{
		$media = ['post-content' => ['name' => esc_attr__('Post Content', 'essential-grid'), 'type' => 'doc-text'],
			'youtube' => ['name' => esc_attr__('YouTube Video', 'essential-grid'), 'type' => 'video'],
			'vimeo' => ['name' => esc_attr__('Vimeo Video', 'essential-grid'), 'type' => 'video'],
			'wistia' => ['name' => esc_attr__('Wistia Video', 'essential-grid'), 'type' => 'video'],
			'html5' => ['name' => esc_attr__('HTML5 Video', 'essential-grid'), 'type' => 'video'],
			'soundcloud' => ['name' => esc_attr__('SoundCloud', 'essential-grid'), 'type' => 'video'],
			'featured-image' => ['name' => esc_attr__('Featured Image', 'essential-grid'), 'type' => 'picture'],
			'alternate-image' => ['name' => esc_attr__('Alternate Image', 'essential-grid'), 'type' => 'picture'],
			'content-image' => ['name' => esc_attr__('First Content Image', 'essential-grid'), 'type' => 'picture']
		];

		return apply_filters('essgrid_set_ajax_source_order', apply_filters('essgrid_get_ajax_source_order', $media));
	}

	/**
	 * set basic Order List for Poster Orders
	 */
	public static function get_poster_source_order()
	{
		$media = ['featured-image' => ['name' => esc_attr__('Featured Image', 'essential-grid'), 'type' => 'picture'],
			'alternate-image' => ['name' => esc_attr__('Alternate Image', 'essential-grid'), 'type' => 'picture'],
			'content-image' => ['name' => esc_attr__('First Content Image', 'essential-grid'), 'type' => 'picture'],
			'youtube-image' => ['name' => esc_attr__('YouTube Thumbnail', 'essential-grid'), 'type' => 'picture'],
			'default-youtube-image' => ['name' => esc_attr__('YouTube Default Image', 'essential-grid'), 'type' => 'picture'],
			'vimeo-image' => ['name' => esc_attr__('Vimeo Thumbnail', 'essential-grid'), 'type' => 'picture'],
			'default-vimeo-image' => ['name' => esc_attr__('Vimeo Default Image', 'essential-grid'), 'type' => 'picture'],
			'default-html-image' => ['name' => esc_attr__('HTML5 Default Image', 'essential-grid'), 'type' => 'picture'],
			'no-image' => ['name' => esc_attr__('No Image', 'essential-grid'), 'type' => 'align-justify']
		];

		return apply_filters('essgrid_set_poster_source_order', apply_filters('essgrid_get_poster_source_order', $media));
	}

	/**
	 * retrieve all content gallery images in post text
	 * @since: 1.5.4
	 * @original: in Essential_Grid->check_for_shortcodes()
	 */
	public function get_all_gallery_images($content, $url = false, $source = 'full')
	{
		$ret = [];
		if (empty($content)) return apply_filters('essgrid_get_all_gallery_images', $ret, $content, $url, $source);
		
		//classic editor shortcode
		if (has_shortcode($content, 'gallery')) {
			preg_match('/\[gallery.*ids=.(.*).\]/', $content, $img_ids);
			if (isset($img_ids[1])) {
				if (!$url) {
					if ($img_ids[1] !== '') $ret = explode(',', $img_ids[1]);
				} else { //get URL instead of ID
					$images = [];
					$imgs = explode(',', $img_ids[1]);
					foreach ($imgs as $img) {
						$t_img = wp_get_attachment_image_src($img, $source);
						if ($t_img !== false) {
							$images[] = $t_img[0];
						}
					}
					$ret = $images;
				}
			}
		}
		
		//gutenberg block
		if (empty($ret) && function_exists('parse_blocks')) {
			
			$blocks = parse_blocks($content);
			foreach ($blocks as $block) {
				if ( 'core/gallery' !== $block['blockName'] ) continue;
				foreach ( $block['innerBlocks'] as $inner_block ) {
					if ( 'core/image' === $inner_block['blockName'] && isset( $inner_block['attrs']['id'] ) ) {
						if (!$url) {
							$ret[] = $inner_block['attrs']['id'];
						} else {
							$t_img = wp_get_attachment_image_src($inner_block['attrs']['id'], $source);
							if ($t_img !== false) {
								$ret[] = $t_img[0];
							}
						}
					}
				}
			}
			
		}

		return apply_filters('essgrid_get_all_gallery_images', $ret, $content, $url, $source);
	}

	/**
	 * retrieve the first content image in post text
	 */
	public function get_first_content_image($post_id, $post = false)
	{
		if ($post_id != -1)
			$post = get_post($post_id);

		$first_img = '';
		
		// phpcs:ignore PluginCheck.CodeAnalysis.ImageFunctions.NonEnqueuedImage
		preg_match_all('/<img.+src=[\'"]([^\'"]+)[\'"].*>/i', $post->post_content, $matches);

		if (isset($matches[1][0]))
			$first_img = $matches[1][0];

		if (empty($first_img)) {
			$first_img = '';
		}

		return apply_filters('essgrid_get_first_content_image', $first_img, $post_id, $post);
	}

	/**
	 * retrieve all content images in post text
	 * @since: 1.5.4
	 */
	public function get_all_content_images($post_id, $post = false, $source = 'full')
	{
		if ($post_id != -1)
			$post = get_post($post_id);

		$images = [];
		
		preg_match_all('/<img[^>]*src\s?=\s?([\'"])((?:(?!\1).)*)[^>]*>/i', $post->post_content, $matches);

		if (isset($matches[2][0]))
			$images = $matches[2];

		if (empty($images)) {
			$images = [];
		} else {
			if ($source !== 'full') {
				foreach ($images as $i => $img) {
					$img_id = attachment_url_to_postid($img);
					$_img = wp_get_attachment_image_src($img_id, $source);
					$images[$i] = (!empty($_img)) ? $_img[0] : $img;
				}
			}
		}

		return apply_filters('essgrid_get_all_content_images', $images, $post_id, $post);
	}

	/**
	 * retrieve the first iframe in the post text
	 * @since: 1.2.0
	 */
	public function get_first_content_iframe($post_id, $post = false)
	{
		if ($post_id != -1)
			$post = get_post($post_id);

		$first_iframe = '';
		
		preg_match_all('/<iframe.+src=[\'"]([^\'"]+)[\'"].*>/i', $post->post_content, $matches);

		if (isset($matches[0][0]))
			$first_iframe = $matches[0][0];

		if (empty($first_iframe)) {
			$first_iframe = '';
		}

		return apply_filters('essgrid_get_first_content_iframe', $first_iframe, $post_id, $post);
	}

	/**
	 * retrieve the first YouTube video in the post text
	 * @since: 1.2.0
	 */
	public function get_first_content_youtube($post_id, $post = false)
	{
		if ($post_id != -1)
			$post = get_post($post_id);

		$first_yt = '';
		
		preg_match_all('/(http:|https:|:)?\/\/(?:[0-9A-Z-]+\.)?(?:youtu\.be\/|youtube\.com(?:\/embed\/|\/v\/|\/watch\?v=|\/ytscreeningroom\?v=|\/feeds\/api\/videos\/|\/user\S*[^\w\-\s]|\S*[^\w\-\s]))([\w\-]{11})[?=&+%\w-]*/i', $post->post_content, $matches);

		if (isset($matches[2][0]))
			$first_yt = $matches[2][0];

		if (empty($first_yt)) {
			$first_yt = '';
		}

		return apply_filters('essgrid_get_first_content_youtube', $first_yt, $post_id, $post);
	}

	/**
	 * retrieve the first vimeo video in the post text
	 * @since: 1.2.0
	 */
	public function get_first_content_vimeo($post_id, $post = false)
	{
		if ($post_id != -1)
			$post = get_post($post_id);

		$first_vim = '';
		
		preg_match_all('/(http:|https:|:)?\/\/?vimeo\.com\/([0-9a-z\/]+)\??|player\.vimeo\.com\/video\/([0-9a-z\/]+)\??/i', $post->post_content, $matches);

		if (!empty($matches[2][0]))
			$first_vim = $matches[2][0];
		if (!empty($matches[3][0]))
			$first_vim = $matches[3][0];

		return apply_filters('essgrid_get_first_content_vimeo', $first_vim, $post_id, $post);
	}

	/**
	 * retrieve the first wistia video in the post text
	 * @since: 2.0.6
	 */
	public function get_first_content_wistia($post_id, $post = false)
	{
		if ($post_id != -1)
			$post = get_post($post_id);

		$first_ws = '';
		
		preg_match_all('/(http:|https:|:)?\/\/?wistia\.net\/([0-9]+)\??|player\.wistia\.net\/video\/([0-9]+)\??/i', $post->post_content, $matches);
		if (isset($matches[2][0]))
			$first_ws = $matches[2][0];

		if (empty($first_ws)) {
			preg_match_all("/wistia\.com\/(medias|embed)\/([0-9a-z]+)/i", $post->post_content, $matches);
			if (isset($matches[2][0]))
				$first_ws = $matches[2][0];
			if (empty($first_ws)) {
				$first_ws = '';
			}
		}

		return apply_filters('essgrid_get_first_content_wistia', $first_ws, $post_id, $post);
	}

	/**
	 * retrieve the first video in the post text
	 * @since: 1.2.0
	 */
	public function get_first_content_video($post_id, $post = false)
	{
		if ($post_id != -1)
			$post = get_post($post_id);

		$video = false;
		
		preg_match_all("'<video>(.*?)</video>'si", $post->post_content, $matches);

		if (isset($matches[0][0])) {
			preg_match_all('/<source.+src=[\'"]([^\'"]+)[\'"].*>/i', $matches[0][0], $video_match);
			if (isset($video_match[1]) && is_array($video_match[1])) {
				foreach ($video_match[1] as $video_source) {
					$vid = explode('.', $video_source);
					switch (end($vid)) {
						case 'ogv':
							$video['ogv'] = $video_source;
							break;
						case 'webm':
							$video['webm'] = $video_source;
							break;
						case 'mp4':
							$video['mp4'] = $video_source;
							break;
					}
				}
			}
		}

		if (empty($video)) {
			$video = false;
		}

		return apply_filters('essgrid_get_first_content_video', $video, $post_id, $post);
	}

	/**
	 * retrieve the first soundcloud in the post text
	 * @since: 1.2.0
	 */
	public function get_first_content_soundcloud($post_id, $post = false)
	{
		if ($post_id != -1)
			$post = get_post($post_id);

		$first_sc = '';
		
		preg_match_all('/\/\/api.soundcloud.com\/tracks\/(.[0-9]*)/i', $post->post_content, $matches);

		if (isset($matches[1][0]))
			$first_sc = $matches[1][0];
		if (empty($first_sc)) {
			$first_sc = '';
		}

		return apply_filters('essgrid_get_first_content_soundcloud', $first_sc, $post_id, $post);
	}

	/**
	 * prints out numbers in YouTube format
	 * @since: 2.1.0
	 */
	public static function thousandsViewFormat($num)
	{
		_deprecated_function( __FUNCTION__, '3.1.9.4', 'esg_thousands_view_format' );
		return esg_thousands_view_format( $num );
	}

	/**
	 * detect device type
	 * @since: 3.0.14
	 */
	public static function detect_device()
	{
		try {
			$detect = new \Esg\Detection\MobileDetect();
			$isMobile = $detect->isMobile();
			$isTablet = $detect->isTablet();
		} catch (Exception $e) {
			$isMobile = false;
			$isTablet = false;
		}
		
		return ($isMobile ? ($isTablet ? 'tablet' : 'mobile') : 'desktop');
	}
	
	/**
	 * get all device types along with column keys to get device width
	 * keys can be checked in get_basic_devices()
	 * default width can be checked in set_basic_columns_width()
	 * 
	 * @since: 3.0.14
	 */
	public static function get_device_columns()
	{
		return [
			[
				'device' => 'desktop',
				'columns' => [0, 1, 2, 3],
			],
			[
				'device' => 'tablet',
				'columns' => [4, 5],
			],
			[
				'device' => 'mobile',
				'columns' => [6, 7],
			],
		];
	}

	/**
	 * clear transients by pattern
	 * 
	 * @param string $pattern
	 * @return void
	 */
	public static function clear_transients($pattern)
	{
		global $wpdb;

		// phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching
		$transients = $wpdb->get_results(
			$wpdb->prepare(
				"SELECT REPLACE(option_name, '_transient_', '') as option_name FROM $wpdb->options WHERE `option_name` LIKE %s",
				'%' . $wpdb->esc_like($pattern) . '%'
			),
			ARRAY_A
		);
		foreach ($transients as $t) {
			delete_transient($t['option_name']);
		}
	}

	/**
	 * @return WP_Filesystem_Direct
	 */
	public static function get_filesystem()
	{
		_deprecated_function( __FUNCTION__, '3.1.9.4', 'esg_get_filesystem');
		return esg_get_filesystem();
	}

}