WP Subtitle v3.4.1

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

Субтитры можно вставить в файлы шаблонов вашей темы (или плагин) с помощью следующего API:

Показать субтитры

Все параметры являются необязательными. Если "post_id" опущен, то используется текущий идентификатор сообщения в цикле.

PHP-код:

do_action( "плагины/wp_subtitle/the_subtitle", массив(
"before" => "<p class="subtitle">",
"после" => "</p>",
"post_id" => get_the_ID(),
"значение_по умолчанию" => ""
) );

Выход:

<p class="subtitle">Подзаголовок моего сообщения</p>

Получите субтитры

Все параметры являются необязательными. Если "post_id" опущен, то используется текущий идентификатор сообщения в цикле.

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

PHP-код:

$subtitle = apply_filters( "plugins/wp_subtitle/get_subtitle", "", array(
"before" => "<p class="subtitle">",
"после" => "</p>",
"post_id" => get_the_ID()
) );

Результат:

$subtitle = "<p class="subtitle">Подзаголовок моего сообщения</p>"

Параметры

Массив аргументов, принимаемых для действия плагинов/wp_subtitle/the_subtitle и фильтра плагинов/wp_subtitle/get_subtitle:

раньше

(строка) Текст для размещения перед субтитром, если он существует. По умолчанию пустая строка.

после

(строка) Текст для размещения после подзаголовка, если он существует. По умолчанию - пустая строка.

post_id

(целое число) Идентификатор типа записи, страницы или пользовательского типа записи.

значение по умолчанию

(строка) Используется только действием плагинов/wp_subtitle/the_subtitle. Позволяет указать субтитр по умолчанию, который будет отображаться, если в сообщении его нет. Для фильтра плагинов/wp_subtitle/get_subtitle вместо этого следует использовать второй параметр apply_filters. По умолчанию - пустая строка.

Поддержка типов сообщений

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

add_post_type_support("my_post_type", "wps_subtitle")

Поддержка плагинов WooCommerce

Субтитры можно автоматически добавлять в ваши продукты WooCommerce без необходимости внесения изменений в шаблон. В панели администратора перейдите в WooCommerce > Настройки > Продукты, где вы можете выбрать:

- Включить субтитры продуктов.

- Показывать подзаголовок на страницах отдельных товаров.

- Отображать подзаголовок в архивах продуктов (страницах категорий).

Поддержка плагинов Yoast SEO и SEOPress

Плагин позволяет включать подзаголовок в ваши мета-заголовки и описания с помощью плагинов Yoast SEO и SEOPress.

Подобно заполнителю Yoast %%title%%, который вставляет заголовок сообщения, вы можете использовать %%wps_subtitle%%.

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

Для получения дополнительной информации просмотрите документацию по поддержке SEO здесь.