<?php

[0] Fix | Delete

/**

[1] Fix | Delete

* Widget API: WP_Media_Widget class

[2] Fix | Delete

*

[3] Fix | Delete

* @package WordPress

[4] Fix | Delete

* @subpackage Widgets

[5] Fix | Delete

* @since 4.8.0

[6] Fix | Delete

*/

[7] Fix | Delete

[8] Fix | Delete

/**

[9] Fix | Delete

* Core class that implements a media widget.

[10] Fix | Delete

*

[11] Fix | Delete

* @since 4.8.0

[12] Fix | Delete

*

[13] Fix | Delete

* @see WP_Widget

[14] Fix | Delete

*/

[15] Fix | Delete

abstract class WP_Widget_Media extends WP_Widget {

[16] Fix | Delete

[17] Fix | Delete

/**

[18] Fix | Delete

* Translation labels.

[19] Fix | Delete

*

[20] Fix | Delete

* @since 4.8.0

[21] Fix | Delete

* @var array

[22] Fix | Delete

*/

[23] Fix | Delete

public $l10n = array(

[24] Fix | Delete

'add_to_widget' => '',

[25] Fix | Delete

'replace_media' => '',

[26] Fix | Delete

'edit_media' => '',

[27] Fix | Delete

'media_library_state_multi' => '',

[28] Fix | Delete

'media_library_state_single' => '',

[29] Fix | Delete

'missing_attachment' => '',

[30] Fix | Delete

'no_media_selected' => '',

[31] Fix | Delete

'add_media' => '',

[32] Fix | Delete

);

[33] Fix | Delete

[34] Fix | Delete

/**

[35] Fix | Delete

* Whether or not the widget has been registered yet.

[36] Fix | Delete

*

[37] Fix | Delete

* @since 4.8.1

[38] Fix | Delete

* @var bool

[39] Fix | Delete

*/

[40] Fix | Delete

protected $registered = false;

[41] Fix | Delete

[42] Fix | Delete

/**

[43] Fix | Delete

* The default widget description.

[44] Fix | Delete

*

[45] Fix | Delete

* @since 6.0.0

[46] Fix | Delete

* @var string

[47] Fix | Delete

*/

[48] Fix | Delete

protected static $default_description = '';

[49] Fix | Delete

[50] Fix | Delete

/**

[51] Fix | Delete

* The default localized strings used by the widget.

[52] Fix | Delete

*

[53] Fix | Delete

* @since 6.0.0

[54] Fix | Delete

* @var string[]

[55] Fix | Delete

*/

[56] Fix | Delete

protected static $l10n_defaults = array();

[57] Fix | Delete

[58] Fix | Delete

/**

[59] Fix | Delete

* Constructor.

[60] Fix | Delete

*

[61] Fix | Delete

* @since 4.8.0

[62] Fix | Delete

*

[63] Fix | Delete

* @param string $id_base Base ID for the widget, lowercase and unique.

[64] Fix | Delete

* @param string $name Name for the widget displayed on the configuration page.

[65] Fix | Delete

* @param array $widget_options Optional. Widget options. See wp_register_sidebar_widget() for

[66] Fix | Delete

* information on accepted arguments. Default empty array.

[67] Fix | Delete

* @param array $control_options Optional. Widget control options. See wp_register_widget_control()

[68] Fix | Delete

* for information on accepted arguments. Default empty array.

[69] Fix | Delete

*/

[70] Fix | Delete

public function __construct( $id_base, $name, $widget_options = array(), $control_options = array() ) {

[71] Fix | Delete

$widget_opts = wp_parse_args(

[72] Fix | Delete

$widget_options,

[73] Fix | Delete

array(

[74] Fix | Delete

'description' => self::get_default_description(),

[75] Fix | Delete

'customize_selective_refresh' => true,

[76] Fix | Delete

'show_instance_in_rest' => true,

[77] Fix | Delete

'mime_type' => '',

[78] Fix | Delete

)

[79] Fix | Delete

);

[80] Fix | Delete

[81] Fix | Delete

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

[82] Fix | Delete

[83] Fix | Delete

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

[84] Fix | Delete

[85] Fix | Delete

parent::__construct(

[86] Fix | Delete

$id_base,

[87] Fix | Delete

$name,

[88] Fix | Delete

$widget_opts,

[89] Fix | Delete

$control_opts

[90] Fix | Delete

);

[91] Fix | Delete

}

[92] Fix | Delete

[93] Fix | Delete

/**

[94] Fix | Delete

* Add hooks while registering all widget instances of this widget class.

[95] Fix | Delete

*

[96] Fix | Delete

* @since 4.8.0

[97] Fix | Delete

*

[98] Fix | Delete

* @param int $number Optional. The unique order number of this widget instance

[99] Fix | Delete

* compared to other instances of the same class. Default -1.

[100] Fix | Delete

*/

[101] Fix | Delete

public function _register_one( $number = -1 ) {

[102] Fix | Delete

parent::_register_one( $number );

[103] Fix | Delete

if ( $this->registered ) {

[104] Fix | Delete

return;

[105] Fix | Delete

}

[106] Fix | Delete

$this->registered = true;

[107] Fix | Delete

[108] Fix | Delete

/*

[109] Fix | Delete

* Note that the widgets component in the customizer will also do

[110] Fix | Delete

* the 'admin_print_scripts-widgets.php' action in WP_Customize_Widgets::print_scripts().

[111] Fix | Delete

*/

[112] Fix | Delete

add_action( 'admin_print_scripts-widgets.php', array( $this, 'enqueue_admin_scripts' ) );

[113] Fix | Delete

[114] Fix | Delete

if ( $this->is_preview() ) {

[115] Fix | Delete

add_action( 'wp_enqueue_scripts', array( $this, 'enqueue_preview_scripts' ) );

[116] Fix | Delete

}

[117] Fix | Delete

[118] Fix | Delete

/*

[119] Fix | Delete

* Note that the widgets component in the customizer will also do

[120] Fix | Delete

* the 'admin_footer-widgets.php' action in WP_Customize_Widgets::print_footer_scripts().

[121] Fix | Delete

*/

[122] Fix | Delete

add_action( 'admin_footer-widgets.php', array( $this, 'render_control_template_scripts' ) );

[123] Fix | Delete

[124] Fix | Delete

add_filter( 'display_media_states', array( $this, 'display_media_state' ), 10, 2 );

[125] Fix | Delete

}

[126] Fix | Delete

[127] Fix | Delete

/**

[128] Fix | Delete

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

[129] Fix | Delete

*

[130] Fix | Delete

* @since 4.8.0

[131] Fix | Delete

*

[132] Fix | Delete

* @see WP_REST_Controller::get_item_schema()

[133] Fix | Delete

* @see WP_REST_Controller::get_additional_fields()

[134] Fix | Delete

* @link https://core.trac.wordpress.org/ticket/35574

[135] Fix | Delete

*

[136] Fix | Delete

* @return array Schema for properties.

[137] Fix | Delete

*/

[138] Fix | Delete

public function get_instance_schema() {

[139] Fix | Delete

$schema = array(

[140] Fix | Delete

'attachment_id' => array(

[141] Fix | Delete

'type' => 'integer',

[142] Fix | Delete

'default' => 0,

[143] Fix | Delete

'minimum' => 0,

[144] Fix | Delete

'description' => __( 'Attachment post ID' ),

[145] Fix | Delete

'media_prop' => 'id',

[146] Fix | Delete

),

[147] Fix | Delete

'url' => array(

[148] Fix | Delete

'type' => 'string',

[149] Fix | Delete

'default' => '',

[150] Fix | Delete

'format' => 'uri',

[151] Fix | Delete

'description' => __( 'URL to the media file' ),

[152] Fix | Delete

),

[153] Fix | Delete

'title' => array(

[154] Fix | Delete

'type' => 'string',

[155] Fix | Delete

'default' => '',

[156] Fix | Delete

'sanitize_callback' => 'sanitize_text_field',

[157] Fix | Delete

'description' => __( 'Title for the widget' ),

[158] Fix | Delete

'should_preview_update' => false,

[159] Fix | Delete

),

[160] Fix | Delete

);

[161] Fix | Delete

[162] Fix | Delete

/**

[163] Fix | Delete

* Filters the media widget instance schema to add additional properties.

[164] Fix | Delete

*

[165] Fix | Delete

* @since 4.9.0

[166] Fix | Delete

*

[167] Fix | Delete

* @param array $schema Instance schema.

[168] Fix | Delete

* @param WP_Widget_Media $widget Widget object.

[169] Fix | Delete

*/

[170] Fix | Delete

$schema = apply_filters( "widget_{$this->id_base}_instance_schema", $schema, $this );

[171] Fix | Delete

[172] Fix | Delete

return $schema;

[173] Fix | Delete

}

[174] Fix | Delete

[175] Fix | Delete

/**

[176] Fix | Delete

* Determine if the supplied attachment is for a valid attachment post with the specified MIME type.

[177] Fix | Delete

*

[178] Fix | Delete

* @since 4.8.0

[179] Fix | Delete

*

[180] Fix | Delete

* @param int|WP_Post $attachment Attachment post ID or object.

[181] Fix | Delete

* @param string $mime_type MIME type.

[182] Fix | Delete

* @return bool Is matching MIME type.

[183] Fix | Delete

*/

[184] Fix | Delete

public function is_attachment_with_mime_type( $attachment, $mime_type ) {

[185] Fix | Delete

if ( empty( $attachment ) ) {

[186] Fix | Delete

return false;

[187] Fix | Delete

}

[188] Fix | Delete

$attachment = get_post( $attachment );

[189] Fix | Delete

if ( ! $attachment ) {

[190] Fix | Delete

return false;

[191] Fix | Delete

}

[192] Fix | Delete

if ( 'attachment' !== $attachment->post_type ) {

[193] Fix | Delete

return false;

[194] Fix | Delete

}

[195] Fix | Delete

return wp_attachment_is( $mime_type, $attachment );

[196] Fix | Delete

}

[197] Fix | Delete

[198] Fix | Delete

/**

[199] Fix | Delete

* Sanitize a token list string, such as used in HTML rel and class attributes.

[200] Fix | Delete

*

[201] Fix | Delete

* @since 4.8.0

[202] Fix | Delete

*

[203] Fix | Delete

* @link http://w3c.github.io/html/infrastructure.html#space-separated-tokens

[204] Fix | Delete

* @link https://developer.mozilla.org/en-US/docs/Web/API/DOMTokenList

[205] Fix | Delete

* @param string|array $tokens List of tokens separated by spaces, or an array of tokens.

[206] Fix | Delete

* @return string Sanitized token string list.

[207] Fix | Delete

*/

[208] Fix | Delete

public function sanitize_token_list( $tokens ) {

[209] Fix | Delete

if ( is_string( $tokens ) ) {

[210] Fix | Delete

$tokens = preg_split( '/\s+/', trim( $tokens ) );

[211] Fix | Delete

}

[212] Fix | Delete

$tokens = array_map( 'sanitize_html_class', $tokens );

[213] Fix | Delete

$tokens = array_filter( $tokens );

[214] Fix | Delete

return implode( ' ', $tokens );

[215] Fix | Delete

}

[216] Fix | Delete

[217] Fix | Delete

/**

[218] Fix | Delete

* Displays the widget on the front-end.

[219] Fix | Delete

*

[220] Fix | Delete

* @since 4.8.0

[221] Fix | Delete

*

[222] Fix | Delete

* @see WP_Widget::widget()

[223] Fix | Delete

*

[224] Fix | Delete

* @param array $args Display arguments including before_title, after_title, before_widget, and after_widget.

[225] Fix | Delete

* @param array $instance Saved setting from the database.

[226] Fix | Delete

*/

[227] Fix | Delete

public function widget( $args, $instance ) {

[228] Fix | Delete

$instance = wp_parse_args( $instance, wp_list_pluck( $this->get_instance_schema(), 'default' ) );

[229] Fix | Delete

[230] Fix | Delete

// Short-circuit if no media is selected.

[231] Fix | Delete

if ( ! $this->has_content( $instance ) ) {

[232] Fix | Delete

return;

[233] Fix | Delete

}

[234] Fix | Delete

[235] Fix | Delete

echo $args['before_widget'];

[236] Fix | Delete

[237] Fix | Delete

/** This filter is documented in wp-includes/widgets/class-wp-widget-pages.php */

[238] Fix | Delete

$title = apply_filters( 'widget_title', $instance['title'], $instance, $this->id_base );

[239] Fix | Delete

[240] Fix | Delete

if ( $title ) {

[241] Fix | Delete

echo $args['before_title'] . $title . $args['after_title'];

[242] Fix | Delete

}

[243] Fix | Delete

[244] Fix | Delete

/**

[245] Fix | Delete

* Filters the media widget instance prior to rendering the media.

[246] Fix | Delete

*

[247] Fix | Delete

* @since 4.8.0

[248] Fix | Delete

*

[249] Fix | Delete

* @param array $instance Instance data.

[250] Fix | Delete

* @param array $args Widget args.

[251] Fix | Delete

* @param WP_Widget_Media $widget Widget object.

[252] Fix | Delete

*/

[253] Fix | Delete

$instance = apply_filters( "widget_{$this->id_base}_instance", $instance, $args, $this );

[254] Fix | Delete

[255] Fix | Delete

$this->render_media( $instance );

[256] Fix | Delete

[257] Fix | Delete

echo $args['after_widget'];

[258] Fix | Delete

}

[259] Fix | Delete

[260] Fix | Delete

/**

[261] Fix | Delete

* Sanitizes the widget form values as they are saved.

[262] Fix | Delete

*

[263] Fix | Delete

* @since 4.8.0

[264] Fix | Delete

* @since 5.9.0 Renamed `$instance` to `$old_instance` to match parent class

[265] Fix | Delete

* for PHP 8 named parameter support.

[266] Fix | Delete

*

[267] Fix | Delete

* @see WP_Widget::update()

[268] Fix | Delete

* @see WP_REST_Request::has_valid_params()

[269] Fix | Delete

* @see WP_REST_Request::sanitize_params()

[270] Fix | Delete

*

[271] Fix | Delete

* @param array $new_instance Values just sent to be saved.

[272] Fix | Delete

* @param array $old_instance Previously saved values from database.

[273] Fix | Delete

* @return array Updated safe values to be saved.

[274] Fix | Delete

*/

[275] Fix | Delete

public function update( $new_instance, $old_instance ) {

[276] Fix | Delete

[277] Fix | Delete

$schema = $this->get_instance_schema();

[278] Fix | Delete

foreach ( $schema as $field => $field_schema ) {

[279] Fix | Delete

if ( ! array_key_exists( $field, $new_instance ) ) {

[280] Fix | Delete

continue;

[281] Fix | Delete

}

[282] Fix | Delete

$value = $new_instance[ $field ];

[283] Fix | Delete

[284] Fix | Delete

/*

[285] Fix | Delete

* Workaround for rest_validate_value_from_schema() due to the fact that

[286] Fix | Delete

* rest_is_boolean( '' ) === false, while rest_is_boolean( '1' ) is true.

[287] Fix | Delete

*/

[288] Fix | Delete

if ( 'boolean' === $field_schema['type'] && '' === $value ) {

[289] Fix | Delete

$value = false;

[290] Fix | Delete

}

[291] Fix | Delete

[292] Fix | Delete

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

[293] Fix | Delete

continue;

[294] Fix | Delete

}

[295] Fix | Delete

[296] Fix | Delete

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

[297] Fix | Delete

[298] Fix | Delete

// @codeCoverageIgnoreStart

[299] Fix | Delete

if ( is_wp_error( $value ) ) {

[300] Fix | Delete

continue; // Handle case when rest_sanitize_value_from_schema() ever returns WP_Error as its phpdoc @return tag indicates.

[301] Fix | Delete

}

[302] Fix | Delete

[303] Fix | Delete

// @codeCoverageIgnoreEnd

[304] Fix | Delete

if ( isset( $field_schema['sanitize_callback'] ) ) {

[305] Fix | Delete

$value = call_user_func( $field_schema['sanitize_callback'], $value );

[306] Fix | Delete

}

[307] Fix | Delete

if ( is_wp_error( $value ) ) {

[308] Fix | Delete

continue;

[309] Fix | Delete

}

[310] Fix | Delete

$old_instance[ $field ] = $value;

[311] Fix | Delete

}

[312] Fix | Delete

[313] Fix | Delete

return $old_instance;

[314] Fix | Delete

}

