Функция WordPress: wp_widget_rss_output()

Функция wp_widget_rss_output() в WordPress используется для отображения элементов RSS-лент в виджетах. Она позволяет разработчикам загружать и отображать контент RSS-лент с указанного URL, а также настраивать вывод в виджетах WordPress. Эта функция особенно полезна для демонстрации обновляемого внешнего контента, например, новостных лент или блогов.

wp_widget_rss_output( string|array|object $rss, array $args = array() )

Параметры

1. $rss (string|array|object, обязателен): URL или объект/массив с RSS-лентой.
2. $args (array, необязателен): Параметры для настройки отображения виджета RSS.
   • url (string): URL RSS-ленты.
   • title (string): Заголовок для виджета.
   • items (int): Количество элементов для отображения.
   • show_summary (bool): Отображать ли описание каждого элемента. По умолчанию: false.
   • show_author (bool): Отображать ли автора каждого элемента. По умолчанию: false.
   • show_date (bool): Отображать ли дату каждого элемента. По умолчанию: false.
   • before_item (string): HTML-код перед каждым элементом.
   • after_item (string): HTML-код после каждого элемента.

Пример 1: Отображение базовой RSS-ленты

В этом примере мы указываем только URL ленты и задаем заголовок для виджета.

$args = array(
    'url'   => 'https://samplefeed.com/rss',
    'title' => 'Последние обновления'
);
wp_widget_rss_output( $args );

Пример 2: Настройка количества отображаемых элементов

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

$args = array(
    'url'   => 'https://example.com/feed',
    'title' => 'Новости',
    'items' => 3  // Отобразить только 3 элемента
);
wp_widget_rss_output( $args );

Пример 3: Отображение описания и даты публикации

Этот пример показывает, как включить отображение описания (show_summary) и даты публикации (show_date) для каждого элемента.

$args = array(
    'url'          => 'https://example.com/feed',
    'title'        => 'Обновления блога',
    'items'        => 5,
    'show_summary' => true,
    'show_date'    => true
);
wp_widget_rss_output( $args );

Пример 4: Добавление пользовательской разметки для каждого элемента

В этом примере мы добавляем HTML-код до и после каждого элемента, используя параметры before_item и after_item.

$args = array(
    'url'         => 'https://example.com/feed',
    'title'       => 'Статьи по теме',
    'items'       => 4,
    'before_item' => '<div class="rss-item">',
    'after_item'  => '</div>'
);
wp_widget_rss_output( $args );

Пример 5: Включение имени автора

Чтобы показать автора каждого элемента, можно установить параметр show_author в значение true.

$args = array(
    'url'         => 'https://example.com/feed',
    'title'       => 'Новости с автором',
    'items'       => 3,
    'show_author' => true
);
wp_widget_rss_output( $args );

Пример 6: Стилизация виджета с помощью CSS-классов

Для стилизации виджета можно добавить параметр css_class, который позволяет задать CSS-класс для всего виджета.

$args = array(
    'url'        => 'https://example.com/feed',
    'title'      => 'Новости технологий',
    'css_class'  => 'custom-rss-widget'
);
wp_widget_rss_output( $args );

Заключение

Функция wp_widget_rss_output() предоставляет мощные инструменты для отображения RSS-лент в виджетах WordPress. Она позволяет гибко настраивать вывод, включая или отключая описание, дату, автора и другие элементы. С помощью этой функции можно добавить обновляемый контент на сайт WordPress, что поможет улучшить взаимодействие с пользователями и предоставить им актуальную информацию.