has_shortcode( string $content, string $tag ): bool

Determines whether the passed content contains the specified shortcode.

Contents

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

Parameters

$content string Required: Content to search for shortcodes.
$tag string Required: Shortcode tag to check.

Return

bool Whether the passed content contains the given shortcode.

Source

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

function has_shortcode( $content, $tag ) {
	if ( ! str_contains( $content, '[' ) ) {
		return false;
	}

	if ( shortcode_exists( $tag ) ) {
		preg_match_all( '/' . get_shortcode_regex() . '/', $content, $matches, PREG_SET_ORDER );
		if ( empty( $matches ) ) {
			return false;
		}

		foreach ( $matches as $shortcode ) {
			if ( $tag === $shortcode[2] ) {
				return true;
			} elseif ( ! empty( $shortcode[5] ) && has_shortcode( $shortcode[5], $tag ) ) {
				return true;
			}
		}
	}
	return false;
}

View on Trac View on GitHub

Uses

Uses
Uses	Description
shortcode_exists() wp-includes/shortcodes.php	Determines whether a registered shortcode exists named $tag.
get_shortcode_regex() wp-includes/shortcodes.php	Retrieves the shortcode regular expression for searching.
has_shortcode() wp-includes/shortcodes.php	Determines whether the passed content contains the specified shortcode.

Used By

Used By
Used By	Description
wp_ajax_parse_embed() wp-admin/includes/ajax-actions.php	Applies [embed] Ajax handlers to a string.
has_shortcode() wp-includes/shortcodes.php	Determines whether the passed content contains the specified shortcode.
get_post_galleries() wp-includes/media.php	Retrieves galleries from the passed post’s content.

Changelog

Changelog
Version	Description
3.6.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 Codex — 8 years ago
Enqueue some script when some post uses some shortcode.
Note: has_shortcode() can use a lot of resources if scanning a lot of content.
```
/**
 * Enqueue the wpdocs-script if the wpdocs-shortcode is being used
 */
function wpdocs_shortcode_scripts() {
	global $post;
	if ( is_a( $post, 'WP_Post' ) && has_shortcode( $post->post_content, 'wpdocs-shortcode') ) {
		wp_enqueue_script( 'wpdocs-script');
	}
}
add_action( 'wp_enqueue_scripts', 'wpdocs_shortcode_scripts');
```
Top ↑
Feedback
- Instead of the `global $post` which requires the `is_a($post, ‘WP_Post’)` check, simply using `get_the_content()` works fine too. — By Alec — 2 years ago
Log in to add feedback

1

Contributed by Ahir Hemant — 2 years ago

Simple Example
Redirect to specific page for not logged in user for specific shortcode

function wpdocs_wordpress_doc_head() {
	global $post;

	if ( has_shortcode( $post->post_content, 'only_loggedin_users' ) ) {
		if ( ! is_user_logged_in() ) {
			$page = get_page_by_title('login');
			wp_redirect( get_permalink( $page->ID ) );
			exit;
		}
	}

}
add_action( 'template_redirect', 'wpdocs_wordpress_doc_head', 5 );

Skip to note 3 content

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

Contributed by Codex — 8 years ago
Simple Example
Note: has_shortcode() can use a lot of resources if scanning a lot of content.
```
$content = 'This is some text, (perhaps pulled via $post->post_content). It has a [gallery] shortcode.';

if ( has_shortcode( $content, 'gallery' ) ) {
	// The content has a [gallery] short code, so this check returned true.
}
```
Log in to add feedback

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