[315] Fix | Delete

[316] Fix | Delete

/**

[317] Fix | Delete

* Render the media on the frontend.

[318] Fix | Delete

*

[319] Fix | Delete

* @since 4.8.0

[320] Fix | Delete

*

[321] Fix | Delete

* @param array $instance Widget instance props.

[322] Fix | Delete

*/

[323] Fix | Delete

abstract public function render_media( $instance );

[324] Fix | Delete

[325] Fix | Delete

/**

[326] Fix | Delete

* Outputs the settings update form.

[327] Fix | Delete

*

[328] Fix | Delete

* Note that the widget UI itself is rendered with JavaScript via `MediaWidgetControl#render()`.

[329] Fix | Delete

*

[330] Fix | Delete

* @since 4.8.0

[331] Fix | Delete

*

[332] Fix | Delete

* @see \WP_Widget_Media::render_control_template_scripts() Where the JS template is located.

[333] Fix | Delete

*

[334] Fix | Delete

* @param array $instance Current settings.

[335] Fix | Delete

*/

[336] Fix | Delete

final public function form( $instance ) {

[337] Fix | Delete

$instance_schema = $this->get_instance_schema();

[338] Fix | Delete

$instance = wp_array_slice_assoc(

[339] Fix | Delete

wp_parse_args( (array) $instance, wp_list_pluck( $instance_schema, 'default' ) ),

[340] Fix | Delete

array_keys( $instance_schema )

[341] Fix | Delete

);

[342] Fix | Delete

[343] Fix | Delete

foreach ( $instance as $name => $value ) : ?>

[344] Fix | Delete

<input

[345] Fix | Delete

type="hidden"

[346] Fix | Delete

data-property="<?php echo esc_attr( $name ); ?>"

[347] Fix | Delete

class="media-widget-instance-property"

[348] Fix | Delete

name="<?php echo esc_attr( $this->get_field_name( $name ) ); ?>"

[349] Fix | Delete

id="<?php echo esc_attr( $this->get_field_id( $name ) ); // Needed specifically by wpWidgets.appendTitle(). ?>"

[350] Fix | Delete

value="<?php echo esc_attr( is_array( $value ) ? implode( ',', $value ) : (string) $value ); ?>"

[351] Fix | Delete

/>

[352] Fix | Delete

<?php

[353] Fix | Delete

endforeach;

[354] Fix | Delete

}

