Formatting: Rename the `$richedit` parameter in `format_to_edit()` to `$rich_text`.
Previously, it was necessary to explain in a double-negative that `$richedit` being false would prevent `$content` from being passed through `esc_textarea()`. The updated `$rich_edit` name and documentation now better reflects the intent of the parameter. Fixes #21613. Built from https://develop.svn.wordpress.org/trunk@34727 git-svn-id: http://core.svn.wordpress.org/trunk@34691 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
parent
1bacb00c01
commit
ec9ec3138e
|
@ -1843,12 +1843,15 @@ function force_balance_tags( $text ) {
|
||||||
* it is simply a holder for the 'format_to_edit' filter.
|
* it is simply a holder for the 'format_to_edit' filter.
|
||||||
*
|
*
|
||||||
* @since 0.71
|
* @since 0.71
|
||||||
|
* @since 4.4.0 The `$richedit` parameter was renamed to `$rich_text` for clarity.
|
||||||
*
|
*
|
||||||
* @param string $content The text about to be edited.
|
* @param string $content The text about to be edited.
|
||||||
* @param bool $richedit Whether the $content should not pass through htmlspecialchars(). Default false (meaning it will be passed).
|
* @param bool $rich_text Optional. Whether `$content` should be considered rich text,
|
||||||
|
* in which case it would not be passed through esc_textarea().
|
||||||
|
* Default false.
|
||||||
* @return string The text after the filter (and possibly htmlspecialchars()) has been run.
|
* @return string The text after the filter (and possibly htmlspecialchars()) has been run.
|
||||||
*/
|
*/
|
||||||
function format_to_edit( $content, $richedit = false ) {
|
function format_to_edit( $content, $rich_text = false ) {
|
||||||
/**
|
/**
|
||||||
* Filter the text to be formatted for editing.
|
* Filter the text to be formatted for editing.
|
||||||
*
|
*
|
||||||
|
@ -1857,7 +1860,7 @@ function format_to_edit( $content, $richedit = false ) {
|
||||||
* @param string $content The text, prior to formatting for editing.
|
* @param string $content The text, prior to formatting for editing.
|
||||||
*/
|
*/
|
||||||
$content = apply_filters( 'format_to_edit', $content );
|
$content = apply_filters( 'format_to_edit', $content );
|
||||||
if ( ! $richedit )
|
if ( ! $rich_text )
|
||||||
$content = esc_textarea( $content );
|
$content = esc_textarea( $content );
|
||||||
return $content;
|
return $content;
|
||||||
}
|
}
|
||||||
|
|
|
@ -4,7 +4,7 @@
|
||||||
*
|
*
|
||||||
* @global string $wp_version
|
* @global string $wp_version
|
||||||
*/
|
*/
|
||||||
$wp_version = '4.4-alpha-34726';
|
$wp_version = '4.4-alpha-34727';
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.
|
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.
|
||||||
|
|
Loading…
Reference in New Issue