''
]
);
$selector = 'main#main';
return apply_filters(
'blocksy:customizer:sync:whole-page',
array_merge(
[
'selector' => $selector,
'container_inclusive' => true,
'render' => function () {
echo blocksy_replace_current_template();
}
],
$args
)
);
}
function blocksy_get_with_percentage($id, $value) {
$val = blocksy_get_theme_mod($id, $value);
if (strpos($value, '%') !== false && is_numeric($val)) {
$val .= '%';
}
return str_replace('%%', '%', $val);
}
/**
* Link to menus editor for every empty menu.
*
* @param array $args Menu args.
*/
if (! function_exists('blocksy_link_to_menu_editor')) {
function blocksy_link_to_menu_editor($args) {
if (! current_user_can('manage_options')) {
return;
}
// see wp-includes/nav-menu-template.php for available arguments
// phpcs:ignore WordPress.PHP.DontExtract.extract_extract
extract($args);
$output = '';
if (! empty($container)) {
$output = "<$container>$output";
}
if ($echo) {
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
echo wp_kses_post($output);
}
return $output;
}
}
/**
* Extract variable from a file.
*
* PARITY: mirrored by the companion's blocksy_companion_get_variables_from_file()
* (framework/helpers/helpers.php) — keep both in sync.
*
* @param string $file_path path to file.
* @param array $_extract_variables variables to return.
* @param array $_set_variables variables to pass into the file.
*/
function blocksy_get_variables_from_file(
$file_path,
array $_extract_variables,
array $_set_variables = array()
) {
// phpcs:ignore WordPress.PHP.DontExtract.extract_extract
extract($_set_variables, EXTR_REFS);
unset($_set_variables);
if (is_file($file_path)) {
try {
require $file_path;
} catch (\Throwable $e) {
blocksy_handle_contained_fatal($e, $file_path);
}
}
foreach ($_extract_variables as $variable_name => $default_value) {
if (isset($$variable_name) ) {
$_extract_variables[$variable_name] = $$variable_name;
}
}
return $_extract_variables;
}
/**
* Safe render a view and return html
* In view will be accessible only passed variables
* Use this function to not include files directly and to not give access to current context variables (like $this)
*
* PARITY: mirrored by the companion's blocksy_companion_render_view()
* (framework/helpers/helpers.php) — keep both in sync.
*
* @param string $file_path File path.
* @param array $view_variables Variables to pass into the view.
*
* @return string HTML.
*/
if (! function_exists('blocksy_render_view')) {
function blocksy_render_view(
$file_path,
$view_variables = [],
$default_value = ''
) {
if (! is_file($file_path)) {
return $default_value;
}
// phpcs:ignore WordPress.PHP.DontExtract.extract_extract
extract($view_variables, EXTR_REFS);
unset($view_variables);
ob_start();
try {
require $file_path;
} catch (\Throwable $e) {
ob_end_clean();
blocksy_handle_contained_fatal($e, $file_path);
return $default_value;
}
return ob_get_clean();
}
}
/**
* Echo the result of blocksy_render_view().
*
* PARITY: mirrored by the companion's blocksy_companion_render_view_e()
* (framework/helpers/helpers.php) — keep both in sync.
*
* @param string $file_path File path.
* @param array $view_variables Variables to pass into the view.
* @param string $default_value Echoed when the file is missing.
*
* @return void
*/
function blocksy_render_view_e($file_path, $view_variables = [], $default_value = '') {
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
echo blocksy_render_view($file_path, $view_variables, $default_value);
}
/**
* Contain a fatal thrown while a view/options file is being `require`d. A missing
* function/class throws \Error (a \Throwable) since PHP 7, so the require can be
* wrapped to keep one broken file from white-screening the whole request — the
* #5212 "theme/companion mid-swap" failure mode.
*
* Logs through blocksy_debug_log(), passing the \Throwable itself as the object so
* the full detail — message, file:line and the backtrace — is captured: print_r'd
* into the error_log, and handed live to the `blocksy:theme:debug-log` action for
* any listener. In development it re-throws so the bug isn't silently swallowed;
* the re-throw is filterable via `blocksy:theme:contained-fatal:rethrow`.
*
* PARITY: mirrored by the companion's blocksy_companion_handle_contained_fatal()
* (framework/helpers/helpers.php) — keep both in sync.
*
* @param \Throwable $e The contained error (carries the backtrace).
* @param string $context The file being loaded when it threw.
*/
if (! function_exists('blocksy_handle_contained_fatal')) {
function blocksy_handle_contained_fatal(\Throwable $e, $context = '') {
blocksy_debug_log(
sprintf(
'[Blocksy] Contained fatal while loading %s: %s in %s:%d',
$context,
$e->getMessage(),
$e->getFile(),
$e->getLine()
),
$e
);
/**
* Filters whether a contained fatal is re-thrown after being logged.
*
* Defaults to true under WP_DEBUG so bugs surface in development, and
* false otherwise so production stays contained. Return true to always
* re-throw, or false to always swallow.
*
* @since 2.1.47
*
* @param bool $should_rethrow Whether to re-throw the contained error.
*/
$should_rethrow = apply_filters(
'blocksy:theme:contained-fatal:rethrow',
defined('WP_DEBUG') && WP_DEBUG
);
if ($should_rethrow) {
throw $e;
}
}
}
function blocksy_get_wp_theme() {
return apply_filters('blocksy_get_wp_theme', wp_get_theme());
}
if (! function_exists('blocksy_get_wp_parent_theme')) {
function blocksy_get_wp_parent_theme() {
return apply_filters('blocksy_get_wp_theme', wp_get_theme(get_template()));
}
}
function blocksy_current_url() {
static $url = null;
if ($url === null) {
if (is_multisite() && !(defined('SUBDOMAIN_INSTALL') && SUBDOMAIN_INSTALL)) {
switch_to_blog(1);
$url = home_url();
restore_current_blog();
} else {
$url = home_url();
}
//Remove the "//" before the domain name
$url = ltrim(preg_replace('/^[^:]+:\/\//', '//', $url), '/');
//Remove the ulr subdirectory in case it has one
$split = explode('/', $url);
//Remove end slash
$url = rtrim($split[0], '/');
$request_uri = blocksy_akg('REQUEST_URI', $_SERVER, '');
$request_uri = apply_filters(
'blocksy:current-url:request-uri',
$request_uri
);
$url .= '/' . ltrim($request_uri, '/');
$url = set_url_scheme('//' . $url); // https fix
}
return $url;
}
if (! function_exists('blocksy_get_all_image_sizes')) {
function blocksy_get_all_image_sizes() {
$titles = [
'thumbnail' => __('Thumbnail', 'blocksy'),
'medium' => __('Medium', 'blocksy'),
'medium_large' => __('Medium Large', 'blocksy'),
'large' => __('Large', 'blocksy'),
'full' => __('Full Size', 'blocksy'),
'woocommerce_thumbnail' => __('WooCommerce Thumbnail', 'blocksy'),
'woocommerce_single' => __('WooCommerce Single', 'blocksy'),
'woocommerce_gallery_thumbnail' => __(
'WooCommerce Gallery Thumbnail',
'blocksy'
),
'woocommerce_archive_thumbnail' => __(
'WooCommerce Archive Thumbnail',
'blocksy'
)
];
$all_sizes = get_intermediate_image_sizes();
$result = [
'full' => __('Full Size', 'blocksy')
];
foreach ($all_sizes as $single_size) {
if (isset($titles[$single_size])) {
$result[$single_size] = $titles[$single_size];
} else {
$result[$single_size] = $single_size;
}
}
return $result;
}
}
/**
* Log a debug message (always — not gated by WP_DEBUG) and fire the
* `blocksy:theme:debug-log` action so anything can observe the theme's debug logs
* (e.g. a companion feature).
*
* PARITY: mirrored by the companion's blocksy_companion_debug_log() (which fires
* blocksy:companion:debug-log) — keep both in sync.
*
* @param string $message The log message.
* @param mixed $object Optional context appended via print_r (e.g. a \Throwable).
*
* @return void
*/
function blocksy_debug_log($message, $object = null) {
/**
* Fires for every theme debug log message.
*
* Lets anything (e.g. a companion feature) observe the theme's debug logs
* without the theme persisting them itself.
*
* @since 2.1.47
*
* @param string $message The log message.
* @param mixed $object Optional context (e.g. a \Throwable). Default null.
*/
do_action('blocksy:theme:debug-log', $message, $object);
if (is_null($object)) {
error_log($message);
} else {
error_log($message . ': ' . print_r($object, true));
}
}
function blocksy_sanitize_user_html($html) {
// Just drop scripts from the html content, if user doesnt have
// unfiltered_html capability.
//
// Should happen BEFORE do_shortcode() as shortcodes can contain inline
// scripts but we should leave those in place, since those come from trusted
// places.
if (! current_user_can('unfiltered_html')) {
$html = preg_replace('#(.*?)#is', '', $html);
// Remove any on*="…" or on*='…' or on*=… (unquoted) attributes
// Matches: space + on + letters + optional whitespace = optional quotes + anything except > + optional closing quote
$html = preg_replace(
'#\s+on[a-z]+\s*=\s*(?:"[^"]*"|\'[^\']*\'|[^\s>]+)#is',
'',
$html
);
}
return $html;
}
function blocksy_output_html_safely($html) {
return do_shortcode($html);
// Dont use wp_filter_post_kses() as it is very unstable as far as slashes go.
// Just call wp_kses() directly.
//
// Context:
//
// https://github.com/WP-API/WP-API/issues/2848
// https://github.com/WP-API/WP-API/issues/2788
// https://core.trac.wordpress.org/ticket/38609
// return wp_kses($html, 'post');
}
function blocksy_get_pricing_links() {
return apply_filters('blocksy:modal:pricing-links', [
'pricing' => 'https://creativethemes.com/blocksy/pricing/',
'premium' => 'https://creativethemes.com/blocksy/premium/',
'compare-plans' => 'https://creativethemes.com/blocksy/pricing/#comparison-free-vs-pro'
]);
}