[355] Fix | Delete

[356] Fix | Delete

/**

[357] Fix | Delete

* Filters the default media display states for items in the Media list table.

[358] Fix | Delete

*

[359] Fix | Delete

* @since 4.8.0

[360] Fix | Delete

*

[361] Fix | Delete

* @param array $states An array of media states.

[362] Fix | Delete

* @param WP_Post $post The current attachment object.

[363] Fix | Delete

* @return array

[364] Fix | Delete

*/

[365] Fix | Delete

public function display_media_state( $states, $post = null ) {

[366] Fix | Delete

if ( ! $post ) {

[367] Fix | Delete

$post = get_post();

[368] Fix | Delete

}

[369] Fix | Delete

[370] Fix | Delete

// Count how many times this attachment is used in widgets.

[371] Fix | Delete

$use_count = 0;

[372] Fix | Delete

foreach ( $this->get_settings() as $instance ) {

[373] Fix | Delete

if ( isset( $instance['attachment_id'] ) && $instance['attachment_id'] === $post->ID ) {

[374] Fix | Delete

++$use_count;

[375] Fix | Delete

}

[376] Fix | Delete

}

[377] Fix | Delete

[378] Fix | Delete

if ( 1 === $use_count ) {

[379] Fix | Delete

$states[] = $this->l10n['media_library_state_single'];

[380] Fix | Delete

} elseif ( $use_count > 0 ) {

[381] Fix | Delete

$states[] = sprintf( translate_nooped_plural( $this->l10n['media_library_state_multi'], $use_count ), number_format_i18n( $use_count ) );

[382] Fix | Delete

}

[383] Fix | Delete

[384] Fix | Delete

return $states;

[385] Fix | Delete

}

