links_add_target() – Function | Developer.WordPress.org

Adds a target attribute to all links in passed content.

Description

By default, this function only applies to <a> tags.
However, this can be modified via the $tags parameter.

_NOTE:_ Any current target attribute will be stripped and replaced.

Parameters

$contentstringrequired: String to search for links in.
$targetstringoptional: The target to add to the links.
Default:'_blank'
$tagsstring[]optional: An array of tags to apply to.
Default:array('a')

Return

string The processed content.

Source

function links_add_target( $content, $target = '_blank', $tags = array( 'a' ) ) {
	global $_links_add_target;
	$_links_add_target = $target;
	$tags              = implode( '|', (array) $tags );
	return preg_replace_callback( "!<($tags)((\s[^>]*)?)>!i", '_links_add_target', $content );
}

View all references View on Trac View on GitHub

Used by	Description
install_plugin_information()`wp-admin/includes/plugin-install.php`	Displays plugin information in dialog box form.

Changelog

Version	Description
2.7.0	Introduced.

User Contributed Notes

Skip to note 2 content

Saurabh Sharma 9 months ago

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
Add target="_blank" to the get_the_category_list() output.
```
$cat_links = get_the_category_list();
$modified = links_add_target( $cat_links ); // the 'target' parameter is omitted as it is _blank by default
echo $modified;
```
Log in to add feedback

links_add_target( string $content, string $target = ‘_blank’, string[] $tags = array(‘a’) ): string

In this article

Description

Parameters

Return

Source

Changelog

User Contributed Notes

links_add_target( string $content, string $target = ‘_blank’, string[] $tags = array(‘a’) ): string

In this article

Description

Parameters

Return

Source

Related

Changelog

User Contributed Notes