Cleaned up and documented customizer functionality

Author: robneu

customize/actions.php

@@ -9,15 +9,62 @@
  * @since     1.0.0
  */
 
-// Prevent direct access.
 defined( 'ABSPATH' ) || exit;
 
+/**
+ * Callback defined in includes/customize/styles.php
+ *
+ * @see carelib_customize_register_controls_styles
+ */
 add_action( 'customize_controls_enqueue_scripts', 'carelib_customize_register_controls_styles', 0 );
-add_action( 'init', 'carelib_customize_load_breadcrumb_settings', 0 );
+
+/**
+ * Callback defined in includes/customize/register.php
+ *
+ * @see carelib_customize_load_breadcrumb_settings
+ */
 add_action( 'customize_register', 'carelib_customize_load_classes', 0 );
+
+/**
+ * Callback defined in includes/customize/register.php
+ *
+ * @see carelib_customize_register_layouts
+ */
+add_action( 'customize_register', 'carelib_customize_register_layouts', 10 );
+
+if ( carelib_breadcrumb_plugin_is_active() ) {
+	/**
+	 * Callback defined in includes/customize/register.php
+	 *
+	 * @see carelib_register_breadcrumb_settings
+	 */
+	add_action( 'customize_register', 'carelib_register_breadcrumb_settings', 15 );
+}
+
+/**
+ * Callback defined in includes/customize/scripts.php
+ *
+ * @see carelib_customize_register_controls_scripts
+ */
 add_action( 'customize_controls_enqueue_scripts', 'carelib_customize_register_controls_scripts', 0 );
-add_action( 'customize_preview_init',             'carelib_customize_register_preview_scripts',  0 );
-add_action( 'customize_preview_init',             'carelib_customize_enqueue_preview_scripts',  10 );
-add_action( 'customize_controls_enqueue_scripts', 'carelib_customize_register_controls_styles', 0 );
 
-add_action( 'customize_register', 'carelib_customize_register_layouts' );
+/**
+ * Callback defined in includes/customize/scripts.php
+ *
+ * @see carelib_customize_register_preview_scripts
+ */
+add_action( 'customize_preview_init', 'carelib_customize_register_preview_scripts', 0 );
+
+/**
+ * Callback defined in includes/customize/scripts.php
+ *
+ * @see carelib_customize_enqueue_preview_scripts
+ */
+add_action( 'customize_preview_init', 'carelib_customize_enqueue_preview_scripts', 10 );
+
+/**
+ * Callback defined in includes/customize/styles.php
+ *
+ * @see carelib_customize_register_controls_styles
+ */
+add_action( 'customize_controls_enqueue_scripts', 'carelib_customize_register_controls_styles', 0 );

customize/register-breadcrumbs.php

@@ -66,3 +66,48 @@ function carelib_customize_register_layouts( $wp_customize ) {
 		)
 	);
 }
+
+/**
+ * Register our customizer breadcrumb options for the parent class to load.
+ *
+ * @since  1.0.0
+ * @access public
+ * @param  object $wp_customize The WordPress customizer API object.
+ * @return void
+ */
+function carelib_register_breadcrumb_settings( $wp_customize ) {
+	$section = "{$GLOBALS['carelib_prefix']}_breadcrumbs";
+
+	$wp_customize->add_section(
+		$section,
+		array(
+			'title'       => __( 'Breadcrumbs', 'carelib' ),
+			'description' => __( 'Choose where you would like breadcrumbs to display.', 'carelib' ),
+			'priority'    => 110,
+			'capability'  => 'edit_theme_options',
+		)
+	);
+
+	$priority = 10;
+
+	foreach ( carelib_get_breadcrumb_options() as $breadcrumb => $setting ) {
+
+		$wp_customize->add_setting(
+			$breadcrumb,
+			array(
+				'default'           => $setting['default'],
+				'sanitize_callback' => 'absint',
+			)
+		);
+
+		$wp_customize->add_control(
+			$breadcrumb,
+			array(
+				'label'    => $setting['label'],
+				'section'  => $section,
+				'type'     => 'checkbox',
+				'priority' => $priority++,
+			)
+		);
+	}
+}

customize/register-layouts.php customize/register.phpcustomize/register-layouts.php renamed to customize/register.php

@@ -65,8 +65,7 @@
 if ( is_customize_preview() ) {
 	require_once CARELIB_DIR . 'customize/control-radio-image.php';
 	require_once CARELIB_DIR . 'customize/control-layout.php';
-	require_once CARELIB_DIR . 'customize/register-breadcrumbs.php';
-	require_once CARELIB_DIR . 'customize/register-layouts.php';
+	require_once CARELIB_DIR . 'customize/register.php';
 	require_once CARELIB_DIR . 'customize/scripts.php';
 	require_once CARELIB_DIR . 'customize/styles.php';
 	require_once CARELIB_DIR . 'customize/actions.php';