<h2>File Contents: /home/planet5/www/yogitonics.com/wp-includes/widgets/copy_of_copy_of_class-wp-widget-media.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/www/yogitonics.com/wp-includes/widgets/copy_of_copy_of_class-wp-widget-media.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php
/**
 * Widget API: WP_Media_Widget class
 *
 * @package WordPress
 * @subpackage Widgets
 * @since 4.8.0
 */

/**
 * Core class that implements a media widget.
 *
 * @since 4.8.0
 *
 * @see WP_Widget
 */
abstract class WP_Widget_Media extends WP_Widget {

	/**
	 * Translation labels.
	 *
	 * @since 4.8.0
	 * @var array
	 */
	public $l10n = array(
		&#039;add_to_widget&#039;              =&gt; &#039;&#039;,
		&#039;replace_media&#039;              =&gt; &#039;&#039;,
		&#039;edit_media&#039;                 =&gt; &#039;&#039;,
		&#039;media_library_state_multi&#039;  =&gt; &#039;&#039;,
		&#039;media_library_state_single&#039; =&gt; &#039;&#039;,
		&#039;missing_attachment&#039;         =&gt; &#039;&#039;,
		&#039;no_media_selected&#039;          =&gt; &#039;&#039;,
		&#039;add_media&#039;                  =&gt; &#039;&#039;,
	);

	/**
	 * Whether or not the widget has been registered yet.
	 *
	 * @since 4.8.1
	 * @var bool
	 */
	protected $registered = false;

	/**
	 * The default widget description.
	 *
	 * @since 6.0.0
	 * @var string
	 */
	protected static $default_description = &#039;&#039;;

	/**
	 * The default localized strings used by the widget.
	 *
	 * @since 6.0.0
	 * @var string[]
	 */
	protected static $l10n_defaults = array();

	/**
	 * Constructor.
	 *
	 * @since 4.8.0
	 *
	 * @param string $id_base         Base ID for the widget, lowercase and unique.
	 * @param string $name            Name for the widget displayed on the configuration page.
	 * @param array  $widget_options  Optional. Widget options. See wp_register_sidebar_widget() for
	 *                                information on accepted arguments. Default empty array.
	 * @param array  $control_options Optional. Widget control options. See wp_register_widget_control()
	 *                                for information on accepted arguments. Default empty array.
	 */
	public function __construct( $id_base, $name, $widget_options = array(), $control_options = array() ) {
		$widget_opts = wp_parse_args(
			$widget_options,
			array(
				&#039;description&#039;                 =&gt; self::get_default_description(),
				&#039;customize_selective_refresh&#039; =&gt; true,
				&#039;show_instance_in_rest&#039;       =&gt; true,
				&#039;mime_type&#039;                   =&gt; &#039;&#039;,
			)
		);

		$control_opts = wp_parse_args( $control_options, array() );

		$this-&gt;l10n = array_merge( self::get_l10n_defaults(), array_filter( $this-&gt;l10n ) );

		parent::__construct(
			$id_base,
			$name,
			$widget_opts,
			$control_opts
		);
	}

