| 1 |
=== Super RSS Reader - Add attractive RSS Feed Widget === |
| 2 |
Contributors: vaakash |
| 3 |
Author URI: https://www.aakashweb.com/ |
| 4 |
Plugin URI: https://www.aakashweb.com/wordpress-plugins/super-rss-reader/ |
| 5 |
Tags: rss, feeds, widget, ticker, feed, twitter, admin, plugin, posts, page, thumbnail, atom, news |
| 6 |
License: GPLv2 or later |
| 7 |
Donate Link: https://www.paypal.me/vaakash |
| 8 |
Requires at least: 2.8 |
| 9 |
Requires PHP: 5.3 |
| 10 |
Tested up to: 5.4 |
| 11 |
Stable tag: 3.1 |
| 12 |
|
| 13 |
A plugin to display RSS feed(s) in widget with news ticker effect in multiple tabbed feeds, thumbnails, customizable color themes and more. |
| 14 |
|
| 15 |
== Description == |
| 16 |
|
| 17 |
Super RSS Reader is a RSS reader widget which displays the RSS feeds in an attractive way. It displays the multiple RSS feeds and adds a news ticker like effect to them. Multiple RSS feeds can be added to a single widget in separate tabs. |
| 18 |
|
| 19 |
The plugin is fully customizable with external styles and with some inbuilt color styles. It acts as a perfect replacement for the default RSS widget in WordPress. |
| 20 |
|
| 21 |
[Check out the **LIVE DEMO** of the plugin](https://www.aakashweb.com/demos/super-rss-reader/) |
| 22 |
|
| 23 |
= Features = |
| 24 |
|
| 25 |
* **News ticker** like effect to the RSS feeds (can turn off or on) |
| 26 |
* Display feeds in **multiple tabs** |
| 27 |
* Display **thumbnail** to the feed items if available. |
| 28 |
* Select **color themes** for widget. Customizable via CSS. |
| 29 |
* Customizable ticker speed. |
| 30 |
* Supports RSS or atom feed. |
| 31 |
* Can strip title and description text of the feed item. |
| 32 |
|
| 33 |
[youtube=https://www.youtube.com/watch?v=02aOG_-98Tg] |
| 34 |
|
| 35 |
= Resources = |
| 36 |
|
| 37 |
* [FAQs](https://www.aakashweb.com/docs/super-rss-reader-doc/faq/) |
| 38 |
* [Support forum](https://www.aakashweb.com/forum/discuss/wordpress-plugins/super-rss-reader/) |
| 39 |
|
| 40 |
== Installation == |
| 41 |
|
| 42 |
Download and upload the latest version of Super RSS Reader, |
| 43 |
|
| 44 |
1. Unzip & upload it to your WordPress site. |
| 45 |
1. Activate the plugin. |
| 46 |
1. Drag and drop the "Super RSS Reader" widget in the "Widgets" page. |
| 47 |
1. Input a RSS feed URL to the widget, tweak some settings and you are, |
| 48 |
1. Done ! |
| 49 |
|
| 50 |
== Frequently Asked Questions == |
| 51 |
|
| 52 |
= My RSS feed is not refreshing ! = |
| 53 |
|
| 54 |
Super RSS Reader uses WordPress's default feed reading module. By default WordPress caches the RSS feed for 12 hours. |
| 55 |
|
| 56 |
You can change this default value by adding the below code to your theme's function.php file. |
| 57 |
|
| 58 |
`add_filter( 'wp_feed_cache_transient_lifetime', create_function('$a', 'return 600;') );` |
| 59 |
|
| 60 |
Here 600 indicates 10 minutes in seconds. Please note that setting lower value will increase the load on the server to refresh the RSS cache. |
| 61 |
|
| 62 |
You can also refer this post https://wordpress.org/support/topic/rss-not-updating-no-matter-which-plugin-i-try/#post-10123881 to change the refresh time for particular feed URL. |
| 63 |
|
| 64 |
= How can I customize the RSS widget via CSS styles ? = |
| 65 |
|
| 66 |
You can use the `super-rss-reader-widget` class in your stylesheet to control the widget styling. Other classes are, |
| 67 |
|
| 68 |
1. `srr-tab-wrap` - the tab's class. |
| 69 |
1. `srr-wrap` - the wrapper of the widget. |
| 70 |
1. `srr-item.odd` - to control the odd feed items. |
| 71 |
1. `srr-item.even` - to control the even feed items. |
| 72 |
|
| 73 |
= Does this plugin support horizontal ticker ? = |
| 74 |
|
| 75 |
No, Super RSS Reader only supports vertical support feature for now. |
| 76 |
|
| 77 |
= How to create a tabbed mode or multiple feeds ? = |
| 78 |
|
| 79 |
Just enter the RSS feed URLs separated by comma in the widget, the plugin automatically renders the tab. |
| 80 |
|
| 81 |
= What fields are shown in the feed output by default ? = |
| 82 |
|
| 83 |
By default the plugin shows fields like title, author, description, thumbnail. Other fields are not supported for now. |
| 84 |
|
| 85 |
= How big is the ticker library ? = |
| 86 |
|
| 87 |
The size of the ticker library is only 2.5 KB. |
| 88 |
|
| 89 |
== Screenshots == |
| 90 |
|
| 91 |
1. Example Super RSS Reader widgets shown in the sidebar, having a ticker effect and a tabbed mode. |
| 92 |
1. Plugin working in different themes and RSS feeds. |
| 93 |
1. Picture showing some possible ways of Customizing the widget. |
| 94 |
1. The Super RSS Reader widget in the administration page. |
| 95 |
|
| 96 |
[Live Working demo](https://www.aakashweb.com/demos/super-rss-reader/) |
| 97 |
|
| 98 |
== Changelog == |
| 99 |
|
| 100 |
= 3.1 = |
| 101 |
* Fix: Settings not being saved. |
| 102 |
* New: Updated the ticker library to the latest. |
| 103 |
* Fix: Added cache buster to JS and CSS files. |
| 104 |
* Fix: Upon tab change, sometimes ticker height gets to 0; |
| 105 |
|
| 106 |
= 3.0 = |
| 107 |
* New: Plugin code is refactored. |
| 108 |
* New: Options are reorganized for easy configuration. |
| 109 |
* Fix: Minor UI changes. |
| 110 |
* Fix: Certain PHP notices on saving widget settings. |
| 111 |
|
| 112 |
= 2.8 = |
| 113 |
* New: jQuery ticker script is now loaded locally. |
| 114 |
* Fix: Minor style adjustments to the admin widget. |
| 115 |
|
| 116 |
= 2.7 = |
| 117 |
* New: Support for "no follow" attribute in links. |
| 118 |
* Fix: Readme with updated FAQ. |
| 119 |
|
| 120 |
= 2.6 = |
| 121 |
* New: Ability to set fixed height for the RSS widget. |
| 122 |
* New: Using minified JavaScript on frontend. |
| 123 |
* Fix: Cleaned widget UI, reordered options. |
| 124 |
* Fix: Code refactoring. |
| 125 |
|
| 126 |
= 2.5 = |
| 127 |
* Added feature to change individual tab titles/names. |
| 128 |
* Added feature to enable rich or full description. |
| 129 |
* Fixed feed ordering issues. |
| 130 |
* Updated jQuery easy ticker plugin to v2.0. |
| 131 |
* Minor code revisions. |
| 132 |
|
| 133 |
= 2.4 = |
| 134 |
* Added feature to cut down/strip feed titles. |
| 135 |
* Added a new 'Simple modern' color style. |
| 136 |
|
| 137 |
= 2.3 = |
| 138 |
* Fixed incompatibility of other jQuery plugins due to the usage of the latest version of jQuery. |
| 139 |
|
| 140 |
= 2.2 = |
| 141 |
* Displays "thumbnail" of the feed item if available. |
| 142 |
* Added setting to change ticker speed. |
| 143 |
* Added setting to edit the "Read more" text. |
| 144 |
* Default styles are revised. |
| 145 |
* Switched to full size ticker code. |
| 146 |
* Core code revised. |
| 147 |
|
| 148 |
= 2.1 = |
| 149 |
* Added option to open links in new window. |
| 150 |
* Changed the method to include the scripts and styles. |
| 151 |
* Added a new 'Orange' color style. |
| 152 |
|
| 153 |
= 2.0 = |
| 154 |
* Core code is completely rewritten. |
| 155 |
* Flash RSS Reader is removed and instead jQuery is used. |
| 156 |
* Administration panel used in the previous version is removed and settings are configured in the widget itself. |
| 157 |
|
| 158 |
= 0.8 = |
| 159 |
* Second version with included CSS and Proxy file (loadXML.php). |
| 160 |
|
| 161 |
= 0.5 = |
| 162 |
* Initial version with a flash RSS Reader |
| 163 |
|
| 164 |
== Upgrade Notice == |
| 165 |
|
| 166 |
Version 2.0 is a major and recommended upgrade for previous version users. |
| 167 |
|
| 168 |
== Credits == |
| 169 |
|
| 170 |
* RSS feed reading engine is the inbuilt WordPress's engine |
| 171 |
* The news ticker effect is powered by [jQuery Easy ticker plugin](https://www.aakashweb.com/jquery-plugins/easy-ticker/) |
