Wordpress 4.6

[autoinstalls/wordpress.git] / wp-includes / class-wp-customize-widgets.php

diff --git a/wp-includes/class-wp-customize-widgets.php b/wp-includes/class-wp-customize-widgets.php
index e2b8bf5f66a89377a1941bf596340628fc7eead4..16549ff6922623ac435a13df2a4ed1dcf5646989 100644 (file)
--- a/wp-includes/class-wp-customize-widgets.php
+++ b/wp-includes/class-wp-customize-widgets.php
@@ -349,7 +349,7 @@ final class WP_Customize_Widgets {
        /**
         * Ensures widgets are available for all types of previews.
         *
        /**
         * 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
         * 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
                                         *
                                         *
                                         * @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
         * 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
         *
         * @since 3.9.0
         * @access public


@@ -575,7 +575,7 @@ final class WP_Customize_Widgets {
                $is_wide          = ( $width > 250 && ! $is_core );
 
                /**
                $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
                 *
                 *
                 * @since 3.9.0
                 *


@@ -799,6 +799,9 @@ final class WP_Customize_Widgets {
         * @access public
         */
        public function print_footer_scripts() {
         * @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' );
 
                /** 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 );
 
                /**
                $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
                 *
                 *
                 * @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
         * @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' );
        }
 
        /**
         */
        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
         * @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' );
        }
 
        /**
         */
        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
         * @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' );
        }
 
        /**
         */
        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
         * @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' );
         */
        public function remove_prepreview_filters() {
                _deprecated_function( __METHOD__, '4.2.0' );