JVM Gutenberg Rich Text Icons v1.3.7

Плагин/набор инструментов для тех, кто хочет интегрировать значки (SVG) в редактор Gutenberg или параметры, созданные с помощью расширенных настраиваемых полей.

Добавляйте встроенные значки в поля форматированного текста, такие как абзацы, заголовки, списки или кнопки, в любом месте редактора блоков WordPress или добавьте специальный блок значков из редактора Gutenberg.

Этот плагин поставляется с бесплатным набором значков Font Awesome в качестве набора значков по умолчанию. Вы можете выбирать между версией 4.x, 5.x и версией 6.x.

Специальный блок значков содержит несколько вариантов стиля для настройки значка в блоке значков.

Плагин также предоставляет простой в использовании интерфейс для создания собственного набора значков на основе значков SVG. Пользовательские значки можно загрузить из настроек плагина с помощью простого в использовании средства загрузки с помощью перетаскивания.

Для пользователей расширенных настраиваемых полей (ACF) плагин также создает новый тип поля: значок JVM. Это позволяет вам создавать настраиваемые поля, которые работают со значком шрифта awsome или любым пользовательским набором значков.

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

Плагин просто вставляет значки в следующем формате HTML:

<i class="icon fa fa-address-book" aria-hidden="true"> </i>

Имена классов CSS и доступные значки можно изменить по своему вкусу, если вы готовы написать несколько PHP-хуков для своей темы WordPress. Обратите внимание, что вам следует оставить настройки плагина для использования "Font Awesome 4.7".

Если вы хотите загрузить созданный вами самостоятельно веб-шрифт или набор значков, пожалуйста, читайте дальше. Если у вас есть файлы SVG, вы можете установить в настройках плагина "Пользовательский набор значков SVG" и загрузить файлы SVG из настроек плагина.

CSS-файл

Слегка модифицированная версия CSS-файла Font Awesome 4.7 по умолчанию загружается во внешний и внутренний интерфейсы, чтобы плагин работал сразу из коробки, но вы также можете выбрать бесплатную версию Font Awesome 5.x или 6.x на экране настроек.

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

Файл пользовательского набора значков

Если для плагина установлен набор значков Font Awesome 4.7 (поведение по умолчанию), значки загружаются из: wp-content/plugins/jvm-richtext-insert-icons/dist/fa-4.7/icons.json. Файл json содержит все классы CSS, которые можно превратить в значки с помощью CSS-файла Font Awesome 4.7. Вы можете загрузить собственный файл набора значков JSON, вызвав фильтр в вашей (дочерней) теме Functions.php.

Например:

функция add_my_icons($file) {
$file = get_stylesheet_directory()."/path_to_my/icons.json";
вернуть $файл;
}

add_filter("jvm_richtext_icons_iconset_file", "add_my_icons");

Файл конфигурации значков также может быть в формате Fontello, начиная с версии 1.0.3. Посетите https://fontello.com, чтобы создать собственный набор значков.

Пользовательский CSS-файл

По умолчанию CSS Font Awesome 4.7 загружается из: wp-content/plugins/jvm-richtext-insert-icons/dist/fa-4.7/font-awesome.min.css. Вы можете загрузить собственный CSS-файл для вашего набора значков, вызвав фильтр в файле function.php вашей (дочерней) темы.

Например:

функция add_my_css($cssfile) {
$cssfile = get_stylesheet_directory_uri()."/path_to_my/cssfile.css";
вернуть $cssfile;
}

add_filter("jvm_richtext_icons_css_file", "add_my_css");

Если вы выбрали загрузку собственного файла CSS и хотите отключить файл CSS по умолчанию, используйте следующий код:

add_filter("jvm_richtext_icons_css_file", "__return_false");

Вся разметка значков имеет префикс имени класса "icon" перед вставленным HTML-кодом значка. Если вы хотите использовать другой префикс, вы можете добавить фильтр. Вот так:

функция my_icon_class($css_class_name) {
return "my-custom-css-имя-класса";
}

add_filter("jvm_richtext_icons_base_class", "my_icon_class");

Используйте этот хук, чтобы отключить весь экран настроек плагина, который был добавлен в версии 1.0.9:

add_filter("jvm_richtext_icons_show_settings", "__return_false");

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