get_url_in_content( string $content ): string|false

Parameters

$contentstring

A string which might contain an A element with a non-empty href attribute.

Return

string|false

Database-escaped URL via esc_url() if found, otherwise false.

Uses · 2

• sanitize_url()Sanitizes a URL for database or redirect usage.
• WP_HTML_Tag_Processor::__construct()Constructor.

Used by · 3

• twentyeleven_get_first_url()Returns the first link from the post content. If none found, the post permalink is used as a fallback.
• twentyfifteen_get_link_url()Returns the post URL.
• twentythirteen_get_link_url()Returns the post URL.

Source

View on Trac ↗View on GitHub ↗

5816function get_url_in_content( $content ) {5817	if ( empty( $content ) ) {5818		return false;5819	}5820 5821	$processor = new WP_HTML_Tag_Processor( $content );5822	while ( $processor->next_tag( 'A' ) ) {5823		$href = $processor->get_attribute( 'href' );5824		if ( is_string( $href ) && '' !== $href ) {5825			return sanitize_url( $href );5826		}5827	}5828 5829	return false;5830}

History

Introduced in 3.6.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.0.4 tag, from src/wp-includes/formatting.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.