pressbooks-aldine/inc/customizer/namespace.php

<?php
/**
 * Aldine Theme Customizer
 *
 * @package Aldine
 */

namespace Aldine\Customizer;

use function Aldine\Helpers\get_catalog_options;
use PressbooksMix\Assets;

const MAX_FEATURED_BOOKS = 4;

/**
 * Add postMessage support for site title and description for the Theme Customizer.
 *
 * @param \WP_Customize_Manager $wp_customize Theme Customizer object.
 */
function customize_register( \WP_Customize_Manager $wp_customize ) {
	// Remove unsupported WP controls, @see \WP_Customize_Manager::register_controls.

	$wp_customize->remove_control( 'display_header_text' );
	$wp_customize->remove_control( 'header_textcolor' );

	// Remove unsupported WP section, @see \WP_Customize_Manager::register_sections.
	$wp_customize->remove_section( 'static_front_page' );

	// Add Pressbooks controls.

	$wp_customize->get_setting( 'blogname' )->transport         = 'postMessage';
	$wp_customize->get_setting( 'blogdescription' )->transport  = 'postMessage';
	$wp_customize->get_setting( 'header_textcolor' )->transport = 'postMessage';

	if ( isset( $wp_customize->selective_refresh ) ) {
		$wp_customize->selective_refresh->add_partial(
			'blogname', [
				'selector'        => '.site-title a',
				'render_callback' => function() {
					bloginfo( 'name' );
				},
			]
		);
		$wp_customize->selective_refresh->add_partial(
			'blogdescription', [
				'selector'        => '.site-description',
				'render_callback' => function() {
					bloginfo( 'description' );
				},
			]
		);
		$wp_customize->selective_refresh->add_partial(
			'pb_front_page_catalog_title', [
				'selector'        => '#latest-books-title',
				'render_callback' => function() {
					get_option( 'pb_front_page_catalog_title' );
				},
			]
		);
		$wp_customize->selective_refresh->add_partial(
			'pb_network_contact_form_title', [
				'selector'        => '#contact .contact__title',
				'render_callback' => function() {
					get_option( 'pb_network_contact_form_title' );
				},
			]
		);
	}

	foreach ( [
		[
			'slug' => 'primary',
			'hex' => '#b01109',
			'label' => __( 'Primary Color', 'pressbooks-aldine' ),
			'description' => __( 'Primary color, used for links and other primary elements.', 'pressbooks-aldine' ),
		],
		[
			'slug' => 'primary_dark',
			'hex' => '#7f0c07',
			'label' => __( 'Primary Color (Hover)', 'pressbooks-aldine' ),
			'description' => __( 'Variant of the primary color, used for primary element hover states.', 'pressbooks-aldine' ),
		],
		[
			'slug' => 'accent',
			'hex' => '#015d75',
			'label' => __( 'Accent Color', 'pressbooks-aldine' ),
			'description' => __( 'Accent color, used for flourishes and secondary elements.', 'pressbooks-aldine' ),
		],
		[
			'slug' => 'accent_dark',
			'hex' => '#013542',
			'label' => __( 'Accent Color (Hover)', 'pressbooks-aldine' ),
			'description' => __( 'Variant of the accent color, used for secondary element hover states.', 'pressbooks-aldine' ),
		],
		[
			'slug' => 'primary_fg',
			'hex' => '#ffffff',
			'label' => __( 'Primary Foreground Color', 'pressbooks-aldine' ),
			'description' => __( 'Used for text on a primary background.', 'pressbooks-aldine' ),
		],
		[
			'slug' => 'accent_fg',
			'hex' => '#ffffff',
			'label' => __( 'Accent Foreground Color', 'pressbooks-aldine' ),
			'description' => __( 'Used for text on an accent color background.', 'pressbooks-aldine' ),
		],
	] as $color ) {
		$wp_customize->add_setting(
			"pb_network_color_{$color['slug']}", [
				'type' => 'option',
				'default' => $color['hex'],
			]
		);
		$wp_customize->add_control(
			new \WP_Customize_Color_Control(
				$wp_customize,
				"pb_network_color_{$color['slug']}",
				[
					'label' => $color['label'],
					'section'  => 'colors',
					'description' => $color['description'],
					'settings' => "pb_network_color_{$color['slug']}",
				]
			)
		);
	}
	$wp_customize->add_section(
		'pb_network_social', [
			'title' => __( 'Social Media', 'pressbooks-aldine' ),
			'priority' => 30,
		]
	);
	$wp_customize->add_setting(
		'pb_network_facebook', [
			'type' => 'option',
			'sanitize_callback' => 'esc_url_raw',
		]
	);
	$wp_customize->add_control(
		'pb_network_facebook', [
			'label' => __( 'Facebook', 'pressbooks-aldine' ),
			'section'  => 'pb_network_social',
			'settings' => 'pb_network_facebook',
		]
	);
	$wp_customize->add_setting(
		'pb_network_twitter', [
			'type' => 'option',
			'sanitize_callback' => 'esc_url_raw',
		]
	);
	$wp_customize->add_control(
		'pb_network_twitter', [
			'label' => __( 'Twitter', 'pressbooks-aldine' ),
			'section'  => 'pb_network_social',
			'settings' => 'pb_network_twitter',
		]
	);
	$wp_customize->add_setting(
		'pb_network_instagram', [
			'type' => 'option',
			'sanitize_callback' => 'esc_url_raw',
		]
	);
	$wp_customize->add_control(
		'pb_network_instagram', [
			'label' => __( 'Instagram', 'pressbooks-aldine' ),
			'section'  => 'pb_network_social',
			'settings' => 'pb_network_instagram',
		]
	);

	if ( defined( 'PB_PLUGIN_VERSION' ) ) {
		$wp_customize->add_section(
			'pb_front_page_catalog', [
				'title' => __( 'Front Page Catalog', 'pressbooks-aldine' ),
				'priority' => 25,
			]
		);
		$wp_customize->add_setting(
			'pb_front_page_catalog', [
				'type' => 'option',
			],
		);

		$wp_customize->add_control(
			'pb_front_page_catalog', [
				'label' => __( 'Show Front Page Catalog', 'pressbooks-aldine' ),
				'section'  => 'pb_front_page_catalog',
				'settings' => 'pb_front_page_catalog',
				'type' => 'checkbox',
				'default' => '0',
			]
		);
		$wp_customize->add_setting(
			'pb_front_page_catalog_title', [
				'type' => 'option',
				'sanitize_callback' => 'sanitize_text_field',
				'default' => __( 'Our Latest Titles', 'pressbooks-aldine' ),
			]
		);
		$wp_customize->add_control(
			'pb_front_page_catalog_title', [
				'label' => __( 'Front Page Catalog Title', 'pressbooks-aldine' ),
				'section'  => 'pb_front_page_catalog',
				'settings' => 'pb_front_page_catalog_title',
			]
		);

		$options = get_catalog_options();
		$books = collect( $options['books'] )->pluck( 'title', 'id' )->toArray();
		$books = [ '' => __( 'Select a book', 'pressbooks-aldine' ) ] + $books;

		foreach ( range( 1, MAX_FEATURED_BOOKS ) as $i ) {
			$wp_customize->add_setting(
				"pb_front_page_catalog_book_{$i}", [
					'type' => 'option',
				]
			);
			$wp_customize->add_control(
				"pb_front_page_catalog_book_{$i}", [
					'label' => __( 'Featured book', 'pressbooks-aldine' ) . " {$i}",
					'section'  => 'pb_front_page_catalog',
					'settings' => "pb_front_page_catalog_book_{$i}",
					'type' => 'select',
					'choices' => $books,
				]
			);
		}
	}

	$wp_customize->add_section(
		'pb_network_contact_form', [
			'title' => __( 'Contact Form', 'pressbooks-aldine' ),
			'priority' => 25,
		]
	);
	$wp_customize->add_setting(
		'pb_network_contact_form', [
			'type' => 'option',
		]
	);
	$wp_customize->add_control(
		'pb_network_contact_form', [
			'label' => __( 'Show Contact Form', 'pressbooks-aldine' ),
			'section'  => 'pb_network_contact_form',
			'settings' => 'pb_network_contact_form',
			'type' => 'checkbox',
		]
	);
	$wp_customize->add_setting(
		'pb_network_contact_form_title', [
			'type' => 'option',
			'sanitize_callback' => 'sanitize_text_field',
			'default' => __( 'Contact Us', 'pressbooks-aldine' ),
		]
	);
	$wp_customize->add_control(
		'pb_network_contact_form_title', [
			'label' => __( 'Contact Form Title', 'pressbooks-aldine' ),
			'section' => 'pb_network_contact_form',
			'settings' => 'pb_network_contact_form_title',
		]
	);
	$wp_customize->add_setting(
		'pb_network_contact_email', [
			'type' => 'option',
			'default' => get_option( 'admin_email', '' ),
			'sanitize_callback' => 'sanitize_email',
		]
	);
	$wp_customize->add_control(
		'pb_network_contact_email', [
			'label' => __( 'Contact Email', 'pressbooks-aldine' ),
			'section' => 'pb_network_contact_form',
			'settings' => 'pb_network_contact_email',
		]
	);
	$wp_customize->add_setting(
		'pb_network_contact_link', [
			'type' => 'option',
		]
	);
	$wp_customize->add_control(
		'pb_network_contact_link', [
			'label' => __( 'Contact Link', 'pressbooks-aldine' ),
			'section' => 'pb_network_contact_form',
			'settings' => 'pb_network_contact_link',
		]
	);
}