	/**
	 * Add hooks while registering all widget instances of this widget class.
	 *
	 * @since 4.8.0
	 *
	 * @param int $number Optional. The unique order number of this widget instance
	 *                    compared to other instances of the same class. Default -1.
	 */
	public function _register_one( $number = -1 ) {
		parent::_register_one( $number );
		if ( $this-&gt;registered ) {
			return;
		}
		$this-&gt;registered = true;

		/*
		 * Note that the widgets component in the customizer will also do
		 * the &#039;admin_print_scripts-widgets.php&#039; action in WP_Customize_Widgets::print_scripts().
		 */
		add_action( &#039;admin_print_scripts-widgets.php&#039;, array( $this, &#039;enqueue_admin_scripts&#039; ) );

		if ( $this-&gt;is_preview() ) {
			add_action( &#039;wp_enqueue_scripts&#039;, array( $this, &#039;enqueue_preview_scripts&#039; ) );
		}

		/*
		 * Note that the widgets component in the customizer will also do
		 * the &#039;admin_footer-widgets.php&#039; action in WP_Customize_Widgets::print_footer_scripts().
		 */
		add_action( &#039;admin_footer-widgets.php&#039;, array( $this, &#039;render_control_template_scripts&#039; ) );

		add_filter( &#039;display_media_states&#039;, array( $this, &#039;display_media_state&#039; ), 10, 2 );
	}

	/**
	 * 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() {
		$schema = array(
			&#039;attachment_id&#039; =&gt; array(
				&#039;type&#039;        =&gt; &#039;integer&#039;,
				&#039;default&#039;     =&gt; 0,
				&#039;minimum&#039;     =&gt; 0,
				&#039;description&#039; =&gt; __( &#039;Attachment post ID&#039; ),
				&#039;media_prop&#039;  =&gt; &#039;id&#039;,
			),
			&#039;url&#039;           =&gt; array(
				&#039;type&#039;        =&gt; &#039;string&#039;,
				&#039;default&#039;     =&gt; &#039;&#039;,
				&#039;format&#039;      =&gt; &#039;uri&#039;,
				&#039;description&#039; =&gt; __( &#039;URL to the media file&#039; ),
			),
			&#039;title&#039;         =&gt; array(
				&#039;type&#039;                  =&gt; &#039;string&#039;,
				&#039;default&#039;               =&gt; &#039;&#039;,
				&#039;sanitize_callback&#039;     =&gt; &#039;sanitize_text_field&#039;,
				&#039;description&#039;           =&gt; __( &#039;Title for the widget&#039; ),
				&#039;should_preview_update&#039; =&gt; 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( &quot;widget_{$this-&gt;id_base}_instance_schema&quot;, $schema, $this );

		return $schema;
	}

	/**
	 * Determine if the supplied attachment is for a valid attachment post with the specified MIME type.
	 *
	 * @since 4.8.0
	 *
	 * @param int|WP_Post $attachment Attachment post ID or object.
	 * @param string      $mime_type  MIME type.
	 * @return bool Is matching MIME type.
	 */
	public function is_attachment_with_mime_type( $attachment, $mime_type ) {
		if ( empty( $attachment ) ) {
			return false;
		}
		$attachment = get_post( $attachment );
		if ( ! $attachment ) {
			return false;
		}
		if ( &#039;attachment&#039; !== $attachment-&gt;post_type ) {
			return false;
		}
		return wp_attachment_is( $mime_type, $attachment );
	}

	/**
	 * Sanitize a token list string, such as used in HTML rel and class attributes.
	 *
	 * @since 4.8.0
	 *
	 * @link http://w3c.github.io/html/infrastructure.html#space-separated-tokens
	 * @link https://developer.mozilla.org/en-US/docs/Web/API/DOMTokenList
	 * @param string|array $tokens List of tokens separated by spaces, or an array of tokens.
	 * @return string Sanitized token string list.
	 */
	public function sanitize_token_list( $tokens ) {
		if ( is_string( $tokens ) ) {
			$tokens = preg_split( &#039;/\s+/&#039;, trim( $tokens ) );
		}
		$tokens = array_map( &#039;sanitize_html_class&#039;, $tokens );
		$tokens = array_filter( $tokens );
		return implode( &#039; &#039;, $tokens );
	}

	/**
	 * Displays the widget on the front-end.
	 *
	 * @since 4.8.0
	 *
	 * @see WP_Widget::widget()
	 *
	 * @param array $args     Display arguments including before_title, after_title, before_widget, and after_widget.
	 * @param array $instance Saved setting from the database.
	 */
	public function widget( $args, $instance ) {
		$instance = wp_parse_args( $instance, wp_list_pluck( $this-&gt;get_instance_schema(), &#039;default&#039; ) );

		// Short-circuit if no media is selected.
		if ( ! $this-&gt;has_content( $instance ) ) {
			return;
		}

		echo $args[&#039;before_widget&#039;];

		/** This filter is documented in wp-includes/widgets/class-wp-widget-pages.php */
		$title = apply_filters( &#039;widget_title&#039;, $instance[&#039;title&#039;], $instance, $this-&gt;id_base );

		if ( $title ) {
			echo $args[&#039;before_title&#039;] . $title . $args[&#039;after_title&#039;];
		}

		/**
		 * Filters the media widget instance prior to rendering the media.
		 *
		 * @since 4.8.0
		 *
		 * @param array           $instance Instance data.
		 * @param array           $args     Widget args.
		 * @param WP_Widget_Media $widget   Widget object.
		 */
		$instance = apply_filters( &quot;widget_{$this-&gt;id_base}_instance&quot;, $instance, $args, $this );

		$this-&gt;render_media( $instance );

		echo $args[&#039;after_widget&#039;];
	}

	/**
	 * Sanitizes the widget form values as they are saved.
	 *
	 * @since 4.8.0
	 * @since 5.9.0 Renamed `$instance` to `$old_instance` to match parent class
	 *              for PHP 8 named parameter support.
	 *
	 * @see WP_Widget::update()
	 * @see WP_REST_Request::has_valid_params()
	 * @see WP_REST_Request::sanitize_params()
	 *
	 * @param array $new_instance Values just sent to be saved.
	 * @param array $old_instance Previously saved values from database.
	 * @return array Updated safe values to be saved.
	 */
	public function update( $new_instance, $old_instance ) {

		$schema = $this-&gt;get_instance_schema();
		foreach ( $schema as $field =&gt; $field_schema ) {
			if ( ! array_key_exists( $field, $new_instance ) ) {
				continue;
			}
			$value = $new_instance[ $field ];

			/*
			 * Workaround for rest_validate_value_from_schema() due to the fact that
			 * rest_is_boolean( &#039;&#039; ) === false, while rest_is_boolean( &#039;1&#039; ) is true.
			 */
			if ( &#039;boolean&#039; === $field_schema[&#039;type&#039;] &amp;&amp; &#039;&#039; === $value ) {
				$value = false;
			}

			if ( true !== rest_validate_value_from_schema( $value, $field_schema, $field ) ) {
				continue;
			}

			$value = rest_sanitize_value_from_schema( $value, $field_schema );

			// @codeCoverageIgnoreStart
			if ( is_wp_error( $value ) ) {
				continue; // Handle case when rest_sanitize_value_from_schema() ever returns WP_Error as its phpdoc @return tag indicates.
			}

			// @codeCoverageIgnoreEnd
			if ( isset( $field_schema[&#039;sanitize_callback&#039;] ) ) {
				$value = call_user_func( $field_schema[&#039;sanitize_callback&#039;], $value );
			}
			if ( is_wp_error( $value ) ) {
				continue;
			}
			$old_instance[ $field ] = $value;
		}

		return $old_instance;
	}

	/**
	 * Render the media on the frontend.
	 *
	 * @since 4.8.0
	 *
	 * @param array $instance Widget instance props.
	 */
	abstract public function render_media( $instance );

	/**
	 * Outputs the settings update form.
	 *
	 * Note that the widget UI itself is rendered with JavaScript via `MediaWidgetControl#render()`.
	 *
	 * @since 4.8.0
	 *
	 * @see \WP_Widget_Media::render_control_template_scripts() Where the JS template is located.
	 *
	 * @param array $instance Current settings.
	 */
	final public function form( $instance ) {
		$instance_schema = $this-&gt;get_instance_schema();
		$instance        = wp_array_slice_assoc(
			wp_parse_args( (array) $instance, wp_list_pluck( $instance_schema, &#039;default&#039; ) ),
			array_keys( $instance_schema )
		);

		foreach ( $instance as $name =&gt; $value ) : ?&gt;
			&lt;input
				type=&quot;hidden&quot;
				data-property=&quot;&lt;?php echo esc_attr( $name ); ?&gt;&quot;
				class=&quot;media-widget-instance-property&quot;
				name=&quot;&lt;?php echo esc_attr( $this-&gt;get_field_name( $name ) ); ?&gt;&quot;
				id=&quot;&lt;?php echo esc_attr( $this-&gt;get_field_id( $name ) ); // Needed specifically by wpWidgets.appendTitle(). ?&gt;&quot;
				value=&quot;&lt;?php echo esc_attr( is_array( $value ) ? implode( &#039;,&#039;, $value ) : (string) $value ); ?&gt;&quot;
			/&gt;
			&lt;?php
		endforeach;
	}

	/**
	 * Filters the default media display states for items in the Media list table.
	 *
	 * @since 4.8.0
	 *
	 * @param array        $states An array of media states.
	 * @param WP_Post|null $post   The current attachment object.
	 * @return array
	 */
	public function display_media_state( $states, $post = null ) {
		if ( ! $post ) {
			$post = get_post();
		}

		// Count how many times this attachment is used in widgets.
		$use_count = 0;
		foreach ( $this-&gt;get_settings() as $instance ) {
			if ( isset( $instance[&#039;attachment_id&#039;] ) &amp;&amp; $instance[&#039;attachment_id&#039;] === $post-&gt;ID ) {
				++$use_count;
			}
		}

		if ( 1 === $use_count ) {
			$states[] = $this-&gt;l10n[&#039;media_library_state_single&#039;];
		} elseif ( $use_count &gt; 0 ) {
			$states[] = sprintf( translate_nooped_plural( $this-&gt;l10n[&#039;media_library_state_multi&#039;], $use_count ), number_format_i18n( $use_count ) );
		}

		return $states;
	}

	/**
	 * Enqueue preview scripts.
	 *
	 * These scripts normally are enqueued just-in-time when a widget is rendered.
	 * In the customizer, however, widgets can be dynamically added and rendered via
	 * selective refresh, and so it is important to unconditionally enqueue them in
	 * case a widget does get added.
	 *
	 * @since 4.8.0
	 */
	public function enqueue_preview_scripts() {}

	/**
	 * Loads the required scripts and styles for the widget control.
	 *
	 * @since 4.8.0
	 */
	public function enqueue_admin_scripts() {
		wp_enqueue_media();
		wp_enqueue_script( &#039;media-widgets&#039; );
	}

	/**
	 * Render form template scripts.
	 *
	 * @since 4.8.0
	 */
	public function render_control_template_scripts() {
		?&gt;
		&lt;script type=&quot;text/html&quot; id=&quot;tmpl-widget-media-&lt;?php echo esc_attr( $this-&gt;id_base ); ?&gt;-control&quot;&gt;
			&lt;# var elementIdPrefix = &#039;el&#039; + String( Math.random() ) + &#039;_&#039; #&gt;
			&lt;p&gt;
				&lt;label for=&quot;{{ elementIdPrefix }}title&quot;&gt;&lt;?php esc_html_e( &#039;Title:&#039; ); ?&gt;&lt;/label&gt;
				&lt;input id=&quot;{{ elementIdPrefix }}title&quot; type=&quot;text&quot; class=&quot;widefat title&quot;&gt;
			&lt;/p&gt;
			&lt;div class=&quot;media-widget-preview &lt;?php echo esc_attr( $this-&gt;id_base ); ?&gt;&quot;&gt;
				&lt;div class=&quot;attachment-media-view&quot;&gt;
					&lt;button type=&quot;button&quot; class=&quot;select-media button-add-media not-selected&quot;&gt;
						&lt;?php echo esc_html( $this-&gt;l10n[&#039;add_media&#039;] ); ?&gt;
					&lt;/button&gt;
				&lt;/div&gt;
			&lt;/div&gt;
			&lt;p class=&quot;media-widget-buttons&quot;&gt;
				&lt;button type=&quot;button&quot; class=&quot;button edit-media selected&quot;&gt;
					&lt;?php echo esc_html( $this-&gt;l10n[&#039;edit_media&#039;] ); ?&gt;
				&lt;/button&gt;
			&lt;?php if ( ! empty( $this-&gt;l10n[&#039;replace_media&#039;] ) ) : ?&gt;
				&lt;button type=&quot;button&quot; class=&quot;button change-media select-media selected&quot;&gt;
					&lt;?php echo esc_html( $this-&gt;l10n[&#039;replace_media&#039;] ); ?&gt;
				&lt;/button&gt;
			&lt;?php endif; ?&gt;
			&lt;/p&gt;
			&lt;div class=&quot;media-widget-fields&quot;&gt;
			&lt;/div&gt;
		&lt;/script&gt;
		&lt;?php
	}

	/**
	 * Resets the cache for the default labels.
	 *
	 * @since 6.0.0
	 */
	public static function reset_default_labels() {
		self::$default_description = &#039;&#039;;
		self::$l10n_defaults       = array();
	}

	/**
	 * Whether the widget has content to show.
	 *
	 * @since 4.8.0
	 *
	 * @param array $instance Widget instance props.
	 * @return bool Whether widget has content.
	 */
	protected function has_content( $instance ) {
		return ( $instance[&#039;attachment_id&#039;] &amp;&amp; &#039;attachment&#039; === get_post_type( $instance[&#039;attachment_id&#039;] ) ) || $instance[&#039;url&#039;];
	}

	/**
	 * Returns the default description of the widget.
	 *
	 * @since 6.0.0
	 *
	 * @return string
	 */
	protected static function get_default_description() {
		if ( self::$default_description ) {
			return self::$default_description;
		}

		self::$default_description = __( &#039;A media item.&#039; );
		return self::$default_description;
	}

	/**
	 * Returns the default localized strings used by the widget.
	 *
	 * @since 6.0.0
	 *
	 * @return (string|array)[]
	 */
	protected static function get_l10n_defaults() {
		if ( ! empty( self::$l10n_defaults ) ) {
			return self::$l10n_defaults;
		}

		self::$l10n_defaults = array(
			&#039;no_media_selected&#039;          =&gt; __( &#039;No media selected&#039; ),
			&#039;add_media&#039;                  =&gt; _x( &#039;Add Media&#039;, &#039;label for button in the media widget&#039; ),
			&#039;replace_media&#039;              =&gt; _x( &#039;Replace Media&#039;, &#039;label for button in the media widget; should preferably not be longer than ~13 characters long&#039; ),
			&#039;edit_media&#039;                 =&gt; _x( &#039;Edit Media&#039;, &#039;label for button in the media widget; should preferably not be longer than ~13 characters long&#039; ),
			&#039;add_to_widget&#039;              =&gt; __( &#039;Add to Widget&#039; ),
			&#039;missing_attachment&#039;         =&gt; sprintf(
				/* translators: %s: URL to media library. */
				__( &#039;That file cannot be found. Check your &lt;a href=&quot;%s&quot;&gt;media library&lt;/a&gt; and make sure it was not deleted.&#039; ),
				esc_url( admin_url( &#039;upload.php&#039; ) )
			),
			/* translators: %d: Widget count. */
			&#039;media_library_state_multi&#039;  =&gt; _n_noop( &#039;Media Widget (%d)&#039;, &#039;Media Widget (%d)&#039; ),
			&#039;media_library_state_single&#039; =&gt; __( &#039;Media Widget&#039; ),
			&#039;unsupported_file_type&#039;      =&gt; __( &#039;Looks like this is not the correct kind of file. Please link to an appropriate file instead.&#039; ),
		);

		return self::$l10n_defaults;
	}
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fwww%2Fyogitonics.com%2Fwp-includes%2Fwidgets'>⬅ Back to Directory</a>