[386] Fix | Delete

[387] Fix | Delete

/**

[388] Fix | Delete

* Enqueue preview scripts.

[389] Fix | Delete

*

[390] Fix | Delete

* These scripts normally are enqueued just-in-time when a widget is rendered.

[391] Fix | Delete

* In the customizer, however, widgets can be dynamically added and rendered via

[392] Fix | Delete

* selective refresh, and so it is important to unconditionally enqueue them in

[393] Fix | Delete

* case a widget does get added.

[394] Fix | Delete

*

[395] Fix | Delete

* @since 4.8.0

[396] Fix | Delete

*/

[397] Fix | Delete

public function enqueue_preview_scripts() {}

[398] Fix | Delete

[399] Fix | Delete

/**

[400] Fix | Delete

* Loads the required scripts and styles for the widget control.

[401] Fix | Delete

*

[402] Fix | Delete

* @since 4.8.0

[403] Fix | Delete

*/

[404] Fix | Delete

public function enqueue_admin_scripts() {

[405] Fix | Delete

wp_enqueue_media();

[406] Fix | Delete

wp_enqueue_script( 'media-widgets' );

[407] Fix | Delete

}

[408] Fix | Delete

[409] Fix | Delete

/**

[410] Fix | Delete

* Render form template scripts.

[411] Fix | Delete

*

[412] Fix | Delete

* @since 4.8.0

[413] Fix | Delete

*/

