strip_shortcodes( string $content )

Remove all shortcode tags from the given content.

Contents

Description Description

Parameters Parameters

$content

(string) (Required) Content to remove shortcode tags.

Top ↑

Return Return

(string) Content without shortcode tags.

Top ↑

Source Source

File: wp-includes/shortcodes.php 

function strip_shortcodes( $content ) {
	global $shortcode_tags;

	if ( false === strpos( $content, '[' ) ) {
		return $content;
	}

	if ( empty( $shortcode_tags ) || ! is_array( $shortcode_tags ) ) {
		return $content;
	}

	// Find all registered tag names in $content.
	preg_match_all( '@\[([^<>&/\[\]\x00-\x20=]++)@', $content, $matches );

	$tags_to_remove = array_keys( $shortcode_tags );

	/**
	 * Filters the list of shortcode tags to remove from the content.
	 *
	 * @since 4.7.0
	 *
	 * @param array  $tags_to_remove Array of shortcode tags to remove.
	 * @param string $content        Content shortcodes are being removed from.
	 */
	$tags_to_remove = apply_filters( 'strip_shortcodes_tagnames', $tags_to_remove, $content );

	$tagnames = array_intersect( $tags_to_remove, $matches[1] );

	if ( empty( $tagnames ) ) {
		return $content;
	}

	$content = do_shortcodes_in_html_tags( $content, true, $tagnames );

	$pattern = get_shortcode_regex( $tagnames );
	$content = preg_replace_callback( "/$pattern/", 'strip_shortcode_tag', $content );

	// Always restore square braces so we don't break things like <!--[if IE ]>
	$content = unescape_invalid_shortcodes( $content );

	return $content;
}

Expand full source code Collapse full source code View on Trac

Top ↑

Changelog Changelog

Changelog
Version Description
2.5.0 Introduced.

Top ↑

Top ↑

Uses Uses

Uses
Uses Description
wp-includes/shortcodes.php: strip_shortcodes_tagnames

Filters the list of shortcode tags to remove from the content.
wp-includes/shortcodes.php: do_shortcodes_in_html_tags()

Search only inside HTML elements for shortcodes and process them.
wp-includes/shortcodes.php: unescape_invalid_shortcodes()

Remove placeholders added by do_shortcodes_in_html_tags().
wp-includes/shortcodes.php: get_shortcode_regex()

Retrieve the shortcode regular expression for searching.
wp-includes/plugin.php: apply_filters()

Call the functions added to a filter hook.

Top ↑

User Contributed Notes 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: 0You must log in to vote on the helpfulness of this note
    Contributed by Codex —

    Strip shortcodes on home page but not on single or archive pages
    When viewing posts ‘home’ page, strip all shortcodes, but on other pages, such as single.php, do not strip the shortcodes.

    /**
 * Remove shortcodes if we are on the home page
 *
 * @param string $content Post content.
 * @return string (Maybe) modified post content.
 */
function wpdocs_remove_shortcode_from_index( $content ) {
	if ( is_home() ) {
		$content = strip_shortcodes( $content );
	}
	return $content;
}
add_filter( 'the_content', 'wpdocs_remove_shortcode_from_index' );

    Expand full source codeCollapse full source code

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