RSS Feed Pro

Ìgbéwọlẹ̀

1. Upload the plugin files to the ‘/wp-content/plugins/plugin-name’ directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the ‘Plugins’ screen in WordPress.
3. Access the ‘Admin Panel > RSS Shortcodes’ to create any shortcode you might need. We suggest Sort by Author, Sort by Category, Sort by Year.

You can insert the following code into a PHP plugin or in a template, for example sidebar.php or single.php:

Example: <?php rssfp_import(10, ‘https://yourdomain.com/feed/’); ?>

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Ìtumọ̀ Yorùbá: ″ feedurl=”https://yourdomain.com/feed/” use_simplepie=”true”]

For all (bool) parameters you can either use the strings true and false or the integer values 1 and 0.

1. display Ìtumọ̀ Yorùbá: – The number of items to display. Default is 5.
2. feedurl Ìtumọ̀ Yorùbá: – The feed address. Default is https://yourdomain.com/feed/.
3. before_desc Ìtumọ̀ Yorùbá: – The HTML or string to insert before the description. Default is empty. You can use some variables which will be replaced, see below.
4. displaydescriptions Ìtumọ̀ Yorùbá: – (bool) When set to true, the description for each entry will be displayed. Default is false.
5. after_desc Ìtumọ̀ Yorùbá: – The HTML or string to insert after the description. Default is empty. You can use some variables which will be replaced, see below.
6. html Ìtumọ̀ Yorùbá: – (bool) When set to true, the description can include HTML tags. Default is false.
7. truncatedescchar Ìtumọ̀ Yorùbá: – 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.
8. truncatedescstring Ìtumọ̀ Yorùbá: – The HTML or string to insert at the end of a description after it has been truncated. Default is ...
9. truncatetitlechar Ìtumọ̀ Yorùbá: – 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.
10. truncatetitlestring Ìtumọ̀ Yorùbá: – The HTML or string to insert at the end of a title after it has been truncated. Default is ' ... '.
11. before_date Ìtumọ̀ Yorùbá: – The HTML or string to insert before the date. Default is <small>.
12. date Ìtumọ̀ Yorùbá: – (bool) If true, display the date of the item. Default is false.
13. after_date Ìtumọ̀ Yorùbá: – The HTML or string to insert after the date. Default is </small>.
14. date_formatÌtumọ̀ Yorùbá: – 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.
15. before_creator Ìtumọ̀ Yorùbá: – The HTML or string to insert before the creator of the item. Default is <small>.
16. creator Ìtumọ̀ Yorùbá: – (bool) If true, display the creator of the item. Default is false.
17. after_creator Ìtumọ̀ Yorùbá: – The HTML or string to insert after creator of the item. Default is </small>.
18. start_items Ìtumọ̀ Yorùbá: – The HTML or string to insert before the list of items. Default is <ul>.
19. end_items Ìtumọ̀ Yorùbá: – The HTML or string to insert after the list of items. Default is </ul>.
20. start_item Ìtumọ̀ Yorùbá: – The HTML or string to insert before each item. Default is <li>. You can use some variables which will be replaced, see below.
21. end_item Ìtumọ̀ Yorùbá: – The HTML or string to insert after each item. Default is </li>. You can use some variables which will be replaced, see below.
22. target Ìtumọ̀ Yorùbá: – The string to use for the target attribute on links. Default is empty. Valid options are blank, self, parent, top.
23. rel Ìtumọ̀ Yorùbá: – The string to use for the rel attribute on links. Default is empty. Valid options are nofollow and follow.
24. desc4title Ìtumọ̀ Yorùbá: – The description to use in the title attribute on item title links. Default is false.
25. charsetscan Ìtumọ̀ Yorùbá: – (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Ìtumọ̀ Yorùbá: ’re having problems with feed content being displayed with stranged characters. Default is false.
26. debug Ìtumọ̀ Yorùbá: – (bool) If true, activate debug-mode, which will echo the Magpie object as an array. Default is false. Only use this option for debugging.
27. before_noitems Ìtumọ̀ Yorùbá: – The HTML or string to insert before the no items message. Default is <p>.
28. noitemsÌtumọ̀ Yorùbá: – The message to display when the feed is empty. Default is No items, feed is empty..
29. after_noitems Ìtumọ̀ Yorùbá: – The HTML or string to insert before the no items message. Default is </p>.
30. before_error Ìtumọ̀ Yorùbá: – The HTML or string to insert before the error message. Default is <p>.
31. error Ìtumọ̀ Yorùbá: – Error message displayed when there is an error loading or displaying the feed. Default is Error: Feed has an error or is not valid.
32. after_error Ìtumọ̀ Yorùbá: – The HTML or string to insert before the error message. Default is </p>.
33. paging Ìtumọ̀ Yorùbá: – (bool) If true, enable pagination. Default is false.
34. prev_paging_link Ìtumọ̀ Yorùbá: – The name of the previous page link. Default is « Previous.
35. next_paging_link Ìtumọ̀ Yorùbá: – The name next page link. Default is Next ».
36. prev_paging_title Ìtumọ̀ Yorùbá: – The title attribute of the previous page link. Default is more items.
37. next_paging_title Ìtumọ̀ Yorùbá: – The title attribute of the next page link. Default is more items.
38. use_simplepie Ìtumọ̀ Yorùbá: – (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.
39. view Ìtumọ̀ Yorùbá: – (bool) If true, calling the rssfp_import() 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.
40. random_sort Ìtumọ̀ Yorùbá: – (bool) If true, Items will be displayed in random order. Default when using Shortcode is false.
41. order Ìtumọ̀ Yorùbá: – (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:

1. %title% for the title of the entry
2. %href% for the entryÌtumọ̀ Yorùbá: ’s URL
3. %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 rssfp_import in your templates or with the Shortcode [RSSImport] in posts and pages.

Examples

Using the PHP function with many parameters:

rssfp_import(
    $display = 5, $feedurl = 'https://bueltge.de/feed/', 
    $before_desc = '', $displaydescriptions = false, $after_desc = '', $html = false, $truncatedescchar = 200, $truncatedescstring = ' ... ', 
    $truncatetitlechar = '', $truncatetitlestring = ' ... ', 
    $before_date = ' <small>', $date = false, $after_date = '</small>', 
    $before_creator = ' <small>', $creator = false, $after_creator = '</small>', 
    $start_items = '<ul>', $end_items = '</ul>', 
    $start_item = '<li>', $end_item = '</li>'
);

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="<ol>" end_items="</ol>" paging="true" use_simplepie="true"]

Add a “more” link to the output:

rssfp_import(
    $display = 5,
    $feedurl = 'https://yourdomain.com/feed/', 
    $before_desc = '',
    $displaydescriptions = true,
    $after_desc = ' <a href="%href%" target="_blank">show more</a>'
);

or

[RSSImport feedurl="https://wordpress.org/news/feed/" after_desc=" <a href='%href%' target='_blank'>show more</a>" displaydescriptions="true" use_simplepie="true"]

Enable Thumbnail Pictures:

rssfp_import(
    $display = 5,
    $feedurl = 'https://bueltge.de/feed/',
    $before_desc = '<img src="%picture_url%" alt="">',
    $displaydescriptions = true
);

or

[RSSImport feedurl="https://wordpress.org/news/feed/" displaydescriptions="true" before_desc="<div><img src='%picture_url%' width='50px' alt='' style='float:left;' />" after_desc="</div>" use_simplepie="true"]