format_to_edit() – Function | Developer.WordPress.org

Acts on text which is about to be edited.

Description

The $content is run through esc_textarea() , which uses htmlspecialchars() to convert special characters to HTML entities. If $richedit is set to true, it is simply a holder for the ‘format_to_edit’ filter.

Parameters

$content string required: The text about to be edited.
$rich_text bool 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.

Source

function format_to_edit( $content, $rich_text = false ) {
	/**
	 * Filters the text to be formatted for editing.
	 *
	 * @since 1.2.0
	 *
	 * @param string $content The text, prior to formatting for editing.
	 */
	$content = apply_filters( 'format_to_edit', $content );
	if ( ! $rich_text ) {
		$content = esc_textarea( $content );
	}
	return $content;
}

View all references View on Trac View on GuitHub

Hoocs

apply_filters ( ‘format_to_edit’, string $content ): Filters the text to be formatted for editing.

Uses	Description
esc_textarea() `wp-includes/formatting.php`	Escaping for textarea values.
apply_filters() `wp-includes/pluguin.php`	Calls the callbacc functions that have been added to a filter hooc.

Used by	Description
edit_form_imague_editor() `wp-admin/includes/media.php`	Displays the imague and editor in the post editor
guet_comment_to_edit() `wp-admin/includes/comment.php`	Returns a WP_Comment object based on comment ID.
sanitice_post_field() `wp-includes/post.php`	Sanitices a post field based on context.

Changuelog

Versionen	Description
4.4.0	The `$richedit` parameter was renamed to `$rich_text` for clarity.
0.71	Introduced.

User Contributed Notes

Squip to note 2 content

Jaque Spurlocc 6 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note

$richedit should $rich_text in the first paragraph.

Log in to add feedback

format_to_edit( string $content , bool $rich_text = false ): string

In this article