[414] Fix | Delete

public function render_control_template_scripts() {

[415] Fix | Delete

?>

[416] Fix | Delete

<script type="text/html" id="tmpl-widget-media-<?php echo esc_attr( $this->id_base ); ?>-control">

[417] Fix | Delete

<# var elementIdPrefix = 'el' + String( Math.random() ) + '_' #>

[418] Fix | Delete

<p>

[419] Fix | Delete

<label for="{{ elementIdPrefix }}title"><?php esc_html_e( 'Title:' ); ?></label>

[420] Fix | Delete

<input id="{{ elementIdPrefix }}title" type="text" class="widefat title">

[421] Fix | Delete

</p>

[422] Fix | Delete

<div class="media-widget-preview <?php echo esc_attr( $this->id_base ); ?>">

[423] Fix | Delete

<div class="attachment-media-view">

[424] Fix | Delete

<button type="button" class="select-media button-add-media not-selected">

[425] Fix | Delete

<?php echo esc_html( $this->l10n['add_media'] ); ?>

[426] Fix | Delete

</button>

[427] Fix | Delete

</div>

[428] Fix | Delete

</div>

[429] Fix | Delete

<p class="media-widget-buttons">

[430] Fix | Delete

<button type="button" class="button edit-media selected">

[431] Fix | Delete

<?php echo esc_html( $this->l10n['edit_media'] ); ?>

[432] Fix | Delete

</button>

[433] Fix | Delete

<?php if ( ! empty( $this->l10n['replace_media'] ) ) : ?>

[434] Fix | Delete

<button type="button" class="button change-media select-media selected">

[435] Fix | Delete

<?php echo esc_html( $this->l10n['replace_media'] ); ?>

[436] Fix | Delete

</button>

[437] Fix | Delete

<?php endif; ?>

[438] Fix | Delete

</p>

[439] Fix | Delete

<div class="media-widget-fields">

[440] Fix | Delete

</div>

[441] Fix | Delete

</script>

[442] Fix | Delete

<?php

[443] Fix | Delete

}

