wppaste
WordPress

WP_Widget_Media_Image

Since
4.8.0
Source
wp-includes/widgets/class-wp-widget-media-image.php:18
Core class that implements an image widget.

Compatibility

WordPress
since 4.8.0
  • 6.7.7
  • 6.8.8
  • 6.9.7
  • 7.0.4
  • 7.1.0

Present in every tracked release (6.7.7 to 7.1.0).

Methods · 5

Source code

class WP_Widget_Media_Image extends WP_Widget_Media { 	/**	 * Constructor.	 *	 * @since 4.8.0	 */	public function __construct() {		parent::__construct(			'media_image',			__( 'Image' ),			array(				'description' => __( 'Displays an image.' ),				'mime_type'   => 'image',			)		); 		$this->l10n = array_merge(			$this->l10n,			array(				'no_media_selected'          => __( 'No image selected' ),				'add_media'                  => _x( 'Add Image', 'label for button in the image widget' ),				'replace_media'              => _x( 'Replace Image', 'label for button in the image widget; should preferably not be longer than ~13 characters long' ),				'edit_media'                 => _x( 'Edit Image', 'label for button in the image widget; should preferably not be longer than ~13 characters long' ),				'missing_attachment'         => sprintf(					/* translators: %s: URL to media library. */					__( 'That image cannot be found. Check your <a href="%s">media library</a> and make sure it was not deleted.' ),					esc_url( admin_url( 'upload.php' ) )				),				/* translators: %d: Widget count. */				'media_library_state_multi'  => _n_noop( 'Image Widget (%d)', 'Image Widget (%d)' ),				'media_library_state_single' => __( 'Image Widget' ),			)		);	} 	/**	 * Get schema for properties of a widget instance (item).	 *	 * @since 4.8.0	 *	 * @see WP_REST_Controller::get_item_schema()	 * @see WP_REST_Controller::get_additional_fields()	 * @link https://core.trac.wordpress.org/ticket/35574	 *	 * @return array Schema for properties.	 */	public function get_instance_schema() {		return array_merge(			array(				'size'              => array(					'type'        => 'string',					'enum'        => array_merge( get_intermediate_image_sizes(), array( 'full', 'custom' ) ),					'default'     => 'medium',					'description' => __( 'Size' ),				),				'width'             => array( // Via 'customWidth', only when size=custom; otherwise via 'width'.					'type'        => 'integer',					'minimum'     => 0,					'default'     => 0,					'description' => __( 'Width' ),				),				'height'            => array( // Via 'customHeight', only when size=custom; otherwise via 'height'.					'type'        => 'integer',					'minimum'     => 0,					'default'     => 0,					'description' => __( 'Height' ),				), 				'caption'           => array(					'type'                  => 'string',					'default'               => '',					'sanitize_callback'     => 'wp_kses_post',					'description'           => __( 'Caption' ),					'should_preview_update' => false,				),				'alt'               => array(					'type'              => 'string',					'default'           => '',					'sanitize_callback' => 'sanitize_text_field',

Changelog

Introduced in 4.8.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 6.9.7 tag, from src/wp-includes/widgets/class-wp-widget-media-image.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.