widget_text │ filter-hook │ WP 2.3.0

Filters the content of the Text widget.

Usage

add_filter( 'widget_text', 'wp_kama_widget_text_filter', 10, 3 );

/**
 * Function for `widget_text` filter-hook.
 * 
 * @param string                               $text     The widget content.
 * @param array                                $instance Array of settings for the current widget.
 * @param WP_Widget_Text|WP_Widget_Custom_HTML $widget   Current text or HTML widget instance.
 *
 * @return string
 */
function wp_kama_widget_text_filter( $text, $instance, $widget ){

	// filter...
	return $text;
}

$text(string)

The widget content.

$instance(array)

Array of settings for the current widget.

$widget(WP_Widget_Text|WP_Widget_Custom_HTML)

Current text or HTML widget instance.

Changelog

Where the hook is called

$text = apply_filters( 'widget_text', $text, $instance, $this );

$content = apply_filters( 'widget_text', $instance['content'], $simulated_text_widget_instance, $this );

Where the hook is used in WordPress

add_filter( 'widget_text', 'balanceTags' );

remove_filter( 'widget_text', 'do_shortcode', $widget_text_do_shortcode_priority );

add_filter( 'widget_text', 'do_shortcode', $widget_text_do_shortcode_priority );