Changeset 34552

Timestamp:

09/25/2015 07:20:37 PM (9 years ago)

Author:

DrewAPicture

Message:

Widgets: Pass $this to the widget_text filter to make targeting specific widget instances easier.

Also fixes docs errors in the type and description for the $instance parameter, introduced in [27697].

Fixes #24605.

File:

• trunk/src/wp-includes/widgets/class-wp-widget-text.php (modified) (1 diff)

trunk/src/wp-includes/widgets/class-wp-widget-text.php

@@ -31 +31 @@
         $title = apply_filters( 'widget_title', empty( $instance['title'] ) ? '' : $instance['title'], $instance, $this->id_base );
 
+        $widget_text = ! empty( $instance['text'] ) ? $instance['text'] : '';
+
         /**
          * Filter the content of the Text widget.
          *
          * @since 2.3.0
+         * @since 4.4.0 Added the `$this` parameter.
          *
-         * @param string    $widget_text The widget content.
-         * @param WP_Widget $instance    WP_Widget instance.
+         * @param string         $widget_text The widget content.
+         * @param array          $instance    Array of settings for the current widget.
+         * @param WP_Widget_Text $this        Current Text widget instance.
          */
-        $text = apply_filters( 'widget_text', empty( $instance['text'] ) ? '' : $instance['text'], $instance );
+        $text = apply_filters( 'widget_text', $widget_text, $instance, $this );
+
         echo $args['before_widget'];
         if ( ! empty( $title ) ) {