FSM Custom Featured Image Caption v1.25.1

Этот плагин позволяет добавлять собственные подписи к избранным изображениям сообщений. Он работает как с Гутенбергом, так и с классическим редактором.

Вот как это работает:

- Если заголовок не указан, плагин отобразит общий заголовок, определенный в медиатеке.

- Если заголовок указан, плагин будет отображать этот заголовок вместо общего заголовка, определенного в Медиа-библиотеке.

- Если заголовок не указан и в Медиатеке нет легенды, она не будет отображаться (очевидно).

Плагин также позволяет:

- Скрыть подпись: оригинал из Медиа-библиотеки или собственный.

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

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

- Вывод текста подписи в любом месте вашей темы с помощью пользовательской функции.

- Выведите изображение с подписью внутри вашего контента с помощью короткого кода.

Для поддержания семантического кода этот плагин записывает заголовок в метку <figcaption>.

Новое в версии 1.21: совместимость с темами Divi. Это экспериментальная функция, позволяющая плагину работать с Divi, как просили многие пользователи. Обратите внимание, что он может работать не для всех макетов и что, поскольку он заменяет функцию, которую divi использует для отображения избранных изображений, при включении он потенциально может вызвать проблемы с более старыми версиями Divi или при обновлении основной темы. Как всегда, может потребоваться добавить в вашу тему собственный CSS, чтобы подписи отображались так, как вы хотите.

Формат

Заголовок будет иметь формат, указанный для элемента <figcaption> и CSS-класса wp-caption-text, который распространен в темах WordPress.

Использование

Плагин работает "из коробки". Чтобы начать его использовать, все, что вам нужно сделать, это активировать его и поиграть с новыми параметрами на странице редактирования. Для продвинутых пользователей вас ждет специальная страница настроек для тонкой настройки некоторых деталей.

Перейдите в "Настройки" > "Подпись к особому изображению FSM", чтобы настроить параметры CSS и HTML:

- CSS для текста подписи: выберите один из вариантов, чтобы изменить класс/стили, которые будут использоваться в контейнере подписи (по умолчанию - wp-caption-text). Обратите внимание, что вы можете указать более одного класса, разделенных пробелами.

- Разрешить код HTML: установите этот флажок, если вы хотите анализировать текст заголовка как HTML, если вам нужно, чтобы браузер анализировал теги HTML, а не отображал их. Имейте в виду, что неправильный HTML-код или потерянные теги могут нарушить ваш макет.

- Разрешить короткие коды: установите этот флажок, если хотите анализировать короткие коды, присутствующие в тексте подписи. Обратите внимание: если шорткод возвращает HTML, он не будет фильтроваться, независимо от состояния опции "разрешить HTML-код"; Кроме того, вывод сложных коротких кодов может изменить ваш макет. После активации вы можете написать короткий код, который хотите использовать, в поле заголовка обычным способом, например: Венецианский пейзаж [myshortcode option1="text"]

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

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

Шорткод

Мы добавили шорткод, который позволяет вам разместить изображение (и его подпись) на вашей странице. Просто напишите [FSM_featured_image] в любом месте поля редактирования контента вашего сообщения или страницы, чтобы отобразить его. Вы также можете выбрать размер изображения с помощью параметра "размер". Обратите внимание, что определенные размеры изображений могут различаться в разных темах WordPress. По умолчанию: миниатюра, средний, средний_большой, большой и полный.

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

Обратите внимание, что использование шорткода не связано с опцией "Разрешить шорткоды" на странице настроек.

Пример использования: [FSM_featured_image size=thumb]

Для разработчиков

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

После активации плагина используйте <?php get_FSM_featured_image_caption()?>, чтобы вернуть строку, содержащую текст, который вы можете присвоить переменной, или <?php the_FSM_featured_image_caption()?>, где вы хотите, чтобы отображалась подпись.

Обе функции принимают параметры, передаваемые внутри массива со следующими ключами:

- тег: тег (без скобок), который вы хотите использовать в качестве контейнера. По умолчанию это div. Если установлено значение false, он удалит его и вернет текст заголовка.

- class: имя класса/классов, которые вы хотите использовать для контейнера. Используйте пробелы, чтобы разделить их. По умолчанию пусто.

- стиль: стили CSS, которые будут использоваться в