PluginProbe
Templately – Elementor & Gutenberg Template Library: 6500+ Free & Pro Ready Templates And Cloud! / 3.4.9
Templately – Elementor & Gutenberg Template Library: 6500+ Free & Pro Ready Templates And Cloud! v3.4.9
3.7.5 3.7.4 3.7.3 3.7.2 1-final 3.7.1 3.7.0 3.6.8 3.6.7 3.6.6 3.6.5 3.6.4 3.6.3 3.6.2 3.6.1 3.0.3 3.0.4 3.0.5 3.0.6 3.0.7 3.0.8 3.0.9 3.1.0 3.1.1 3.1.10 All 111 releases
← All changes | includes/Utils/Helper.php +382 -86 3.1.03.4.9 View file →
@@ -1,11 +1,15 @@
1 1 <?php
2 +
2 3 namespace Templately\Utils;
3 4
5 +use Elementor\Plugin;
6 +use Templately\Core\Importer\Utils\Utils;
4 7 use WP_Error;
5 8 use WP_REST_Response;
6 9 use function get_plugins;
7 10 use function is_plugin_active;
11 +
8 12 /**
9 13 * Utility Helper for Templately
10 14 *
11 15 * This class contains some helper functions for easy access.
@@ -12,31 +16,46 @@
12 16 *
13 17 * @since 1.0.0
14 18 */
15 19 class Helper extends Base {
16 - /**
17 - * Get installed WordPress Plugin List
18 - * @return array
19 - */
20 - public static function get_plugins(){
21 - if( ! function_exists( 'get_plugins' ) ) {
22 - require_once ABSPATH . 'wp-admin/includes/plugin.php';
23 - }
24 - return get_plugins();
25 - }
20 + /**
21 + * Check if development API should be used
22 + *
23 + * @return bool True if development API should be used
24 + */
25 + public static function is_dev_api(){
26 + // Only check TEMPLATELY_DEV_API constant - no fallback mechanisms
27 + return defined( 'TEMPLATELY_DEV_API' ) && constant( 'TEMPLATELY_DEV_API' );
28 + }
26 29
27 - /**
28 - * Get installed WordPress Plugin List
29 - * @return boolean
30 - */
31 - public static function is_plugin_active( $plugin ){
32 - if( ! function_exists( 'is_plugin_active' ) ) {
33 - require_once ABSPATH . 'wp-admin/includes/plugin.php';
34 - }
35 - return is_plugin_active( $plugin );
36 - }
30 + /**
31 + * Get installed WordPress Plugin List
32 + * @return array
33 + */
34 + public static function get_plugins() {
35 + if (! function_exists('get_plugins')) {
36 + require_once ABSPATH . 'wp-admin/includes/plugin.php';
37 + }
38 + return get_plugins();
39 + }
40 + public static function is_plugins_installed($plugin_file) {
41 + $_plugins = self::get_plugins();
42 + $is_installed = isset($_plugins[$plugin_file]);
43 + return $is_installed;
44 + }
37 45
38 - /**
46 + /**
47 + * Get installed WordPress Plugin List
48 + * @return boolean
49 + */
50 + public static function is_plugin_active($plugin) {
51 + if (! function_exists('is_plugin_active')) {
52 + require_once ABSPATH . 'wp-admin/includes/plugin.php';
53 + }
54 + return is_plugin_active($plugin);
55 + }
56 +
57 + /**
39 58 * Collect IP from request.
40 59 *
41 60 * @return string
42 61 */
@@ -41,37 +60,145 @@
41 60 * @return string
42 61 */
43 62 public static function get_ip() {
44 63 $ip = '127.0.0.1'; // Local IP
45 - if ( ! empty( $_SERVER['HTTP_CLIENT_IP'] ) ) {
64 + if (! empty($_SERVER['HTTP_CLIENT_IP'])) {
46 65 $ip = $_SERVER['HTTP_CLIENT_IP'];
47 - } elseif ( ! empty( $_SERVER['HTTP_X_FORWARDED_FOR'] ) ) {
66 + } elseif (! empty($_SERVER['HTTP_X_FORWARDED_FOR'])) {
48 67 $ip = $_SERVER['HTTP_X_FORWARDED_FOR'];
49 68 } else {
50 - $ip = ! empty( $_SERVER['REMOTE_ADDR'] ) ? $_SERVER['REMOTE_ADDR'] : $ip;
69 + $ip = ! empty($_SERVER['REMOTE_ADDR']) ? $_SERVER['REMOTE_ADDR'] : $ip;
51 70 }
52 71
53 - return sanitize_text_field( $ip );
72 + return sanitize_text_field($ip);
54 73 }
55 74
56 - /**
57 - * Get views for front-end display
58 - *
59 - * @param string $name it will be file name only from the view's folder.
60 - * @param array $data
61 - * @return void
62 - */
63 - public static function views( $name, $data = [] ){
64 - extract( $data );
65 - $helper = self::class;
66 - $file = TEMPLATELY_PATH . 'views/' . $name . '.php';
75 + /**
76 + * Get views for front-end display
77 + *
78 + * @param string $name it will be file name only from the view's folder.
79 + * @param array $data
80 + * @return void
81 + */
82 + public static function views($name, $data = []) {
83 + extract($data);
84 + $helper = self::class;
85 + $file = TEMPLATELY_PATH . 'views/' . $name . '.php';
67 86
68 - if( is_readable( $file ) ) {
69 - include_once $file;
70 - }
71 - }
87 + if (is_readable($file)) {
88 + include_once $file;
89 + }
90 + }
72 91
73 92 /**
93 + * Get API URL for Templately endpoints
94 + *
95 + * @param string $endpoint API endpoint path (e.g., 'v2/import/pack/123')
96 + * @return string Complete API URL
97 + */
98 + public static function get_api_url($endpoint): string {
99 + $base_url = self::is_dev_api() ? 'https://app.templately.dev' : 'https://app.templately.com';
100 +
101 + /**
102 + * Filter the base URL for development API
103 + *
104 + * @since 3.5.0
105 + * @param string $base_url The default base URL
106 + */
107 + $base_url = apply_filters('templately_dev_api_base_url', $base_url);
108 +
109 + return "{$base_url}/api/{$endpoint}";
110 + }
111 +
112 + /**
113 + * Make a unified API request to Templately API
114 + *
115 + * @param string $method HTTP method (GET or POST)
116 + * @param string $api_url Complete API URL
117 + * @param array $body Request body data (for POST requests)
118 + * @param array $extra_headers Additional headers beyond the standard ones
119 + * @param int $timeout Request timeout in seconds (default: 30)
120 + * @return array|WP_Error Response array or WP_Error on failure
121 + */
122 + private static function make_api_request($method, $api_url, $body = [], $extra_headers = [], $timeout = 30) {
123 + $api_key = Options::get_instance()->get('api_key');
124 +
125 + $headers = [
126 + 'Authorization' => 'Bearer ' . $api_key,
127 + 'x-templately-ip' => self::get_ip(),
128 + 'x-templately-url' => home_url('/'),
129 + 'x-templately-version' => defined( 'TEMPLATELY_VERSION' ) ? constant( 'TEMPLATELY_VERSION' ) : '1.0.0',
130 + ];
131 +
132 + // Add Content-Type for POST requests
133 + if (strtoupper($method) === 'POST') {
134 + $headers['Content-Type'] = 'application/json';
135 + }
136 +
137 + // Merge additional headers
138 + $headers = array_merge($headers, $extra_headers);
139 +
140 + $args = [
141 + 'timeout' => $timeout,
142 + 'headers' => $headers,
143 + ];
144 +
145 + // Apply filter to allow network admin or other functionality to modify request args
146 + $args = apply_filters( 'templately_api_request_params', $args, $method, $api_url );
147 +
148 + // Add body for POST requests
149 + if (strtoupper($method) === 'POST') {
150 + $args['body'] = is_array($body) ? json_encode($body) : $body;
151 + }
152 +
153 + // Make the appropriate request
154 + if (strtoupper($method) === 'POST') {
155 + $response = wp_remote_post($api_url, $args);
156 + } else {
157 + $response = wp_remote_get($api_url, $args);
158 + }
159 +
160 + // Check for verification header in the response
161 + self::check_verification_header($response);
162 +
163 + return $response;
164 + }
165 +
166 + /**
167 + * Make a GET request to Templately API
168 + *
169 + * @param string $endpoint API endpoint path (e.g., 'v2/import/pack/123')
170 + * @param array $query_params Query parameters as key-value pairs
171 + * @param array $extra_headers Additional headers beyond the standard ones
172 + * @param int $timeout Request timeout in seconds (default: 30)
173 + * @return array|WP_Error Response array or WP_Error on failure
174 + */
175 + public static function make_api_get_request($endpoint, $query_params = [], $extra_headers = [], $timeout = 30) {
176 + $api_url = self::get_api_url($endpoint);
177 +
178 + // Add query parameters if provided
179 + if (!empty($query_params)) {
180 + $api_url = add_query_arg($query_params, $api_url);
181 + }
182 +
183 + return self::make_api_request('GET', $api_url, [], $extra_headers, $timeout);
184 + }
185 +
186 + /**
187 + * Make a POST request to Templately API
188 + *
189 + * @param string $endpoint API endpoint path (e.g., 'v2/feedback/store')
190 + * @param array $body Request body data
191 + * @param array $extra_headers Additional headers beyond the standard ones
192 + * @param int $timeout Request timeout in seconds (default: 30)
193 + * @return array|WP_Error Response array or WP_Error on failure
194 + */
195 + public static function make_api_post_request($endpoint, $body = [], $extra_headers = [], $timeout = 30) {
196 + $api_url = self::get_api_url($endpoint);
197 + return self::make_api_request('POST', $api_url, $body, $extra_headers, $timeout);
198 + }
199 +
200 + /**
74 201 * Sanitize Helper
75 202 *
76 203 * @param mixed $value
77 204 * @param string $type
@@ -77,15 +204,15 @@
77 204 * @param string $type
78 205 *
79 206 * @return bool|string
80 207 */
81 - public static function sanitize( $value, $type = 'text' ){
82 - switch ( $type ) {
208 + public static function sanitize($value, $type = 'text') {
209 + switch ($type) {
83 210 case 'boolean':
84 - $sanitized_value = rest_sanitize_boolean( $value );
211 + $sanitized_value = rest_sanitize_boolean($value);
85 212 break;
86 213 default:
87 - $sanitized_value = sanitize_text_field( $value );
214 + $sanitized_value = sanitize_text_field($value);
88 215 break;
89 216 }
90 217
91 218 return $sanitized_value;
@@ -91,8 +218,61 @@
91 218 return $sanitized_value;
92 219 }
93 220
94 221 /**
222 + * Check for X-Templately-Verified header and update user verification status
223 + *
224 + * @param array|WP_Error $response The HTTP response array from wp_remote_get/wp_remote_post
225 + * @return void
226 + */
227 + public static function check_verification_header($response) {
228 + // Only process if response is not a WP_Error and contains headers
229 + if (is_wp_error($response)) {
230 + return;
231 + }
232 +
233 + // Retrieve the X-Templately-Verified header
234 + $verification_header = wp_remote_retrieve_header($response, 'X-Templately-Verified');
235 +
236 + // Check if header exists and has a truthy value
237 + if (!empty($verification_header) && filter_var($verification_header, FILTER_VALIDATE_BOOLEAN)) {
238 + try {
239 + // Get current user data
240 + $options = Options::get_instance();
241 + $user = $options->get('user');
242 +
243 + // Only update if user data exists and is not already verified
244 + if (!empty($user) && is_array($user) && empty($user['is_verified'])) {
245 + // Set verification flag
246 + $user['is_verified'] = true;
247 +
248 + // Save updated user data
249 + $options->set('user', $user);
250 +
251 + }
252 +
253 + if (!empty($user['is_verified'])){
254 + if(!headers_sent()){
255 + header( 'X-Templately-Verified: true' );
256 + if (defined('TEMPLATELY_DEBUG_LOG') && constant('TEMPLATELY_DEBUG_LOG')) {
257 + self::log('User verification status already updated via X-Templately-Verified header');
258 + }
259 + }
260 +
261 + return true;
262 + }
263 + } catch (\Exception $e) {
264 + // Log error if debug logging is enabled
265 + if (defined('TEMPLATELY_DEBUG_LOG') && constant('TEMPLATELY_DEBUG_LOG')) {
266 + self::log('Error updating user verification status: ' . $e->getMessage());
267 + }
268 + }
269 + }
270 +
271 + return false;
272 + }
273 +
274 + /**
95 275 * API Error Formatter
96 276 *
97 277 * @param int $error_code
98 278 * @param mixed $error_message
@@ -100,15 +280,18 @@
100 280 * @param integer $status
101 281 * @param array $additional_data
102 282 * @return WP_Error
103 283 */
104 - public static function error( $error_code, $error_message, $endpoint = '', $status = 500, $additional_data = [] ) {
284 + public static function error($error_code, $error_message, $endpoint = '', $status = 500, $additional_data = []) {
105 285 $additional_data['status'] = $status;
106 - if ( ! empty( $endpoint ) ) {
286 + if (! empty($endpoint)) {
107 287 $additional_data['endpoint'] = $endpoint;
108 288 }
289 + // Add browser padding to avoid browsers not serving small JSON responses
290 + $padding_length = 512;
291 + $additional_data['browser_padding'] = str_repeat(' ', $padding_length);
109 292
110 - return new WP_Error( $error_code, $error_message, $additional_data );
293 + return new WP_Error($error_code, $error_message, $additional_data);
111 294 }
112 295
113 296 /**
114 297 * API Response Formatter
@@ -115,10 +298,10 @@
115 298 *
116 299 * @param mixed $data
117 300 * @return WP_REST_Response
118 301 */
119 - public static function success( $data ) {
120 - return new WP_REST_Response( $data, 200 );
302 + public static function success($data) {
303 + return new WP_REST_Response($data, 200);
121 304 }
122 305
123 306 /**
124 307 * Normalize Favourites Data
@@ -128,42 +311,42 @@
128 311 * @param boolean $undo
129 312 *
130 313 * @return array
131 314 */
132 - public function normalizeFavourites( $favourites, $_favourites = [], $undo = false ){
133 - if( $undo ) {
134 - $_favourites[ $favourites['type'] ] = array_values(array_filter( $_favourites[ $favourites['type'] ], function( $item ) use( $favourites ) {
315 + public function normalizeFavourites($favourites, $_favourites = [], $undo = false) {
316 + if ($undo) {
317 + $_favourites[$favourites['type']] = array_values(array_filter($_favourites[$favourites['type']], function ($item) use ($favourites) {
135 318 return $item != $favourites['id'];
136 - } ));
319 + }));
137 320 return $_favourites;
138 321 }
139 322
140 - array_map( function( $item ) use ( &$_favourites) {
141 - if( ! is_null( $item ) ) {
323 + array_map(function ($item) use (&$_favourites) {
324 + if (! is_null($item)) {
142 325 $item = (array) $item;
143 - if ( isset( $_favourites[ $item['type'] ] ) ){
144 - $_favourites[ $item['type'] ][] = $item['id'];
326 + if (isset($_favourites[$item['type']])) {
327 + $_favourites[$item['type']][] = $item['id'];
145 328 } else {
146 - $_favourites[ $item['type'] ] = [ $item['id'] ];
329 + $_favourites[$item['type']] = [$item['id']];
147 330 }
148 331 }
149 332 return $_favourites;
150 - }, $favourites );
333 + }, $favourites);
151 334
152 335 return $_favourites;
153 336 }
154 337
155 - public function normalizeReviews( $favourites, $_favourites = [], $undo = false ){
156 - array_map( function( $item ) use ( &$_favourites) {
157 - if( ! is_null( $item ) ) {
338 + public function normalizeReviews($favourites, $_favourites = [], $undo = false) {
339 + array_map(function ($item) use (&$_favourites) {
340 + if (! is_null($item)) {
158 341 $item = (array) $item;
159 - if ( !isset( $_favourites[ $item['type'] ] ) ){
160 - $_favourites[ $item['type'] ] = [];
342 + if (!isset($_favourites[$item['type']])) {
343 + $_favourites[$item['type']] = [];
161 344 }
162 - $_favourites[ $item['type'] ][$item['type_id']] = $item['rating'];
345 + $_favourites[$item['type']][$item['type_id']] = $item['rating'];
163 346 }
164 347 return $_favourites;
165 - }, $favourites );
348 + }, $favourites);
166 349
167 350 return $_favourites;
168 351 }
169 352
@@ -172,10 +355,10 @@
172 355 *
173 356 * @param object $triggered_by
174 357 * @return void
175 358 */
176 - public static function trigger_error( $triggered_by, $method = 'get_instance' ){
177 - $class = get_class( $triggered_by );
359 + public static function trigger_error($triggered_by, $method = 'get_instance') {
360 + $class = get_class($triggered_by);
178 361 $trace = debug_backtrace(); // phpcs:ignore PHPCompatibility.FunctionUse.ArgumentFunctionsReportCurrentValue.NeedsInspection
179 362 $file = $trace[0]['file'];
180 363 $line = $trace[0]['line'];
181 364 trigger_error("Call to undefined method $class::$method() in $file on line $line", E_USER_ERROR);
@@ -183,22 +366,63 @@
183 366
184 367 /**
185 368 * Printing Error Logs in debug.log file.
186 369 *
187 - * @param mixed $log
370 + * @param mixed $log The data to log
371 + * @param string $context Optional context for categorizing log entries
372 + * @param string $level Optional log level (debug, info, warning, error)
188 373 * @return void
189 374 */
190 - public static function log( $log ){
191 - if ( defined('WP_DEBUG_LOG') && WP_DEBUG_LOG === true ) {
192 - if ( is_array( $log ) || is_object( $log ) ) {
193 - error_log( print_r( $log, true ) );
194 - } else {
195 - error_log( $log ?: '' );
196 - }
375 + public static function log($log, $context = '', $level = 'info') {
376 + // Allow complete override of logging behavior
377 + $override_result = apply_filters('templately_log_override', null, $log, $context, $level);
378 + if ($override_result !== null) {
379 + return;
197 380 }
381 +
382 + // Only log if WP_DEBUG_LOG is enabled
383 + if (!defined('WP_DEBUG_LOG') || !WP_DEBUG_LOG) {
384 + return;
385 + }
386 +
387 + // Format the log message
388 + $formatted_message = self::format_log_message($log, $context, $level);
389 +
390 + // Write to error log
391 + error_log($formatted_message);
198 392 }
199 393
200 - public static function should_flush(){
394 + /**
395 + * Format log message with context and level
396 + *
397 + * @param mixed $log The data to log
398 + * @param string $context Context for categorizing log entries
399 + * @param string $level Log level
400 + * @return string Formatted log message
401 + */
402 + private static function format_log_message($log, $context = '', $level = 'info') {
403 + // Convert arrays and objects to readable format
404 + if (is_array($log) || is_object($log)) {
405 + $log_content = print_r($log, true);
406 + } else {
407 + $log_content = (string) ($log ?: '');
408 + }
409 +
410 + // Build the formatted message
411 + $timestamp = current_time('Y-m-d H:i:s');
412 + $level_upper = strtoupper($level);
413 +
414 + if (!empty($context)) {
415 + return "[{$timestamp}] [{$level_upper}] [{$context}] {$log_content}";
416 + } else {
417 + return "[{$timestamp}] [{$level_upper}] {$log_content}";
418 + }
419 + }
420 +
421 + public static function should_flush() {
422 + if (isset($_REQUEST['is_lightspeed']) && $_REQUEST['is_lightspeed'] === 'true') {
423 + return false;
424 + }
201 425 return (!defined('TEMPLATELY_IGNORE_FLUSH_ALL') || !TEMPLATELY_IGNORE_FLUSH_ALL) && strpos($_SERVER['SERVER_SOFTWARE'], 'LiteSpeed') === false;
202 426 }
203 427
204 428 public static function get_block_by_name($blocks, $search) {
@@ -206,9 +430,9 @@
206 430
207 431 while (!empty($queue)) {
208 432 $current_block = array_shift($queue);
209 433
210 - if($search === $current_block['blockName']){
434 + if ($search === $current_block['blockName']) {
211 435 return $current_block;
212 436 }
213 437
214 438 if (isset($current_block['innerBlocks'])) {
@@ -230,13 +454,13 @@
230 454 public static function current_user_can($cap, ...$args) {
231 455 $user = wp_get_current_user();
232 456
233 457 // Multisite super admin has all caps by definition, Unless specifically denied.
234 - if ( is_multisite() && is_super_admin( $user->ID ) ) {
458 + if (is_multisite() && is_super_admin($user->ID)) {
235 459 return true;
236 460 }
237 461
238 - $caps = map_meta_cap( $cap, $user->ID, ...$args );
462 + $caps = map_meta_cap($cap, $user->ID, ...$args);
239 463
240 464 switch ($cap) {
241 465 case 'install_plugins':
242 466 case 'upload_plugins':
@@ -256,24 +480,24 @@
256 480 break;
257 481 }
258 482
259 483 // Maintain BC for the argument passed to the "user_has_cap" filter.
260 - $args = array_merge( array( $cap, $user->ID ), $args );
484 + $args = array_merge(array($cap, $user->ID), $args);
261 485
262 486 /**
263 487 * See WP_User::has_cap() for description.
264 488 */
265 - $capabilities = apply_filters( 'user_has_cap', $user->allcaps, $caps, $args, $user );
489 + $capabilities = apply_filters('user_has_cap', $user->allcaps, $caps, $args, $user);
266 490
267 491 // Everyone is allowed to exist.
268 492 $capabilities['exist'] = true;
269 493
270 494 // Nobody is allowed to do things they are not allowed to do.
271 - unset( $capabilities['do_not_allow'] );
495 + unset($capabilities['do_not_allow']);
272 496
273 497 // Must have ALL requested caps.
274 - foreach ( (array) $caps as $cap ) {
275 - if ( empty( $capabilities[ $cap ] ) ) {
498 + foreach ((array) $caps as $cap) {
499 + if (empty($capabilities[$cap])) {
276 500 return false;
277 501 }
278 502 }
279 503
@@ -279,5 +503,77 @@
279 503
280 504 return true;
281 505 }
282 506
283 -}
507 + /**
508 + * Calculates the elapsed time and checks if it is close to the maximum execution time.
509 + * Returns true if the script should exit to avoid exceeding the limit.
510 + *
511 + * @return bool True if the script should exit, false otherwise.
512 + */
513 + public static function fsi_should_exit() {
514 + if (defined('TEMPLATELY_START_TIME') && ini_get('max_execution_time')) {
515 + $max_time = ini_get('max_execution_time');
516 + $elapsed = microtime(true) - TEMPLATELY_START_TIME;
517 + $delay = max(5, $max_time * 20 / 100);
518 +
519 + // Check if elapsed time is close to max execution time
520 + if ($max_time - $elapsed <= $delay) {
521 + return ['max_time' => $max_time, 'elapsed' => $elapsed, 'delay' => $delay];
522 + }
523 + }
524 + return false;
525 + }
526 +
527 + /**
528 + * Enable Elementor Container
529 + * This function will enable the Elementor Container feature.
530 + * Without this feature, some of the templates may not work properly.
531 + *
532 + * @return boolean
533 + */
534 + public static function enable_elementor_container() {
535 + if (class_exists('Elementor\Plugin')) {
536 + $control_name = Plugin::instance()->experiments->get_feature_option_key('container');
537 + if (get_option($control_name) !== 'active') {
538 + update_option($control_name, 'active');
539 + return true;
540 + }
541 + }
542 + return false;
543 + }
544 +
545 + /**
546 + * Undocumented function
547 + *
548 + * @param [type] $args
549 + * @param [type] $defaults
550 + * @return array
551 + */
552 + public static function recursive_wp_parse_args($args, $defaults) {
553 + $args = (array) $args;
554 + $defaults = (array) $defaults;
555 + $r = $defaults;
556 + foreach ($args as $key => $value) {
557 + if (is_array($value) && isset($r[$key])) {
558 + // also handle numeric array. if both $value and $r[ $key ] are numeric array. wp_is_numeric_array()
559 + if (wp_is_numeric_array($value) && wp_is_numeric_array($r[$key])) {
560 + foreach ($value as $k => $v) {
561 + if (!in_array($v, $r[$key])) {
562 + if (!isset($r[$key][$k])) {
563 + $r[$key][$k] = $v;
564 + } else {
565 + $r[$key][] = $v;
566 + }
567 + }
568 + }
569 + } else {
570 + $r[$key] = self::recursive_wp_parse_args($value, $r[$key]);
571 + }
572 + } else {
573 + $r[$key] = $value;
574 + }
575 + }
576 + return $r;
577 + }
578 +
579 +}