內容簡介
這款外掛可使用 PHP、小工具或短代碼在您的部落格中顯示 RSS 資訊。此外掛僅使用 WordPress 標準功能，因此不需要外部庫。對於較舊版本的 WordPress，使用內建的MagpieRSS 函式庫。對於 WordPress 2.8 及更新版本，有一個設置可用於啟用內建的SimplePie 函式庫以解析 RSS 資訊。
與您發佈的所有其他內容一樣，請確保您有權 (重新)發佈您將要匯入的 RSS 資訊內容！
您可以將以下代碼插入到 PHP 外掛中或模版，例如 sidebar.php 或 single.php：
範例：
<?php RSSImport(10, ‘https://bueltge.de/feed/’); ?>
這是使用該外掛所需的最小代碼。 外掛可接受許多參數，以自訂匯入的資訊。 可在下方查看完整的參數列表。 您也可以在文章和頁面中使用短代碼的任何參數。
短代碼範例：
[RSSImport display=”5″ feedurl=”https://bueltge.de/feed/” use_simplepie=”true”]
對於所有 (bool) 參數，您可以使用字符串 true 和false 或整數值 1 和0。
display – 顯示的項目數。預設為 5。
feedurl – RSS 位址。預設為 https://bueltge.de/feed/。
before_desc – 描述前插入的 HTML 或字串。預設為empty。您可以使用一些變數進行替換，請參閱下文。
displaydescriptions – (bool) 設定為 true 時會顯示每個項目的描述。預設為false。
after_desc – 描述後插入的 HTML 或字串。預設為empty。您可以使用一些變數進行替換，請參閱下文。
html – (bool) 設定為 true 時，描述中可以包含 HTML 標記。預設為false。
truncatedescchar – 允許在描述中使用的最大字元數。如果描述長度超過此長度，則截斷至指定的長度。預設為 200，將值設置為空引號 ''則不截斷描述。
truncatedescstring – 在描述被截斷後插入的 HTML 或字串。預設為...
truncatetitlechar – 允許在標題中使用的最大字元數。如果標題超過此值，則將其截斷為指定的長度。預設為''，表示不截斷標題。
truncatetitlestring – 在標題被截斷後插入的 HTML 或字串。預設為 '...'。
before_date – 日期前插入的 HTML 或字串。預設為<small>。
date – (bool) 設定為 true 時會顯示項目的日期。預設為 false。
after_date – 描述後插入的 HTML 或字串。預設為</small>。
date_format – 日期格式字符串。留空以使用 WordPress 安裝的格式。如果需要不同的日期格式，請指定 PHP 日期字符串，例如：F j, Y。參見格式化日期和時間。
外掛標籤
開發者團隊
📦 歷史版本下載
原文外掛簡介
Display feeds in your blog, using PHP, a Widget or Shortcode. The plugin uses only standard WordPress functionality, so no external libraries are required. For older versions of WordPress, the built-in MagpieRSS library is used. For WordPress 2.8 and newer, there is a setting available to enable the built-in SimplePie library for parsing feeds.
As with all other content you publish, make sure you are allowed to (re-)publish the content of the feeds you are about to import!
You can insert the following code into a PHP plugin or in a template, for example sidebar.php or single.php:
Example:
This is the minimal code needed for using the plugin. The plugin accepts a number of parameters for customizing the feed content import. See below for the full list of available parameters. You can also use any of the parameters with Shortcode in posts and pages.
Example Shortcode:
[RSSImport display=”5″ feedurl=”https://bueltge.de/feed/” use_simplepie=”true”]
For all (bool) parameters you can either use the strings true and false or the integer values 1 and 0.
display – The number of items to display. Default is 5.
feedurl – The feed address. Default is https://bueltge.de/feed/.
before_desc – The HTML or string to insert before the description. Default is empty. You can use some variables which will be replaced, see below.
displaydescriptions – (bool) When set to true, the description for each entry will be displayed. Default is false.
after_desc – The HTML or string to insert after the description. Default is empty. You can use some variables which will be replaced, see below.
html – (bool) When set to true, the description can include HTML tags. Default is false.
truncatedescchar – The maximum number of characters allowed in descriptions. If the description is longer than this length, it will be truncated to the given length. Default is 200, set the value to empty quotes '' to never truncate descriptions.
truncatedescstring – The HTML or string to insert at the end of a description after it has been truncated. Default is ...
truncatetitlechar – The maximum number of characters allowed in titles. If the title is longer than this value, it will be truncated to the given length. Default is '', which means never truncate titles.
truncatetitlestring – The HTML or string to insert at the end of a title after it has been truncated. Default is ' ... '.
before_date – The HTML or string to insert before the date. Default is .
date – (bool) If true, display the date of the item. Default is false.
after_date – The HTML or string to insert after the date. Default is .
date_format– The date format string. Leave empty to use the format of your WordPress installation. If a different date format is desired, specify a PHP date string, for example: F j, Y. See also the date and time formatting page in the WordPress Codex.
before_creator – The HTML or string to insert before the creator of the item. Default is .
creator – (bool) If true, display the creator of the item. Default is false.
after_creator – The HTML or string to insert after creator of the item. Default is .
start_items – The HTML or string to insert before the list of items. Default is
- .
end_items – The HTML or string to insert after the list of items. Default is
.
start_item – The HTML or string to insert before each item. Default is
end_item – The HTML or string to insert after each item. Default is
. You can use some variables which will be replaced, see below.
target – The string to use for the target attribute on links. Default is empty. Valid options are blank, self, parent, top.
rel – The string to use for the rel attribute on links. Default is empty. Valid options are nofollow and follow.
desc4title – The description to use in the title attribute on item title links. Default is false.
charsetscan – (bool) If true, scan the feed content for the correct character set. This may cause the content to load more slowly. Use this option if you’re having problems with feed content being displayed with stranged characters. Default is false.
debug – (bool) If true, activate debug-mode, which will echo the Magpie object as an array. Default is false. Only use this option for debugging.
before_noitems – The HTML or string to insert before the no items message. Default is
.
noitems– The message to display when the feed is empty. Default is No items, feed is empty..
after_noitems – The HTML or string to insert before the no items message. Default is
.
before_error – The HTML or string to insert before the error message. Default is
.
error – Error message displayed when there is an error loading or displaying the feed. Default is Error: Feed has an error or is not valid.
after_error – The HTML or string to insert before the error message. Default is
.
paging – (bool) If true, enable pagination. Default is false.
prev_paging_link – The name of the previous page link. Default is « Previous.
next_paging_link – The name next page link. Default is Next ».
prev_paging_title – The title attribute of the previous page link. Default is more items.
next_paging_title – The title attribute of the next page link. Default is more items.
use_simplepie – (bool) If true, use SimplePie to parse the feed. SimplePie is included in WordPress 2.8 and newer and can parse both RSS and ATOM feeds. Default is false if used with Shortcode, true if used with the PHP function.
view – (bool) If true, calling the RSSImport() function will print the rendered HTML directly to the output. If false, the rendered HTML will be returned by the function as a string value and nothing will be output. Default when using PHP code is true. Default when using Shortcode is false.
random_sort – (bool) If true, Items will be displayed in random order. Default when using Shortcode is false.
order – (string) Order of the filds Date, Title, Creator, Description. Use a comma separated string for your order. Default is date,title,creator,description
The parameters before_desc, after_desc, start_item and end_item accepts the following variables which will be replaced:
%title% for the title of the entry
%href% for the entry’s URL
%picture_url% for the URL of a thumbnail image for the entry if available. To use this variable, SimplePie is required to be enabled (use_simplepie="true")
If pagination is enabled, it adds a div with the class rsspaging to enable easier styling with CSS. You can also style the previous and next links, which have the classes: rsspaging_prev and rsspaging_next.
You can use any of the parameters in the php function RSSImport() in your templates or with the Shortcode [RSSImport] in posts and pages.
Examples
Using the PHP function with many parameters:
RSSImport(
$display = 5, $feedurl = 'https://bueltge.de/feed/',
$before_desc = '', $displaydescriptions = false, $after_desc = '', $html = false, $truncatedescchar = 200, $truncatedescstring = ' ... ',
$truncatetitlechar = '', $truncatetitlestring = ' ... ',
$before_date = ' ', $date = false, $after_date = '',
$before_creator = ' ', $creator = false, $after_creator = '',
$start_items = '
- ', $end_items = '
',
$start_item = '
'
);
Please note that for the PHP function the parameters are expected in the order in which they are defined in the above list. Thus if you skip one parameter, you will also have to skip all of the subsequent parameters.
Using Shortcode with several parameters:
[RSSImport display="10" feedurl="https://your_feed_url/"
displaydescriptions="true" html="true"
start_items="
- " end_items="
" paging="true" use_simplepie="true"]
Add a “more” link to the output:
RSSImport(
$display = 5,
$feedurl = 'https://bueltge.de/feed/',
$before_desc = '',
$displaydescriptions = true,
$after_desc = ' show more'
);
or
[RSSImport feedurl="https://wordpress.org/news/feed/" after_desc=" show more" displaydescriptions="true" use_simplepie="true"]
Enable Thumbnail Pictures:
RSSImport(
$display = 5,
$feedurl = 'https://bueltge.de/feed/',
$before_desc = '',
$displaydescriptions = true
);
or
[RSSImport feedurl="https://wordpress.org/news/feed/" displaydescriptions="true" before_desc="
" use_simplepie="true"]
Acknowledgements
Thanks to Dave Wolf for the idea, to Thomas Fischer and Gunnar Tillmann for better code and Ilya Shindyapin, http://skookum.com for the idea and solution of pagination.
License
Good news, this plugin is free for everyone! Since it’s released under the GPL, you can use it free of charge on your personal or commercial blog. But if you enjoy this plugin, you can thank me by leaving a small donation for the time I’ve spent writing and supporting this plugin. And I really don’t want to know how many hours of my life this plugin has already eaten 😉
Translations
The plugin comes with various translations, please refer to the WordPress Codex for more information about activating the translation. Please helpt to translate or improve the translations of this plugin.