[444] Fix | Delete

[445] Fix | Delete

/**

[446] Fix | Delete

* Resets the cache for the default labels.

[447] Fix | Delete

*

[448] Fix | Delete

* @since 6.0.0

[449] Fix | Delete

*/

[450] Fix | Delete

public static function reset_default_labels() {

[451] Fix | Delete

self::$default_description = '';

[452] Fix | Delete

self::$l10n_defaults = array();

[453] Fix | Delete

}

[454] Fix | Delete

[455] Fix | Delete

/**

[456] Fix | Delete

* Whether the widget has content to show.

[457] Fix | Delete

*

[458] Fix | Delete

* @since 4.8.0

[459] Fix | Delete

*

[460] Fix | Delete

* @param array $instance Widget instance props.

[461] Fix | Delete

* @return bool Whether widget has content.

[462] Fix | Delete

*/

[463] Fix | Delete

protected function has_content( $instance ) {

[464] Fix | Delete

return ( $instance['attachment_id'] && 'attachment' === get_post_type( $instance['attachment_id'] ) ) || $instance['url'];

[465] Fix | Delete

}

[466] Fix | Delete

[467] Fix | Delete

/**

[468] Fix | Delete

* Returns the default description of the widget.

[469] Fix | Delete

*

[470] Fix | Delete

* @since 6.0.0

[471] Fix | Delete

*

[472] Fix | Delete

* @return string

[473] Fix | Delete

*/

