WP_Widget_Media::get_instance_schema(): array

Get schema for properties of a widget instance (item).

Description

See also

Return

array Schema for properties.

Source

public function get_instance_schema() {
	$schema = array(
		'attachment_id' => array(
			'type'        => 'integer',
			'default'     => 0,
			'minimum'     => 0,
			'description' => __( 'Attachment post ID' ),
			'media_prop'  => 'id',
		),
		'url'           => array(
			'type'        => 'string',
			'default'     => '',
			'format'      => 'uri',
			'description' => __( 'URL to the media file' ),
		),
		'title'         => array(
			'type'                  => 'string',
			'default'               => '',
			'sanitize_callback'     => 'sanitize_text_field',
			'description'           => __( 'Title for the widget' ),
			'should_preview_update' => false,
		),
	);

	/**
	 * Filters the media widget instance schema to add additional properties.
	 *
	 * @since 4.9.0
	 *
	 * @param array           $schema Instance schema.
	 * @param WP_Widget_Media $widget Widget object.
	 */
	$schema = apply_filters( "widget_{$this->id_base}_instance_schema", $schema, $this );

	return $schema;
}

Hooks

apply_filters( “widget_{$this->id_base}_instance_schema”, array $schema, WP_Widget_Media $widget )

Filters the media widget instance schema to add additional properties.

Changelog

VersionDescription
4.8.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.