enmi-conf.org: comparison wp/wp-includes/class-wp-customize-control.php

equal deleted inserted replaced

-:48c4eec2b7e6
+:8c2e4d02f4ef
 *
 * @package WordPress
 * @subpackage Customize
 * @since 3.4.0
 */
+// Don't load directly.
+if ( ! defined( 'ABSPATH' ) ) {
+	die( '-1' );
+}
 /**
 * Customize Control class.
 *
 * @since 3.4.0
 		}
 		$this->settings = $settings;
 	}
 	/**
-	 * Enqueue control related scripts/styles.
+	 * Enqueues control related scripts/styles.
 	 *
 	 * @since 3.4.0
 	 */
 	public function enqueue() {}
 	/**
-	 * Check whether control is active to current Customizer preview.
+	 * Checks whether control is active to current Customizer preview.
 	 *
 	 * @since 4.0.0
 	 *
 	 * @return bool Whether the control is active to the current preview.
 	 */
 	public function active_callback() {
 		return true;
 	}
 	/**
-	 * Fetch a setting's value.
+	 * Fetches a setting's value.
 	 * Grabs the main setting by default.
 	 *
 	 * @since 3.4.0
 	 *
 	 * @param string $setting_key
 			return $this->settings[ $setting_key ]->value();
 		}
 	}
 	/**
-	 * Refresh the parameters passed to the JavaScript via JSON.
+	 * Refreshes the parameters passed to the JavaScript via JSON.
 	 *
 	 * @since 3.4.0
 	 */
 	public function to_json() {
 		$this->json['settings'] = array();
 			$this->json['allow_addition'] = $this->allow_addition;
 		}
 	}
 	/**
-	 * Get the data to export to the client via JSON.
+	 * Gets the data to export to the client via JSON.
 	 *
 	 * @since 4.1.0
 	 *
 	 * @return array Array of parameters passed to the JavaScript.
 	 */
 		return true;
 	}
 	/**
-	 * Get the control's content for insertion into the Customizer pane.
+	 * Gets the control's content for insertion into the Customizer pane.
 	 *
 	 * @since 4.1.0
 	 *
 	 * @return string Contents of the control.
 	 */
 		$this->maybe_render();
 		return trim( ob_get_clean() );
 	}
 	/**
-	 * Check capabilities and render the control.
+	 * Checks capabilities and render the control.
 	 *
 	 * @since 3.4.0
 	 * @uses WP_Customize_Control::render()
 	 */
 	final public function maybe_render() {
 		$this->render_content();
 		echo '</li>';
 	}
 	/**
-	 * Get the data link attribute for a setting.
+	 * Gets the data link attribute for a setting.
 	 *
 	 * @since 3.4.0
 	 * @since 4.9.0 Return a `data-customize-setting-key-link` attribute if a setting is not registered for the supplied setting key.
 	 *
 	 * @param string $setting_key
-	 * @return string Data link parameter, a `data-customize-setting-link` attribute if the `$setting_key` refers to a pre-registered setting,
+	 * @return string Data link parameter, a `data-customize-setting-link` attribute if the `$setting_key` refers
-	 *                and a `data-customize-setting-key-link` attribute if the setting is not yet registered.
+	 *                to a pre-registered setting, and a `data-customize-setting-key-link` attribute if the setting
+	 *                is not yet registered.
 	 */
 	public function get_link( $setting_key = 'default' ) {
 		if ( isset( $this->settings[ $setting_key ] ) && $this->settings[ $setting_key ] instanceof WP_Customize_Setting ) {
 			return 'data-customize-setting-link="' . esc_attr( $this->settings[ $setting_key ]->id ) . '"';
 		} else {
 			return 'data-customize-setting-key-link="' . esc_attr( $setting_key ) . '"';
 		}
 	}
 	/**
-	 * Render the data link attribute for the control's input element.
+	 * Renders the data link attribute for the control's input element.
 	 *
 	 * @since 3.4.0
 	 * @uses WP_Customize_Control::get_link()
 	 *
-	 * @param string $setting_key
+	 * @param string $setting_key Default 'default'.
 	 */
 	public function link( $setting_key = 'default' ) {
 		echo $this->get_link( $setting_key );
 	}
 	/**
-	 * Render the custom attributes for the control's input element.
+	 * Renders the custom attributes for the control's input element.
 	 *
 	 * @since 4.0.0
 	 */
 	public function input_attrs() {
 		foreach ( $this->input_attrs as $attr => $value ) {
 			echo $attr . '="' . esc_attr( $value ) . '" ';
 		}
 	}
 	/**
-	 * Render the control's content.
+	 * Renders the control's content.
 	 *
 	 * Allows the content to be overridden without having to rewrite the wrapper in `$this::render()`.
 	 *
 	 * Supports basic input types `text`, `checkbox`, `textarea`, `radio`, `select` and `dropdown-pages`.
 	 * Additional input types such as `email`, `url`, `number`, `hidden` and `date` are supported implicitly.
 				// Hackily add in the data link parameter.
 				$dropdown = str_replace( '<select', '<select ' . $this->get_link() . ' id="' . esc_attr( $input_id ) . '" ' . $describedby_attr, $dropdown );
 				/*
-				 * Even more hacikly add auto-draft page stubs.
+				 * Even more hackily add auto-draft page stubs.
 				 * @todo Eventually this should be removed in favor of the pages being injected into the underlying get_pages() call.
 				 * See <https://github.com/xwp/wp-customize-posts/pull/250>.
 				 */
 				$nav_menus_created_posts_setting = $this->manager->get_setting( 'nav_menus_created_posts' );
 				if ( $nav_menus_created_posts_setting && current_user_can( 'publish_pages' ) ) {
 				echo $dropdown;
 				?>
 				<?php if ( $this->allow_addition && current_user_can( 'publish_pages' ) && current_user_can( 'edit_theme_options' ) ) : // Currently tied to menus functionality. ?>
 					<button type="button" class="button-link add-new-toggle">
 						<?php
-						/* translators: %s: Add New Page label. */
+						/* translators: %s: Add Page label. */
 						printf( __( '+ %s' ), get_post_type_object( 'page' )->labels->add_new_item );
 						?>
 					</button>
 					<div class="new-content-item-wrapper">
 						<label for="create-input-<?php echo esc_attr( $this->id ); ?>"><?php _e( 'New page title' ); ?></label>
 				break;
 		}
 	}
 	/**
-	 * Render the control's JS template.
+	 * Renders the control's JS template.
 	 *
 	 * This function is only run for control types that have been registered with
 	 * WP_Customize_Manager::register_control_type().
 	 *
 	 * In the future, this will also print the template for the control's container

changeset 22	8c2e4d02f4ef
parent 21	48c4eec2b7e6