Wordpress 4.6
[autoinstalls/wordpress.git] / wp-includes / class-wp-customize-widgets.php
index e2b8bf5f66a89377a1941bf596340628fc7eead4..16549ff6922623ac435a13df2a4ed1dcf5646989 100644 (file)
@@ -349,7 +349,7 @@ final class WP_Customize_Widgets {
        /**
         * Ensures widgets are available for all types of previews.
         *
-        * When in preview, hook to 'customize_register' for settings after WordPress is loaded
+        * When in preview, hook to {@see 'customize_register'} for settings after WordPress is loaded
         * so that all filters have been initialized (e.g. Widget Visibility).
         *
         * @since 3.9.0
@@ -455,7 +455,7 @@ final class WP_Customize_Widgets {
                                        );
 
                                        /**
-                                        * Filter Customizer widget section arguments for a given sidebar.
+                                        * Filters Customizer widget section arguments for a given sidebar.
                                         *
                                         * @since 3.9.0
                                         *
@@ -556,7 +556,7 @@ final class WP_Customize_Widgets {
         * have widths of 400 and yet they still render fine in the Customizer panel.
         *
         * This method will return all Core widgets as being not wide, but this can be
-        * overridden with the is_wide_widget_in_customizer filter.
+        * overridden with the {@see 'is_wide_widget_in_customizer'} filter.
         *
         * @since 3.9.0
         * @access public
@@ -575,7 +575,7 @@ final class WP_Customize_Widgets {
                $is_wide          = ( $width > 250 && ! $is_core );
 
                /**
-                * Filter whether the given widget is considered "wide".
+                * Filters whether the given widget is considered "wide".
                 *
                 * @since 3.9.0
                 *
@@ -799,6 +799,9 @@ final class WP_Customize_Widgets {
         * @access public
         */
        public function print_footer_scripts() {
+               /** This action is documented in wp-admin/admin-footer.php */
+               do_action( 'admin_print_footer_scripts-widgets.php' );
+
                /** This action is documented in wp-admin/admin-footer.php */
                do_action( 'admin_print_footer_scripts' );
 
@@ -836,7 +839,7 @@ final class WP_Customize_Widgets {
                $args = array_merge( $args, $overrides );
 
                /**
-                * Filter the common arguments supplied when constructing a Customizer setting.
+                * Filters the common arguments supplied when constructing a Customizer setting.
                 *
                 * @since 3.9.0
                 *
@@ -1986,32 +1989,48 @@ final class WP_Customize_Widgets {
        }
 
        /**
+        * {@internal Missing Summary}
+        *
+        * See the {@see 'customize_dynamic_setting_args'} filter.
+        *
         * @since 3.9.0
-        * @deprecated 4.2.0 Deprecated in favor of customize_dynamic_setting_args filter.
+        * @deprecated 4.2.0 Deprecated in favor of the {@see 'customize_dynamic_setting_args'} filter.
         */
        public function setup_widget_addition_previews() {
                _deprecated_function( __METHOD__, '4.2.0' );
        }
 
        /**
+        * {@internal Missing Summary}
+        *
+        * See the {@see 'customize_dynamic_setting_args'} filter.
+        *
         * @since 3.9.0
-        * @deprecated 4.2.0 Deprecated in favor of customize_dynamic_setting_args filter.
+        * @deprecated 4.2.0 Deprecated in favor of the {@see 'customize_dynamic_setting_args'} filter.
         */
        public function prepreview_added_sidebars_widgets() {
                _deprecated_function( __METHOD__, '4.2.0' );
        }
 
        /**
+        * {@internal Missing Summary}
+        *
+        * See the {@see 'customize_dynamic_setting_args'} filter.
+        *
         * @since 3.9.0
-        * @deprecated 4.2.0 Deprecated in favor of customize_dynamic_setting_args filter.
+        * @deprecated 4.2.0 Deprecated in favor of the {@see 'customize_dynamic_setting_args'} filter.
         */
        public function prepreview_added_widget_instance() {
                _deprecated_function( __METHOD__, '4.2.0' );
        }
 
        /**
+        * {@internal Missing Summary}
+        *
+        * See the {@see 'customize_dynamic_setting_args'} filter.
+        *
         * @since 3.9.0
-        * @deprecated 4.2.0 Deprecated in favor of customize_dynamic_setting_args filter.
+        * @deprecated 4.2.0 Deprecated in favor of the {@see 'customize_dynamic_setting_args'} filter.
         */
        public function remove_prepreview_filters() {
                _deprecated_function( __METHOD__, '4.2.0' );