/
readme.txt
169 lines (118 loc) · 6.27 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
=== Multi Feed Reader ===
Contributors: eteubert
Donate link: https://flattr.com/thing/474620/WordPress-Plugin-Multi-Feed-Reader
Tags: feed, rss, archive, shortcode, custom, template, html, customizable
Requires at least: 3.0
Tested up to: 3.7.5
Stable tag: trunk
Reads multiple feeds. Output can be customized via templates. Is displayed via Shortcodes.
== Description ==
This plugin was created with the iTunes Podcast Feed in mind. However, you can feed it any RSS feed you like. If you would like to display some tags which are not supported right now, please feel free to contact me.
= Quick Start =
Create a template "myfeeds" in `Settings > Multi Feed Reader`.
Add your Feeds.
Create a page and paste in one of these shortocdes:
[multi-feed-reader template="myfeeds"]
[multi-feed-reader template="myfeeds" limit="10"]
[multi-feed-reader template="myfeeds" cachetime="300"]
Enjoy :)
= Parameters =
- `template`: (required) name of the template
- `limit`: (optional) maximum number of items per feed. default: 15
- `cachetime`: (optional) time in seconds to cache results. default: 300
- `nocache`: (optional) set to "1" to deactivate cache. not recommended, will make your multifeed-page very slow. default: 0
= Force Cache Refresh =
To clear the cache, call the site with parameter `?nocache=1`. So if your site is `example.com/archives`, open `example.com/archives?nocache=1` in your browser. You should then see the refreshed page immediately.
= Placeholders =
You can specify a custom template to display the archive elements.
Go to `Settings > Multi Feed Reader` for plugin preferences.
Use HTML and any of the following template placeholders.
- `%TITLE%` - Episode title (<title>).
- `%SUBTITLE%` - Episode subtitle (<itunes:subtitle>).
- `%CONTENT%` - Episode content (<content:encoded>).
- `%CONTENT|...%` - Same as above but truncated to the given amount of words.
- `%DURATION%` - Episode duration (<itunes:duration>).
- `%SUMMARY%` - Episode summary (<itunes:summary>).
- `%LINK%` - Episode link (<link>).
- `%GUID%` - Episode Globally Unique Identifier (<guid>)
- `%DESCRIPTION%` - Episode description (<itunes:description> or <description>).
- `%DESCRIPTION|...%` - Same as above but truncated to the given amount of words.
- `%ENCLOSURE%` - Url of first episode enclosure (<enclosure> url attribute).
- `%THUMBNAIL%` - Thumbnail tag in original size (<itunes:image>).
- `%THUMBNAIL|...x...%` - Same as above but with certain dimensions. Example: `%THUMBNAIL|75x75%`.
- `%DATE%` - Episode publish date (<pubDate>) in WordPress default format.
- `%DATE|...%` - Same as above but in a custom format. Example: `%DATE|Y/m/d%`.
Access data from app store feeds:
- %APPNAME% - App name.
- %APPPRICE% - App price.
- %APPIMAGE% - App Icon as HTML image.
- %APPARTIST% - App artist / publisher.
- %APPRELEASE% - App release date in WordPress format.
Use these placeholders to access global feed data:
- `%FEEDTITLE%` - Feed title (<title>).
- `%FEEDSUBTITLE%` - Feed subtitle (<itunes:subtitle>).
- `%FEEDSUMMARY%` - Feed summary (<itunes:summary>).
- `%FEEDLINK%` - Feed link (<link>).
- `%FEEDLANGUAGE%` - Feed language (<language>).
- `%FEEDTHUMBNAIL%` - Feed image (<itunes:image>).
- `%FEEDTHUMBNAIL|...x...%` - Same as above but with certain dimensions. Example: `%FEEDTHUMBNAIL|75x75%`.
== Installation ==
1. Upload the `multi-feed-reader` directory to the `/wp-content/plugins/` directory
1. Activate the plugin through the 'Plugins' menu in WordPress
1. Go to `Settings > Multi Feed Reader` and create a template
1. Place `[multi-feed-reader template="mytemplate"]` in your post or page
== Frequently Asked Questions ==
= W00t, it says I need PHP 5.3?! =
PHP 5.3 is available since June 2009.
It introduced some long overdue features to the language and I refuse to support legacy junk.
Please ask your hoster to update, kindly.
= How many feeds can I add to a collection? =
That depends on two aspects: Feed response time and feed size. Each feed you add increases the time needed to display the final page. The results are cached, so most of the time the page will render in a snap. If you'd like to see how long the page rendering takes when the cache is expired, have a look at the logfile (/wp-content/multi-feed-reader/reader.log). Look for the last line containing "template generated". It contains the durations.
Rule of thumb: On average, one feed requires one second. 5 Feeds are fine. 10 might work. 20 is probably too much. Your mileage may vary :)
= Can I help to add a feature? =
That would be awesome!
Visit https://github.com/eteubert/multi-feed-reader, fork the project, add your feature and create a Pull Request. I'll be happy to review and add your changes.
== Screenshots ==
1. The Admin Interface
2. Example Archive
== Changelog ==
= 2.2.4 =
* security: fix SQL injection (thanks to JPCERT)
= 2.2.3 =
* fix error (use of deprecated function `mysql_insert_id()`)
= 2.2.2 =
* apparently having a settings.php in your plugin breaks the network pages. Yay WordPress. *slow clap*
= 2.2.1 =
* fix issue for windows based servers
= 2.2.0 =
* new placeholder: `%CONTENT|...%`
* add documentation for all parameters
* cache duration is configurable via `cachetime` parameter
* minor fixes / enhancements
= 2.1.3 =
* class loading fix
= 2.1.2 =
* compatibility fix
= 2.1.1 =
* if there are class attributes the description html, they will now correctly be displayed
= 2.1.0 =
* add support for some iTunes App Store tags (name, price, icon, releasedate). Please see readme for usage.
* bugfix concerning description truncating
* internal translation API changes
= 2.0.0 =
* finally supports a wide variety of feeds
* logs feed fetching info to a log file
= 1.1.3 =
* add `DESCRIPTION|...` placeholder
* enhanced description parsing
= 1.1.2 =
* enhance feed parser robustness
= 1.1.1 =
* Bugfix: Shortcode prints template in the correct place now
= 1.1 =
* `%THUMBNAIL%`: Use <itunes:image> if available. Otherwise, look for the first suitable <img> in <content:encoded>
* add support for global feed data: `%FEEDTITLE%`, `%FEEDSUBTITLE%`, `%FEEDSUMMARY%`, `%FEEDLINK%`, `%FEEDLANGUAGE%`, `%FEEDTHUMBNAIL%`, `%FEEDTHUMBNAIL|...x...%`
= 1.0 =
* Release
== Upgrade Notice ==
* nothing to watch out for, yet :)