wp_dashboard_rss_control( string $widget_id, array $form_inputs = array() )

Description

Parameters

$widget_idstring

$form_inputsarrayoptional

Default: array()

Uses · 10

• get_option()Retrieves an option value based on an option name.
• wp_unslash()Removes slashes from a string or recursively removes slashes from strings within an array.
• wp_widget_rss_process()Processes RSS feed widget data and optionally retrieve feed items.
• fetch_feed()Builds SimplePie object based on RSS or Atom feed from URL.
• is_wp_error()Checks whether the given variable is a WordPress Error.
• __()Retrieves the translation of $text.
• update_option()Updates the value of an option that was already added.
• get_user_locale()Retrieves the locale of a user.
• delete_transient()Deletes a transient.
• wp_widget_rss_form()Displays RSS widget options form.

Source

View on Trac ↗View on GitHub ↗

1265function wp_dashboard_rss_control( $widget_id, $form_inputs = array() ) {1266	$widget_options = get_option( 'dashboard_widget_options' );1267 1268	if ( ! $widget_options ) {1269		$widget_options = array();1270	}1271 1272	if ( ! isset( $widget_options[ $widget_id ] ) ) {1273		$widget_options[ $widget_id ] = array();1274	}1275 1276	$number = 1; // Hack to use wp_widget_rss_form().1277 1278	$widget_options[ $widget_id ]['number'] = $number;1279 1280	if ( 'POST' === $_SERVER['REQUEST_METHOD'] && isset( $_POST['widget-rss'][ $number ] ) ) {1281		$_POST['widget-rss'][ $number ]         = wp_unslash( $_POST['widget-rss'][ $number ] );1282		$widget_options[ $widget_id ]           = wp_widget_rss_process( $_POST['widget-rss'][ $number ] );1283		$widget_options[ $widget_id ]['number'] = $number;1284 1285		// Title is optional. If black, fill it if possible.1286		if ( ! $widget_options[ $widget_id ]['title'] && isset( $_POST['widget-rss'][ $number ]['title'] ) ) {1287			$rss = fetch_feed( $widget_options[ $widget_id ]['url'] );1288			if ( is_wp_error( $rss ) ) {1289				$widget_options[ $widget_id ]['title'] = htmlentities( __( 'Unknown Feed' ) );1290			} else {1291				$widget_options[ $widget_id ]['title'] = htmlentities( strip_tags( $rss->get_title() ) );1292				$rss->__destruct();1293				unset( $rss );1294			}1295		}1296 1297		update_option( 'dashboard_widget_options', $widget_options, false );1298 1299		$locale    = get_user_locale();1300		$cache_key = 'dash_v2_' . md5( $widget_id . '_' . $locale );1301		delete_transient( $cache_key );1302	}1303 1304	wp_widget_rss_form( $widget_options[ $widget_id ], $form_inputs );1305}

History

Introduced in 2.5.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.0.4 tag, from src/wp-admin/includes/dashboard.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.