2015-09-01 09:49:21 -04:00
< ? php
/**
2015-09-22 11:04:26 -04:00
* Widget API : WP_Widget_Text class
2015-09-01 09:49:21 -04:00
*
* @ package WordPress
* @ subpackage Widgets
2015-09-22 11:04:26 -04:00
* @ since 4.4 . 0
*/
/**
* Core class used to implement a Text widget .
*
* @ since 2.8 . 0
*
* @ see WP_Widget
2015-09-01 09:49:21 -04:00
*/
class WP_Widget_Text extends WP_Widget {
2017-07-11 18:47:43 -04:00
/**
* Whether or not the widget has been registered yet .
*
* @ since 4.8 . 1
* @ var bool
*/
protected $registered = false ;
2015-09-26 20:27:26 -04:00
/**
* Sets up a new Text widget instance .
*
* @ since 2.8 . 0
*/
2015-09-01 09:49:21 -04:00
public function __construct () {
2017-11-30 18:11:00 -05:00
$widget_ops = array (
'classname' => 'widget_text' ,
'description' => __ ( 'Arbitrary text.' ),
2016-03-21 17:59:29 -04:00
'customize_selective_refresh' => true ,
2021-05-25 04:27:57 -04:00
'show_instance_in_rest' => true ,
2016-03-21 17:59:29 -04:00
);
2017-05-11 14:55:43 -04:00
$control_ops = array (
2017-11-30 18:11:00 -05:00
'width' => 400 ,
2017-05-11 14:55:43 -04:00
'height' => 350 ,
);
2016-03-21 17:59:29 -04:00
parent :: __construct ( 'text' , __ ( 'Text' ), $widget_ops , $control_ops );
2015-09-01 09:49:21 -04:00
}
2017-05-11 14:55:43 -04:00
/**
2023-04-24 12:37:22 -04:00
* Adds hooks for enqueueing assets when registering all widget instances of this widget class .
2017-05-11 14:55:43 -04:00
*
2020-10-10 16:02:05 -04:00
* @ param int $number Optional . The unique order number of this widget instance
* compared to other instances of the same class . Default - 1.
2017-05-11 14:55:43 -04:00
*/
2017-07-11 18:47:43 -04:00
public function _register_one ( $number = - 1 ) {
parent :: _register_one ( $number );
if ( $this -> registered ) {
return ;
}
$this -> registered = true ;
2017-05-11 14:55:43 -04:00
2018-01-29 18:56:29 -05:00
if ( $this -> is_preview () ) {
add_action ( 'wp_enqueue_scripts' , array ( $this , 'enqueue_preview_scripts' ) );
}
Docs: Replace multiple single line comments with multi-line comments.
This changeset updates various comments as per WordPress PHP Inline Documentation Standards.
See https://developer.wordpress.org/coding-standards/inline-documentation-standards/php/#5-inline-comments.
Follow-up to [56174], [56175], [56176], [56177], [56178], [56179], [56180], [56191], [56192], [56193], [56194], [56195].
Props costdev, audrasjb.
See #58459.
Built from https://develop.svn.wordpress.org/trunk@56196
git-svn-id: http://core.svn.wordpress.org/trunk@55708 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2023-07-10 19:21:22 -04:00
/*
* Note that the widgets component in the customizer will also do
* the 'admin_print_scripts-widgets.php' action in WP_Customize_Widgets :: print_scripts () .
*/
2017-05-11 14:55:43 -04:00
add_action ( 'admin_print_scripts-widgets.php' , array ( $this , 'enqueue_admin_scripts' ) );
Docs: Replace multiple single line comments with multi-line comments.
This changeset updates various comments as per WordPress PHP Inline Documentation Standards.
See https://developer.wordpress.org/coding-standards/inline-documentation-standards/php/#5-inline-comments.
Follow-up to [56174], [56175], [56176], [56177], [56178], [56179], [56180], [56191], [56192], [56193], [56194], [56195].
Props costdev, audrasjb.
See #58459.
Built from https://develop.svn.wordpress.org/trunk@56196
git-svn-id: http://core.svn.wordpress.org/trunk@55708 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2023-07-10 19:21:22 -04:00
/*
* Note that the widgets component in the customizer will also do
* the 'admin_footer-widgets.php' action in WP_Customize_Widgets :: print_footer_scripts () .
*/
2017-08-13 01:25:46 -04:00
add_action ( 'admin_footer-widgets.php' , array ( 'WP_Widget_Text' , 'render_control_template_scripts' ) );
2017-05-11 14:55:43 -04:00
}
2017-07-14 13:09:43 -04:00
/**
* Determines whether a given instance is legacy and should bypass using TinyMCE .
*
* @ since 4.8 . 1
*
* @ param array $instance {
* Instance data .
*
* @ type string $text Content .
* @ type bool | string $filter Whether autop or content filters should apply .
* @ type bool $legacy Whether widget is in legacy mode .
* }
* @ return bool Whether Text widget instance contains legacy data .
*/
public function is_legacy_instance ( $instance ) {
2017-07-24 18:46:42 -04:00
// Legacy mode when not in visual mode.
if ( isset ( $instance [ 'visual' ] ) ) {
return ! $instance [ 'visual' ];
2017-07-14 13:09:43 -04:00
}
2017-07-24 18:46:42 -04:00
// Or, the widget has been added/updated in 4.8.0 then filter prop is 'content' and it is no longer legacy.
2017-07-14 13:09:43 -04:00
if ( isset ( $instance [ 'filter' ] ) && 'content' === $instance [ 'filter' ] ) {
return false ;
}
// If the text is empty, then nothing is preventing migration to TinyMCE.
if ( empty ( $instance [ 'text' ] ) ) {
return false ;
}
2017-11-30 18:11:00 -05:00
$wpautop = ! empty ( $instance [ 'filter' ] );
Code Modernization: Replace usage of `strpos()` with `str_contains()`.
`str_contains()` was introduced in PHP 8.0 to perform a case-sensitive check indicating if the string to search in (haystack) contains the given substring (needle).
WordPress core includes a polyfill for `str_contains()` on PHP < 8.0 as of WordPress 5.9.
This commit replaces `false !== strpos( ... )` with `str_contains()` in core files, making the code more readable and consistent, as well as better aligned with modern development practices.
Follow-up to [52039], [52040], [52326], [55703], [55710], [55987].
Props Soean, spacedmonkey, costdev, dingo_d, azaozz, mikeschroder, flixos90, peterwilsoncc, SergeyBiryukov.
Fixes #58206.
Built from https://develop.svn.wordpress.org/trunk@55988
git-svn-id: http://core.svn.wordpress.org/trunk@55500 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2023-06-22 10:36:26 -04:00
$has_line_breaks = ( str_contains ( trim ( $instance [ 'text' ] ), " \n " ) );
2017-07-14 13:09:43 -04:00
// If auto-paragraphs are not enabled and there are line breaks, then ensure legacy mode.
if ( ! $wpautop && $has_line_breaks ) {
return true ;
}
// If an HTML comment is present, assume legacy mode.
Code Modernization: Replace usage of `strpos()` with `str_contains()`.
`str_contains()` was introduced in PHP 8.0 to perform a case-sensitive check indicating if the string to search in (haystack) contains the given substring (needle).
WordPress core includes a polyfill for `str_contains()` on PHP < 8.0 as of WordPress 5.9.
This commit replaces `false !== strpos( ... )` with `str_contains()` in core files, making the code more readable and consistent, as well as better aligned with modern development practices.
Follow-up to [52039], [52040], [52326], [55703], [55710], [55987].
Props Soean, spacedmonkey, costdev, dingo_d, azaozz, mikeschroder, flixos90, peterwilsoncc, SergeyBiryukov.
Fixes #58206.
Built from https://develop.svn.wordpress.org/trunk@55988
git-svn-id: http://core.svn.wordpress.org/trunk@55500 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2023-06-22 10:36:26 -04:00
if ( str_contains ( $instance [ 'text' ], '<!--' ) ) {
2017-07-14 13:09:43 -04:00
return true ;
}
// In the rare case that DOMDocument is not available we cannot reliably sniff content and so we assume legacy.
if ( ! class_exists ( 'DOMDocument' ) ) {
// @codeCoverageIgnoreStart
return true ;
// @codeCoverageIgnoreEnd
}
$doc = new DOMDocument ();
2019-01-14 00:05:48 -05:00
2020-01-28 19:45:18 -05:00
// Suppress warnings generated by loadHTML.
2019-01-14 00:05:48 -05:00
$errors = libxml_use_internal_errors ( true );
2019-07-09 01:45:58 -04:00
// phpcs:ignore WordPress.PHP.NoSilencedErrors.Discouraged
2017-11-30 18:11:00 -05:00
@ $doc -> loadHTML (
sprintf (
'<!DOCTYPE html><html><head><meta charset="%s"></head><body>%s</body></html>' ,
esc_attr ( get_bloginfo ( 'charset' ) ),
$instance [ 'text' ]
)
);
2019-01-14 00:05:48 -05:00
libxml_use_internal_errors ( $errors );
2017-07-14 13:09:43 -04:00
$body = $doc -> getElementsByTagName ( 'body' ) -> item ( 0 );
// See $allowedposttags.
$safe_elements_attributes = array (
2017-11-30 18:11:00 -05:00
'strong' => array (),
'em' => array (),
'b' => array (),
'i' => array (),
'u' => array (),
's' => array (),
'ul' => array (),
'ol' => array (),
'li' => array (),
'hr' => array (),
'abbr' => array (),
2017-07-14 13:09:43 -04:00
'acronym' => array (),
2017-11-30 18:11:00 -05:00
'code' => array (),
'dfn' => array (),
'a' => array (
2017-07-14 13:09:43 -04:00
'href' => true ,
),
2017-11-30 18:11:00 -05:00
'img' => array (
2017-07-14 13:09:43 -04:00
'src' => true ,
'alt' => true ,
),
);
2017-11-30 18:11:00 -05:00
$safe_empty_elements = array ( 'img' , 'hr' , 'iframe' );
2017-07-14 13:09:43 -04:00
foreach ( $body -> getElementsByTagName ( '*' ) as $element ) {
/** @var DOMElement $element */
$tag_name = strtolower ( $element -> nodeName );
// If the element is not safe, then the instance is legacy.
if ( ! isset ( $safe_elements_attributes [ $tag_name ] ) ) {
return true ;
}
// If the element is not safely empty and it has empty contents, then legacy mode.
if ( ! in_array ( $tag_name , $safe_empty_elements , true ) && '' === trim ( $element -> textContent ) ) {
return true ;
}
// If an attribute is not recognized as safe, then the instance is legacy.
foreach ( $element -> attributes as $attribute ) {
/** @var DOMAttr $attribute */
$attribute_name = strtolower ( $attribute -> nodeName );
if ( ! isset ( $safe_elements_attributes [ $tag_name ][ $attribute_name ] ) ) {
return true ;
}
}
}
// Otherwise, the text contains no elements/attributes that TinyMCE could drop, and therefore the widget does not need legacy mode.
return false ;
}
2017-11-14 21:27:48 -05:00
/**
2020-08-10 20:34:08 -04:00
* Filters gallery shortcode attributes .
2017-11-14 21:27:48 -05:00
*
* Prevents all of a site ' s attachments from being shown in a gallery displayed on a
* non - singular template where a $post context is not available .
*
* @ since 4.9 . 0
*
* @ param array $attrs Attributes .
* @ return array Attributes .
*/
public function _filter_gallery_shortcode_attrs ( $attrs ) {
if ( ! is_singular () && empty ( $attrs [ 'id' ] ) && empty ( $attrs [ 'include' ] ) ) {
$attrs [ 'id' ] = - 1 ;
}
return $attrs ;
}
2015-09-01 09:49:21 -04:00
/**
2015-09-26 20:27:26 -04:00
* Outputs the content for the current Text widget instance .
2015-09-25 15:24:24 -04:00
*
* @ since 2.8 . 0
*
2019-08-04 08:28:56 -04:00
* @ global WP_Post $post Global post object .
2017-09-10 02:33:44 -04:00
*
2015-09-25 15:24:24 -04:00
* @ param array $args Display arguments including 'before_title' , 'after_title' ,
* 'before_widget' , and 'after_widget' .
2015-09-26 20:27:26 -04:00
* @ param array $instance Settings for the current Text widget instance .
2015-09-01 09:49:21 -04:00
*/
public function widget ( $args , $instance ) {
2017-09-10 02:33:44 -04:00
global $post ;
2015-09-25 15:24:24 -04:00
2017-10-15 17:43:47 -04:00
$title = ! empty ( $instance [ 'title' ] ) ? $instance [ 'title' ] : '' ;
2015-09-08 18:17:26 -04:00
/** This filter is documented in wp-includes/widgets/class-wp-widget-pages.php */
2017-10-15 17:43:47 -04:00
$title = apply_filters ( 'widget_title' , $title , $instance , $this -> id_base );
2015-09-01 09:49:21 -04:00
2017-11-30 18:11:00 -05:00
$text = ! empty ( $instance [ 'text' ] ) ? $instance [ 'text' ] : '' ;
2017-07-24 18:46:42 -04:00
$is_visual_text_widget = ( ! empty ( $instance [ 'visual' ] ) && ! empty ( $instance [ 'filter' ] ) );
// In 4.8.0 only, visual Text widgets get filter=content, without visual prop; upgrade instance props just-in-time.
if ( ! $is_visual_text_widget ) {
$is_visual_text_widget = ( isset ( $instance [ 'filter' ] ) && 'content' === $instance [ 'filter' ] );
}
if ( $is_visual_text_widget ) {
$instance [ 'filter' ] = true ;
$instance [ 'visual' ] = true ;
}
2017-07-14 13:09:43 -04:00
/*
2017-09-10 02:33:44 -04:00
* Suspend legacy plugin - supplied do_shortcode () for 'widget_text' filter for the visual Text widget to prevent
2022-09-26 18:43:10 -04:00
* shortcodes being processed twice . Now do_shortcode () is added to the 'widget_text_content' filter in core itself
2017-09-10 02:33:44 -04:00
* and it applies after wpautop () to prevent corrupting HTML output added by the shortcode . When do_shortcode () is
2022-09-26 18:43:10 -04:00
* added to 'widget_text_content' then do_shortcode () will be manually called when in legacy mode as well .
2017-07-14 13:09:43 -04:00
*/
2017-11-30 18:11:00 -05:00
$widget_text_do_shortcode_priority = has_filter ( 'widget_text' , 'do_shortcode' );
2017-09-10 02:33:44 -04:00
$should_suspend_legacy_shortcode_support = ( $is_visual_text_widget && false !== $widget_text_do_shortcode_priority );
if ( $should_suspend_legacy_shortcode_support ) {
2017-07-14 13:09:43 -04:00
remove_filter ( 'widget_text' , 'do_shortcode' , $widget_text_do_shortcode_priority );
2017-09-10 02:33:44 -04:00
}
2017-11-14 21:27:48 -05:00
// Override global $post so filters (and shortcodes) apply in a consistent context.
$original_post = $post ;
if ( is_singular () ) {
// Make sure post is always the queried object on singular queries (not from another sub-query that failed to clean up the global $post).
$post = get_queried_object ();
} else {
// Nullify the $post global during widget rendering to prevent shortcodes from running with the unexpected context on archive queries.
2017-09-10 02:33:44 -04:00
$post = null ;
2017-07-14 13:09:43 -04:00
}
2015-09-25 15:21:24 -04:00
2017-11-14 21:27:48 -05:00
// Prevent dumping out all attachments from the media library.
add_filter ( 'shortcode_atts_gallery' , array ( $this , '_filter_gallery_shortcode_attrs' ) );
2015-09-01 09:49:21 -04:00
/**
2016-05-22 14:06:28 -04:00
* Filters the content of the Text widget .
2015-09-01 09:49:21 -04:00
*
* @ since 2.3 . 0
2021-01-08 09:30:14 -05:00
* @ since 4.4 . 0 Added the `$widget` parameter .
* @ since 4.8 . 1 The `$widget` param may now be a `WP_Widget_Custom_HTML` object in addition to a `WP_Widget_Text` object .
2015-09-01 09:49:21 -04:00
*
2017-07-18 18:11:44 -04:00
* @ param string $text The widget content .
* @ param array $instance Array of settings for the current widget .
2021-01-08 09:30:14 -05:00
* @ param WP_Widget_Text | WP_Widget_Custom_HTML $widget Current text or HTML widget instance .
2015-09-01 09:49:21 -04:00
*/
2017-05-15 18:36:41 -04:00
$text = apply_filters ( 'widget_text' , $text , $instance , $this );
2015-09-25 15:21:24 -04:00
2017-07-24 18:46:42 -04:00
if ( $is_visual_text_widget ) {
/**
* Filters the content of the Text widget to apply changes expected from the visual ( TinyMCE ) editor .
*
* By default a subset of the_content filters are applied , including wpautop and wptexturize .
*
* @ since 4.8 . 0
*
* @ param string $text The widget content .
* @ param array $instance Array of settings for the current widget .
2021-01-08 09:30:14 -05:00
* @ param WP_Widget_Text $widget Current Text widget instance .
2017-07-24 18:46:42 -04:00
*/
$text = apply_filters ( 'widget_text_content' , $text , $instance , $this );
2017-09-10 02:33:44 -04:00
} else {
// Now in legacy mode, add paragraphs and line breaks when checkbox is checked.
if ( ! empty ( $instance [ 'filter' ] ) ) {
$text = wpautop ( $text );
}
/*
* Manually do shortcodes on the content when the core - added filter is present . It is added by default
2022-09-26 18:43:10 -04:00
* in core by adding do_shortcode () to the 'widget_text_content' filter to apply after wpautop () .
2017-09-10 02:33:44 -04:00
* Since the legacy Text widget runs wpautop () after 'widget_text' filters are applied , the widget in
2022-09-26 18:43:10 -04:00
* legacy mode here manually applies do_shortcode () on the content unless the default
2017-09-10 02:33:44 -04:00
* core filter for 'widget_text_content' has been removed , or if do_shortcode () has already
* been applied via a plugin adding do_shortcode () to 'widget_text' filters .
*/
if ( has_filter ( 'widget_text_content' , 'do_shortcode' ) && ! $widget_text_do_shortcode_priority ) {
if ( ! empty ( $instance [ 'filter' ] ) ) {
$text = shortcode_unautop ( $text );
}
2022-09-26 18:43:10 -04:00
$text = do_shortcode ( $text );
2017-09-10 02:33:44 -04:00
}
}
2017-07-24 18:46:42 -04:00
2017-09-10 02:33:44 -04:00
// Restore post global.
2017-11-14 21:27:48 -05:00
$post = $original_post ;
remove_filter ( 'shortcode_atts_gallery' , array ( $this , '_filter_gallery_shortcode_attrs' ) );
2017-05-11 14:55:43 -04:00
2017-09-10 02:33:44 -04:00
// Undo suspension of legacy plugin-supplied shortcode handling.
if ( $should_suspend_legacy_shortcode_support ) {
2017-07-14 13:09:43 -04:00
add_filter ( 'widget_text' , 'do_shortcode' , $widget_text_do_shortcode_priority );
}
2015-09-01 09:49:21 -04:00
echo $args [ 'before_widget' ];
if ( ! empty ( $title ) ) {
echo $args [ 'before_title' ] . $title . $args [ 'after_title' ];
2017-05-11 14:55:43 -04:00
}
2017-10-24 17:32:46 -04:00
$text = preg_replace_callback ( '#<(video|iframe|object|embed)\s[^>]*>#i' , array ( $this , 'inject_video_max_width_style' ), $text );
2017-10-05 20:39:52 -04:00
2020-10-19 19:39:04 -04:00
// Adds 'noopener' relationship, without duplicating values, to all HTML A elements that have a target.
2019-04-08 19:18:52 -04:00
$text = wp_targeted_link_rel ( $text );
2017-05-11 14:55:43 -04:00
?>
< div class = " textwidget " >< ? php echo $text ; ?> </div>
2015-09-01 09:49:21 -04:00
< ? php
echo $args [ 'after_widget' ];
}
2017-10-05 20:39:52 -04:00
/**
2023-04-24 12:37:22 -04:00
* Injects max - width and removes height for videos too constrained to fit inside sidebars on frontend .
2017-10-05 20:39:52 -04:00
*
* @ since 4.9 . 0
*
* @ see WP_Widget_Media_Video :: inject_video_max_width_style ()
2020-01-09 19:30:05 -05:00
*
2017-10-05 20:39:52 -04:00
* @ param array $matches Pattern matches from preg_replace_callback .
* @ return string HTML Output .
*/
public function inject_video_max_width_style ( $matches ) {
$html = $matches [ 0 ];
$html = preg_replace ( '/\sheight="\d+"/' , '' , $html );
$html = preg_replace ( '/\swidth="\d+"/' , '' , $html );
$html = preg_replace ( '/(?<=width:)\s*\d+px(?=;?)/' , '100%' , $html );
return $html ;
}
2015-09-01 09:49:21 -04:00
/**
2015-09-26 20:27:26 -04:00
* Handles updating settings for the current Text widget instance .
*
* @ since 2.8 . 0
*
* @ param array $new_instance New settings for this instance as input by the user via
* WP_Widget :: form () .
* @ param array $old_instance Old settings for this instance .
* @ return array Settings to save or bool false to cancel saving .
2015-09-01 09:49:21 -04:00
*/
public function update ( $new_instance , $old_instance ) {
2017-11-30 18:11:00 -05:00
$new_instance = wp_parse_args (
2018-08-16 21:51:36 -04:00
$new_instance ,
array (
2017-11-30 18:11:00 -05:00
'title' => '' ,
'text' => '' ,
'filter' => false , // For back-compat.
2020-01-28 19:45:18 -05:00
'visual' => null , // Must be explicitly defined.
2017-11-30 18:11:00 -05:00
)
);
2017-07-24 18:46:42 -04:00
2015-09-01 09:49:21 -04:00
$instance = $old_instance ;
2017-07-24 18:46:42 -04:00
2015-09-01 09:49:21 -04:00
$instance [ 'title' ] = sanitize_text_field ( $new_instance [ 'title' ] );
2016-02-22 20:02:26 -05:00
if ( current_user_can ( 'unfiltered_html' ) ) {
$instance [ 'text' ] = $new_instance [ 'text' ];
} else {
$instance [ 'text' ] = wp_kses_post ( $new_instance [ 'text' ] );
}
2017-05-11 14:55:43 -04:00
2017-07-24 18:46:42 -04:00
$instance [ 'filter' ] = ! empty ( $new_instance [ 'filter' ] );
// Upgrade 4.8.0 format.
if ( isset ( $old_instance [ 'filter' ] ) && 'content' === $old_instance [ 'filter' ] ) {
$instance [ 'visual' ] = true ;
}
if ( 'content' === $new_instance [ 'filter' ] ) {
$instance [ 'visual' ] = true ;
}
if ( isset ( $new_instance [ 'visual' ] ) ) {
$instance [ 'visual' ] = ! empty ( $new_instance [ 'visual' ] );
}
// Filter is always true in visual mode.
if ( ! empty ( $instance [ 'visual' ] ) ) {
$instance [ 'filter' ] = true ;
2017-07-14 13:09:43 -04:00
}
2017-05-11 14:55:43 -04:00
2015-09-01 09:49:21 -04:00
return $instance ;
}
2018-01-29 18:56:29 -05:00
/**
2023-04-24 12:37:22 -04:00
* Enqueues preview scripts .
2018-01-29 18:56:29 -05:00
*
* These scripts normally are enqueued just - in - time when a playlist shortcode is used .
* However , in the customizer , a playlist shortcode may be used in a text widget and
* dynamically added via selective refresh , so it is important to unconditionally enqueue them .
*
* @ since 4.9 . 3
*/
public function enqueue_preview_scripts () {
2020-02-06 01:33:11 -05:00
require_once dirname ( __DIR__ ) . '/media.php' ;
2018-01-29 18:56:29 -05:00
wp_playlist_scripts ( 'audio' );
wp_playlist_scripts ( 'video' );
}
2017-05-11 14:55:43 -04:00
/**
* Loads the required scripts and styles for the widget control .
*
* @ since 4.8 . 0
*/
public function enqueue_admin_scripts () {
wp_enqueue_editor ();
2018-01-22 14:25:31 -05:00
wp_enqueue_media ();
2017-05-11 14:55:43 -04:00
wp_enqueue_script ( 'text-widgets' );
2023-03-15 07:38:20 -04:00
wp_add_inline_script ( 'text-widgets' , sprintf ( 'wp.textWidgets.idBases.push( %s );' , wp_json_encode ( $this -> id_base ) ) );
Editor: Add CodeMirror-powered code editor with syntax highlighting, linting, and auto-completion.
* Code editor is integrated into the Theme/Plugin Editor, Additional CSS in Customizer, and Custom HTML widget. Code editor is not yet integrated into the post editor, and it may not be until accessibility concerns are addressed.
* The CodeMirror component in the Custom HTML widget is integrated in a similar way to TinyMCE being integrated into the Text widget, adopting the same approach for integrating dynamic JavaScript-initialized fields.
* Linting is performed for JS, CSS, HTML, and JSON via JSHint, CSSLint, HTMLHint, and JSONLint respectively. Linting is not yet supported for PHP.
* When user lacks `unfiltered_html` the capability, the Custom HTML widget will report any Kses-invalid elements and attributes as errors via a custom Kses rule for HTMLHint.
* When linting errors are detected, the user will be prevented from saving the code until the errors are fixed, reducing instances of broken websites.
* The placeholder value is removed from Custom CSS in favor of a fleshed-out section description which now auto-expands when the CSS field is empty. See #39892.
* The CodeMirror library is included as `wp.CodeMirror` to prevent conflicts with any existing `CodeMirror` global.
* An `wp.codeEditor.initialize()` API in JS is provided to convert a `textarea` into CodeMirror, with a `wp_enqueue_code_editor()` function in PHP to manage enqueueing the assets and settings needed to edit a given type of code.
* A user preference is added to manage whether or not "syntax highlighting" is enabled. The feature is opt-out, being enabled by default.
* Allowed file extensions in the theme and plugin editors have been updated to include formats which CodeMirror has modes for: `conf`, `css`, `diff`, `patch`, `html`, `htm`, `http`, `js`, `json`, `jsx`, `less`, `md`, `php`, `phtml`, `php3`, `php4`, `php5`, `php7`, `phps`, `scss`, `sass`, `sh`, `bash`, `sql`, `svg`, `xml`, `yml`, `yaml`, `txt`.
Props westonruter, georgestephanis, obenland, melchoyce, pixolin, mizejewski, michelleweber, afercia, grahamarmfield, samikeijonen, rianrietveld, iseulde.
See #38707.
Fixes #12423, #39892.
Built from https://develop.svn.wordpress.org/trunk@41376
git-svn-id: http://core.svn.wordpress.org/trunk@41209 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-09-13 02:08:47 -04:00
wp_add_inline_script ( 'text-widgets' , 'wp.textWidgets.init();' , 'after' );
2017-05-11 14:55:43 -04:00
}
2015-09-01 09:49:21 -04:00
/**
2015-09-26 20:27:26 -04:00
* Outputs the Text widget settings form .
*
* @ since 2.8 . 0
2017-05-11 14:55:43 -04:00
* @ since 4.8 . 0 Form only contains hidden inputs which are synced with JS template .
2017-07-14 13:09:43 -04:00
* @ since 4.8 . 1 Restored original form to be displayed when in legacy mode .
2020-01-09 19:30:05 -05:00
*
2018-01-31 20:20:30 -05:00
* @ see WP_Widget_Text :: render_control_template_scripts ()
2017-08-17 19:37:43 -04:00
* @ see _WP_Editors :: editor ()
2015-09-26 20:27:26 -04:00
*
* @ param array $instance Current settings .
2015-09-01 09:49:21 -04:00
*/
public function form ( $instance ) {
2017-05-11 14:55:43 -04:00
$instance = wp_parse_args (
( array ) $instance ,
array (
'title' => '' ,
2017-11-30 18:11:00 -05:00
'text' => '' ,
2017-05-11 14:55:43 -04:00
)
);
2015-09-01 09:49:21 -04:00
?>
2017-07-14 13:09:43 -04:00
< ? php if ( ! $this -> is_legacy_instance ( $instance ) ) : ?>
2017-08-17 19:37:43 -04:00
< ? php
if ( user_can_richedit () ) {
add_filter ( 'the_editor_content' , 'format_for_editor' , 10 , 2 );
$default_editor = 'tinymce' ;
} else {
$default_editor = 'html' ;
}
/** This filter is documented in wp-includes/class-wp-editor.php */
$text = apply_filters ( 'the_editor_content' , $instance [ 'text' ], $default_editor );
// Reset filter addition.
if ( user_can_richedit () ) {
remove_filter ( 'the_editor_content' , 'format_for_editor' );
}
// Prevent premature closing of textarea in case format_for_editor() didn't apply or the_editor_content filter did a wrong thing.
$escaped_text = preg_replace ( '#</textarea#i' , '</textarea' , $text );
?>
< input id = " <?php echo $this->get_field_id ( 'title' ); ?> " name = " <?php echo $this->get_field_name ( 'title' ); ?> " class = " title sync-input " type = " hidden " value = " <?php echo esc_attr( $instance['title'] ); ?> " >
< textarea id = " <?php echo $this->get_field_id ( 'text' ); ?> " name = " <?php echo $this->get_field_name ( 'text' ); ?> " class = " text sync-input " hidden >< ? php echo $escaped_text ; ?> </textarea>
< input id = " <?php echo $this->get_field_id ( 'filter' ); ?> " name = " <?php echo $this->get_field_name ( 'filter' ); ?> " class = " filter sync-input " type = " hidden " value = " on " >
< input id = " <?php echo $this->get_field_id ( 'visual' ); ?> " name = " <?php echo $this->get_field_name ( 'visual' ); ?> " class = " visual sync-input " type = " hidden " value = " on " >
2017-07-14 13:09:43 -04:00
< ? php else : ?>
2017-07-24 18:46:42 -04:00
< input id = " <?php echo $this->get_field_id ( 'visual' ); ?> " name = " <?php echo $this->get_field_name ( 'visual' ); ?> " class = " visual " type = " hidden " value = " " >
2017-07-14 13:09:43 -04:00
< p >
< label for = " <?php echo $this->get_field_id ( 'title' ); ?> " >< ? php _e ( 'Title:' ); ?> </label>
2021-03-20 14:30:08 -04:00
< input class = " widefat " id = " <?php echo $this->get_field_id ( 'title' ); ?> " name = " <?php echo $this->get_field_name ( 'title' ); ?> " type = " text " value = " <?php echo esc_attr( $instance['title'] ); ?> " />
2017-07-14 13:09:43 -04:00
</ p >
< div class = " notice inline notice-info notice-alt " >
2017-07-24 19:11:43 -04:00
< ? php if ( ! isset ( $instance [ 'visual' ] ) ) : ?>
< p >< ? php _e ( 'This widget may contain code that may work better in the “Custom HTML” widget. How about trying that widget instead?' ); ?> </p>
< ? php else : ?>
Administration: Replace contracted verb forms for better consistency.
This changeset replaces contracted verb forms like `doesn't`, `can't`, or `isn't` with non-contracted forms like `does not`, `cannot`, or `is not`, for better consistency across the WordPress administration. It also updates some corresponding unit tests strings.
Props Presskopp, socalchristina, aandrewdixon, francina, SergeyBiryukov, JeffPaul, audrasjb, hellofromTonya.
Fixes #38913.
See #39176.
Built from https://develop.svn.wordpress.org/trunk@52978
git-svn-id: http://core.svn.wordpress.org/trunk@52567 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-03-22 12:25:03 -04:00
< p >< ? php _e ( 'This widget may have contained code that may work better in the “Custom HTML” widget. If you have not yet, how about trying that widget instead?' ); ?> </p>
2017-07-24 19:11:43 -04:00
< ? php endif ; ?>
2017-07-14 13:09:43 -04:00
</ div >
< p >
< label for = " <?php echo $this->get_field_id ( 'text' ); ?> " >< ? php _e ( 'Content:' ); ?> </label>
< textarea class = " widefat " rows = " 16 " cols = " 20 " id = " <?php echo $this->get_field_id ( 'text' ); ?> " name = " <?php echo $this->get_field_name ( 'text' ); ?> " >< ? php echo esc_textarea ( $instance [ 'text' ] ); ?> </textarea>
</ p >
< p >
< input id = " <?php echo $this->get_field_id ( 'filter' ); ?> " name = " <?php echo $this->get_field_name ( 'filter' ); ?> " type = " checkbox " < ? php checked ( ! empty ( $instance [ 'filter' ] ) ); ?> /> <label for="<?php echo $this->get_field_id( 'filter' ); ?>"><?php _e( 'Automatically add paragraphs' ); ?></label>
</ p >
2019-01-12 01:41:52 -05:00
< ? php
2017-07-14 13:09:43 -04:00
endif ;
2017-05-11 14:55:43 -04:00
}
2015-09-01 09:49:21 -04:00
2017-05-11 14:55:43 -04:00
/**
2023-04-24 12:37:22 -04:00
* Renders form template scripts .
2017-05-11 14:55:43 -04:00
*
* @ since 4.8 . 0
2017-08-13 01:25:46 -04:00
* @ since 4.9 . 0 The method is now static .
2017-05-11 14:55:43 -04:00
*/
2017-08-13 01:25:46 -04:00
public static function render_control_template_scripts () {
2017-07-14 13:09:43 -04:00
$dismissed_pointers = explode ( ',' , ( string ) get_user_meta ( get_current_user_id (), 'dismissed_wp_pointers' , true ) );
2017-05-11 14:55:43 -04:00
?>
< script type = " text/html " id = " tmpl-widget-text-control-fields " >
< # var elementIdPrefix = 'el' + String( Math.random() ).replace( /\D/g, '' ) + '_' #>
< p >
< label for = " { { elementIdPrefix }}title " >< ? php esc_html_e ( 'Title:' ); ?> </label>
< input id = " { { elementIdPrefix }}title " type = " text " class = " widefat title " >
</ p >
2017-07-14 13:09:43 -04:00
< ? php if ( ! in_array ( 'text_widget_custom_html' , $dismissed_pointers , true ) ) : ?>
< div hidden class = " wp-pointer custom-html-widget-pointer wp-pointer-top " >
< div class = " wp-pointer-content " >
< h3 >< ? php _e ( 'New Custom HTML Widget' ); ?> </h3>
< ? php if ( is_customize_preview () ) : ?>
2017-09-23 07:26:46 -04:00
< p >< ? php _e ( 'Did you know there is a “Custom HTML” widget now? You can find it by pressing the “<a class="add-widget" href="#">Add a Widget</a>” button and searching for “HTML”. Check it out to add some custom code to your site!' ); ?> </p>
2017-07-14 13:09:43 -04:00
< ? php else : ?>
2017-09-23 07:26:46 -04:00
< p >< ? php _e ( 'Did you know there is a “Custom HTML” widget now? You can find it by scanning the list of available widgets on this screen. Check it out to add some custom code to your site!' ); ?> </p>
2017-07-14 13:09:43 -04:00
< ? php endif ; ?>
< div class = " wp-pointer-buttons " >
< a class = " close " href = " # " >< ? php _e ( 'Dismiss' ); ?> </a>
</ div >
</ div >
< div class = " wp-pointer-arrow " >
< div class = " wp-pointer-arrow-inner " ></ div >
</ div >
</ div >
< ? php endif ; ?>
< ? php if ( ! in_array ( 'text_widget_paste_html' , $dismissed_pointers , true ) ) : ?>
< div hidden class = " wp-pointer paste-html-pointer wp-pointer-top " >
< div class = " wp-pointer-content " >
< h3 >< ? php _e ( 'Did you just paste HTML?' ); ?> </h3>
< p >< ? php _e ( 'Hey there, looks like you just pasted HTML into the “Visual” tab of the Text widget. You may want to paste your code into the “Text” tab instead. Alternately, try out the new “Custom HTML” widget!' ); ?> </p>
< div class = " wp-pointer-buttons " >
< a class = " close " href = " # " >< ? php _e ( 'Dismiss' ); ?> </a>
</ div >
</ div >
< div class = " wp-pointer-arrow " >
< div class = " wp-pointer-arrow-inner " ></ div >
</ div >
</ div >
< ? php endif ; ?>
2017-05-11 14:55:43 -04:00
< p >
I18N: Mark screen reader strings as such with translator comments.
This aims to provide better context for translators and make it easier to determine that some strings contain hidden accessibility text and are not displayed in the UI.
Props kebbet, mercime, pavelevap, ocean90, swissspidy, Chouby, jipmoors, afercia, desrosj, costdev, audrasjb, SergeyBiryukov.
Fixes #29748.
Built from https://develop.svn.wordpress.org/trunk@55276
git-svn-id: http://core.svn.wordpress.org/trunk@54809 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2023-02-07 12:10:21 -05:00
< label for = " { { elementIdPrefix }}text " class = " screen-reader-text " >< ? php /* translators: Hidden accessibility text. */ esc_html_e ( 'Content:' ); ?> </label>
2017-05-15 20:11:41 -04:00
< textarea id = " { { elementIdPrefix }}text " class = " widefat text wp-editor-area " style = " height: 200px " rows = " 16 " cols = " 20 " ></ textarea >
2017-05-11 14:55:43 -04:00
</ p >
</ script >
2015-09-26 20:27:26 -04:00
< ? php
2015-09-01 09:49:21 -04:00
}
}
