links_add_target( string $content, string $target = '_blank', array $tags = array('a') )

Adds a Target attribute to all links in passed content.

Description Description

This function by default only applies to <a> tags, however this can be modified by the 3rd param.

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

Parameters Parameters


(string) (Required) String to search for links in.


(string) (Optional) The Target to add to the links.

Default value: '_blank'


(array) (Optional) An array of tags to apply to.

Default value: array('a')

Top ↑

Return Return

(string) The processed content.

Top ↑

Source Source

File: wp-includes/formatting.php

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)([^>]*)>!i", '_links_add_target', $content );

Top ↑

Changelog Changelog

Version Description
2.7.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

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