Функция make_clickable() в WordPress предназначена для автоматического преобразования текстовых ссылок (URI) в кликабельные HTML-ссылки. Она поддерживает различные форматы ссылок, включая веб-адреса, FTP и email-адреса.
make_clickable( string $text ): string
Описание параметров
$text(строка, обязательный): Строка, содержащая текст, который нужно преобразовать. В ней могут быть как ссылки, так и обычный текст.
Возвращаемое значение
Функция возвращает строку, в которой текстовые ссылки заменены на соответствующие HTML-ссылки.
Как работает функция make_clickable()
Функция make_clickable() ищет текстовые ссылки в переданном контенте и заменяет их на HTML-ссылки. Она автоматически обрабатывает такие протоколы, как http://, https://, ftp://, а также текст, начинающийся с www или email-адреса.
Функция не обрабатывает текст внутри определённых тегов, таких как <code>, <pre>, <script>, и <style>, чтобы избежать нарушений разметки.
Пример 1: Преобразование простой ссылки
В этом примере мы преобразуем текст с URL в кликабельную ссылку:
$text = "Какой-то текст http://example.com/page-108 и еще какой-то текст.";
echo make_clickable($text);
Результат:
Какой-то текст <a href="http://example.com/page-108" rel="nofollow">http://example.com/page-108</a> и еще какой-то текст.
Пример 2: Обработка нескольких ссылок
Если у вас есть длинный текст с несколькими ссылками, make_clickable() легко справится с этим:
$string = "Посетите наши сайты: http://www.wordpress.org и http://www.wordpress.com.";
echo make_clickable($string);
Результат:
Посетите наши сайты: <a href="http://www.wordpress.org" rel="nofollow">http://www.wordpress.org</a> и <a href="http://www.wordpress.com" rel="nofollow">http://www.wordpress.com</a>.
Пример 3: Кликабельные ссылки с атрибутом target
Вы можете комбинировать make_clickable() с функцией links_add_target() для добавления атрибута target к ссылкам. Например, чтобы ссылки открывались в новой вкладке:
$content = "Какой-то текст http://example.com/page-108 и еще какой-то текст.";
$clickable_content = make_clickable($content);
echo links_add_target($clickable_content);
Результат:
Какой-то текст <a href="http://example.com/page-108" rel="nofollow" target="_blank">http://example.com/page-108</a> и еще какой-то текст.
Пример 4: Email-ссылки
Функция также обрабатывает email-адреса, превращая их в кликабельные ссылки:
$email_text = "Напишите нам на [email protected] для получения информации.";
echo make_clickable($email_text);
Результат:
Напишите нам на <a href="mailto:[email protected]">[email protected]</a> для получения информации.
Заключение
Функция make_clickable() в WordPress является мощным инструментом для автоматизации процесса превращения текстовых ссылок в кликабельные элементы. Это позволяет значительно улучшить взаимодействие пользователей с контентом. Будь то одиночные URL, email-адреса или группы ссылок, make_clickable() обеспечит простоту и удобство в использовании ссылок на вашем сайте.