wp_kses_post( string $data ): string

Sanitizes content for allowed HTML tags for post content.

Contents

Description

Post content refers to the page contents of the ‘post’ type and not $_POST data from forms.

This function expects unslashed data.

Top ↑

Parameters

$data string Required
Post content to filter.

Top ↑

Return

string Filtered post content with allowed HTML tags and attributes intact.

Top ↑

Source

File: wp-includes/kses.php. View all references 

function wp_kses_post( $data ) {
	return wp_kses( $data, 'post' );
}

View on Trac View on GitHub

Top ↑

Top ↑

Uses

Uses
Uses Description
wp_kses() wp-includes/kses.php

Filters text content and strips out disallowed HTML.

Top ↑

Used By

Used By
Used By Description
WP_Site_Health::get_test_page_cache() wp-admin/includes/class-wp-site-health.php

Tests if a full page cache is available.
WP_Widget_Block::update() wp-includes/widgets/class-wp-widget-block.php

Handles updating settings for the current Block widget instance.
WP_REST_Pattern_Directory_Controller::prepare_item_for_response() wp-includes/rest-api/endpoints/class-wp-rest-pattern-directory-controller.php

Prepare a raw block pattern before it gets output in a REST API response.
WP_Widget_Custom_HTML::update() wp-includes/widgets/class-wp-widget-custom-html.php

Handles updating settings for the current Custom HTML widget instance.
do_settings_sections() wp-admin/includes/template.php

Prints out all settings sections added to a particular settings page.
wp_add_id3_tag_data() wp-admin/includes/media.php

Parses ID3v2, ID3v1, and getID3 comments to extract usable data.
WP_Widget_Text::update() wp-includes/widgets/class-wp-widget-text.php

Handles updating settings for the current Text widget instance.
WP_SimplePie_Sanitize_KSES::sanitize() wp-includes/class-wp-simplepie-sanitize-kses.php

WordPress SimplePie sanitization using KSES.
WP_Customize_Widgets::sanitize_widget_instance() wp-includes/class-wp-customize-widgets.php

Sanitizes a widget instance.
Show 4 more used by Hide more used by

Top ↑

Changelog

Changelog
Version Description
2.9.0 Introduced.

Top ↑

User Contributed Notes

  1. Skip to note 1 content
    You must log in to vote on the helpfulness of this noteVote results for this note: -5You must log in to vote on the helpfulness of this note
    Contributed by Pitabas —

    Display Admin notice

    The following example of basic usage of the wp_kses_post() function. We can use it to print the message in the admin screen. 

    if ( ! version_compare( PHP_VERSION, '5.6', '>=' ) ) {
	add_action( 'admin_notices', 'wpdocs_fail_php_version' );
} 

/**
 * Admin notice for minimum PHP version.
 *
 * Warning when the site doesn't have the minimum required PHP version.
 *
 * @since 1.0.0
 *
 * @return void
 */
function wpdocs_fail_php_version() {

	if ( isset( $_GET['activate'] ) ) {
		unset( $_GET['activate'] );
	}

	/* translators: %s: PHP version */
	$message      = sprintf( __( '<strong>My Custom Plugin</strong> requires PHP version %s+, plugin is currently NOT RUNNING.', 'wpdocs-text-domain' ), '5.6' );
	$html_message = sprintf( '<div class="error">%s</div>', wpautop( $message ) );
	echo wp_kses_post( $html_message );
}

You must log in before being able to contribute a note or feedback.