PluginProbe
FeedWordPress / 0.95
FeedWordPress v0.95
trunk 0.8 0.9 0.91 0.95 0.96 0.97 0.98 0.981 0.99 0.991 0.992 0.993 2008.1030 2008.1101 2008.1105 2008.1214 2009.0612 2009.0613 2009.0618 2009.0707 2009.1111 2009.1112 2010.0127 2010.0528 All 65 releases
← All changes | README.text +309 -401 0.96 → 0.95 View file →
@@ -1,9 +1,9 @@
1 1 FeedWordPress
2 2 =============
3 3
4 4 * Author: [Charles Johnson](http://www.radgeek.com/contact)
5 -* Version: 0.96
5 +* Version: 0.95
6 6 * Project URI: <http://projects.radgeek.com/feedwordpress>
7 7 * License: GPL. See License below for copyright jots and tittles.
8 8
9 9 Introduction
@@ -9,24 +9,23 @@
9 9 Introduction
10 10 ------------
11 11 FeedWordPress is an Atom/RSS aggregator for WordPress. It syndicates content
12 12 from newsfeeds that you select into your WordPress blog; if you syndicate
13 -several newsfeeds then you can WordPress's posts database and templating
14 -engine as the back-end of an aggregation ("planet") website. I originally
15 -developed it because I needed a more flexible replacement for [Planet][] to
16 -use at [Feminist Blogs][].
13 +several newsfeeds then you can WordPress's posts database and templating engine
14 +as the back-end of an aggregation ("planet") website. I originally developed it
15 +because I needed a more flexible replacement for [Planet][] to use at
16 +[Feminist Blogs][].
17 17
18 18 [Planet]: http://www.planetplanet.org/ "Planet Planet"
19 19 [Feminist Blogs]: http://www.feministblogs.org/
20 20
21 21 FeedWordPress is designed with flexibility, ease of use, and ease of
22 -configuration in mind. You'll need a working installation of [WordPress
23 -1.5][] and FTP or SFTP access to your web host. The ability to create cron
24 -jobs on your web host would be very helpful but it's not absolutely
25 -necessary. You *don't* need to tweak any plain-text configuration files and
26 -you *don't* need shell access to your web host to make it work. (Although, I
27 -should point out, web hosts that *don't* offer shell access are *bad web
28 -hosts*.)
22 +configuration in mind. You'll need a working installation of [WordPress 1.5][]
23 +and FTP or SFTP access to your web host. The ability to create cron jobs on your
24 +web host would be very helpful but it's not absolutely necessary. You *don't*
25 +need to tweak any plain-text configuration files and you *don't* need shell
26 +access to your web host to make it work. (Although, I should point out, web
27 +hosts that *don't* offer shell access are *bad web hosts*.)
29 28
30 29 [WordPress 1.5]: http://wordpress.org/development/2005/02/strayhorn/
31 30
32 31 Installation & Requirements
@@ -35,46 +34,36 @@
35 34 SFTP access to your web space. You'll probably also want to have either (1)
36 35 the ability to create cron jobs on your web host, or (2) a computer of your
37 36 own that has always-on Internet access.
38 37
39 -1. Install `feedwordpress.php` in your WordPress `plugins` directory
40 - and `update.php` in your WordPress `wp-content` directory.
38 +1. Install `feedwordpress.php` in your WordPress `plugins` directory and
39 + `update.php` in your WordPress `wp-content` directory.
41 40
42 41 2. (Optional) Upgrade the copy of MagpieRSS packaged with WordPress by
43 42 installing the new `rss-functions.php` (archived in
44 43 `OPTIONAL/wp-includes`) into your WordPress `wp-includes` directory.
45 - Upgrading MagpieRSS is necessary if you want to take advantage of
46 - support for multiple post categories, RSS enclosures, and multiple
47 - character encodings. (Note, however, that support for
48 - transliterating between character encodings is a very complex and
49 - iffy prospect in some PHP environments, so if you intend to use
50 - a lot of feeds with alternate encodings you should make sure that
51 - your installation of PHP is up-to-date and that you keep a copy of
52 - the old MagpieRSS around to compare results.)
53 44
54 -3. Log in to the WordPress Dashboard and activate the FeedWordPress
55 - plugin. Go to Options --> Syndication to set up initial settings for
56 - the syndication link category ("Contributors") by default and the
57 - RPC secret word (blank by default, but you should probably set it to
58 - something.)
45 +3. Log in to the WordPress Dashboard and activate the FeedWordPress plugin.
46 + Go to Options --> Syndication to set up initial settings for the
47 + syndication link category ("Contributors") by default and the RPC secret
48 + word (blank by default, but you should probably set it to something.)
59 49
60 50 4. Set up links for syndication from the WordPress Dashboard using
61 51 Links --> Syndicated or Links --> Import.
62 52
63 -5. FeedWordPress is now *ready* to feed syndicated content into
64 - WordPress. In order for it to actually receive that content, either
65 - (1) have your contributors add WordPress's XML-RPC URI to their
66 - blog's list of URIs to ping when they update posts, (2) set up a
67 - cron job to check in on all the feeds on a regular basis, or (3)
68 - both. If you do (2), you can either set up a job to run `php
69 - update-feeds.php` on your web host, or set one up on any computer
70 - with always-on Internet access to request `update-feeds.php` over
71 - the web.
53 +5. FeedWordPress is now *ready* to feed syndicated content into WordPress.
54 + In order for it to actually receive that content, either (1) have your
55 + contributors add WordPress's XML-RPC URI to their blog's list of URIs
56 + to ping when they update posts, (2) set up a cron job to check in on all
57 + the feeds on a regular basis, or (3) both. If you do (2), you can either
58 + set up a job to run `php update-feeds.php` on your web host, or set one
59 + up on any computer with always-on Internet access to request
60 + `update-feeds.php` over the web.
72 61
73 - If your copy of WordPress is installed at <http://www.zyx.com/blog>,
74 - and you set the secret word for XML-RPC pings to "foo", then your
75 - XML-RPC URI will be <http://www.zyx.com/blog/xmlrpc.php>, and the
76 - URI to request for `update-feeds.php` to update all feeds will be
62 + If your copy of WordPress is installed at <http://www.zyx.com/blog>, and
63 + you set the secret word for XML-RPC pings to "foo", then your XML-RPC
64 + URI will be <http://www.zyx.com/blog/xmlrpc.php>, and the URI to request
65 + for `update-feeds.php` to update all feeds will be
77 66 <http://www.zyx.com/blog/wp-content/update-feeds.php?shibboleth=foo>
78 67
79 68 For detailed installation instructions, point your web browser to
80 69 <http://projects.radgeek.com/feedwordpress/install>.
@@ -80,16 +69,16 @@
80 69 <http://projects.radgeek.com/feedwordpress/install>.
81 70
82 71 Basic Concepts
83 72 --------------
84 -FeedWordPress is written as a plugin for [WordPress 1.5][]. It is designed
85 -to store all the data it needs within the WordPress database and to make
86 -that data easy to manage from within the WordPress Dashboard.
73 +FeedWordPress is written as a plugin for [WordPress 1.5][]. It is designed to
74 +store all the data it needs within the WordPress database and to make that data
75 +easy to manage from within the WordPress Dashboard.
87 76
88 77 ### Contributors / Newsfeeds ###
89 78
90 -FeedWordPress uses the WordPress Links database to keep a list of the feeds
91 -from which it will syndicate content. WordPress allows you to place links in
79 +FeedWordPress uses the WordPress Links database to keep a list of the feeds from
80 +which it will syndicate content. WordPress allows you to place links in
92 81 categories; FeedWordPress will treat all and only the links in one category
93 82 (by default, this is a category named "Contributors"; you can change the
94 83 category that FeedWordPress will use using Options --> Syndication).
95 84
@@ -95,17 +84,17 @@
95 84
96 85 From WordPress's perspective, the list of Contributors are normal links, and
97 86 they can be manipulated like other links through the WordPress Dashboard. If
98 87 you need to add, remove, or change information for any contributors, you can
99 -do so easily under Links --> Syndicated. If you want to distribute the labor
100 -of adding, updating, and managing feeds, you can use the WordPress login and
101 -access privileges system. Users with an access level of 5 or greater can
102 -add, delete, and modify Contributors; users with an access level of 6 or
103 -greater can change syndication options.
88 +do so easily under Links --> Syndicated. If you want to distribute the labor of
89 +adding, updating, and managing feeds, you can use the WordPress login and
90 +access privileges system. Users with an access level of 5 or greater can add,
91 +delete, and modify Contributors; users with an access level of 6 or greater can
92 +change syndication options.
104 93
105 -When FeedWordPress looks for new posts, it does so by retrieving one or all
106 -of the links from the Contributors category (depending on whether it has
107 -been told to scan for new posts on one or all of the feeds).
94 +When FeedWordPress looks for new posts, it does so by retrieving one or all of
95 +the links from the Contributors category (depending on whether it has been told
96 +to scan for new posts on one or all of the feeds).
108 97
109 98 __Feed settings:__ All of the information for a syndicated feed is stored in
110 99 the WordPress Links database. Feeds in the category to be syndicated (by
111 100 default, "Contributors") use several fields of the standard WordPress Link
@@ -111,18 +100,17 @@
111 100 default, "Contributors") use several fields of the standard WordPress Link
112 101 record:
113 102
114 103 - The RSS URI is used to store the URI for the feed to be syndicated.
115 - (Note that this is *not* the same as the Link URI. The Link URI
116 - points to the human-readable *front page* of the website that the
117 - feed syndicates.)
104 + (Note that this is *not* the same as the Link URI. The Link URI points
105 + to the human-readable *front page* of the website that the feed
106 + syndicates.)
118 107
119 108 - The Link URI is used to store a URI to the human-readable front page
120 - (*not* the feed!) of the syndicated website. FeedWordPress
121 - automatically updates this URI using the URI that is reported by the
122 - newsfeed whenever it checks the feed for new posts, so if the page
123 - moves this will be reflected automatically on your Contributors
124 - links list.
109 + (*not* the feed!) of the syndicated website. FeedWordPress automatically
110 + updates this URI using the URI that is reported by the newsfeed whenever
111 + it checks the feed for new posts, so if the page moves this will be
112 + reflected automatically on your Contributors links list.
125 113
126 114 - The Link Name is used to store the title of the syndicated website.
127 115 By default, FeedWordPress automatically updates the name of the link
128 116 whenever it checks for new posts, using the title that the
@@ -133,20 +121,20 @@
133 121 overridden for specific feeds using the feed setting
134 122 `hardcode name`.
135 123
136 124 - The Short Description is used to store the tagline of the syndicated
137 - website. By default, FeedWordPress automatically updates the
138 - description whenever it checks for new posts, using the tagline or
139 - description that the newsfeed reports (so that if a Contributor
140 - changes the tagline of her website, this is reflected automatically
141 - on your Contributors links list). his behavior can be turned off for
142 - all feeds through the settings in Options --> Syndication. The
143 - default behavior can be overridden for specific feeds using the feed
144 - setting `hardcode description`.
125 + website. By default, FeedWordPress automatically updates the description
126 + whenever it checks for new posts, using the tagline or description that
127 + the newsfeed reports (so that if a Contributor changes the tagline of
128 + her website, this is reflected automatically on your Contributors links
129 + list). his behavior can be turned off for all feeds through the
130 + settings in Options --> Syndication. The default behavior can be
131 + overridden for specific feeds using the feed setting
132 + `hardcode description`.
145 133
146 -- The Link Notes are used to store a collection of manually-encoded
147 - and automatically-generated settings that apply to this feed. The
148 - format of settings in Link Notes is:
134 +- The Link Notes are used to store a collection of manually-encoded and
135 + automatically-generated settings that apply to this feed. The format of
136 + settings in Link Notes is:
149 137
150 138 key1: value1
151 139 key2: value2
152 140 feed/key1: value1
@@ -152,15 +140,15 @@
152 140 feed/key1: value1
153 141 feed/key2: value2
154 142
155 143 And so on. Values that are prefixed by 'feed/' are automatically
156 - generated from feed data every time the feed syndicated by this link
157 - is checked for updates. Values without the prefix are set manually
158 - by the user.
144 + generated from feed data every time the feed syndicated by this link is
145 + checked for updates. Values without the prefix are set manually by the
146 + user.
159 147
160 148 The Link Notes section can be used to add, remove, and change custom feed
161 -settings. For example, if you want to *add* the feed setting for `unfamiliar
162 -author` with the value `filter`, you can do so by going to Links -->
149 +settings. For example, if you want to *add* the feed setting for
150 +`unfamiliar author` with the value `filter`, you can do so by going to Links -->
163 151 Syndicated, clicking the "Edit" link for the feed that you wish to add this
164 152 setting for, and then adding the following, on a line by itself, to the Link
165 153 Notes section:
166 154
@@ -166,33 +154,32 @@
166 154
167 155 unfamiliar author: filter
168 156
169 157 To remove the setting, follow the same procedure, but find the line for the
170 -feed setting that you want to remove and remove it. To change the value,
171 -simply change the text that follows after the colon.
158 +feed setting that you want to remove and remove it. To change the value, simply
159 +change the text that follows after the colon.
172 160
173 -Most settings in the Link Notes have no effect on FeedWordPress, but you can
174 -use them to store information for templates to retrieve using the
175 -`get_feed_meta()` template function in a post context (see Template API
176 -below). For example, many aggregator sites use a "face" image for each feed
177 -to visually distinguish posts from different feeds. To implement a face
178 -feature, you could add something like this to each feed's Link Notes, on a
179 -line by itself:
161 +Most settings in the Link Notes have no effect on FeedWordPress, but you can use
162 +them to store information for templates to retrieve using the `get_feed_meta()`
163 +template function in a post context (see Template API below). For example, many
164 +aggregator sites use a "face" image for each feed to visually distinguish posts
165 +from different feeds. To implement a face feature, you could add something
166 +like this to each feed's Link Notes, on a line by itself:
180 167
181 168 face: http://www.zyx.com/mugs/ugly
182 169
183 -The URI should be changed out for each feed to point to the appropriate
184 -image, of course. Then, to use the setting from within a template:
170 +The URI should be changed out for each feed to point to the appropriate image,
171 +of course. Then, to use the setting from within a template:
185 172
186 - // In a post context
187 - <?php $img = get_feed_meta('face'); if (strlen($img) > 0): ?>
188 - <img src="<?=$img?>" alt="" />
189 - <?php endif; ?>
173 + // In a post context
174 + <?php $img = get_feed_meta('face'); if (strlen($img) > 0): ?>
175 + <img src="<?=$img?>" alt="" />
176 + <?php endif; ?>
190 177
191 -... which will display the image, if any, whose URI is set in the "face"
192 -setting for the feed that post comes from. If there is no "face" setting for
193 -a particular feed, ``get_feed_meta()`` will return an empty string and no
194 -image will be displayed.
178 +... which will display the image, if any, whose URI is set in the "face" setting
179 +for the feed that post comes from. If there is no "face" setting for a
180 +particular feed, ``get_feed_meta()`` will return an empty string and no image
181 +will be displayed.
195 182
196 183 Not all feed settings are only for templates. Some affect how FeedWordPress
197 184 processes posts from that feed. Currently, the settings with special effects
198 185 on FeedWordPress are `cats`, `hardcode name`, `hardcode description`,
@@ -203,20 +190,18 @@
203 190 ### Syndicated Posts ###
204 191
205 192 Whenever FeedWordPress updates, it scans one or more of the feeds in its
206 193 Contributors list and adds any new posts that it finds to the WordPress
207 -database. Syndicated posts are displayed on your WordPress pages like any
208 -other posts: they can be listed in archives by category, author, or date;
209 -they can be found with the search box; and they are included in the newsfeed
210 -of your blog.
194 +database. Syndicated posts are displayed on your WordPress pages like any other
195 +posts: they can be listed in archives by category, author, or date; they can be
196 +found with the search box; and they are included in the newsfeed of your blog.
211 197
212 198 In your WordPress templates (Presentation --> Theme Editor) you can access
213 199 special information about syndicated posts using functions provided by
214 200 FeedWordPress, such as `is_syndicated()`, `the_syndication_source()`,
215 201 `the_syndication_source_link()`, and `get_feed_meta()`. For example, here is
216 -the template code that I use (in a post context) to display both the
217 -author's name and the original source of the post in the templates for
218 -[Feminist Blogs][]:
202 +the template code that I use (in a post context) to display both the author's
203 +name and the original source of the post in the templates for [Feminist Blogs][]:
219 204
220 205 <cite class="feed">from <?php the_author_posts_link()?><?php
221 206 if (is_syndicated() and (get_the_author() !== get_syndication_source())):
222 207 echo ' @ <a href="'; the_syndication_source_link(); echo '">';
@@ -227,23 +212,23 @@
227 212 For more information on template functions, see Template API below.
228 213
229 214 ### Categories ###
230 215
231 -WordPress allows for posts to be placed in *categories*. Each syndicated
232 -post that FeedWordPress adds to the WordPress database is placed into a set
233 -of categories. FeedWordPress gets the list of category names to use from two
216 +WordPress allows for posts to be placed in *categories*. Each syndicated post
217 +that FeedWordPress adds to the WordPress database is placed into a set of
218 +categories. FeedWordPress gets the list of category names to use from two
234 219 sources:
235 220
236 -1. Categories (or "tags") that the original author placed the post in
237 - on her blog
221 +1. Categories (or "tags") that the original author placed the post in on
222 + her blog
238 223
239 224 2. Categories that you set explicitly for each feed using the `cats`
240 - feed setting. For example, if you wanted all the posts from Alas, A
241 - Blog to be placed in the "Pacific Northwest" category and the
242 - "Cartoonists" category (in addition to any categories that they were
243 - placed in on Alas, A Blog), you could do this by going to Links -->
244 - Syndicated, clicking the "Edit" link for Alas, A Blog, and adding
245 - the following line to the Link Notes section:
225 + feed setting. For example, if you wanted all the posts from Alas, A Blog
226 + to be placed in the "Pacific Northwest" category and the "Cartoonists"
227 + category (in addition to any categories that they were placed in on
228 + Alas, A Blog), you could do this by going to Links --> Syndicated,
229 + clicking the "Edit" link for Alas, A Blog, and adding the following line
230 + to the Link Notes section:
246 231
247 232 cats: Pacific Northwest:Cartoonists
248 233
249 234 (The colon separates one category name from the next.)
@@ -253,139 +238,134 @@
253 238 (2) one of the "aliases" listed in the category description.
254 239
255 240 __Aliases:__ Different often authors use slightly different names for
256 241 categories that mean the same thing (contributors to Feminist Blogs, for
257 -example, used categories including "Feminism", "feministy stuff", "Women's
258 -Issues", "Gender Issues", "Gender Equality", and so on). If you want
242 +example, used categories including "Feminism", "feministy stuff",
243 +"Women's Issues", "Gender Issues", "Gender Equality", and so on). If you want
259 244 FeedWordPress to treat one category name as a synonym for another, you can
260 245 do so by creating an "alias" for the category. For example, to make
261 -FeedWordPress treat posts that are placed in the category "feministy stuff"
262 -as if they had been placed in the category "Feminism", go to Manage -->
263 -Categories, find the category "Feminism" and click the "Edit" link for it,
264 -and then add the following to the Description field, on a line by itself:
246 +FeedWordPress treat posts that are placed in the category "feministy stuff" as
247 +if they had been placed in the category "Feminism", go to Manage --> Categories,
248 +find the category "Feminism" and click the "Edit" link for it, and then add
249 +the following to the Description field, on a line by itself:
265 250
266 251 a.k.a.: feministy stuff
267 252
268 -You can add as many aliases as you like. You can also add any other text
269 -that you like to the Description without interfering with FeedWordPress's
270 -ability to use the aliases. Each alias must be on a line by itself.
253 +You can add as many aliases as you like. You can also add any other text that
254 +you like to the Description without interfering with FeedWordPress's ability to
255 +use the aliases. Each alias must be on a line by itself.
271 256
272 257 __Unfamiliar categories:__ By default, if one of the category names that a
273 258 newsfeed provides is unfamiliar -- that is, if there is not yet any category
274 259 with that name (or with that name as an alias) in your WordPress database --
275 -then by default FeedWordPress will *automatically create* a new category
276 -with that name and place the current post in it. The default behavior can be
277 -changed, using either the global settings in Options --> Syndication or the
278 -`unfamiliar categories` feed setting (see Feed Settings above), so that
279 -unfamiliar categories will not be added to the database. If you choose to
280 -disable the creation of new categories, you can also choose whether or not
281 -FeedWordPress should syndicate posts that do not match *any* of the
282 -categories that are currently in the database.
260 +then by default FeedWordPress will *automatically create* a new category with
261 +that name and place the current post in it. The default behavior can be changed,
262 +using either the global settings in Options --> Syndication or the
263 +`unfamiliar categories` feed setting (see Feed Settings above), so that unfamiliar
264 +categories will not be added to the database. If you choose to disable the
265 +creation of new categories, you can also choose whether or not FeedWordPress
266 +should syndicate posts that do not match *any* of the categories that are
267 +currently in the database.
283 268
284 -One of the uses of this feature is filtering posts by category: if you want
285 -to your blog to syndicate only the posts in one particular category from a
286 -feed that has several categories, you could do so by creating a category by
287 -that name, adding the new feed(s), and then adding the following line to the
288 -Link Notes section of the feed(s) that you want to filter:
269 +One of the uses of this feature is filtering posts by category: if you want to
270 +your blog to syndicate only the posts in one particular category from a feed
271 +that has several categories, you could do so by creating a category by that
272 +name, adding the new feed(s), and then adding the following line to the Link
273 +Notes section of the feed(s) that you want to filter:
289 274
290 275 unfamiliar categories: filter
291 276
292 -Since only posts in categories that are in your database will be included,
293 -and only the category or categories that you wanted posts from has been
294 -added to your database, this will filter out all the posts that aren't in
295 -the category or categories that you defined ahead of time. (Similarly, you
296 -could set up FeedWordPress so that *all* the feeds are filtered by author by
297 -creating the set of users named after the authors you want to syndicate, and
298 -then setting the default behavior for *all* feeds at Options -->
299 -Syndication).
277 +Since only posts in categories that are in your database will be included, and
278 +only the category or categories that you wanted posts from has been added to
279 +your database, this will filter out all the posts that aren't in the category
280 +or categories that you defined ahead of time. (Similarly, you could set up
281 +FeedWordPress so that *all* the feeds are filtered by author by creating the set
282 +of users named after the authors you want to syndicate, and then setting the
283 +default behavior for *all* feeds at Options --> Syndication).
300 284
301 -If you need a category filter with more complex logic, you can always create
302 -a `syndicated_item` filter in PHP (see Plugin API below) that manipulates
303 -the `['categories']` array of a syndicated item.
285 +If you need a category filter with more complex logic, you can always create a
286 +`syndicated_item` filter in PHP (see Plugin API below) that manipulates the
287 +`['categories']` array of a syndicated item.
304 288
305 289 ### Authors ###
306 290
307 291 Most newsfeeds include information about the author of the items on them.
308 292 (If a feed doesn't, then FeedWordPress will create an author's name based on
309 -the title of the feed from which the item was taken.) This information is
310 -used to determine the WordPress user that the post will be attributed to.
311 -Given the name of the author, FeedWordPress looks for authors in the
312 -WordPress database with the same name as either (1) their login, (2) their
313 -first name, (3) their nickname, (4) their full name, or (5) one of the
314 -"aliases" listed in the user's profile.
293 +the title of the feed from which the item was taken.) This information is used
294 +to determine the WordPress user that the post will be attributed to. Given the
295 +name of the author, FeedWordPress looks for authors in the WordPress database
296 +with the same name as either (1) their login, (2) their first name, (3) their
297 +nickname, (4) their full name, or (5) one of the "aliases" listed in the
298 +user's profile.
315 299
316 300 __Aliases:__ If there is an author who posts under more than one name (for
317 301 example, one of our contributors at [Feminist Blogs][] posts on several
318 302 different blogs, sometimes using her full name and sometimes using only her
319 -first name), then you can ensure that FeedWordPress will attribute those
320 -posts to the same author by creating "aliases" for the author. For example,
321 -to make FeedWordPress treat posts by "Joseph Cardinal Ratzinger" and posts
322 -by "Pope Benedict XVI" as having the same author, go to Users --> Authors &
323 -Users, click on the "Edit" link for Pope Benedict XVI, and add a line like
324 -this to the Profile text:
303 +first name), then you can ensure that FeedWordPress will attribute those posts
304 +to the same author by creating "aliases" for the author. For example, to make
305 +FeedWordPress treat posts by "Joseph Cardinal Ratzinger" and posts by "Pope
306 +Benedict XVI" as having the same author, go to Users --> Authors & Users, click
307 +on the "Edit" link for Pope Benedict XVI, and add a line like this to the
308 +Profile text:
325 309
326 310 a.k.a.: Joseph Cardinal Ratzinger
327 311
328 -You can add as many aliases as you like. You can also add any other text
329 -that you like to the Profile without interfering with FeedWordPress's
330 -ability to use the aliases. Each alias must be on a line by itself.
312 +You can add as many aliases as you like. You can also add any other text that
313 +you like to the Profile without interfering with FeedWordPress's ability to use
314 +the aliases. Each alias must be on a line by itself.
331 315
332 316 __Unfamiliar authors:__ By default, if the author named by the newsfeed is
333 317 unfamiliar -- that is, if there is no-one with that name registered in the
334 -WordPress author's database -- then by default FeedWordPress will
335 -automatically create a new user account with the given name and attribute
336 -the post to the new user. The default behavior can be changed, using either
337 -the global settings in Options --> Syndication or the `unfamiliar author`
338 -feed setting (see Feed Settings above), so that posts by unfamiliar authors
339 -will either be attributed to a default author (instead of creating a new
340 -user account to attribute them to), or filtered out and not syndicated at
341 -all.
318 +WordPress author's database -- then by default FeedWordPress will automatically
319 +create a new user account with the given name and attribute the post to the new
320 +user. The default behavior can be changed, using either the global settings in
321 +Options --> Syndication or the `unfamiliar author` feed setting (see Feed
322 +Settings above), so that posts by unfamiliar authors will either be attributed
323 +to a default author (instead of creating a new user account to attribute them
324 +to), or filtered out and not syndicated at all.
342 325
343 326 One of the uses of this feature is filtering posts by author: if you want to
344 -your blog to syndicate only the posts by one particular author from a feed
345 -that has several authors, you could do so by creating a user account with
346 -that author's name, adding the new feed(s), and then adding the following
347 -line to the Link Notes section of the feed(s) that you want to filter:
327 +your blog to syndicate only the posts by one particular author from a feed that
328 +has several authors, you could do so by creating a user account with that
329 +author's name, adding the new feed(s), and then adding the following line to the
330 +Link Notes section of the feed(s) that you want to filter:
348 331
349 332 unfamiliar author: filter
350 333
351 -Since only posts by authors that are in your database will be included, and
352 -only the author that you wanted posts from has been added to your database,
353 -this will filter out posts by anyone else on the feeds with that setting.
354 -(Similarly, you could set up FeedWordPress so that *all* the feeds are
355 -filtered by author by creating the set of users named after the authors you
356 -want to syndicate, and then setting the default behavior for *all* feeds at
357 -Options --> Syndication).
334 +Since only posts by authors that are in your database will be included, and only
335 +the author that you wanted posts from has been added to your database, this will
336 +filter out posts by anyone else on the feeds with that setting. (Similarly, you
337 +could set up FeedWordPress so that *all* the feeds are filtered by author by
338 +creating the set of users named after the authors you want to syndicate, and
339 +then setting the default behavior for *all* feeds at Options --> Syndication).
358 340
359 -If you need an author filter with more complex logic than this allows, you
360 -can always create a `syndicated_item` filter in PHP (see Plugin API below)
361 -that manipulates the `['author_name']` or `['dc']['creator']` elements of a
341 +If you need an author filter with more complex logic than this allows, you can
342 +always create a `syndicated_item` filter in PHP (see Plugin API below) that
343 +manipulates the `['author_name']` or `['dc']['creator']` elements of a
362 344 syndicated item.
363 345
364 346 Special Feed Settings
365 347 ---------------------
366 348 Most feed settings (see Feed Settings above) have no effect on FeedWordPress
367 -itself, but can be useful because they can be accessed from templates using
368 -the `get_feed_meta()` template function in a post context (see Feed Settings
369 -above for an example). However, you can use some feed settings to affect how
349 +itself, but can be useful because they can be accessed from templates using the
350 +`get_feed_meta()` template function in a post context (see Feed Settings above
351 +for an example). However, you can use some feed settings to affect how
370 352 FeedWordPress will process posts from that particular feed. Currently, these
371 353 special settings are:
372 354
373 -- `cats:` a colon-separated list of default categories for any post
374 - coming from this feed. So, for example, a this line in its Notes
375 - section:
355 +- `cats:` a colon-separated list of default categories for any post coming
356 + from this feed. So, for example, a this line in its Notes section:
376 357
377 358 cats: computers:web
378 359
379 - ... will make FeedWordPress place any posts syndicated from that
380 - feed in the "computers" and "web" categories. Note that by default,
381 - FeedWordPress will place them in those categories *in addition to*
382 - any categories that the author of the post put them in on her own
383 - website. If you want to place posts from a feed *only* in the
384 - categories you explicitly set, then you should use the `cats`
385 - setting together with the `unfamiliar categories` setting. (See
386 - Categories above and `unfamiliar categories` below for the
387 - nitty-gritty.)
360 + ... will make FeedWordPress place any posts syndicated from that feed in
361 + the "computers" and "web" categories. Note that by default,
362 + FeedWordPress will place them in those categories *in addition to* any
363 + categories that the author of the post put them in on her own website.
364 + If you want to place posts from a feed *only* in the categories you
365 + explicitly set, then you should use the `cats` setting together with
366 + the `unfamiliar categories` setting. (See Categories above and
367 + `unfamiliar categories` below for the nitty-gritty.)
388 368
389 369 - `hardcode name: (yes|no)`
390 370
391 371 By default, FeedWordPress updates the value of the Link Name field
@@ -390,30 +370,28 @@
390 370
391 371 By default, FeedWordPress updates the value of the Link Name field
392 372 automatically to reflect the title that is reported by a syndicated
393 373 feed--so that if one of your contributors changes the title of her
394 - website, the change will be reflected on your Contributors list
395 - after the next update. If you want to stop this behavior (so that
396 - you can set the title of a Contributor link manually -- e.g. so that
397 - you can use an abbreviated form for reasons of space), you can
398 - change the default behavior for *all* feeds using the settings in
399 - Options --> Syndication. If you want to override the default
400 - behavior for only *one* feed, you can use the `hardcode name` feed
401 - setting. If FeedWordPress updates the title of all feeds by default,
402 - but you wish to use a manually-set title for one particular feed,
403 - you can add a line like this to the Link Notes section of the feed
404 - that you want to manually set the title for:
374 + website, the change will be reflected on your Contributors list after
375 + the next update. If you want to stop this behavior (so that you can
376 + set the title of a Contributor link manually -- e.g. so that you can use
377 + an abbreviated form for reasons of space), you can change the default
378 + behavior for *all* feeds using the settings in Options --> Syndication.
379 + If you want to override the default behavior for only *one* feed, you
380 + can use the `hardcode name` feed setting. If FeedWordPress updates the
381 + title of all feeds by default, but you wish to use a manually-set title
382 + for one particular feed, you can add a line like this to the Link Notes
383 + section of the feed that you want to manually set the title for:
405 384
406 385 hardcode name: yes
407 386
408 - Similarly, if FeedWordPress uses your manually-entered titles for
409 - all feeds by default, but you wish to use an automatically updated
410 - title for one particular feed, you can add a line like this to the
411 - Link Notes section of the feed that you want to manually set the
412 - title for:
413 -
387 + Similarly, if FeedWordPress uses your manually-entered titles for all
388 + feeds by default, but you wish to use an automatically updated title for
389 + one particular feed, you can add a line like this to the Link Notes
390 + section of the feed that you want to manually set the title for:
391 +
414 392 hardcode name: no
415 -
393 +
416 394 If `hardcode name` is absent, or set to a value other than `yes` or
417 395 `no`, FeedWordPress will follow the default behavior set under
418 396 Options --> Syndication.
419 397
@@ -422,214 +400,145 @@
422 400 By default, FeedWordPress updates the value of the Link Description
423 401 field automatically to reflect the tagline or description that is
424 402 reported by a syndicated feed--so that if one of your contributors
425 403 changes the tagline for her website, the change will be reflected on
426 - your Contributors list after the next update. If you want to stop
427 - this behavior (so that you can set the tagline of a Contributor link
428 - manually -- e.g. so that you can use it to provide information of
429 - another sort or use an abbreviated form for reasons of space), you
430 - can change the default behavior for *all* feeds using the settings
431 - in Options --> Syndication. If you want to override the default
432 - behavior for only *one* feed, you can use the `hardcode description`
433 - feed setting. If FeedWordPress updates the description of all feeds
434 - by default, but you wish to use a manually-set description for one
435 - particular feed, you can add a line like this to the Link Notes
436 - section of that particular feed:
404 + your Contributors list after the next update. If you want to stop this
405 + behavior (so that you can set the taglien of a Contributor link manually
406 + -- e.g. so that you can use it to provide information of another sort or
407 + use an abbreviated form for reasons of space), you can change the
408 + default behavior for *all* feeds using the settings in Options -->
409 + Syndication. If you want to override the default behavior for only *one*
410 + feed, you can use the `hardcode description` feed setting. If
411 + FeedWordPress updates the description of all feeds by default, but you
412 + wish to use a manually-set description for one particular feed, you can
413 + add a line like this to the Link Notes section of that particular feed:
437 414
438 415 hardcode description: yes
439 416
440 - Similarly, if FeedWordPress uses your manually-entered descriptions
441 - for all feeds by default, but you wish to use an automatically
442 - updated description for one particular feed, you can add a line like
443 - this to the Link Notes section of that particular feed:
417 + Similarly, if FeedWordPress uses your manually-entered descriptions for
418 + all feeds by default, but you wish to use an automatically updated
419 + description for one particular feed, you can add a line like this to the
420 + Link Notes section of that particular feed:
444 421
445 422 hardcode description: no
446 423
447 - If `hardcode description` is absent, or set to a value other than
448 - `yes` or `no`, FeedWordPress will follow the default behavior set
449 - under Options --> Syndication.
450 -
451 -- `hardcode url: (yes|no)`
452 -
453 - By default, FeedWordPress updates the value of the Link URI field
454 - automatically to reflect the link to the front page of the website
455 - you are syndicating, as reported by the syndicated feed--so that if
456 - one of your contributors changes the front page of her website (from
457 - <http://www.zyx.com/blog/> to <http://www.zyx.com/>, say), the
458 - change will be reflected on your Contributors list after the next
459 - update. If you want to stop this behavior (so that you can set the
460 - human-readable URI that a Contributor link points to manually), you
461 - can change the default behavior for *all* feeds using the settings
462 - in Options --> Syndication. If you want to override the default
463 - behavior for only *one* feed, you can use the `hardcode url` feed
464 - setting. If FeedWordPress updates the human-readable URI of all
465 - feeds by default, but you wish to use a manually-set URI for one
466 - particular feed, you can add a line like this to the Link Notes
467 - section of that particular feed:
468 -
469 - hardcode url: yes
470 -
471 - Similarly, if FeedWordPress uses your manually-entered URIs for all
472 - feeds by default, but you wish to use an automatically updated URI
473 - for one particular feed, you can add a line like this to the Link
474 - Notes section of that particular feed:
475 -
476 - hardcode url: no
477 -
478 - If `hardcode url` is absent, or set to a value other than `yes` or
479 - `no`, FeedWordPress will follow the default behavior set under
424 + If `hardcode description` is absent, or set to a value other than `yes`
425 + or `no`, FeedWordPress will follow the default behavior set under
480 426 Options --> Syndication.
481 427
482 428 - `hardcode categories: (yes|no)`
483 429
484 - **This setting has been deprecated.** If set to `yes` it is now
485 - treated as equivalent to `unfamiliar categories: default`. (See
486 - below.)
430 + **This setting has been deprecated.** If set to `yes` it is now treated
431 + as equivalent to `unfamiliar categories: default`. (See below.)
487 432
488 -- `post status: (publish|draft|private)`
433 +- `post status:` sets the default post status for posts from this feed
434 + This can be 'publish', 'draft', or 'private'. By default, it is set to
435 + 'publish' (syndicated posts go online immediately).
489 436
490 - By default, FeedWordPress sets all new syndicated posts to be
491 - published immediately. If you want syndicated posts to have some
492 - other status (for example, to hold them as drafts for moderation, or
493 - to hold them as private posts), you can change the default behavior
494 - using Options --> Syndication. If you want to override the default
495 - post status for syndicated posts from *one particular feed*, you
496 - can do so using the `post status` feed setting. So, for example, if
497 - you have FeedWordPress set to publish new syndicated posts
498 - immediately, but you want posts from one particular feed to be put
499 - into the drafts pile for moderation, you can do so by placing the
500 - following line in the Link Notes section of that feed's Contributor
501 - link:
502 -
503 - post status: draft
437 +- `comment status:` sets the default status for comments on posts
438 + syndicated from this feed. By default, all comments on syndicated posts
439 + are closed, but you can set it to 'open', 'closed', or 'registered_only'
440 + for particular feeds.
504 441
505 -- `comment status: (open|closed)`
442 +- `ping status:` sets the default status for receiving TrackBack and
443 + PingBack pings on posts syndicated from this feed. By default,
444 + syndicated posts are closed to pings, but you can set this to 'open' or
445 + 'closed' for particular feeds.
506 446
507 - By default, FeedWordPress sets all new syndicated posts to be
508 - closed for comments--if users want to comment on posts then it's
509 - often best for them to comment on the *original* website rather than
510 - your syndication site. But if you want syndicated posts to be open
511 - for comments, you can change the default behavior for all syndicated
512 - posts using the settings in Options --> Syndication. If you want to
513 - override the default comment status for *one particular feed*, you
514 - can do so using the `comment status` feed setting. So, for example,
515 - if you have FeedWordPress set not to open up new syndicated posts
516 - for comments, but you want posts from *one particular feed* to be
517 - opened for comments, then you can do so by placing the following
518 - line in the Link Notes section of that feed's Contributor link:
519 -
520 - comment status: open
521 -
522 -- `ping status: (open|closed)`
523 -
524 - By default, FeedWordPress sets all new syndicated posts *not* to
525 - accept PingBack or TrackBack link notifications ("pings"). If you
526 - want syndicated posts on your syndication site to accept pings, you
527 - can change the default behavior for all syndicated posts using the
528 - settings in Options --> Syndication. If you want to override the
529 - default ping status for *one particular feed*, you can do so using
530 - the `ping status` feed setting. So, for example, if you have
531 - FeedWordPress set not to accept pings for new syndicated posts, but
532 - you want posts from *one particular feed* to accept pings, then you
533 - can do so by placing the following line in the Link Notes section of
534 - that feed's Contributor link:
535 -
536 - ping status: open
537 -
538 447 - `unfamiliar authors: (create|default|filter)`
539 448
540 - By default, FeedWordPress creates new author accounts whenever it
541 - finds a new post that is by an author whose name is not already in
542 - the WordPress database, and uses that account for this post and any
543 - future posts by an author of that name. FeedWordPress also allows
544 - you to attribute posts by unfamiliar authors to a *default* user
545 - account (currently, this means the System Administrator account),
546 - *instead of* creating a new author, or simply not to syndicate posts
547 - by unfamiliar authors (thus only syndicating posts by authors who
548 - are already in the database).
449 + By default, FeedWordPress creates new author accounts whenever it finds
450 + a new post that is by an author whose name is not already in the
451 + WordPress database, and uses that account for this post and any future
452 + posts by an author of that name. FeedWordPress also allows you to
453 + attribute posts by unfamiliar authors to a *default* user account
454 + (currently, this means the System Administrator account), *instead of*
455 + creating a new author, or simply not to syndicate posts by unfamiliar
456 + authors (thus only syndicating posts by authors who are already in the
457 + database).
549 458
550 459 Which of these FeedWordPress does by default can be set using the
551 - settings in Options --> Syndication. You can also override the
552 - default behavior for specific feeds by adding the `unfamiliar
553 - author` feed setting to the Link Notes section of a feed. For
554 - example, to ensure that FeedWordPress filters out posts by
555 - unfamiliar authors for one particular feed, add the setting:
460 + settings in Options --> Syndicated. You can also override the default
461 + behavior for specific feeds by adding the `unfamiliar author` feed
462 + setting to the Link Notes section of a feed. For example, to ensure that
463 + FeedWordPress filters out posts by unfamiliar authors for one particular
464 + feed, add the setting:
556 465
557 466 unfamiliar author: filter
558 467
559 - To ensure that FeedWordPress assigns posts by unfamiliar authors to
560 - the default user account instead of creating a new user account, add
561 - the setting:
468 + To ensure that FeedWordPress assigns posts by unfamiliar authors to the
469 + default user account instead of creating a new user account, add the
470 + setting:
562 471
563 472 unfamiliar author: default
564 473
565 - If you changed the default behavior under Options --> Syndication
566 - but want to ensure that FeedWordPress creates new author accounts
567 - for unfamiliar authors on one specific feed, add the setting:
474 + If you changed the default behavior under Options --> Syndicated but
475 + want to ensure that FeedWordPress creates new author accounts for
476 + unfamiliar authors on one specific feed, add the setting:
568 477
569 478 unfamiliar author: create
570 479
571 - If the setting is anything other than `create`, `default`, or
572 - `filter`, FeedWordPress will ignore the setting and follow the
573 - default behavior that you specified under Options --> Syndication.
480 + If the setting is anything other than `create`, `default`, or `filter`,
481 + FeedWordPress will ignore the setting and follow the default behavior
482 + that you specified under Options --> Syndication.
574 483
575 484 - `unfamiliar categories: (create|default|filter)`
576 485
577 486 By default, FeedWordPress creates categories whenever it finds a new
578 487 post that is placed in categories whose names are not already in the
579 - WordPress database. FeedWordPress allows you to change this
580 - behavior, so that it will *not* create new category names. It also
581 - allows you to choose whether or not posts must match *at least one*
582 - familiar category to be syndicated at all.
488 + WordPress database. FeedWordPress allows you to change this behavior,
489 + so that it will *not* create new category names. It also allows you to
490 + choose whether or not posts must match *at least one* familiar category
491 + to be syndicated at all.
583 492
584 493 Which of these FeedWordPress does by default can be set using the
585 - settings in Options --> Syndication. You can also override the
586 - default behavior for specific feeds by adding the `unfamiliar
587 - categories` feed setting to the Link Notes section of a feed. For
588 - example, to ensure that, when adding new posts from *one particular
589 - feed*, FeedWordPress does *not* create new categories, and filters
590 - out any posts that don't match *at least one* of the categories that
591 - you have already defined, add the setting:
494 + settings in Options --> Syndicated. You can also override the default
495 + behavior for specific feeds by adding the `unfamiliar categories` feed
496 + setting to the Link Notes section of a feed. For example, to ensure
497 + that, when adding new posts from *one particular feed*, FeedWordPress
498 + does *not* create new categories, and filters out any posts that don't
499 + match *at least one* of the categories that you have already defined,
500 + add the setting:
592 501
593 502 unfamiliar categories: filter
594 503
595 504 To ensure that FeedWordPress does *not* create new categories, but
596 - *will* still syndicate categories even if they don't match any of
597 - the pre-defined categories, add the following to the feed settings:
505 + *will* still syndicate categories even if they don't match any of the
506 + pre-defined categories, add the following to the feed settings:
598 507
599 508 unfamiliar categories: default
600 509
601 - If you changed the default behavior under Options --> Syndication
602 - but want to ensure that FeedWordPress creates new categories for
603 - posts from one particular feed, add the setting:
510 + If you changed the default behavior under Options --> Syndicated but
511 + want to ensure that FeedWordPress creates new categories for posts
512 + from one particular feed, add the setting:
604 513
605 514 unfamiliar categories: create
606 515
607 - If the setting is anything other than `create`, `default`, or
608 - `filter`, FeedWordPress will ignore the setting and follow the
609 - default behavior that you specified under Options --> Syndication.
516 + If the setting is anything other than `create`, `default`, or `filter`,
517 + FeedWordPress will ignore the setting and follow the default behavior
518 + that you specified under Options --> Syndication.
610 519
611 520 Template API
612 521 ------------
613 -When activated, FeedWordPress makes the following functions available for
614 -use by themes/templates:
522 +When activated, FeedWordPress makes the following functions available for use by
523 +themes/templates:
615 524
616 -* ``is_syndicated()``: in a post context, returns ``TRUE`` if the post
617 - was syndicated from another website, or ``FALSE`` if it was
618 - originally posted here
525 +* ``is_syndicated()``: in a post context, returns ``TRUE`` if the post was
526 + syndicated from another website, or ``FALSE`` if it was originally
527 + posted here
619 528
620 -* ``get_syndication_permalink()``: in a post context, returns the URI
621 - of the permalink for this post *on the website it was syndicated from*
529 +* ``get_syndication_permalink()``: in a post context, returns the URI of
530 + the permalink for this post *on the website it was syndicated from*
622 531
623 -* ``the_syndication_permalink()``: in a post context, outputs the
624 - value returned by ``get_syndication_permalink()``
532 +* ``the_syndication_permalink()``: in a post context, outputs the value
533 + returned by ``get_syndication_permalink()``
625 534
626 -* ``get_syndication_source_link()``: in a post context, returns the
627 - URI of the front page (*not* the feed) of the website this post was
628 - syndicated from
535 +* ``get_syndication_source_link()``: in a post context, returns the URI of
536 + the front page (*not* the feed) of the website this post was syndicated
537 + from
629 538
630 -* ``the_syndication_source_link()``: in a post context, outputs the
631 - URI returned by ``get_syndication_source_link()``
539 +* ``the_syndication_source_link()``: in a post context, outputs the URI
540 + returned by ``get_syndication_source_link()``
632 541
633 542 * ``get_syndication_source()``: in a post context, returns the
634 543 human-readable title of the website that a syndicated post was
635 544 syndicated from
@@ -636,34 +545,34 @@
636 545
637 546 * ``the_syndication_source()``: in a post context, outputs the value
638 547 returned by ``get_syndication_source()``
639 548
640 -* ``get_syndication_feed():`` in a post context, returns the URI of
641 - the feed (*not* the front page) that this post was syndicated from
549 +* ``get_syndication_feed():`` in a post context, returns the URI of the
550 + feed (*not* the front page) that this post was syndicated from
642 551
643 552 * ``the_syndication_feed()``: in a post context, outputs the value
644 553 returned by ``get_syndication_feed()``
645 554
646 -* ``get_feed_meta($key)``: in a post context, returns the value, if
647 - any, of the feed setting ``$key`` for the feed that this post was
648 - syndicated from
555 +* ``get_feed_meta($key)``: in a post context, returns the value, if any,
556 + of the feed setting ``$key`` for the feed that this post was syndicated
557 + from
649 558
650 559 By default, FeedWordPress also places a filter on the standard functions
651 -``get_permalink()`` and ``the_permalink()`` that substitutes the URI
652 -returned by ``get_syndication_permalink()`` for the URI generated by
653 -WordPress. This means that by default the permalinks listed on your website
654 -and in your newsfeed will link to the location of the posts on the source
655 -website, *not* to their location on your website. You can switch this
656 -behavior on or off at Options --> Syndication in the WordPress Dashboard.
560 +``get_permalink()`` and ``the_permalink()`` that substitutes the URI returned by
561 +``get_syndication_permalink()`` for the URI generated by WordPress. This means
562 +that by default the permalinks listed on your website and in your newsfeed will
563 +link to the location of the posts on the source website, *not* to their location
564 +on your website. You can switch this behavior on or off at Options -->
565 +Syndication in the WordPress Dashboard.
657 566
658 567 ### Plugin API ###
659 568
660 -FeedWordPress creates five hooks through the WordPress plugin architecture
661 -that you can plug in to using PHP WordPress plugins, to supplement ordinary
662 -FeedWordPress behavior, or to filter posts according to criteria that you
663 -set. The hooks are the action ``feedwordpress_update``, the action
664 -``feedwordpress_check_feed``, the action ``feedwordpress_update_complete``,
665 -the filter ``syndicated_item``, the filter ``syndicated_post``, the action
569 +FeedWordPress creates five hooks through the WordPress plugin architecture that
570 +you can plug in to using PHP WordPress plugins, to supplement ordinary
571 +FeedWordPress behavior, or to filter posts according to criteria that you set.
572 +The hooks are the action ``feedwordpress_update``, the action
573 +``feedwordpress_check_feed``, the action ``feedwordpress_update_complete``, the
574 +filter ``syndicated_item``, the filter ``syndicated_post``, the action
666 575 ``post_syndicated_item``, and the action ``update_syndicated_item``.
667 576
668 577 For more information, see <http://projects.radgeek.com/feedwordpress/api>.
669 578
@@ -668,26 +577,25 @@
668 577 For more information, see <http://projects.radgeek.com/feedwordpress/api>.
669 578
670 579 License
671 580 -------
672 -The FeedWordPress plugin is copyright (c) 2005 by Charles Johnson. It uses
673 -code derived or translated from:
581 +The FeedWordPress plugin is copyright (c) 2005 by Charles Johnson. It uses code
582 +derived or translated from:
674 583
675 -- [wp-rss-aggregate.php][] by [Kellan Elliot-McCrea](mailto:kellan@protest.net)
676 -- [HTTP Navigator 2][] by [Keyvan Minoukadeh](mailto:keyvan@k1m.com)
677 -- [Ultra-Liberal Feed Finder][] by [Mark Pilgrim](mailto:mark@diveintomark.org)
584 +- [wp-rss-aggregate.php][] by [Kellan Elliot-McCrea](kellan@protest.net)
585 +- [HTTP Navigator 2][] by [Keyvan Minoukadeh](keyvan@k1m.com)
586 +- [Ultra-Liberal Feed Finder][] by [Mark Pilgrim](mark@diveintomark.org)
678 587
679 588 according to the terms of the [GNU General Public License][].
680 589
681 -This program is free software; you can redistribute it and/or modify it
682 -under the terms of the [GNU General Public License][] as published by the
683 -Free Software Foundation; either version 2 of the License, or (at your
684 -option) any later version.
590 +This program is free software; you can redistribute it and/or modify it under
591 +the terms of the [GNU General Public License][] as published by the Free Software
592 +Foundation; either version 2 of the License, or (at your option) any later
593 +version.
685 594
686 -This program is distributed in the hope that it will be useful, but WITHOUT
687 -ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
688 -FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
689 -more details.
595 +This program is distributed in the hope that it will be useful, but WITHOUT ANY
596 +WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
597 +PARTICULAR PURPOSE. See the GNU General Public License for more details.
690 598
691 599 [wp-rss-aggregate.php]: http://laughingmeme.org/archives/002203.html
692 600 [HTTP Navigator 2]: http://www.keyvan.net/2004/11/16/http-navigator/
693 601 [Ultra-Liberal Feed Finder]: http://diveintomark.org/projects/feed_finder/