strip_shortcodes( string $content ): string

Removes all shortcode tags from the given content.

Contents

Parameters
Return
Source
Hooks
Related
- Uses
- Used By
Changelog
User Contributed Notes

Parameters

$content string Required: Content to remove shortcode tags.

Return

string Content without shortcode tags.

Source

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

function strip_shortcodes( $content ) {
	global $shortcode_tags;

	if ( ! str_contains( $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;
}

View on Trac View on GitHub

Hooks

apply_filters( 'strip_shortcodes_tagnames', array $tags_to_remove, string $content )

Filters the list of shortcode tags to remove from the content.

Uses

Uses
Uses	Description
do_shortcodes_in_html_tags() wp-includes/shortcodes.php	Searches only inside HTML elements for shortcodes and process them.
unescape_invalid_shortcodes() wp-includes/shortcodes.php	Removes placeholders added by do_shortcodes_in_html_tags() .
get_shortcode_regex() wp-includes/shortcodes.php	Retrieves the shortcode regular expression for searching.
apply_filters() wp-includes/plugin.php	Calls the callback functions that have been added to a filter hook.

Show 1 more use Hide more uses

Used By

Used By
Used By	Description
wp_trim_excerpt() wp-includes/formatting.php	Generates an excerpt from the content, if needed.

Changelog

Changelog
Version	Description
2.5.0	Introduced.

User Contributed Notes

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 Vitalii Kiiko — 5 years ago

It is worth to note that this function removes only those shortcodes which are registered at the moment of the processing of this function. If there are any “leftovers” shortcodes, like those which were added by some plugin but that plugin is not active anymore, this function WILL NOT strip them. It is possible to check which shortcodes may and will be stripped with the help of this filter strip_shortcodes_tagnames

Log in to add feedback
Skip to note 2 content

You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

Contributed by Codex — 8 years ago
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' );
```
Log in to add feedback

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