PluginProbe
FeedWordPress / 0.96
FeedWordPress v0.96
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 +401 -309 0.95 → 0.96 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.95
5 +* Version: 0.96
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,23 +9,24 @@
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 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][].
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][].
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 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*.)
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*.)
28 29
29 30 [WordPress 1.5]: http://wordpress.org/development/2005/02/strayhorn/
30 31
31 32 Installation & Requirements
@@ -34,36 +35,46 @@
34 35 SFTP access to your web space. You'll probably also want to have either (1)
35 36 the ability to create cron jobs on your web host, or (2) a computer of your
36 37 own that has always-on Internet access.
37 38
38 -1. Install `feedwordpress.php` in your WordPress `plugins` directory and
39 - `update.php` in your WordPress `wp-content` directory.
39 +1. Install `feedwordpress.php` in your WordPress `plugins` directory
40 + and `update.php` in your WordPress `wp-content` directory.
40 41
41 42 2. (Optional) Upgrade the copy of MagpieRSS packaged with WordPress by
42 43 installing the new `rss-functions.php` (archived in
43 44 `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.)
44 53
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.)
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.)
49 59
50 60 4. Set up links for syndication from the WordPress Dashboard using
51 61 Links --> Syndicated or Links --> Import.
52 62
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.
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.
61 72
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
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
66 77 <http://www.zyx.com/blog/wp-content/update-feeds.php?shibboleth=foo>
67 78
68 79 For detailed installation instructions, point your web browser to
69 80 <http://projects.radgeek.com/feedwordpress/install>.
@@ -69,16 +80,16 @@
69 80 <http://projects.radgeek.com/feedwordpress/install>.
70 81
71 82 Basic Concepts
72 83 --------------
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.
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.
76 87
77 88 ### Contributors / Newsfeeds ###
78 89
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
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
81 92 categories; FeedWordPress will treat all and only the links in one category
82 93 (by default, this is a category named "Contributors"; you can change the
83 94 category that FeedWordPress will use using Options --> Syndication).
84 95
@@ -84,17 +95,17 @@
84 95
85 96 From WordPress's perspective, the list of Contributors are normal links, and
86 97 they can be manipulated like other links through the WordPress Dashboard. If
87 98 you need to add, remove, or change information for any contributors, you can
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.
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.
93 104
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).
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).
97 108
98 109 __Feed settings:__ All of the information for a syndicated feed is stored in
99 110 the WordPress Links database. Feeds in the category to be syndicated (by
100 111 default, "Contributors") use several fields of the standard WordPress Link
@@ -100,17 +111,18 @@
100 111 default, "Contributors") use several fields of the standard WordPress Link
101 112 record:
102 113
103 114 - The RSS URI is used to store the URI for the feed to be syndicated.
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.)
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.)
107 118
108 119 - The Link URI is used to store a URI to the human-readable front page
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.
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.
113 125
114 126 - The Link Name is used to store the title of the syndicated website.
115 127 By default, FeedWordPress automatically updates the name of the link
116 128 whenever it checks for new posts, using the title that the
@@ -121,20 +133,20 @@
121 133 overridden for specific feeds using the feed setting
122 134 `hardcode name`.
123 135
124 136 - The Short Description is used to store the tagline of the syndicated
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`.
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`.
133 145
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:
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:
137 149
138 150 key1: value1
139 151 key2: value2
140 152 feed/key1: value1
@@ -140,15 +152,15 @@
140 152 feed/key1: value1
141 153 feed/key2: value2
142 154
143 155 And so on. Values that are prefixed by 'feed/' are automatically
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.
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.
147 159
148 160 The Link Notes section can be used to add, remove, and change custom feed
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 -->
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 -->
151 163 Syndicated, clicking the "Edit" link for the feed that you wish to add this
152 164 setting for, and then adding the following, on a line by itself, to the Link
153 165 Notes section:
154 166
@@ -154,32 +166,33 @@
154 166
155 167 unfamiliar author: filter
156 168
157 169 To remove the setting, follow the same procedure, but find the line for the
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.
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.
160 172
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:
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:
167 180
168 181 face: http://www.zyx.com/mugs/ugly
169 182
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:
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:
172 185
173 - // In a post context
174 - <?php $img = get_feed_meta('face'); if (strlen($img) > 0): ?>
175 - <img src="<?=$img?>" alt="" />
176 - <?php endif; ?>
186 + // In a post context
187 + <?php $img = get_feed_meta('face'); if (strlen($img) > 0): ?>
188 + <img src="<?=$img?>" alt="" />
189 + <?php endif; ?>
177 190
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.
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.
182 195
183 196 Not all feed settings are only for templates. Some affect how FeedWordPress
184 197 processes posts from that feed. Currently, the settings with special effects
185 198 on FeedWordPress are `cats`, `hardcode name`, `hardcode description`,
@@ -190,18 +203,20 @@
190 203 ### Syndicated Posts ###
191 204
192 205 Whenever FeedWordPress updates, it scans one or more of the feeds in its
193 206 Contributors list and adds any new posts that it finds to the WordPress
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.
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.
197 211
198 212 In your WordPress templates (Presentation --> Theme Editor) you can access
199 213 special information about syndicated posts using functions provided by
200 214 FeedWordPress, such as `is_syndicated()`, `the_syndication_source()`,
201 215 `the_syndication_source_link()`, and `get_feed_meta()`. For example, here is
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][]:
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][]:
204 219
205 220 <cite class="feed">from <?php the_author_posts_link()?><?php
206 221 if (is_syndicated() and (get_the_author() !== get_syndication_source())):
207 222 echo ' @ <a href="'; the_syndication_source_link(); echo '">';
@@ -212,23 +227,23 @@
212 227 For more information on template functions, see Template API below.
213 228
214 229 ### Categories ###
215 230
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
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
219 234 sources:
220 235
221 -1. Categories (or "tags") that the original author placed the post in on
222 - her blog
236 +1. Categories (or "tags") that the original author placed the post in
237 + on her blog
223 238
224 239 2. Categories that you set explicitly for each feed using the `cats`
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:
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:
231 246
232 247 cats: Pacific Northwest:Cartoonists
233 248
234 249 (The colon separates one category name from the next.)
@@ -238,134 +253,139 @@
238 253 (2) one of the "aliases" listed in the category description.
239 254
240 255 __Aliases:__ Different often authors use slightly different names for
241 256 categories that mean the same thing (contributors to Feminist Blogs, for
242 -example, used categories including "Feminism", "feministy stuff",
243 -"Women's Issues", "Gender Issues", "Gender Equality", and so on). If you want
257 +example, used categories including "Feminism", "feministy stuff", "Women's
258 +Issues", "Gender Issues", "Gender Equality", and so on). If you want
244 259 FeedWordPress to treat one category name as a synonym for another, you can
245 260 do so by creating an "alias" for the category. For example, to make
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:
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:
250 265
251 266 a.k.a.: feministy stuff
252 267
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.
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.
256 271
257 272 __Unfamiliar categories:__ By default, if one of the category names that a
258 273 newsfeed provides is unfamiliar -- that is, if there is not yet any category
259 274 with that name (or with that name as an alias) in your WordPress 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.
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.
268 283
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:
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:
274 289
275 290 unfamiliar categories: filter
276 291
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).
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).
284 300
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.
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.
288 304
289 305 ### Authors ###
290 306
291 307 Most newsfeeds include information about the author of the items on them.
292 308 (If a feed doesn't, then FeedWordPress will create an author's name based on
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.
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.
299 315
300 316 __Aliases:__ If there is an author who posts under more than one name (for
301 317 example, one of our contributors at [Feminist Blogs][] posts on several
302 318 different blogs, sometimes using her full name and sometimes using only her
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:
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:
309 325
310 326 a.k.a.: Joseph Cardinal Ratzinger
311 327
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.
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.
315 331
316 332 __Unfamiliar authors:__ By default, if the author named by the newsfeed is
317 333 unfamiliar -- that is, if there is no-one with that name registered in the
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.
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.
325 342
326 343 One of the uses of this feature is filtering posts by author: if you want to
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:
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:
331 348
332 349 unfamiliar author: filter
333 350
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).
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).
340 358
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
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
344 362 syndicated item.
345 363
346 364 Special Feed Settings
347 365 ---------------------
348 366 Most feed settings (see Feed Settings above) have no effect on FeedWordPress
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
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
352 370 FeedWordPress will process posts from that particular feed. Currently, these
353 371 special settings are:
354 372
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:
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:
357 376
358 377 cats: computers:web
359 378
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.)
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.)
368 388
369 389 - `hardcode name: (yes|no)`
370 390
371 391 By default, FeedWordPress updates the value of the Link Name field
@@ -370,28 +390,30 @@
370 390
371 391 By default, FeedWordPress updates the value of the Link Name field
372 392 automatically to reflect the title that is reported by a syndicated
373 393 feed--so that if one of your contributors changes the title of her
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:
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:
384 405
385 406 hardcode name: yes
386 407
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 -
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 +
392 414 hardcode name: no
393 -
415 +
394 416 If `hardcode name` is absent, or set to a value other than `yes` or
395 417 `no`, FeedWordPress will follow the default behavior set under
396 418 Options --> Syndication.
397 419
@@ -400,145 +422,214 @@
400 422 By default, FeedWordPress updates the value of the Link Description
401 423 field automatically to reflect the tagline or description that is
402 424 reported by a syndicated feed--so that if one of your contributors
403 425 changes the tagline for her website, the change will be reflected on
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:
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:
414 437
415 438 hardcode description: yes
416 439
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:
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:
421 444
422 445 hardcode description: no
423 446
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
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
426 480 Options --> Syndication.
427 481
428 482 - `hardcode categories: (yes|no)`
429 483
430 - **This setting has been deprecated.** If set to `yes` it is now treated
431 - as equivalent to `unfamiliar categories: default`. (See below.)
484 + **This setting has been deprecated.** If set to `yes` it is now
485 + treated as equivalent to `unfamiliar categories: default`. (See
486 + below.)
432 487
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).
488 +- `post status: (publish|draft|private)`
436 489
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.
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
441 504
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.
505 +- `comment status: (open|closed)`
446 506
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 +
447 538 - `unfamiliar authors: (create|default|filter)`
448 539
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).
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).
458 549
459 550 Which of these FeedWordPress does by default can be set using the
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:
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:
465 556
466 557 unfamiliar author: filter
467 558
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:
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:
471 562
472 563 unfamiliar author: default
473 564
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:
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:
477 568
478 569 unfamiliar author: create
479 570
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.
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.
483 574
484 575 - `unfamiliar categories: (create|default|filter)`
485 576
486 577 By default, FeedWordPress creates categories whenever it finds a new
487 578 post that is placed in categories whose names are not already in the
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.
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.
492 583
493 584 Which of these FeedWordPress does by default can be set using the
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:
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:
501 592
502 593 unfamiliar categories: filter
503 594
504 595 To ensure that FeedWordPress does *not* create new categories, but
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:
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:
507 598
508 599 unfamiliar categories: default
509 600
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:
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:
513 604
514 605 unfamiliar categories: create
515 606
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.
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.
519 610
520 611 Template API
521 612 ------------
522 -When activated, FeedWordPress makes the following functions available for use by
523 -themes/templates:
613 +When activated, FeedWordPress makes the following functions available for
614 +use by themes/templates:
524 615
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
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
528 619
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*
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*
531 622
532 -* ``the_syndication_permalink()``: in a post context, outputs the value
533 - returned by ``get_syndication_permalink()``
623 +* ``the_syndication_permalink()``: in a post context, outputs the
624 + value returned by ``get_syndication_permalink()``
534 625
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
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
538 629
539 -* ``the_syndication_source_link()``: in a post context, outputs the URI
540 - returned by ``get_syndication_source_link()``
630 +* ``the_syndication_source_link()``: in a post context, outputs the
631 + URI returned by ``get_syndication_source_link()``
541 632
542 633 * ``get_syndication_source()``: in a post context, returns the
543 634 human-readable title of the website that a syndicated post was
544 635 syndicated from
@@ -545,34 +636,34 @@
545 636
546 637 * ``the_syndication_source()``: in a post context, outputs the value
547 638 returned by ``get_syndication_source()``
548 639
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
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
551 642
552 643 * ``the_syndication_feed()``: in a post context, outputs the value
553 644 returned by ``get_syndication_feed()``
554 645
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
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
558 649
559 650 By default, FeedWordPress also places a filter on the standard functions
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.
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.
566 657
567 658 ### Plugin API ###
568 659
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
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
575 666 ``post_syndicated_item``, and the action ``update_syndicated_item``.
576 667
577 668 For more information, see <http://projects.radgeek.com/feedwordpress/api>.
578 669
@@ -577,25 +668,26 @@
577 668 For more information, see <http://projects.radgeek.com/feedwordpress/api>.
578 669
579 670 License
580 671 -------
581 -The FeedWordPress plugin is copyright (c) 2005 by Charles Johnson. It uses code
582 -derived or translated from:
672 +The FeedWordPress plugin is copyright (c) 2005 by Charles Johnson. It uses
673 +code derived or translated from:
583 674
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)
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)
587 678
588 679 according to the terms of the [GNU General Public License][].
589 680
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.
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.
594 685
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.
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.
598 690
599 691 [wp-rss-aggregate.php]: http://laughingmeme.org/archives/002203.html
600 692 [HTTP Navigator 2]: http://www.keyvan.net/2004/11/16/http-navigator/
601 693 [Ultra-Liberal Feed Finder]: http://diveintomark.org/projects/feed_finder/