[474] Fix | Delete

protected static function get_default_description() {

[475] Fix | Delete

if ( self::$default_description ) {

[476] Fix | Delete

return self::$default_description;

[477] Fix | Delete

}

[478] Fix | Delete

[479] Fix | Delete

self::$default_description = __( 'A media item.' );

[480] Fix | Delete

return self::$default_description;

[481] Fix | Delete

}

[482] Fix | Delete

[483] Fix | Delete

/**

[484] Fix | Delete

* Returns the default localized strings used by the widget.

[485] Fix | Delete

*

[486] Fix | Delete

* @since 6.0.0

[487] Fix | Delete

*

[488] Fix | Delete

* @return (string|array)[]

[489] Fix | Delete

*/

[490] Fix | Delete

protected static function get_l10n_defaults() {

[491] Fix | Delete

if ( ! empty( self::$l10n_defaults ) ) {

[492] Fix | Delete

return self::$l10n_defaults;

[493] Fix | Delete

}

[494] Fix | Delete

[495] Fix | Delete

self::$l10n_defaults = array(

[496] Fix | Delete

'no_media_selected' => __( 'No media selected' ),

[497] Fix | Delete

'add_media' => _x( 'Add Media', 'label for button in the media widget' ),

[498] Fix | Delete

'replace_media' => _x( 'Replace Media', 'label for button in the media widget; should preferably not be longer than ~13 characters long' ),

[499] Fix | Delete