woocommerce/storefront
2
0
Fork 0
mirror of https://github.com/woocommerce/storefront.git synced 2025-08-21 04:11:59 +08:00
Code Issues Packages Wiki Activity Actions

Add docblocks to hooks used in customizer class. (#2038)

Browse source 
* Add docblocks to hooks used in customizer class.

This resolves PHP linting errors.

* Fix spacing warnings

Minor update to fix `Equals sign not aligned correctly; expected 1 space
but found X spaces` warnings.
This commit is contained in:
Daniel W. Robert 2022-09-09 15:59:13 -04:00 • committed by GitHub
parent 654917738e
commit c18cd6eef2
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 190 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

194
inc/customizer/class-storefront-customizer.php
View file

@ -38,6 +38,13 @@ if ( ! class_exists( 'Storefront_Customizer' ) ) :
* @return array * @return array
*/ */
public function get_storefront_default_setting_values() { public function get_storefront_default_setting_values() {
/**
* Filters for the default Storefront Options.
*
* @param array $args
* @package storefront
* @since 2.0.0
*/
return apply_filters( return apply_filters(
'storefront_setting_default_values', 'storefront_setting_default_values',
$args = array( $args = array(
@ -163,6 +170,13 @@ if ( ! class_exists( 'Storefront_Customizer' ) ) :
require_once dirname( __FILE__ ) . '/class-storefront-customizer-control-radio-image.php'; require_once dirname( __FILE__ ) . '/class-storefront-customizer-control-radio-image.php';
require_once dirname( __FILE__ ) . '/class-storefront-customizer-control-arbitrary.php'; require_once dirname( __FILE__ ) . '/class-storefront-customizer-control-arbitrary.php';
/**
* Filter for including additional custom controls.
*
* @param boolean Include control file.
* @package storefront
* @since 2.0.0
*/
if ( apply_filters( 'storefront_customizer_more', true ) ) { if ( apply_filters( 'storefront_customizer_more', true ) ) {
require_once dirname( __FILE__ ) . '/class-storefront-customizer-control-more.php'; require_once dirname( __FILE__ ) . '/class-storefront-customizer-control-more.php';
} }
@ -184,6 +198,13 @@ if ( ! class_exists( 'Storefront_Customizer' ) ) :
$wp_customize->add_setting( $wp_customize->add_setting(
'storefront_heading_color', 'storefront_heading_color',
array( array(
/**
* Filters for modifying the default heading color.
*
* @param string Hex color value.
* @package storefront
* @since 2.0.0
*/
'default' => apply_filters( 'storefront_default_heading_color', '#484c51' ), 'default' => apply_filters( 'storefront_default_heading_color', '#484c51' ),
'sanitize_callback' => 'sanitize_hex_color', 'sanitize_callback' => 'sanitize_hex_color',
) )
@ -208,6 +229,13 @@ if ( ! class_exists( 'Storefront_Customizer' ) ) :
$wp_customize->add_setting( $wp_customize->add_setting(
'storefront_text_color', 'storefront_text_color',
array( array(
/**
* Filters for modifying the default text color.
*
* @param string Hex color value.
* @package storefront
* @since 2.0.0
*/
'default' => apply_filters( 'storefront_default_text_color', '#43454b' ), 'default' => apply_filters( 'storefront_default_text_color', '#43454b' ),
'sanitize_callback' => 'sanitize_hex_color', 'sanitize_callback' => 'sanitize_hex_color',
) )
@ -232,6 +260,13 @@ if ( ! class_exists( 'Storefront_Customizer' ) ) :
$wp_customize->add_setting( $wp_customize->add_setting(
'storefront_accent_color', 'storefront_accent_color',
array( array(
/**
* Filters for modifying the default accent color.
*
* @param string Hex color value.
* @package storefront
* @since 2.0.0
*/
'default' => apply_filters( 'storefront_default_accent_color', '#7f54b3' ), 'default' => apply_filters( 'storefront_default_accent_color', '#7f54b3' ),
'sanitize_callback' => 'sanitize_hex_color', 'sanitize_callback' => 'sanitize_hex_color',
) )
@ -256,6 +291,13 @@ if ( ! class_exists( 'Storefront_Customizer' ) ) :
$wp_customize->add_setting( $wp_customize->add_setting(
'storefront_hero_heading_color', 'storefront_hero_heading_color',
array( array(
/**
* Filters for modifying the default hero heading color.
*
* @param string Hex color value.
* @package storefront
* @since 2.0.0
*/
'default' => apply_filters( 'storefront_default_hero_heading_color', '#000000' ), 'default' => apply_filters( 'storefront_default_hero_heading_color', '#000000' ),
'sanitize_callback' => 'sanitize_hex_color', 'sanitize_callback' => 'sanitize_hex_color',
) )
@ -280,6 +322,13 @@ if ( ! class_exists( 'Storefront_Customizer' ) ) :
$wp_customize->add_setting( $wp_customize->add_setting(
'storefront_hero_text_color', 'storefront_hero_text_color',
array( array(
/**
* Filters for modifying the default hero text color.
*
* @param string Hex color value.
* @package storefront
* @since 2.0.0
*/
'default' => apply_filters( 'storefront_default_hero_text_color', '#000000' ), 'default' => apply_filters( 'storefront_default_hero_text_color', '#000000' ),
'sanitize_callback' => 'sanitize_hex_color', 'sanitize_callback' => 'sanitize_hex_color',
) )
@ -317,6 +366,13 @@ if ( ! class_exists( 'Storefront_Customizer' ) ) :
$wp_customize->add_setting( $wp_customize->add_setting(
'storefront_header_background_color', 'storefront_header_background_color',
array( array(
/**
* Filters for modifying the default header background color.
*
* @param string Hex color value.
* @package storefront
* @since 2.0.0
*/
'default' => apply_filters( 'storefront_default_header_background_color', '#2c2d33' ), 'default' => apply_filters( 'storefront_default_header_background_color', '#2c2d33' ),
'sanitize_callback' => 'sanitize_hex_color', 'sanitize_callback' => 'sanitize_hex_color',
) )
@ -341,6 +397,13 @@ if ( ! class_exists( 'Storefront_Customizer' ) ) :
$wp_customize->add_setting( $wp_customize->add_setting(
'storefront_header_text_color', 'storefront_header_text_color',
array( array(
/**
* Filters for modifying the default header text color.
*
* @param string Hex color value.
* @package storefront
* @since 2.0.0
*/
'default' => apply_filters( 'storefront_default_header_text_color', '#9aa0a7' ), 'default' => apply_filters( 'storefront_default_header_text_color', '#9aa0a7' ),
'sanitize_callback' => 'sanitize_hex_color', 'sanitize_callback' => 'sanitize_hex_color',
) )
@ -365,6 +428,13 @@ if ( ! class_exists( 'Storefront_Customizer' ) ) :
$wp_customize->add_setting( $wp_customize->add_setting(
'storefront_header_link_color', 'storefront_header_link_color',
array( array(
/**
* Filters for modifying the default header link color.
*
* @param string Hex color value.
* @package storefront
* @since 2.0.0
*/
'default' => apply_filters( 'storefront_default_header_link_color', '#d5d9db' ), 'default' => apply_filters( 'storefront_default_header_link_color', '#d5d9db' ),
'sanitize_callback' => 'sanitize_hex_color', 'sanitize_callback' => 'sanitize_hex_color',
) )
@ -401,6 +471,13 @@ if ( ! class_exists( 'Storefront_Customizer' ) ) :
$wp_customize->add_setting( $wp_customize->add_setting(
'storefront_footer_background_color', 'storefront_footer_background_color',
array( array(
/**
* Filters for modifying the default footer background color.
*
* @param string Hex color value.
* @package storefront
* @since 2.0.0
*/
'default' => apply_filters( 'storefront_default_footer_background_color', '#f0f0f0' ), 'default' => apply_filters( 'storefront_default_footer_background_color', '#f0f0f0' ),
'sanitize_callback' => 'sanitize_hex_color', 'sanitize_callback' => 'sanitize_hex_color',
) )
@ -425,6 +502,13 @@ if ( ! class_exists( 'Storefront_Customizer' ) ) :
$wp_customize->add_setting( $wp_customize->add_setting(
'storefront_footer_heading_color', 'storefront_footer_heading_color',
array( array(
/**
* Filters for modifying the default footer heading color.
*
* @param string Hex color value.
* @package storefront
* @since 2.0.0
*/
'default' => apply_filters( 'storefront_default_footer_heading_color', '#494c50' ), 'default' => apply_filters( 'storefront_default_footer_heading_color', '#494c50' ),
'sanitize_callback' => 'sanitize_hex_color', 'sanitize_callback' => 'sanitize_hex_color',
) )
@ -449,6 +533,13 @@ if ( ! class_exists( 'Storefront_Customizer' ) ) :
$wp_customize->add_setting( $wp_customize->add_setting(
'storefront_footer_text_color', 'storefront_footer_text_color',
array( array(
/**
* Filters for modifying the default footer text color.
*
* @param string Hex color value.
* @package storefront
* @since 2.0.0
*/
'default' => apply_filters( 'storefront_default_footer_text_color', '#61656b' ), 'default' => apply_filters( 'storefront_default_footer_text_color', '#61656b' ),
'sanitize_callback' => 'sanitize_hex_color', 'sanitize_callback' => 'sanitize_hex_color',
) )
@ -473,6 +564,13 @@ if ( ! class_exists( 'Storefront_Customizer' ) ) :
$wp_customize->add_setting( $wp_customize->add_setting(
'storefront_footer_link_color', 'storefront_footer_link_color',
array( array(
/**
* Filters for modifying the default footer link color.
*
* @param string Hex color value.
* @package storefront
* @since 2.0.0
*/
'default' => apply_filters( 'storefront_default_footer_link_color', '#2c2d33' ), 'default' => apply_filters( 'storefront_default_footer_link_color', '#2c2d33' ),
'sanitize_callback' => 'sanitize_hex_color', 'sanitize_callback' => 'sanitize_hex_color',
) )
@ -509,6 +607,13 @@ if ( ! class_exists( 'Storefront_Customizer' ) ) :
$wp_customize->add_setting( $wp_customize->add_setting(
'storefront_button_background_color', 'storefront_button_background_color',
array( array(
/**
* Filters for modifying the default button background color.
*
* @param string Hex color value.
* @package storefront
* @since 2.0.0
*/
'default' => apply_filters( 'storefront_default_button_background_color', '#96588a' ), 'default' => apply_filters( 'storefront_default_button_background_color', '#96588a' ),
'sanitize_callback' => 'sanitize_hex_color', 'sanitize_callback' => 'sanitize_hex_color',
) )
@ -533,6 +638,13 @@ if ( ! class_exists( 'Storefront_Customizer' ) ) :
$wp_customize->add_setting( $wp_customize->add_setting(
'storefront_button_text_color', 'storefront_button_text_color',
array( array(
/**
* Filters for modifying the default button text color.
*
* @param string Hex color value.
* @package storefront
* @since 2.0.0
*/
'default' => apply_filters( 'storefront_default_button_text_color', '#ffffff' ), 'default' => apply_filters( 'storefront_default_button_text_color', '#ffffff' ),
'sanitize_callback' => 'sanitize_hex_color', 'sanitize_callback' => 'sanitize_hex_color',
) )
@ -557,6 +669,13 @@ if ( ! class_exists( 'Storefront_Customizer' ) ) :
$wp_customize->add_setting( $wp_customize->add_setting(
'storefront_button_alt_background_color', 'storefront_button_alt_background_color',
array( array(
/**
* Filters for modifying the default button alt background color.
*
* @param string Hex color value.
* @package storefront
* @since 2.0.0
*/
'default' => apply_filters( 'storefront_default_button_alt_background_color', '#2c2d33' ), 'default' => apply_filters( 'storefront_default_button_alt_background_color', '#2c2d33' ),
'sanitize_callback' => 'sanitize_hex_color', 'sanitize_callback' => 'sanitize_hex_color',
) )
@ -581,6 +700,13 @@ if ( ! class_exists( 'Storefront_Customizer' ) ) :
$wp_customize->add_setting( $wp_customize->add_setting(
'storefront_button_alt_text_color', 'storefront_button_alt_text_color',
array( array(
/**
* Filters for modifying the default button alt text color.
*
* @param string Hex color value.
* @package storefront
* @since 2.0.0
*/
'default' => apply_filters( 'storefront_default_button_alt_text_color', '#ffffff' ), 'default' => apply_filters( 'storefront_default_button_alt_text_color', '#ffffff' ),
'sanitize_callback' => 'sanitize_hex_color', 'sanitize_callback' => 'sanitize_hex_color',
) )
@ -613,6 +739,13 @@ if ( ! class_exists( 'Storefront_Customizer' ) ) :
$wp_customize->add_setting( $wp_customize->add_setting(
'storefront_layout', 'storefront_layout',
array( array(
/**
* Filters for modifying the default layout.
*
* @param string left/right based on RTL.
* @package storefront
* @since 2.0.0
*/
'default' => apply_filters( 'storefront_default_layout', $layout = is_rtl() ? 'left' : 'right' ), 'default' => apply_filters( 'storefront_default_layout', $layout = is_rtl() ? 'left' : 'right' ),
'sanitize_callback' => 'storefront_sanitize_choices', 'sanitize_callback' => 'storefront_sanitize_choices',
) )
@ -636,7 +769,11 @@ if ( ! class_exists( 'Storefront_Customizer' ) ) :
); );
/** /**
* More * Filter for including additional custom controls.
*
* @param boolean Add additional sections.
* @package storefront
* @since 2.0.0
*/ */
if ( apply_filters( 'storefront_customizer_more', true ) ) { if ( apply_filters( 'storefront_customizer_more', true ) ) {
$wp_customize->add_section( $wp_customize->add_section(
@ -696,6 +833,13 @@ if ( ! class_exists( 'Storefront_Customizer' ) ) :
'button_alt_text_color' => get_theme_mod( 'storefront_button_alt_text_color' ), 'button_alt_text_color' => get_theme_mod( 'storefront_button_alt_text_color' ),
); );
/**
* Filters for Storefront Theme Mods.
*
* @param array Associative array of theme mods for color options.
* @package storefront
* @since 2.0.0
*/
return apply_filters( 'storefront_theme_mods', $storefront_theme_mods ); return apply_filters( 'storefront_theme_mods', $storefront_theme_mods );
} }
@ -707,8 +851,22 @@ if ( ! class_exists( 'Storefront_Customizer' ) ) :
*/ */
public function get_css() { public function get_css() {
$storefront_theme_mods = $this->get_storefront_theme_mods(); $storefront_theme_mods = $this->get_storefront_theme_mods();
$brighten_factor = apply_filters( 'storefront_brighten_factor', 25 ); /**
$darken_factor = apply_filters( 'storefront_darken_factor', -25 ); * Filters for brightening color value.
*
* @param int Numerical value for brighten amount.
* @package storefront
* @since 2.0.0
*/
$brighten_factor = apply_filters( 'storefront_brighten_factor', 25 );
/**
* Filters for darkening color value.
*
* @param int Numerical value for darken amount.
* @package storefront
* @since 2.0.0
*/
$darken_factor = apply_filters( 'storefront_darken_factor', -25 );
$styles = ' $styles = '
.main-navigation ul li a, .main-navigation ul li a,
@ -889,6 +1047,13 @@ if ( ! class_exists( 'Storefront_Customizer' ) ) :
} }
}'; }';
/**
* Filters for Storefront Customizer CSS.
*
* @param object Object of CSS rulesets.
* @package storefront
* @since 2.0.0
*/
return apply_filters( 'storefront_customizer_css', $styles ); return apply_filters( 'storefront_customizer_css', $styles );
} }
@ -900,7 +1065,14 @@ if ( ! class_exists( 'Storefront_Customizer' ) ) :
*/ */
public function gutenberg_get_css() { public function gutenberg_get_css() {
$storefront_theme_mods = $this->get_storefront_theme_mods(); $storefront_theme_mods = $this->get_storefront_theme_mods();
$darken_factor = apply_filters( 'storefront_darken_factor', -25 ); /**
* Filters for darkening color value.
*
* @param int Numerical value for darken amount.
* @package storefront
* @since 2.0.0
*/
$darken_factor = apply_filters( 'storefront_darken_factor', -25 );
// Gutenberg. // Gutenberg.
$styles = ' $styles = '
@ -1021,6 +1193,13 @@ if ( ! class_exists( 'Storefront_Customizer' ) ) :
} }
'; ';
/**
* Filters for Gutenberg Customizer CSS.
*
* @param object Object of CSS rulesets.
* @package storefront
* @since 2.0.0
*/
return apply_filters( 'storefront_gutenberg_customizer_css', $styles ); return apply_filters( 'storefront_gutenberg_customizer_css', $styles );
} }
@ -1088,6 +1267,13 @@ if ( ! class_exists( 'Storefront_Customizer' ) ) :
$styles .= $this->gutenberg_get_css(); $styles .= $this->gutenberg_get_css();
/**
* Filters for Gutenberg Block Editor Customizer CSS.
*
* @param object Object of CSS rulesets.
* @package storefront
* @since 2.0.0
*/
wp_add_inline_style( 'storefront-gutenberg-blocks', apply_filters( 'storefront_gutenberg_block_editor_customizer_css', $styles ) ); wp_add_inline_style( 'storefront-gutenberg-blocks', apply_filters( 'storefront_gutenberg_block_editor_customizer_css', $styles ) );
} }