<?php /** * Helper functions for the Customizer. * * @package GeneratePress */ if ( ! defined( 'ABSPATH' ) ) { exit; // Exit if accessed directly. } if ( ! function_exists( 'generate_is_posts_page' ) ) { /** * Check to see if we're on a posts page * * @since 1.3.39 */ function generate_is_posts_page() { return ( is_home() || is_archive() || is_tax() ) ? true : false; } } if ( ! function_exists( 'generate_is_footer_bar_active' ) ) { /** * Check to see if we're using our footer bar widget * * @since 1.3.42 */ function generate_is_footer_bar_active() { return ( is_active_sidebar( 'footer-bar' ) ) ? true : false; } } if ( ! function_exists( 'generate_is_top_bar_active' ) ) { /** * Check to see if the top bar is active * * @since 1.3.45 */ function generate_is_top_bar_active() { $top_bar = is_active_sidebar( 'top-bar' ) ? true : false; return apply_filters( 'generate_is_top_bar_active', $top_bar ); } } if ( ! function_exists( 'generate_customize_partial_blogname' ) ) { /** * Render the site title for the selective refresh partial. * * @since 1.3.41 */ function generate_customize_partial_blogname() { bloginfo( 'name' ); } } if ( ! function_exists( 'generate_customize_partial_blogdescription' ) ) { /** * Render the site tagline for the selective refresh partial. * * @since 1.3.41 */ function generate_customize_partial_blogdescription() { bloginfo( 'description' ); } } if ( ! function_exists( 'generate_enqueue_color_palettes' ) ) { add_action( 'customize_controls_enqueue_scripts', 'generate_enqueue_color_palettes' ); /** * Add our custom color palettes to the color pickers in the Customizer. * * @since 1.3.42 */ function generate_enqueue_color_palettes() { // Old versions of WP don't get nice things. if ( ! function_exists( 'wp_add_inline_script' ) ) { return; } // Grab our palette array and turn it into JS. $palettes = wp_json_encode( generate_get_default_color_palettes() ); // Add our custom palettes. // json_encode takes care of escaping. wp_add_inline_script( 'wp-color-picker', 'jQuery.wp.wpColorPicker.prototype.options.palettes = ' . $palettes . ';' ); } } if ( ! function_exists( 'generate_sanitize_integer' ) ) { /** * Sanitize integers. * * @since 1.0.8 * @param string $input The value to check. */ function generate_sanitize_integer( $input ) { return absint( $input ); } } if ( ! function_exists( 'generate_sanitize_decimal_integer' ) ) { /** * Sanitize integers that can use decimals. * * @since 1.3.41 * @param string $input The value to check. */ function generate_sanitize_decimal_integer( $input ) { return abs( floatval( $input ) ); } } /** * Sanitize a positive number, but allow an empty value. * * @since 2.2 * @param string $input The value to check. */ function generate_sanitize_empty_absint( $input ) { // phpcs:ignore WordPress.PHP.StrictComparisons.LooseComparison -- Intentially loose. if ( '' == $input ) { return ''; } return absint( $input ); } if ( ! function_exists( 'generate_sanitize_checkbox' ) ) { /** * Sanitize checkbox values. * * @since 1.0.8 * @param string $checked The value to check. */ function generate_sanitize_checkbox( $checked ) { // phpcs:ignore WordPress.PHP.StrictComparisons.LooseComparison -- Intentially loose. return ( ( isset( $checked ) && true == $checked ) ? true : false ); } } if ( ! function_exists( 'generate_sanitize_blog_excerpt' ) ) { /** * Sanitize blog excerpt. * Needed because GP Premium calls the control ID which is different from the settings ID. * * @since 1.0.8 * @param string $input The value to check. */ function generate_sanitize_blog_excerpt( $input ) { $valid = array( 'full', 'excerpt', ); if ( in_array( $input, $valid ) ) { return $input; } else { return 'full'; } } } if ( ! function_exists( 'generate_sanitize_hex_color' ) ) { /** * Sanitize colors. * Allow blank value. * * @since 1.2.9.6 * @param string $color The color to check. */ function generate_sanitize_hex_color( $color ) { // phpcs:ignore WordPress.PHP.StrictComparisons.LooseComparison -- Intentially loose. if ( '' === $color ) { return ''; } // 3 or 6 hex digits, or the empty string. if ( preg_match( '|^#([A-Fa-f0-9]{3}){1,2}$|', $color ) ) { return $color; } return ''; } } /** * Sanitize RGBA colors. * * @since 2.2 * @param string $color The color to check. */ function generate_sanitize_rgba_color( $color ) { if ( '' === $color ) { return ''; } if ( false === strpos( $color, 'rgba' ) ) { return generate_sanitize_hex_color( $color ); } $color = str_replace( ' ', '', $color ); sscanf( $color, 'rgba(%d,%d,%d,%f)', $red, $green, $blue, $alpha ); return 'rgba(' . $red . ',' . $green . ',' . $blue . ',' . $alpha . ')'; } if ( ! function_exists( 'generate_sanitize_choices' ) ) { /** * Sanitize choices. * * @since 1.3.24 * @param string $input The value to check. * @param object $setting The setting object. */ function generate_sanitize_choices( $input, $setting ) { // Ensure input is a slug. $input = sanitize_key( $input ); // Get list of choices from the control. // associated with the setting. $choices = $setting->manager->get_control( $setting->id )->choices; // If the input is a valid key, return it. // otherwise, return the default. return ( array_key_exists( $input, $choices ) ? $input : $setting->default ); } } /** * Sanitize our Google Font variants * * @since 2.0 * @param string $input The value to check. */ function generate_sanitize_variants( $input ) { if ( is_array( $input ) ) { $input = implode( ',', $input ); } return sanitize_text_field( $input ); } add_action( 'customize_controls_enqueue_scripts', 'generate_do_control_inline_scripts', 100 ); /** * Add misc inline scripts to our controls. * * We don't want to add these to the controls themselves, as they will be repeated * each time the control is initialized. * * @since 2.0 */ function generate_do_control_inline_scripts() { wp_localize_script( 'generatepress-typography-customizer', 'gp_customize', array( 'nonce' => wp_create_nonce( 'gp_customize_nonce' ), ) ); $number_of_fonts = apply_filters( 'generate_number_of_fonts', 200 ); wp_localize_script( 'generatepress-typography-customizer', 'generatePressTypography', array( 'googleFonts' => apply_filters( 'generate_typography_customize_list', generate_get_all_google_fonts( $number_of_fonts ) ), ) ); wp_localize_script( 'generatepress-typography-customizer', 'typography_defaults', generate_typography_default_fonts() ); wp_enqueue_script( 'generatepress-customizer-controls', trailingslashit( get_template_directory_uri() ) . 'inc/customizer/controls/js/customizer-controls.js', array( 'customize-controls', 'jquery' ), GENERATE_VERSION, true ); wp_localize_script( 'generatepress-customizer-controls', 'generatepress_defaults', generate_get_defaults() ); wp_localize_script( 'generatepress-customizer-controls', 'generatepress_color_defaults', generate_get_color_defaults() ); wp_localize_script( 'generatepress-customizer-controls', 'generatepress_typography_defaults', generate_get_default_fonts() ); wp_localize_script( 'generatepress-customizer-controls', 'generatepress_spacing_defaults', generate_spacing_get_defaults() ); } if ( ! function_exists( 'generate_customizer_live_preview' ) ) { add_action( 'customize_preview_init', 'generate_customizer_live_preview', 100 ); /** * Add our live preview scripts * * @since 0.1 */ function generate_customizer_live_preview() { $spacing_settings = wp_parse_args( get_option( 'generate_spacing_settings', array() ), generate_spacing_get_defaults() ); wp_enqueue_script( 'generate-themecustomizer', trailingslashit( get_template_directory_uri() ) . 'inc/customizer/controls/js/customizer-live-preview.js', array( 'customize-preview' ), GENERATE_VERSION, true ); wp_localize_script( 'generate-themecustomizer', 'generatepress_live_preview', array( 'mobile' => generate_get_media_query( 'mobile' ), 'tablet' => generate_get_media_query( 'tablet' ), 'desktop' => generate_get_media_query( 'desktop' ), 'contentLeft' => absint( $spacing_settings['content_left'] ), 'contentRight' => absint( $spacing_settings['content_right'] ), 'isFlex' => generate_is_using_flexbox(), 'isRTL' => is_rtl(), ) ); } } /** * Check to see if we have a logo or not. * * Used as an active callback. Calling has_custom_logo creates a PHP notice for * multisite users. * * @since 2.0.1 */ function generate_has_custom_logo_callback() { if ( get_theme_mod( 'custom_logo' ) ) { return true; } return false; } /** * Save our preset layout controls. These should always save to be "current". * * @since 2.2 */ function generate_sanitize_preset_layout() { return 'current'; } /** * Display options if we're using the Floats structure. */ function generate_is_using_floats_callback() { return 'floats' === generate_get_option( 'structure' ); } /** * Callback to determine whether to show the inline logo option. */ function generate_show_inline_logo_callback() { return 'floats' === generate_get_option( 'structure' ) && generate_has_logo_site_branding(); }