Функция links_add_target() в WordPress предназначена для добавления атрибута target ко всем ссылкам в переданном тексте. Это может быть полезно, например, если вы хотите, чтобы все ссылки открывались в новой вкладке или окне браузера.
links_add_target( string $content, string $target = '_blank', string[] $tags = array('a') ): string
Описание параметров
$content(строка, обязательный): Строка, в которой необходимо найти и изменить ссылки.$target(строка, необязательный): Значение, которое будет добавлено к атрибутуtarget. По умолчанию используется'_blank'.$tags(массив строк, необязательный): Массив HTML-тегов, к которым следует применить изменения. По умолчанию функция обрабатывает только теги<a>.
Возвращаемое значение
Функция возвращает строку с обновленными атрибутами target для указанных тегов.
Как работает функция links_add_target()
Функция links_add_target() ищет ссылки в предоставленном тексте и добавляет (или обновляет) атрибут target в соответствии с заданными параметрами. Это позволяет управлять поведением ссылок, не изменяя их вручную.
Пример 1: Добавление атрибута target="_blank" ко всем ссылкам
Рассмотрим простой пример, когда мы добавляем атрибут target="_blank" ко всем ссылкам в тексте:
$text = 'Задача организации, в особенности же <a href="#">дальнейшее</a>
развитие <a href="#" target="_self">различных форм.</a>';
$updated_text = links_add_target($text);
echo $updated_text;
Результат:
Задача организации, в особенности же <a href="#" target="_blank">дальнейшее</a>
развитие <a href="#" target="_blank">различных форм.</a>
Пример 2: Указание другого значения для атрибута target
Вы также можете изменить значение атрибута target. Например, чтобы открыть ссылки в том же окне, можно сделать следующее:
$text = 'Посетите наш сайт <a href="https://example.com">здесь</a>
или <a href="https://another-example.com">здесь</a>.';
$updated_text = links_add_target($text, '_self');
echo $updated_text;
Результат:
Посетите наш сайт <a href="https://example.com" target="_self">здесь</a>
или <a href="https://another-example.com" target="_self">здесь</a>.
Пример 3: Применение функции к другим тегам
Вы можете использовать links_add_target() не только для <a> тегов, но и для других. Например, если вам нужно добавить target к тегам <area>:
$content = '<map name="map1">
<area shape="rect" coords="34,44,270,350" href="https://example.com">
<area shape="circle" coords="220,220,40" href="https://another-example.com">
</map>';
$updated_content = links_add_target($content, '_blank', array('a', 'area'));
echo $updated_content;
Результат:
<map name="map1">
<area shape="rect" coords="34,44,270,350" href="https://example.com" target="_blank">
<area shape="circle" coords="220,220,40" href="https://another-example.com" target="_blank">
</map>
Заключение
Функция links_add_target() в WordPress предоставляет простое и эффективное средство для управления атрибутами ссылок в контенте. С её помощью можно легко обеспечить единообразное поведение ссылок, что улучшает пользовательский опыт. Будь то открытие ссылок в новой вкладке или изменение существующих атрибутов, links_add_target() позволяет сделать это быстро и без лишних усилий.