Text Replace v4.0

Этот плагин позволяет вам легко определить текст или HTML, который должен использоваться в ваших сообщениях вместо слов или фраз, которые фактически присутствуют в сообщениях. Это удобный метод создания ярлыков для обычного, длинного или часто меняющегося текста/HTML, а также для смайлов.

Дополнительные возможности плагина, управляемые как через настройки, так и через фильтры:

- Для комментариев можно включить замену текста (по умолчанию это не так).

- Замену текста можно сделать нечувствительной к регистру (по умолчанию учитывается регистр).

- Замена текста может быть ограничена выполнением только одной замены для каждого термина в каждой публикации (по умолчанию заменяются все вхождения термина).

- Замена текста может выполняться на ранней или поздней стадии процесса фильтрации текста WordPress (по умолчанию она выполняется раньше).

- Замену текста можно расширить, чтобы повлиять на другие фильтры.

Несколько вещей, которые следует иметь в виду:

- Лучше всего при определении ярлыков определить что-то, что иначе никогда бы не появилось в вашем тексте. Например, завершите ярлык двоеточиями:

:wp: => WordPress

:aol: => America Online, Inc.

В противном случае вы рискуете сделать правильные, но нежелательные замены:

Привет => Привет

Приведёт к изменению "Его величества" на "Привет величество".

- Если вы собираетесь использовать этот плагин для обработки смайлов, вам, вероятно, следует отключить обработчик смайлов WordPress по умолчанию на странице администрирования "Настройки записи".

- Этот плагин настроен на фильтрацию "the_content", "the_excerpt", "widget_text" и, при необходимости, "get_comment_text" и "get_comment_excerpt". Фильтры из популярных плагинов, таких как Advanced Custom Fields (ACF) и Elementor, также обрабатываются по умолчанию (подробности см. в разделе "Часто задаваемые вопросы"). Параметр "Больше фильтров" можно использовать для указания дополнительных фильтров, которые должен обрабатывать плагин. Фильтр "c2c_text_replace_filters" также можно использовать для добавления или изменения списка затронутых фильтров.

- Текст внутри тегов HTML (например, имена и атрибуты тегов) не будет сопоставлен. Так, например, вы не можете ожидать, что ярлык :mycss: будет работать в <a href="" style=":mycss:">тексте</a>.

- ОСОБОЕ ВНИМАНИЕ: имейте в виду, что текст ярлыка, который вы используете в своих сообщениях, будет храниться в базе данных таким образом. В то время как вызовы для отображения сообщений будут видеть отфильтрованную версию с заменой текста, все, что работает непосредственно с базой данных, не увидит расширенный текст замены. Таким образом, если вы когда-либо называли "America Online" только ":aol:" (где :aol: => <a href="http://www.aol.com">America Online</a>), посетители вашего сайта увидят связанный расширенный текст из-за замены текста, но поиск в базе данных никогда не выдаст совпадение с "America Online".

- Однако преимущество того, что текст замены не сохраняется в базе данных, а вместо этого оценивается при загрузке данных на веб-страницу, заключается в том, что если текст замены будет изменен, все страницы, использующие ярлык, отныне будут использовать обновленный текст замены.

Ссылки: Домашняя страница плагина | Страница каталога плагинов | Гитхаб | Домашняя страница автора

Документация разработчика

Документацию разработчика можно найти в DEVELOPER-DOCS.md. В этой документации описаны многочисленные перехватчики, предоставляемые плагином. Эти крючки перечислены ниже, чтобы дать представление о том, что доступно.

- c2c_text_replace_filters: настройте, к каким хукам применяется замена текста.

- c2c_text_replace_ Third_party_filters: настройте, какие сторонние перехватчики будут применять к ним замену текста.

- c2c_text_replace_filter_priority: переопределить приоритет по умолчанию для фильтра "c2c_text_replace".

- c2c_text_replace Настройте или переопределите параметр, определяющий все ярлыки замены текста и их замены.

- c2c_text_replace_comments: настройте или переопределите параметр, указывающий, следует ли включать замену текста в комментариях.

- c2c_text_replace_case_sensitivity: настройте или переопределите параметр, указывающий, должна ли замена текста учитывать регистр.

- c2c_text_replace_once: настройте или переопределите параметр, указывающий, должна ли замена текста быть ограничена одним разом для каждого термина для каждого обрабатываемого фрагмента текста, независимо от того, сколько раз этот термин появляется.