Auto-hyperlink URLs

Автоматически превращает URL-адреса и адреса электронной почты в виде обычного текста в ссылки. Этот плагин пытается заменить и расширить стандартную функцию автоматической гиперссылки WordPress. Этот плагин использует выражения сопоставления с образцом, отличные от стандартных в WordPress, чтобы не допустить, чтобы несоответствующие соседние символы становились частью ссылки (поскольку WordPress с годами совершенствовался, в настоящее время это всего лишь несколько крайних случаев, таких как текстовые ссылки, заключенные в скобки или скобки) и предотвращает превращение недействительных URI (например, http: // blah) в ссылки. Что еще более важно, этот плагин добавляет настраиваемость автогиперссылки, так что вы можете настроить: если вы хотите, чтобы текстовые URL-адреса отображали только имя хоста; если вы хотите, чтобы текстовые URL-адреса были усечены после N символов; если вы хотите, чтобы URL-адреса с автоматической гиперссылкой открывались в новом окне браузера. или нет. Если вы хотите, чтобы схема URI (например, «http: //») была удалена для отображаемых ссылок. Текст до и после текста ссылки для усеченных ссылок. Если вы хотите, чтобы поддерживался rel = ”nofollow” Если вы хотите для поддержки дополнительных доменных расширений, которые еще не настроены в плагине. Если вы хотите, чтобы определенные домены не включались в автоматическое связывание, этот плагин распознает любую явную схему URI (http | https | ftp | news): // и т. д., а также электронную почту адреса. Он также добавляет новую возможность распознавать ссылки на домены класса B (например, «somesite.net», а не только домены с префиксом «www.») В качестве действительных ссылок (например, «wordpress.org» будет автоматически содержать гиперссылки). Следующие расширения домена (также известные как TLD, домены верхнего уровня) распознаются плагином: com, org, net, gov, edu, mil, us, info, biz, ws, name, mobi, cc, tv. Они вступают в игру только тогда, когда у вас есть URL-адрес в виде обычного текста, для которого не указана явная схема URI. Если вам нужна поддержка дополнительных TLD, вы можете добавить больше через страницу параметров администратора плагина или через фильтр. Этот плагин также активирует автоматическую гиперссылку текстовых ссылок в содержимом публикации / страницы. Ссылки: Домашняя страница плагина | Страница каталога плагинов | GitHub | Примеры домашней страницы автора (при работе с конфигурацией по умолчанию): «wordpress.org» wordpress.org «http://www.cnn.com» www.cnn.com «person@example.com» person@example.com Чтобы лучше проиллюстрировать какие результаты вы можете получить, используя различные настройки выше, вот примеры. В следующих случаях предположим, что следующий URL-адрес отображается в сообщении в виде открытого текста: www.somelonghost.com/with/some/long/URL/that/might/mess/up/your/theme/and/is/unsightly.php И если явно не указано иное, в результатах используются значения по умолчанию (nofollow - false, электронные письма с гиперссылками - true, режим гиперссылки - 0). По умолчанию: www.somelonghost.com/with/some/long/URL/that/might/mess/up/ your / theme / и / is / unsightly.php При установке режима гиперссылки на 1 www.somelonghost.com При установке режима гиперссылки на 15 www.somelonghos… При установке режима гиперссылки на 15, nofollow установлен на true, открывать в новом окне установлен на false, усечение перед «[«, усечение после «…]» [www.somelonghos…] Хуки Плагин предоставляет ряд фильтров для перехвата. Как правило, код, использующий фильтры, в идеале должен быть помещен в плагин mu или плагин для конкретного сайта (что выходит за рамки данного файла readme). Имейте в виду, что большинство функций, контролируемых этими фильтрами, можно настроить на странице настроек плагина. Эти фильтры, вероятно, будут интересны только опытным пользователям, умеющим программировать. c2c_autohyperlink_urls_filters (filter) Этот хук позволяет вам настроить, какие фильтры обрабатываются плагином. Аргументы: $ filters (массив): фильтры, текст которых должен быть гиперссылкой автоматически. Массив по умолчанию ('the_content', 'the_excerpt', 'widget_text'). Пример: / ** * Дополнительные фильтры автогиперссылки. * * @param array $ filters * @return array * / function my_c2c_autohyperlink_urls_filters ($ filters) {// Добавить другой фильтр для обработки. $ filters [] = 'my_custom_filter'; вернуть фильтры $; } add_filter ('c2c_autohyperlink_urls_filters', 'my_c2c_autohyperlink_urls_filters'); c2c_autohyperlink_urls_acf_filters (filter) Этот хук позволяет вам настроить, какие фильтры Advanced Custom Field обрабатываются плагином. Примечание: результаты этого фильтра затем проходят через фильтр c2c_autohyperlink_urls_filters, поэтому фильтры, специфичные для ACF, могут быть изменены с помощью любого крючка. Аргументы: $ filters (массив): фильтры, связанные с ACF, текст которых должен быть гиперссылкой автоматически. Массив по умолчанию ('acf / format_value / type = text', 'acf / format_value / type = textarea', 'acf / format_value / type = url', 'acf_the_content'). Пример: / ** * Остановить автоматическое связывание текстовых полей ACF. * * @param array $ filters * @return array * / function my_c2c_autohyperlink_urls_acf_filters ($ filters) {unset ($ filters ['acf / format_value / type = text']); вернуть фильтры $; } add_filter ('c2c_autohyperlink_urls_acf_filters', 'my_c2c_autohyperlink_urls_acf_filters'); autohyperlink_urls_class (filter) Этот хук позволяет вам настроить класс, добавляемый к ссылкам, созданным плагином. Аргументы: $ class (строка): имя класса. По умолчанию "автогиперссылка". Пример: // Установить класс по умолчанию для ссылок, добавленных URL-адресами автогиперссылки. add_filter ('autohyperlink_urls_class', функция ($ class) {return 'myclass';}); autohyperlink_urls_link_attributes (filter) Этот хук позволяет добавлять пользовательские атрибуты к ссылкам, созданным плагином. Аргументы: $ attributes (массив): атрибуты ссылки, уже созданные плагином. $ context (строка): контекст для ссылки. Либо url, либо email. URL-адрес по умолчанию. $ title (строка): текст атрибута заголовка ссылки. Пример: / ** * Выводит атрибут 'title' для ссылки, как это делал плагин до версии v5.0. * * @param array $ attributes Атрибуты тега ссылки. * @param string $ context Контекст для ссылки. Либо url, либо email. URL-адрес по умолчанию. * @param string $ title Текст для атрибута заголовка ссылки. * @return массив * / функция add_title_attribute_for_autohyperlink_urls ($ attributes, $ context = 'url', $ title = '') {if ($ title) {$ attributes ['title'] = $ title; } вернуть $ атрибуты; } add_filter ('autohyperlink_urls_link_attributes', 'add_title_attribute_for_autohyperlink_urls', 10, 3); autohyperlink_urls_tlds (filter) Эта ловушка позволяет вам настроить список поддерживаемых TLD для автоматической гиперссылки ссылок на схемы без URI. Обратите внимание, что значение, отправляемое в ловушку, включает TLD по умолчанию, а также те, которые добавлены с помощью параметра more_extensions. Также обратите внимание, что TLD определены как строка, разделенная символом «|». Аргументы: $ tlds (строка): поддерживаемые TLD. По умолчанию 'com | org | net | gov | edu | mil | us | info | biz | ws | name | mobi | cc | tv'. Пример: // Добавить поддержку для большего количества TLD. add_filter ('autohyperlink_urls_tlds', функция ($ tlds) {return $ tlds. '| in | io | tt';}); autohyperlink_urls_truncate_link (filter) Этот хук позволяет вам настроить отображение усеченных ссылок. Аргументы: $ url (строка): потенциально усеченный URL. $ original_url (строка): полный исходный URL. $ context (строка): контекст для ссылки. Либо url, либо email. URL-адрес по умолчанию. autohyperlink_urls_custom_exclusions (filter) Этот хук позволяет вам определить настраиваемую логику, чтобы определить, должна ли ссылка быть гиперссылкой. Аргументы: $ should (bool): должна ли ссылка быть гиперссылкой? По умолчанию true. $ url (строка): URL-адрес, на который будет сделана гиперссылка. $ domain (строка): только часть URL-адреса домена / хоста. Пример: / ** * Не используйте гиперссылки на ссылки на главной странице. * * @param bool $ should * @param string $ url * @param string $ domain * @return bool * / function my_autohyperlink_urls_custom_exclusions ($ should, $ url, $ domain) {if (is_front_page ()) {return false; } else {return $ должен; }} add_filter ('autohyperlink_urls_custom_exclusions', 'my_autohyperlink_urls_custom_exclusions'); autohyperlink_urls_exclude_domains (filter) Этот хук позволяет вам указать домены, на которые не должны автоматически добавляться гиперссылки. Обратите внимание, что значение, отправляемое в ловушку, включает значение параметра exclude_domains. Обратите внимание, что следует указывать только домен (без схемы URI и завершающей косой черты). Аргументы: $ excluded_domains (массив): домены, которые уже исключаются. Пустой массив по умолчанию. Пример: / ** * Исключить определенные домены из автоматической гиперссылки. * * @param array $ excluded_domains * @return array * / function my_autohyperlink_urls_exclude_domains ($ excluded_domains) {$ excluded_domains [] = 'youtube.com'; $ excluded_domains [] = 'example.com'; вернуть $ excluded_domains; } add_filter ('autohyperlink_urls_exclude_domains', 'my_autohyperlink_urls_exclude_domains'); autohyperlink_no_autolink_content_tags (filter) Этот хук позволяет указать, какие HTML-теги не будут автоматически связывать свое содержимое. Аргументы: $ html_tags (массив): HTML-теги, которые не будут автоматически связываться. По умолчанию ['code', 'pre', 'script', 'style']. Пример: / ** * Разрешить автоматическое связывание текста внутри пре`, но не разрешать автоматическое связывание текста внутри * цитаты. * * @param array $ html_tags HTML-теги, для которых не требуется автоматическое связывание. * @return array * / function my_autohyperlink_no_autolink_content_tags ($ html_tags) {// Тег, который должен автоматически связывать контент, но в противном случае это будет по умолчанию. $ html_tags = array_flip ($ html_tags); отключено ($ html_tags ['pre']); $ html_tags = array_flip ($ html_tags); // Тег, который не должен автоматически связывать контент. $ html_tags [] = 'цитата'; return $ html_tags; } add_filter ('autohyperlink_no_autolink_content_tags', 'my_autohyperlink_no_autolink_content_tags'); `

Автор: Scott Reilly

Версия: 5.4.1

Последнее обновление: 2020-01-16 8:25pm GMT