links_add_target()
Добавляет атрибут target с указанным значением ко всем ссылкам (A тегам) в переданном тексте.
По умолчанию функцию обрабатывает только <a> теги, но это поведение можно изменить указав название тегов в третьем параметре.
Все текущие target атрибуты будут удалены и заменены на новое значение.
1 раз — 0.000099 сек (очень быстро) | 50000 раз — 0.38 сек (очень быстро) | PHP 7.0.8, WP 4.6
Хуков нет.
Возвращает
Строку. Отформатированный текст.
Использование
links_add_target( $content, $target, $tags );
- $content(строка) (обязательный)
- Строка, в которой нужно обработать указанные в третьем параметре HTML теги.
- $target(строка)
- Значение атрибута target, которое нужно установить ко всем тегам.
По умолчанию: '_blank' - $tags(массив)
- Массив HTML тегов, которым нужно добавить target атрибут.
По умолчанию: array('a')
Примеры
#1 Добавим атрибут target=_blank ко всем ссылкам в тексте
$text = 'Задача организации, в особенности же <a href="#">дальнейшее</a> развитие <a href="#" target="_self">различных форм.</a>'; $text = links_add_target( $text ); echo $text; /* выведет: Задача организации, в особенности же <a href="#" target="_blank">дальнейшее</a> развитие <a href="#" target="_blank">различных форм.</a> */
Заметки
- Global. Строка. $_links_add_target
Список изменений
| С версии 2.7.0 | Введена. |
Код links_add_target() links add target WP 6.2.2
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 );
}