/**
 * Binds JS handlers to make Theme Customizer preview reload changes asynchronously.
 */
function customize_preview_js() {
	$assets = new Assets( 'pressbooks-aldine', 'theme' );
	$assets->setSrcDirectory( 'assets' )->setDistDirectory( 'dist' );

	wp_enqueue_script( 'aldine/customizer', $assets->getPath( 'scripts/customizer.js' ), [ 'customize-preview' ], false, null );
}

/**
 * Binds JS handlers to make Theme Customizer preview reload changes asynchronously.
 */
function featured_books_scripts() {
	$assets = new Assets( 'pressbooks-aldine', 'theme' );
	$assets->setSrcDirectory( 'assets' )->setDistDirectory( 'dist' );

	wp_enqueue_script( 'aldine/featured-books', $assets->getPath( 'scripts/featured-books.js' ), [], false, null );
}

/**
 * Load color contrast validation tool
 *
 * @see https://github.com/soderlind/customizer-validate-wcag-color-contrast
 */
function enqueue_color_contrast_validator() {
	$handle = 'wcag-validate-customizer-color-contrast';

	wp_enqueue_script(
		$handle,
		get_template_directory_uri() . '/lib/customizer-validate-wcag-color-contrast/customizer-validate-wcag-color-contrast.js',
		[ 'customize-controls' ]
	);

	$exports = [
		'validate_color_contrast' => [
			'pb_network_color_primary_fg' => [ 'pb_network_color_primary', 'pb_network_color_primary_dark' ],
			'pb_network_color_accent_fg' => [ 'pb_network_color_accent', 'pb_network_color_accent_dark' ],
			'pb_network_color_primary' => [ 'pb_network_color_primary_fg' ],
			'pb_network_color_primary_dark' => [ 'pb_network_color_primary_fg' ],
			'pb_network_color_accent' => [ 'pb_network_color_accent_fg' ],
			'pb_network_color_accent_dark' => [ 'pb_network_color_accent_fg' ],
		],
	];

	wp_scripts()->add_data(
		$handle,
		'data',
		sprintf( 'var _validateWCAGColorContrastExports = %s;', wp_json_encode( $exports ) )
	);
}

/**
 * Contact form UI tweaks (checkbox should toggle either/or)
 */
function enqueue_contact_form_tweaks() {
	$assets = new Assets( 'pressbooks-aldine', 'theme' );
	$assets->setSrcDirectory( 'assets' )->setDistDirectory( 'dist' );
	wp_enqueue_script( 'aldine/customizer-toggle', $assets->getPath( 'scripts/customizer-toggle.js' ) );
}

/**
 * Enqueue pb-a11y hacks in customizer
 */
function enqueue_pb_a11y_in_customizer() {
	$pb_a11y_script = plugin_dir_url( 'pressbooks' ) . 'pressbooks/assets/src/scripts/a11y.js';
	wp_enqueue_script( 'pb-a11y', $pb_a11y_script, [ 'wp-i18n' ], false, true );
}