This repository has been archived on 2020-05-08. You can view files and clone it, but cannot push or open issues or pull requests.
understrap/inc/customizer.php

154 lines
5.0 KiB
PHP
Raw Normal View History

2014-12-10 11:36:38 +00:00
<?php
/**
2019-07-18 16:21:25 +00:00
* UnderStrap Theme Customizer
2014-12-10 11:36:38 +00:00
*
* @package understrap
*/
2019-06-20 08:57:12 +00:00
// Exit if accessed directly.
defined( 'ABSPATH' ) || exit;
2018-09-10 21:59:04 +00:00
2014-12-10 11:36:38 +00:00
/**
* Add postMessage support for site title and description for the Theme Customizer.
*
* @param WP_Customize_Manager $wp_customize Theme Customizer object.
*/
if ( ! function_exists( 'understrap_customize_register' ) ) {
2016-11-21 16:25:56 +00:00
/**
* Register basic customizer support.
*
* @param object $wp_customize Customizer reference.
*/
function understrap_customize_register( $wp_customize ) {
$wp_customize->get_setting( 'blogname' )->transport = 'postMessage';
$wp_customize->get_setting( 'blogdescription' )->transport = 'postMessage';
$wp_customize->get_setting( 'header_textcolor' )->transport = 'postMessage';
}
2014-12-10 11:36:38 +00:00
}
add_action( 'customize_register', 'understrap_customize_register' );
if ( ! function_exists( 'understrap_theme_customize_register' ) ) {
2016-11-21 16:25:56 +00:00
/**
* Register individual settings through customizer's API.
*
* @param WP_Customize_Manager $wp_customize Customizer reference.
2016-11-21 16:25:56 +00:00
*/
function understrap_theme_customize_register( $wp_customize ) {
2016-11-21 16:25:56 +00:00
// Theme layout settings.
2018-11-18 23:43:14 +00:00
$wp_customize->add_section(
'understrap_theme_layout_options',
array(
'title' => __( 'Theme Layout Settings', 'understrap' ),
'capability' => 'edit_theme_options',
'description' => __( 'Container width and sidebar defaults', 'understrap' ),
2019-11-07 21:11:14 +00:00
'priority' => apply_filters( 'understrap_theme_layout_options_priority', 160 ),
2018-11-18 23:43:14 +00:00
)
);
/**
* Select sanitization function
*
* @param string $input Slug to sanitize.
* @param WP_Customize_Setting $setting Setting instance.
* @return string Sanitized slug if it is a valid choice; otherwise, the setting default.
*/
2018-11-18 23:43:14 +00:00
function understrap_theme_slug_sanitize_select( $input, $setting ) {
2018-11-18 23:43:14 +00:00
// Ensure input is a slug (lowercase alphanumeric characters, dashes and underscores are allowed only).
$input = sanitize_key( $input );
2018-11-18 23:43:14 +00:00
// Get the list of possible select options.
$choices = $setting->manager->get_control( $setting->id )->choices;
2019-11-07 21:05:37 +00:00
// If the input is a valid key, return it; otherwise, return the default.
return ( array_key_exists( $input, $choices ) ? $input : $setting->default );
2018-11-18 23:43:14 +00:00
}
2018-11-18 23:43:14 +00:00
$wp_customize->add_setting(
'understrap_container_type',
array(
'default' => 'container',
'type' => 'theme_mod',
'sanitize_callback' => 'understrap_theme_slug_sanitize_select',
'capability' => 'edit_theme_options',
)
);
$wp_customize->add_control(
new WP_Customize_Control(
$wp_customize,
2018-11-18 23:43:14 +00:00
'understrap_container_type',
array(
'label' => __( 'Container Width', 'understrap' ),
'description' => __( 'Choose between Bootstrap\'s container and container-fluid', 'understrap' ),
'section' => 'understrap_theme_layout_options',
'settings' => 'understrap_container_type',
'type' => 'select',
'choices' => array(
'container' => __( 'Fixed width container', 'understrap' ),
'container-fluid' => __( 'Full width container', 'understrap' ),
),
2019-11-07 21:11:14 +00:00
'priority' => apply_filters( 'understrap_container_type_priority', 10 ),
)
2018-11-18 23:43:14 +00:00
)
);
2018-11-18 23:43:14 +00:00
$wp_customize->add_setting(
'understrap_sidebar_position',
array(
'default' => 'right',
'type' => 'theme_mod',
'sanitize_callback' => 'sanitize_text_field',
'capability' => 'edit_theme_options',
)
);
$wp_customize->add_control(
new WP_Customize_Control(
$wp_customize,
2018-11-18 23:43:14 +00:00
'understrap_sidebar_position',
array(
'label' => __( 'Sidebar Positioning', 'understrap' ),
'description' => __(
'Set sidebar\'s default position. Can either be: right, left, both or none. Note: this can be overridden on individual pages.',
'understrap'
),
'section' => 'understrap_theme_layout_options',
'settings' => 'understrap_sidebar_position',
'type' => 'select',
'sanitize_callback' => 'understrap_theme_slug_sanitize_select',
2018-11-18 23:43:14 +00:00
'choices' => array(
'right' => __( 'Right sidebar', 'understrap' ),
'left' => __( 'Left sidebar', 'understrap' ),
'both' => __( 'Left & Right sidebars', 'understrap' ),
'none' => __( 'No sidebar', 'understrap' ),
),
2019-11-07 21:11:14 +00:00
'priority' => apply_filters( 'understrap_sidebar_position_priority', 20 ),
)
2018-11-18 23:43:14 +00:00
)
);
}
} // End of if function_exists( 'understrap_theme_customize_register' ).
add_action( 'customize_register', 'understrap_theme_customize_register' );
2014-12-10 11:36:38 +00:00
/**
* Binds JS handlers to make Theme Customizer preview reload changes asynchronously.
*/
if ( ! function_exists( 'understrap_customize_preview_js' ) ) {
2016-11-21 17:12:36 +00:00
/**
* Setup JS integration for live previewing.
*/
function understrap_customize_preview_js() {
2018-11-18 23:43:14 +00:00
wp_enqueue_script(
'understrap_customizer',
get_template_directory_uri() . '/js/customizer.js',
array( 'customize-preview' ),
'20130508',
true
);
}
2014-12-10 11:36:38 +00:00
}
add_action( 'customize_preview_init', 'understrap_customize_preview_js' );