Linkify Text
Этот плагин позволяет вам определять слова или фразы, которые всякий раз, когда они появляются в ваших сообщениях или страницах, автоматически связываются с выбранными вами URL-адресами. Например, где бы вы ни упомянули слово «WordPress», оно может быть автоматически связано как «WordPress». Дополнительные функции плагина, управляемые с помощью настроек и фильтров: Для комментариев можно включить текстовые ссылки (это не по умолчанию) Текстовые ссылки могут быть сделаны с учетом регистра (это не по умолчанию) Текстовые ссылки могут быть ограничены выполнением только одного связывание для каждого термина, для каждого сообщения (по умолчанию все вхождения термина связаны) Текстовые ссылки для связывания можно настроить так, чтобы они открывались в новом окне (это не по умолчанию). Вы также можете связать несколько терминов с одной и той же ссылкой и только определите эту ссылку один раз в настройках с помощью специального синтаксиса ссылки. Существует ряд фильтров для программной настройки поведения плагина, все из которых задокументированы. Ссылки: Домашняя страница плагина | Страница каталога плагинов | GitHub | Хуки на главной странице автора Плагин предоставляет ряд фильтров для перехвата. Как правило, код, использующий фильтры, в идеале должен быть помещен в плагин mu или плагин для конкретного сайта (что выходит за рамки данного файла readme). Имейте в виду, что большинство функций, контролируемых этими фильтрами, можно настроить на странице настроек плагина. Эти фильтры, вероятно, будут интересны только опытным пользователям, умеющим программировать. c2c_linkify_text_filters (filter) Хук 'c2c_linkify_text_filters' позволяет вам настроить, какие хуки будут применять к ним текстовые ссылки. Аргументы: $ hooks (array): массив хуков, которые будут текстовыми ссылками. Пример: / ** * Включает текстовые ссылки для настраиваемых полей. * * @param array $ filters Фильтры, обрабатываемые плагином Linkify Text. * / function more_text_replacements ($ filters) {$ filters [] = 'the_meta'; // Здесь вы можете указать имя любого нужного фильтра return $ filters; } add_filter ('c2c_linkify_text_filters', 'more_text_replacements'); c2c_linkify_text_comments (filter) Хук 'c2c_linkify_text_comments' позволяет вам настроить или переопределить параметр, указывающий, следует ли включать текстовые ссылки в комментариях. Аргументы: $ state (bool): Либо true, либо false, указывающее, включена ли текстовая ссылка для комментариев. Значением по умолчанию будет значение, установленное на странице настроек плагина. Пример: // Запретить включение текстовых ссылок в комментариях. add_filter ('c2c_linkify_text_comments', '__return_false'); c2c_linkify_text (filter) Хук 'c2c_linkify_text' позволяет вам настроить или переопределить параметр, определяющий все текстовые фразы и связанные с ними ссылки. Аргументы: $ linkify_text_array (array): массив текста и связанных с ним ссылок. Значением по умолчанию будет значение, установленное на странице настроек плагина. Пример: / ** * Программно добавляет дополнительный текст для ссылки. * * @param array $ text_to_links Массив текста и связанных с ними URL. * / function my_text_linkifications ($ text_to_links) {// Добавить текстовую ссылку $ text_to_links ['Matt Mullenweg'] => 'https://ma.tt'; // Удаляем текстовую ссылку, которую мы никогда не хотим определять if (isset ($ text_to_links ['WordPress'])) {unset ($ text_to_links ['WordPress']); } // Важный! Верните изменения. вернуть $ text_to_links; } add_filter ('c2c_linkify_text', 'my_text_linkifications'); c2c_linkify_text_case_sensitive (фильтр) Хук 'c2c_linkify_text_case_sensitive' позволяет вам настроить или переопределить параметр, указывающий, должно ли совпадение текста для потенциальной ссылки текста быть чувствительным к регистру или нет. Аргументы: $ state (bool): Либо истина, либо ложь, указывая, учитывается ли при сопоставлении текста регистр. Значением по умолчанию будет значение, установленное на странице настроек плагина. Пример: // Предотвращение учета регистра при сопоставлении текста. add_filter ('c2c_linkify_text_case_sensitive', '__return_false'); c2c_linkify_text_replace_once (filter) Хук 'c2c_linkify_text_replace_once' позволяет вам настроить или переопределить параметр, указывающий, должно ли связывание текста ограничиваться одним разом на термин для каждого фрагмента текста, который обрабатывается независимо от того, сколько раз этот термин появляется. Аргументы: $ state (bool): значение true или false, указывающее, должна ли текстовая ссылка выполняться только один раз за термин. Значением по умолчанию будет значение, установленное на странице настроек плагина. Пример: // Связывайте термин только один раз для каждого сообщения. add_filter ('c2c_linkify_text_replace_once', '__return_true'); c2c_linkify_text_open_new_window (фильтр) Хук 'c2c_linkify_text_open_new_window' позволяет вам настроить или переопределить параметр, указывающий, должны ли ссылки открываться в новом окне. Аргументы: $ state (bool): Либо истина, либо ложь, указывающая, должны ли ссылки открываться в новом окне. Значением по умолчанию будет значение, установленное на странице настроек плагина, которая сама по себе имеет значение false. Пример: // Сделать ссылки открытыми в новом окне. add_filter ('c2c_linkify_text_open_new_window', '__return_true'); c2c_linkify_text_linked_text (filter) Хук 'c2c_linkify_text_linked_text' позволяет вам настроить или переопределить разметку замещающей ссылки для данной строки. Верните значение $ old_text, чтобы эффективно предотвратить указанную текстовую ссылку. Аргументы: $ new_text (строка): разметка ссылки, которая заменит $ old_text. $ old_text (строка): текст, который заменяется / связывается. $ link (строка): URL-адрес, на который нужно связать $ old_text. $ text_to_link (массив): полный массив текста и URL-адреса, на которые они должны ссылаться. Пример: / ** * Отключить связывание ссылок для сообщений, для которых определено настраиваемое поле 'disable_linkify_text' *. * * @param array $ display_link Ассоциативный массив атрибутов, который будет использоваться для ссылки. * @param string $ old_text Заменяемый / связываемый текст. * @param string $ link_for_text URL-адрес, на который нужно связать $ old_text. * @param string $ text_to_link Полный массив текста и URL-адреса, на которые они должны ссылаться. * @return string * / function selectedly_disable_text_linkification ($ display_link, $ old_text, $ link_for_text, $ text_to_link) {if (get_metadata ('post', get_the_ID (), 'disable_linkify_text', true)) {$ display_link = $ old_text; } return $ display_link; } add_filter ('c2c_linkify_text_linked_text', 'выборочно_disable_text_linkification', 10, 4); c2c_linkify_text_link_attrs (filter) Хук 'c2c_linkify_text_link_attrs' позволяет вам добавлять или настраивать атрибуты для ссылки. Аргументы: $ attrs (array): ассоциативный массив атрибутов, который будет использоваться для ссылки. По умолчанию включает "href". $ old_text (строка): текст, который заменяется / связывается. $ link (строка): URL-адрес, на который нужно связать $ old_text. Пример: / ** * Заставить ссылки, созданные плагином Linkify Text, открываться в новой вкладке. * * @param array $ attrs Ассоциативный массив атрибутов, который будет использоваться для ссылки. * @param string $ old_text Заменяемый / связываемый текст. * @param string $ link URL, на который нужно связать $ old_text. * @return массив * / функция my_linkify_text_attrs ($ attrs, $ old_text, $ link) {$ attrs ['target'] = '_blank'; вернуть $ attrs; } add_filter ('c2c_linkify_text_link_attrs', 'my_linkify_text_attrs', 10, 3);
Автор: Scott Reilly
Версия: 1.9.1
Последнее обновление: 2018-07-20 6:06am GMT