get_rss()
云策文档标注
概述
get_rss() 函数用于在 HTML 列表项中显示 RSS 项目，需指定列表类型和显示数量，不支持自动检测 feed URL。
关键要点
- 函数用于显示 RSS 项目，需预先指定有序或无序 HTML 列表类型。
- 必须指定显示的项目数量，不能像 wp_rss() 那样显示所有项目。
- 参数 $url 为必需，表示要显示的 feed URL；$num_items 为可选，默认显示 5 个项目。
- 失败时返回 false。
代码示例
function get_rss ($url, $num_items = 5) {
$rss = fetch_rss($url);
if ( $rss ) {
$rss->items = array_slice($rss->items, 0, $num_items);
foreach ( (array) $rss->items as $item ) {
echo "<li>";
echo esc_html($item['title']);
echo "</li>";
}
} else {
return false;
}
}注意事项
- 使用前需确保已指定 HTML 列表类型（如 <ul> 或 <ol>）。
- 依赖 fetch_rss() 函数构建 Magpie 对象，esc_html() 函数进行 HTML 转义。
- 自 WordPress 1.5.0 版本引入。
原文内容
Display RSS items in HTML list items.
Description
You have to specify which HTML list you want, either ordered or unordered before using the function. You also have to specify how many items you wish to display. You can’t display all of them like you can with wp_rss() function.
Parameters
$urlstringrequired-
URL of feed to display. Will not auto sense feed URL.
$num_itemsintoptional-
Number of items to display, default is all.
Default:
5
Source
function get_rss ($url, $num_items = 5) { // Like get posts, but for RSS
$rss = fetch_rss($url);
if ( $rss ) {
$rss->items = array_slice($rss->items, 0, $num_items);
foreach ( (array) $rss->items as $item ) {
echo "<li>n";
echo "<a href='$item[link]' title='$item[description]'>";
echo esc_html($item['title']);
echo "</a><br />n";
echo "</li>n";
}
} else {
return false;
}
}
Changelog
| Version | Description |
|---|---|
| 1.5.0 | Introduced. |