On this page
strip_shortcodes( string $content ): string
Removes all shortcode tags from the given content.
Parameters
$contentstring 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 ( 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;
}
Hooks
- apply_filters( 'strip_shortcodes_tagnames',
array $tags_to_remove ,string $content ) -
Filters the list of shortcode tags to remove from the content.
Related
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. |
Used By
| Used By | Description |
|---|---|
| wp_trim_excerpt() wp-includes/formatting.php | Generates an excerpt from the content, if needed. |
Changelog
| Version | Description |
|---|---|
| 2.5.0 | Introduced. |
© 2003–2022 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/strip_shortcodes