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 | ChangeLog.text +78 -644 2008.11010.95 View file →
@@ -1,685 +1,109 @@
1 -FeedWordPress Change Log
2 -========================
1 +Change Log
2 +==========
3 3
4 -Changes from 2008.1030 to 2008.1101
5 -
6 -* INTERFACE BUG THAT PREVENTED ADDING NEW SITES FIXED: The UI reforms in
7 - FWP 2008.1030 unintentionally introduced a bug that prevents clean
8 - installations of FeedWordPress from providing an input box for adding
9 - new feeds to the list of syndicated feeds. This bug has been fixed.
10 -
11 -Changes from 0.993 to 2008.1030
12 -
13 -* WORDPRESS 2.6 COMPATABILITY: FeedWordPress should now be compatible with
14 - WordPress 2.6, and should work more or less seamlessly with the new post
15 - revision system. A bug which caused multiple new revisions to be created
16 - for posts on certain feeds, regardless of whether or not the item had
17 - been updated, has been fixed.
18 -
19 -* INTERFACE IMPROVEMENTS: The user interface has been substantially
20 - restyled to fit in better with the visual style of WordPress 2.5 and
21 - 2.6.
22 -
23 -* YOUTUBE BUG FIXED: POSTS SYNDICATED THROUGH AN AUTOMATIC UPDATE ARE NO
24 - LONGER STRIPPED OF `<OBJECT>` TAGS AND CERTAIN OTHER HTML ELEMENTS: Due
25 - to the way that some versions of WordPress process posts that are
26 - inserted into the database when no user is logged in, many users
27 - experienced an issue where YouTube videos and other content using the
28 - HTML `<object>` tag would be stripped out of posts that were syndicated
29 - during an automatic update. (Posts that were syndicated through manual
30 - updates from within the WordPress Dashboard were not affected, because
31 - the issue does not arise when an update is executed under a logged-in
32 - administrator's credentials.) This bug has now been fixed; YouTube
33 - videos and other content using `<object>` tags should now appear
34 - properly in syndicated posts, regardless of the way in which the post
35 - was syndicated.
36 -
37 -* AJAX BUGS FIXED: Bugs which blocked the normal operation of WordPress
38 - 2.5's AJAX interface elements when FeedWordPress was activated have been
39 - fixed.
40 -
41 -* TAG SUPPORT: A couple of features have been introduced to take advantage
42 - of the tagging features in WordPress 2.3.x, 2.5.x, and 2.6.x. Now, when
43 - unfamiliar categories are encountered for posts on a feed, you can
44 - choose for FeedWordPress (1) to drop the category; (2) to drop the
45 - category and to filter out any post that does not match at least one
46 - familiar category; (3) to create a new category with that name, or,
47 - now, you can also have FeedWordPress (4) create a new *tag* with that
48 - name. This option can be set site-wide under Syndication --> Options,
49 - or it can be set on a feed-by-feed basis in a feed's Edit screen.
50 -
51 - In addition, you can now set particular tags to apply to all incoming
52 - syndicated posts, under Syndication --> Options, or you can set tags
53 - to apply to all incoming syndicated posts from a particular feed in that
54 - feed's Edit screen.
55 -
56 -* FORMATTING FILTERS: There is a new option available under Syndication ->
57 - Options which allows users to choose whether or not to expose syndicated
58 - posts to being altered by formatting filters. By default, FeedWordPress
59 - has always protected syndicated posts (which are already in display-ready
60 - HTML when they are syndicated) from being reformatted by formatting
61 - filters. However, this approach means that certain plugins which depend
62 - on formatting filters (for example, to add "Share This" bars or relevant
63 - links to the end of a post) are blocked from working on any syndicated
64 - posts. If you want to use one of these plugins together with
65 - FeedWordPress, you can now do so by changing the "Formatting Filters"
66 - setting from "Protect" to "Expose."
67 -
68 -* **`<atom:source>` ELEMENTS NOW INCLUDED IN ATOM FEED:** Atom 1.0 provides
69 - a standard method for aggregators to indicate information about the original source of
70 - a syndicated post, using the `<atom:source>` element. FeedWordPress now
71 - introduces standard `<atom:source>` elements including the title, homepage, and
72 - feed URI of the source from which a syndicated post was syndicated. Cf.
73 - <http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.source>
74 -
75 -* MODULARIZATION OF CODE: The code for different elements of FeedWordPress
76 - has been broken out into several modules for easier inspection,
77 - documentation, and maintenance of the code.
78 -
79 -* VERSIONING SCHEME CHANGED: FeedWordPress's feature set has proven stable
80 - enough that it can now be removed from beta status; a good thing, since
81 - I was very quickly running out of version numbers to use. New releases
82 - of FeedWordPress will have version numbers based on the date of their
83 - release.
84 -
85 -Changes from 0.992 to 0.993
86 -
87 -* WORDPRESS 2.5.1 COMPATIBILITY: FeedWordPress should now be compatible
88 - with WordPress 2.5.1.
89 -
90 -* WORDPRESS 2.5 INTERFACE IMPROVEMENTS: FeedWordPress's Dashboard
91 - interface has undergone several cosmetic changes that should help it
92 - integrate better with the WordPress Dashboard interface in WordPress
93 - version 2.5.x.
94 -
95 -* SYNDICATED POSTS CAN BE MARKED AS "PENDING REVIEW": WordPress 2.3 users
96 - can now take advantage of WordPress's new "Pending Review" features for
97 - incoming syndicated posts. Posts marked as "Pending Review" are not
98 - published immediately, but are marked as ready to be reviewed by an
99 - Administrator or Editor, who can then choose to publish the post or
100 - hold it back. If you want to review syndicated posts from a particular
101 - feed, or from all feeds, before they are posted, then use
102 - Syndication --> Syndicated Sites --> Edit or Syndication --> Options to
103 - change the settings for handling new posts.
104 -
105 -* AWARE OF NEW URI FOR del.icio.us FEEDS: Previous releases of
106 - FeedWordPress already automatically split del.icio.us tags up
107 - appropriately appropriately when generating categories. (del.icio.us
108 - feeds smoosh all the tags into a single `<dc:subject>` element,
109 - separated by spaces; FeedWordPress un-smooshes them into multiple
110 - categories by separating them at whitespace.) Unfortunately, del.icio.us
111 - recently broke the existing behavior by changing host names for their
112 - feeds from del.icio.us to feeds.delicious.com. Version 0.993 accounts
113 - for the new host name and un-breaks the tag splitting.
114 -
115 -Changes from 0.991 to 0.992
116 -* AUTHOR RE-MAPPING: FeedWordPress now offers considerable control over
117 - how author names on a feed are translated into usernames within the
118 - WordPress database. When a post by an unrecognized author comes in,
119 - Administrators can now specify any username as the default username to
120 - assign the post to by setting the option in Syndication --> Options
121 - (formerly FeedWordPress only allowed you to assign such posts to user
122 - #1, the site administrator). Administrators can also create re-mapping
123 - rules for particular feeds (under Syndication --> Syndicated Sites -->
124 - Edit), so that (for example) any posts attributed to "Administrator"
125 - on the feed <http://praxeology.net/blog/feed/> will be assigned to
126 - a user named "Roderick T. Long," rather than a user named
127 - "Administrator." These settings also allow administrators to filter out
128 - posts by particular users, and to control what will happen when
129 - FeedWordPress encounters a post by an unrecognized user on that
130 - particular feed.
131 -
132 -* BUG RELATED TO URIS CONTAINING AMPERSAND CHARACTERS FIXED: A bug in
133 - WordPress 2.x's handling of URIs in Blogroll links created problems for
134 - updating any feeds whose URIs included an ampersand character, such as
135 - Google News RSS feeds and other feeds that have multiple parameters
136 - passed through HTTP GET. If you experienced this bug, the most likely
137 - effect was that FeedWordPress simply would not import new posts from a
138 - feed when instructred to do so, returning a "0 new posts" response. In
139 - other cases, it might lead to unpredictable results from feed updates,
140 - such as importing posts which were not contained in the feed being
141 - syndicated, but which did appear elsewhere on the same website. This bug
142 - has, hopefully, been resolved, by correcting for the bug in WordPress.
143 -
144 -Changes from 0.99 to 0.991
145 -* WORDPRESS MU COMPATABILITY: FeedWordPress should now be compatible with
146 - recent releases of WordPress MU. Once FeedWordPress is made available
147 - as a plugin, each individual blog can choose to activate FeedWordPress
148 - and syndicate content from its own set of contributors.
149 -
150 -* DISPLAY OF MAGPIE WARNINGS: A number of MagpieRSS warnings or error
151 - messages that were displayed when performing an automatic update are
152 - no longer displayed, unless debugging parameters have been explicitly
153 - enabled.
154 -
155 -* BUG RELATED TO INTERNATIONAL CHARACTERS IN AUTHOR NAMES FIXED: Due to a
156 - subtle incompatability between the way that FeedWordPress generated new
157 - user information, and the way that WordPress 2.0 and later added new
158 - authors to the database, FeedWordPress might end up creating duplicate
159 - authors, or throwing a critical error message, when it encountered
160 - authors whose names included international characters. This
161 - incompatability has now been fixed; hopefully, authors with
162 - international characters in their names should now be handled properly.
163 -
164 -* media:content BUG IN MAGPIERSS FIXED: A bug in MagpieRSS's handling of
165 - namespaced elements has been fixed. Among other things, this bug caused
166 - items containing a Yahoo MediaRSS `<media:content>` element (such as
167 - many of the feeds produced by wordpress.com) to be represented
168 - incorrectly, with only a capital "A" where the content of the post
169 - should have been. Feeds containing `<media:content>` elements should now
170 - be syndicated correctly.
171 -
172 -* update_feedwordpress PARAMETER: You can now use an HTTP GET parameter
173 - (`update_feedwordpress=1`) to request that FeedWordPress poll its feeds
174 - for updates. When used together with a crontab or other means of
175 - scheduling tasks, this means that you can keep your blog automatically
176 - updated on a regular schedule, even if you do not choose to use the
177 - cron-less automatic updates option.
178 -
179 -* Some minor interface-related bugs were also fixed.
180 -
181 -
182 -Changes from 0.981 to 0.99
183 -Version 0.99 adds several significant new features, fixes some bugs, and
184 -provides compatability with WordPress 2.2.x and 2.3.x.
185 -
186 -* WORDPRESS 2.2 AND 2.3 COMPATIBILITY: FeedWordPress should now be
187 - compatible with WordPress version 2.2 and the upcoming WordPress
188 - version 2.3. In particular, it has been tested extensively against
189 - WordPress 2.2.3 and WordPress 2.3 Release Candidate 1.
190 -
191 -* AUTOMATIC UPDATES WITHOUT CRON: FeedWordPress now allows you to
192 - automatically schedule checks for new posts without using external task
193 - scheduling tools such as cron. In order to enable automatic updates, go
194 - to **Syndication --> Options** and set "Check for new posts" to
195 - "automatically." For details, see "Automatic Feed Updates" in
196 - README.text.
197 -
198 - An important side-effect of the changes to the update system is that if
199 - you were previously using the cron job and the `update-feeds.php` script
200 - to schedule updates, you need to change your cron set-up. The old
201 - `update-feeds.php` script no longer exists. Instead, if you wish to use
202 - a cron job to guarantee updates on a particular schedule, you should
203 - have the cron job fetch the front page of your blog (for example, by
204 - using `curl http://www.zyx.com/blog/ > /dev/null`) instead of activating
205 - the `update-feeds.php` script. If automatic updates have been enabled,
206 - fetching the front page will automatically trigger the update process.
207 -
208 -* INTERFACE REORGANIZATION: All FeedWordPress functions are now located
209 - under a top-level "Syndication" menu in the WordPress Dashboard. To
210 - manage the list of syndicated sites, manually check for new posts on
211 - one or more feeds, or syndicate a new site, you should use the main page
212 - under **Syndication**. To change global settings for FeedWordPress,
213 - you should use **Syndication --> Options**.
214 -
215 -* FILE STRUCTURE REORGANIZATION: Due to a combination of changing styles
216 - for FeedWordPress plugins and lingering bugs in the FeedWordPress admin
217 - menu code, the code for FeedWordPress is now contained in two different
218 - PHP files, which should be installed together in a subdirectory of your
219 - plugins directory named `feedwordpress`. (See README.text for
220 - installation and upgrade instructions relating to the change.)
221 -
222 -* MULTIPLE CATEGORIES SETTING: Some feeds use non-standard methods to
223 - indicate multiple categories within a single category element. (The most
224 - popular site to do this is del.icio.us, which separates tags with a
225 - space.) FeedWordPress now allows you to set an optional setting, for any
226 - feed which does this, indicating the character or characters used to
227 - divide multiple categories, using a Perl-compatible regular expression.
228 - (In the case of del.icio.us feeds, FeedWordPress will automatically use
229 - \s for the pattern without your having to do any further configuration.)
230 - To turn this setting on, simply use the "Edit" link for the feed that
231 - you want to turn it on for.
232 -
233 -* REGULAR EXPRESSION BUG FIXED: Eliminated a minor bug in the regular
234 - expressions for e-mail addresses (used in parsing RSS `author`
235 - elements), which could produce unsightly error messages for some users
236 - parsing RSS 2.0 feeds.
237 -
238 -* DATE / UPDATE BUG FIXED: A bug in date handling was eliminated that may
239 - have caused problems if any of (1) WordPress, or (2) PHP, or (3) your
240 - web server, or (4) your MySQL server, has been set to use a different
241 - time zone from the one that any of the others is set to use. If
242 - FeedWordPress has not been properly updating updated posts, or has been
243 - updating posts when there shouldn't be any changes for the update, this
244 - release may solve that problem.
245 -
246 -* GOOGLE READER BUGS FIXED: A couple of bugs that made it difficult for
247 - FeedWordPress to interact with Google Reader public feeds have been
248 - fixed. Firstly, if you encountered an error message reading "There was a
249 - problem adding the newsfeed. [SQL: ]" when you tried to add the feed,
250 - the cause of this error has been fixed. Secondly, if you succeeded in
251 - getting FeedWordPress to check a Google Reader feed, only to find that
252 - the title of posts had junk squashed on to the end of them, that bug
253 - has been fixed too. To fix this bug, you must install the newest version
254 - of the optional MagpieRSS upgrade.
255 -
256 -* FILTER PARAMETERS: Due to an old, old bug in WordPress 1.5.0 (which was
257 - what was available back when I first wrote the filter interface),
258 - FeedWordPress has traditionally only passed one parameter to
259 - syndicated_item and syndicated_post filters functions -- an array
260 - containing either the Magpie representation of a syndicated item from
261 - the feed, or the database representation of a post about to be inserted
262 - into the WordPress database. If you needed information about the feed
263 - that the item came from, this was accessible only through a pair of
264 - global variables, $fwp_channel and $fwp_feedmeta.
265 -
266 - Since it's been a pretty long time since WordPress 1.5.0 was in
267 - widespread usage, I have gone ahead and added an optional second
268 - parameter to the invocation of the syndicated_item and syndicated_post
269 - filters. If you have written a filter for FeedWordPress that uses either
270 - of these hooks, you can now register that filter to accept 2 parameters.
271 - If you do so, the second parameter will be a SyndicatedPost object,
272 - which, among other things, allows you to access information about the
273 - feed from which an item is syndicated using the $post->feed and the
274 - $post->feedmeta elements (where $post is the name of the second
275 - parameter).
276 -
277 - NOTE THAT THE OLD GLOBAL VARIABLES ARE STILL AVAILABLE, for the time
278 - being at least, so existing filters will not break with the upgrade.
279 - They should be considered deprecated, however, and may be eliminated in
280 - the future.
281 -
282 -* FILTER CHANGE / BUGFIX: the array that is passed as the first argument
283 - syndicated_post filters no longer is no longer backslash-escaped for
284 - MySQL when filters are called. This was originally a bug, or an
285 - oversight; the contents of the array should only be escaped for the
286 - database *after* they have gone through all filters. IF YOU HAVE WRITTEN
287 - ANY syndicated_post FILTERS THAT PRESUME THE OLD BEHAVIOR OF PASSING IN
288 - STRINGS THAT ARE ALREADY BACKSLASH-ESCAPED, UPDATE YOUR FILTERS
289 - ACCORDINGLY.
290 -
291 -* OTHER MINOR BUGFIXES AND INTERNAL CHANGES: The internal architecture of
292 - FeedWordPress has been significantly changed to make the code more
293 - modular and clean; hopefully this should help reduce the number of
294 - compatibility updates that are needed, and make them easier and quicker
295 - when they are needed.
296 -
297 -Changes from 0.98 to 0.981
298 -Version 0.981 is a narrowly targeted bugfix and compatibility release, whose
299 -main purpose is to resolve a major outstanding problem: the incompatibility
300 -between version 0.98 of WordPress and the recently released WordPress 2.1.
301 -
302 -* WORDPRESS 2.1 COMPATIBILITY: FeedWordPress is now compatible with
303 - WordPress 2.1, as well as retaining its existing support for WordPress
304 - 2.0 and 1.5. Incompatibilities that resulted in database warnings, fatal
305 - errors, and which prevented FeedWordPress from syndicating new posts,
306 - have been eliminated.
307 -
308 -* RSS-FUNCTIONS.PHP RENAMED TO RSS.PHP: if you use the upgraded MagpieRSS
309 - replacement that's included with FeedWordPress, be sure to note that
310 - there are now *two* files to upload from the `OPTIONAL/wp-includes`
311 - subdirectory in order to carry out the upgrade: rss-functions.php and
312 - rss.php. **It is necessary to upload both files**, due to a change in
313 - the file naming scheme in WordPress 2.1, and it is necessary to do so
314 - whether you are using WordPress 2.1 or not. If you only upload the
315 - `rss-functions.php` file as in previous installations you will not have
316 - a working copy of MagpieRSS; the rss.php file contains the actual code.
317 -
318 -* DATE BUG AFFECTING SOME PHP INSTALLATIONS RESOLVED: due to a subtle bug
319 - in parse_w3cdtf(), some installations of PHP encountered problems with
320 - FeedWordPress's attempt to date posts, which would cause some new posts
321 - on Atom feeds to be dated as if they had apppeared in 1969 or 1970
322 - (thus, effectively, never appearing on front apge at all). This bug in
323 - the date handling should now be fixed.
324 -
325 -* PHP <?=...?> SHORT FORM ELIMINATED: some installations of PHP do not
326 - allow the <?=...?> short form for printing PHP values, which was used
327 - extensively in the FeedWordPress interface code. Since this could cause
328 - fatal errors for users with the wrong installation of PHP, the short
329 - form has been replaced with full PHP echo statements, and is no longer
330 - used in FeedWordPress.
331 -
332 -* BETTER USER INTERFACE INTEGRATION WITH WORDPRESS 2.x: Some minor changes
333 - have been made to help the FeedWordPress interface pages blend in better
334 - with the user interface when running under WordPress 2.x.
335 -
336 -* GLOBAL CATEGORIES BUG RESOLVED: a bug that prevented some users from
337 - setting one or more categories to apply to syndicated posts from all
338 - feeds (using the checkbox interface under Options --> Syndication) has
339 - been resolved.
340 -
341 -Changes from 0.97 to 0.98
342 -
343 -* WORDPRESS 2.0 COMPATIBILITY: This is a narrowly-targeted release to
344 - solve a major outstanding problem. FeedWordPress is now compatible with
345 - both WordPress 1.5 and WordPress 2.0. Incompatibilities that caused
346 - fatal SQL errors, and a more subtle bug with off-kilter counts of posts
347 - under a given category, have been resolved. FeedWordPress tests for
348 - database schema using the global $wp_db_version variable (if null, then
349 - we presume that we're dealing with WordPress 1.5).
350 -
351 - NOTE: I have **not** fully tested FeedWordPress with WordPress 2.0.
352 - Further testing may reveal more bugs. However, you should now be able
353 - to get at least basic FeedWordPress functionality up and running.
354 -
355 -* AUTHOR MATCHING: FeedWordPress tests several fields to see if it can
356 - identify the author of the post as a user already in the WordPress user
357 - database. In previous versions, it tested the user login, the nickname,
358 - and tested for "aliases" listed in the Profile (see documentation). FWP
359 - now also matches authors on the basis of e-mail address (*if* an e-mail
360 - address is present). This is particularly helpful for formats such as
361 - RSS 2.0, in which authors are primarily identified by e-mail addresses.
362 -
363 -Changes from 0.96 to 0.97
364 -
365 -* INSTALLATION PROCEDURE: Some of the changes between 0.96 and 0.97
366 - require upgrades to the meta-data stored by FeedWordPress to work
367 - properly. Thus, if you are upgrading from 0.96 or earlier to 0.97, most
368 - FeedWordPress operations (including updates and template functions)
369 - WILL BE DISABLED until you run the upgrade procedure. Fortunately,
370 - running the upgrade procedure is easy: just go to either Options -->
371 - Syndication or Links --> Syndicated in the WordPress Dashboard and press
372 - the button.
373 -
374 -* FEED FORMAT SUPPORT: Support has been added for the Atom 1.0 IETF
375 - standard. Several other elements are also newly supported
376 - (dcterms:created, dcterms:issued, dcterms:modified, dc:identifier,
377 - proper support for the RSS 2.0 guid element, the RSS 2.0 author element,
378 - the use of Atom author or Dublin Core dc:creator constructs at the feed
379 - level to identify the author of individual items, etc.)
380 -
381 - N.B.: full support of several Atom 1.0 features, such as categories
382 - and enclosures, requires you to install the optional rss-functions.php
383 - upgrade in your wp-includes directory.
384 -
385 -* BUG FIX: Running `update-feeds.php` from command line or crontab
386 - returned "I don't syndicate..." errors. It turns out that WordPress
387 - sometimes tramples on the internal PHP superglobals that I depended on
388 - to determine whether or not the script was being invoked from the
389 - command line. This has been fixed (the variables are now checked
390 - *before* WordPress can trample them). Note that `update-feeds.php` has
391 - been thoroughly overhauled anyway; see below for details.
392 -
393 -* BUG FIX: Duplicate categories or author names. Fixed two bugs that could
394 - create duplicate author and/or category names when the name contained
395 - either (a) certain international characters (causing a mismatch between
396 - MySQL and PHP's handling of lowercasing text), or (b) characters that
397 - have a special meaning in regular expressions (causing MySQL errors when
398 - looking for the author or category due to regexp syntax errors). These
399 - should now be fixed thanks to careful escaping of names that go into
400 - regular expressions and careful matching of lowercasing functions
401 - (comparing results from PHP only to other results from PHP, and results
402 - from MySQL only to other results from MySQL).
403 -
404 -* BUG FIX: Items dated Decembr 31, 1969 should appear less often. The
405 - function for parsing W3C date-time format dates that ships with
406 - MagpieRSS can only correctly parse fully-specified dates with a
407 - fully-specified time, but valid W3C date-time format dates may omit the
408 - time, the day of the month, or even the month. Some feeds in the wild
409 - date their items with coarse-grained dates, so the optional
410 - `rss-functions.php` upgrade now includes a more flexible parse_w3cdtf()
411 - function that will work with both coarse-grained and fully-specified
412 - dates. (If parts of the date or the time are omitted, they are filled in
413 - with values based on the current time, so '2005-09-10' will be dated to
414 - the current time on that day; '2004' will be dated to this day and time
415 - one year ago.
416 -
417 - N.B.: This fix is only available in the optional `rss-functions.php`
418 - upgrade.
419 -
420 -* BUG FIX: Evil use of HTTP GET has been undone. The WordPress interface
421 - is riddled with inappropriate (non-idempotent) uses of HTTP GET queries
422 - (ordinary links that make the server do something with significant
423 - side-effects, such as deleting a post or a link from the database).
424 - FeedWordPress did some of this too, especially in places where it aped
425 - the WordPress interface (e.g. the "Delete" links in Links -->
426 - Syndicated). That's bad business, though. I've changed the interface so
427 - that all the examples of improper side-effects that I can find now
428 - require an HTTP POST to take effect. I think I got pretty much
429 - everything; if there's anything that I missed, let me know.
430 -
431 - Further reading: [Sam Ruby 2005-05-06: This Stuff Matters] (http://www.intertwingly.net/blog/2005/05/06/This-Stuff-Matters)
432 -
433 -* BUG FIX: Categories applied by `cats` setting should no longer prevent
434 - category-based filtering from working. In FeedWordPress, you can (1)
435 - apply certain categories to all syndicated posts, or all posts from
436 - a particular feed; and (2) filter out all posts that don't match one
437 - of the categories that are already in the WordPress database (allowing
438 - for simple category-based filtering; just load up WordPress with the
439 - categories you want to accept, and then tell FeedWordPress not to create
440 - new ones). However, the way that (1) and (2) were implemented meant that
441 - you couldn't effectively use them together; once you applied a known
442 - category to all syndicated posts from a particular feed, it meant that
443 - they'd have at least one familiar category (the category or categories
444 - you were applying), and that would get all posts past the filter no
445 - matter what categories they were originally from.
446 -
447 - Well, no longer. You can still apply categories to all syndicated posts
448 - (using either Syndication --> Options, or the feed-level settings under
449 - Links --> Syndicated). But these categories are not applied to the post
450 - until *after* it has already passed by the "familiar categories" filter.
451 - So now, if you want, you can do category filtering and *then* apply as
452 - many categories as you please to all and only posts that pass the filter.
453 -
454 -* BUG FIX: Other minor typos and HTML gaffes were fixed along the way.
455 -
456 -* PERFORMANCE: get_feed_meta() no longer hits the database for information
457 - on every call; it now caches link data in memory, so FeedWordPress only
458 - goes to the database once for each syndicated link. This may
459 - substantially improve performance if your database server resources
460 - are tight and your templates make a lot of use of custom settings from
461 - get_feed_meta().
462 -
463 -* API CHANGE: Link ID numbers, rather than RSS URIs, are now used to
464 - identify the feed from which a post is syndicated when you use template
465 - functions such as get_feed_meta(). The practical upshot of this is you
466 - can switch feeds, or change the feed address for a particular syndicated
467 - site, without breaking your templates for all the posts that were
468 - syndicated from the earlier URI.
469 -
470 -* API CHANGE: if you have plugins or templates that make use of the
471 - get_feed_meta() function or the $fwp_feedmeta global, note that the
472 - data formerly located under the `uri` and `name` fields is now located
473 - under the `link/uri` field and the `link/name` field, respectively. Note
474 - also that you can access the link ID number for any given feed under the
475 - global $fwp_feedmeta['link/id'] (in plugins) or
476 - get_feed_meta('link/id') (in a template in post contexts).
477 -
478 -* FEATURE: the settings for individual feeds can now be edited using a
479 - humane interface (where formerly you had to tweak key-value pairs in the
480 - Link Notes section). To edit settings for a feed, pick the feed that you
481 - want under Links --> Syndicated and click the Edit link.
482 -
483 -* FEATURE: The "Unsubscribe" button (formerly "Delete") in Links -->
484 - Syndicated now offers three options for unsubscribing from a feed: (1)
485 - turning off the subscription without deleting the feed data or affecting
486 - posts that were syndicated from the feed (this works by setting the Link
487 - for the feed as "invisible"); (2) deleting the feed data and all of the
488 - posts that were syndicated from the feed; or (3) deleting the feed data
489 - and *keeping* the posts that were syndicated from the feed
490 - setting the Link to "Invisible" (meaning that it will not be displayed
491 - in lists of the site links on the front page, and it won't be checked
492 - for updates; (2) deleting the Link and all of the posts that were
493 - syndicated from its feed; or (3) deleting the feed data but keeping the
494 - posts that were syndicated (which will henceforward be treated as if
495 - they were local rather than syndicated posts). (Note that (1) is usually
496 - the best option for aggregator sites, unless you want to clean up the
497 - results of an error or a test.)
498 -
499 -* FEATURE / BUG FIX: If you have been receiving mysterious "I don't
500 - syndicate...", or "(local) HTTP status code was not 200", or "(local)
501 - transport error - could not open socket", or "parse error - not well
502 - formed" errors, then this update may solve your problems, and if it does
503 - *not* solve them, it will at least make the reasons for the problems
504 - easier to understand. That's because I've overhauled the way that
505 - FeedWordPress goes about updating feeds.
506 -
507 - If you use the command-line PHP scripting method to run scheduled
508 - updates, then not much should change for you, except for fewer
509 - mysterious errors. If you have done updates by sending periodic HTTP
510 - requests to <http://your-blog.com/path/wp-content/update-feeds.php>,
511 - then the details have changed somewhat; mostly in such a way as to make
512 - things easier on you. See the README file or online documentation on
513 - Staying Current for the details.
514 -
515 -* FEATURE: FeedWordPress now features a more sophisticated system for
516 - timed updates. Instead of polling *every* subscribed feed for updates
517 - *each* time `update-feeds.php` is run, FeedWordPress now keeps track of
518 - the last time it polled each feed, and only polls them again after a
519 - certain period of time has passed. The amount of time is normally set
520 - randomly for each feed, in a period between 30 minutes and 2 hours (so
521 - as to stagger updates over time rather than polling all of the feeds at once. However, the length of time between updates can also be set
522 - directly by the feed, which brings us to ...
523 -
524 -* FEATURE: FeedWordPress now respects the settings in the `ttl` and
525 - Syndication Module RSS elements. Feeds with these elements set will not
526 - be polled any more frequently than they indicate with these feeds unless
527 - the user manually forces FeedWordPress to poll the feed (see Links -->
528 - Syndicated --> Edit settings).
529 -
530 -Changes from 0.95 to 0.96
531 -
532 -* FEATURE: support has been added for enclosures in RSS 2.0 and Atom
533 - 0.6+ newsfeeds. WordPress already supports adding enclosures to an
534 - item; FeedWordPress merely gets the information on the enclosure
535 - from the feed it is syndicating and plugs that information directly
536 - into the WordPress database so that (among other things) that post
537 - will have its enclosure listed in your blog's RSS 2 newsfeed.
538 -
539 - Note that enclosure support requires using the optional MagpieRSS
540 - upgrade (i.e., replacing your `wp-includes/rss-functions.php` with `OPTIONAL/wp-includes/rss-functions.php` from the FWP archive)
541 -
542 -* FEATURE: for completeness's sake, there is now a feed setting,
543 - `hardcode url`, that allows you to set the URI for the front page
544 - of a contributor's website manually (that is, prevent it from being
545 - automatically updated from the feed channel link on each update). To
546 - set the URI manually, put a line like this in the Link Notes section
547 - of a feed:
548 -
549 - hardcode url: yes
550 -
551 - You can also instruct FeedWordPress to use hardcoded URIs by default
552 - on all feeds using Options --> Syndication
553 -
554 -* FEATURE: by default, when FeedWordPress finds new syndicated posts,
555 - it (1) publishes them immediately, (2) turns comments off, and (3)
556 - turns trackback / pingback pings off. You can now alter all three
557 - default behaviors (e.g., to allow pings on syndicated posts, or to
558 - send newly-syndicated posts to the draft pile for moderation) using
559 - Options --> Syndication
560 -
561 -
562 4 Changes from 0.91 to 0.95
563 5 -------------------------
564 6
565 -* BUG FIX: Fixed an obscure bug in the handling of categories:
566 - categories with trailing whitespace could cause categories with
567 - duplicate names to be created. This no longer happens. While I was
568 - at it I tightened up the operation of
569 - FeedWordPress::lookup_categories() a bit in general.
7 +* BUG FIX: Fixed an obscure bug in the handling of categories: categories
8 + with trailing whitespace could cause categories with duplicate names to
9 + be created. This no longer happens. While I was at it I tightened up the
10 + operation of FeedWordPress::lookup_categories() a bit in general.
570 11
571 12 * FEATURE DEPRECATED: the feed setting `hardcode categories` is now
572 - deprecated in favor of `unknown categories` (see below), which
573 - allows you to strip off any syndication categories not already in
574 - your database using `unknown categories: default` or `unknown
575 - categories: filter`. If you have `hardcode categories: yes` set on a
576 - feed, this will be treated as `unknown categories: default` (i.e.,
577 - no new categories will be added, but if a post doesn't match any of
578 - the categories it will be added in the default category--usually
579 - "Uncategorized" or "General").
13 + deprecated in favor of `unknown categories` (see below), which allows
14 + you to strip off any syndication categories not already in your database
15 + using `unknown categories: default` or `unknown categories: filter`. If
16 + you have `hardcode categories: yes` set on a feed, this will be treated
17 + as `unknown categories: default` (i.e., no new categories will be added,
18 + but if a post doesn't match any of the categories it will be added in
19 + the default category--usually "Uncategorized" or "General").
580 20
581 21 * FEATURE: You can now set global defaults as to whether or not
582 - FeedWordPress will update the Link Name and Link Description
583 - settings for feeds automatically from the feed title and feed
584 - tagline. (By default, it does, as it has in past versions.) Whether
585 - this behavior is turned on or off, you can still override the
586 - default behavior using feed settings of `hardcode name: yes`,
587 - `hardcode name: no`, `hardcode description: yes`, or `hardcode
588 - description: no`.
22 + FeedWordPress will update the Link Name and Link Description settings
23 + for feeds automatically from the feed title and feed tagline. (By
24 + default, it does, as it has in past versions.) Whether this behavior is
25 + turned on or off, you can still override the default behavior using
26 + feed settings of `hardcode name: yes`, `hardcode name: no`,
27 + `hardcode description: yes`, or `hardcode description: no`.
589 28
590 -* FEATURE: Users can now provide one or several "aliases" for an
591 - author, just as they can for a category. For example, to make
592 - FeedWordPress treat posts by "Joseph Cardinal Ratzinger" and "Pope
593 - Benedict XVI" as by the same author, edit the user profile for Pope
594 - Benedict XVI and add a line like this to the "User profile" field:
29 +* FEATURE: Users can now provide one or several "aliases" for an author,
30 + just as they can for a category. For example, to make FeedWordPress
31 + treat posts by "Joseph Cardinal Ratzinger" and "Pope Benedict XVI" as
32 + by the same author, edit the user profile for Pope Benedict XVI and add
33 + a line like this to the "User profile" field:
595 34
596 35 a.k.a.: Joseph Cardinal Ratzinger
597 36
598 - You can add several aliases, each on a line by itself. You can also
599 - add any other text you like to the Profile without interfering with
600 - the aliases.
37 + You can add several aliases, each on a line by itself. You can also add
38 + any other text you like to the Profile without interfering with the
39 + aliases.
601 40
602 -* FEATURE: Users can now choose how to handle syndicated posts that
603 - are in unfamiliar categories or by unfamiliar authors (i.e.,
604 - categories or authors whose names are not yet in the WordPress
605 - database). By default, FeedWordPress will (as before) create a new
606 - category (or new author) and use it for the current post and any
607 - future posts. This behavior can be changed, either for all feeds or
608 - for one or another particular feed.
41 +* FEATURE: Users can now choose how to handle syndicated posts that are
42 + in unfamiliar categories or by unfamiliar authors (i.e., categories or
43 + authors whose names are not yet in the WordPress database). By default,
44 + FeedWordPress will (as before) create a new category (or new author) and
45 + use it for the current post and any future posts. This behavior can be
46 + changed, either for all feeds or for one or another particular feed.
609 47
610 48 There are now three different options for an unfamiliar author: (1)
611 49 FeedWordPress can create a new author account and attribute the
612 - syndicated post to the new account; (2) FeedWordPress can attribute
613 - the post to an author if the author's name is familiar, and to a
614 - default author (currently, this means the Site Administrator
615 - account) if it is not; (3) FeedWordPress can drop posts by
616 - unfamiliar authors and syndicate only posts by authors who are
617 - already in the database.
50 + syndicated post to the new account; (2) FeedWordPress can attribute the
51 + post to an author if the author's name is familiar, and to a default
52 + author (currently, this means the Site Administrator account) if it is
53 + not; (3) FeedWordPress can drop posts by unfamiliar authors and
54 + syndicate only posts by authors who are already in the database.
618 55
619 - There are, similarly, two different options for an unfamiliar
620 - category: (1) FeedWordPress can create new categories and place the
621 - syndicated post in them; (2) FeedWordPress can drop the unfamiliar
622 - categories and place syndicated posts only in categories that it is
623 - already familiar with. In addition, FeedWordPress 0.95 lets you
624 - choose whether posts that are in *no* familiar categories should be
625 - syndicated (and placed in the default category for the blog) or
626 - simply dropped.
56 + There are, similarly, two different options for an unfamiliar category:
57 + (1) FeedWordPress can create new categories and place the syndicated
58 + post in them; (2) FeedWordPress can drop the unfamiliar categories and
59 + place syndicated posts only in categories that it is already familiar
60 + with. In addition, FeedWordPress 0.95 lets you choose whether posts that
61 + are in *no* familiar categories should be syndicated (and placed in the
62 + default category for the blog) or simply dropped.
627 63
628 - You can set the default behavior for both authors and categories
629 - using the settings in Options --> Syndication. You can also set
630 - different behavior for specific feeds by adding the `unfamiliar
631 - author` and / or `unfamiliar categories` settings to the Link Notes
632 - section of a feed:
64 + You can set the default behavior for both authors and categories using
65 + the settings in Options --> Syndication. You can also set different
66 + behavior for specific feeds by adding the `unfamiliar author` and / or
67 + `unfamiliar categories` settings to the Link Notes section of a feed:
633 68
634 69 unfamiliar author: (create|default|filter)
635 70 unfamiliar categories: (create|default|filter)
636 71
637 - A setting of `unfamiliar author: create` will make FeedWordPress
638 - create new authors to match unfamiliar author names *for this feed
639 - alone*. A setting of `unfamiliar author: default` will make it
640 - assign posts from unfamiliar authors to the default user account. A
641 - setting of `unfamiliar author: filter` will cause all posts (from
642 - this feed alone) to be dropped unless they are by an author already
643 - listed in the database. Similiarly, `unfamiliar categories: create`
644 - will make FeedWordPress create new categories to match unfamiliar
645 - category names *for this feed alone*; `unfamiliar categories:
646 - default` will cause it to drop any unfamiliar category names; and
72 + A setting of `unfamiliar author: create` will make FeedWordPress create
73 + new authors to match unfamiliar author names *for this feed alone*. A
74 + setting of `unfamiliar author: default` will make it assign posts from
75 + unfamiliar authors to the default user account. A setting of
76 + `unfamiliar author: filter` will cause all posts (from this feed alone)
77 + to be dropped unless they are by an author already listed in the
78 + database. Similiarly, `unfamiliar categories: create` will make
79 + FeedWordPress create new categories to match unfamiliar category names
80 + *for this feed alone*; `unfamiliar categories: default` will cause it
81 + to drop any unfamiliar category names; and
647 82 `unfamiliar categories: filter` will cause it to *both* drop any
648 - unfamiliar category names *and* to only syndicate posts that are
649 - placed in one or more familiar categories.
83 + unfamiliar category names *and* to only syndicate posts that are placed
84 + in one or more familiar categories.
650 85
651 - These two new features allow users to do some coarse-grained
652 - filtering without having to write a PHP filter. Specifically, they
653 - offer an easy way for you to filter feeds by category or by author.
654 - Suppose, for example, that you only wanted to syndicate posts that
655 - your contributors place in the "Llamas" category. You could do so by
656 - setting up your installation of WordPress so that the only category
657 - in the database is "Llamas," and then use Options --> Syndication to
658 - set "Unfamiliar categories" to "don't create new categories and
659 - don't syndicate posts unless they match at least one familiar
660 - category". Now, when you update, only posts in the "Llamas" category
661 - will be syndicated by FeedWordPress.
86 + These two new features allow users to do some coarse-grained filtering
87 + without having to write a PHP filter. Specifically, they offer an easy
88 + way for you to filter feeds by category or by author. Suppose, for
89 + example, that you only wanted to syndicate posts that your contributors
90 + place in the "Llamas" category. You could do so by setting up your
91 + installation of WordPress so that the only category in the database is
92 + "Llamas," and then use Options --> Syndication to set "Unfamiliar
93 + categories" to "don't create new categories and don't syndicate posts
94 + unless they match at least one familiar category". Now, when you update,
95 + only posts in the "Llamas" category will be syndicated by FeedWordPress.
662 96
663 97 Similarly, if you wanted to filter one particular feed so that only
664 98 posts by (for example) the author "Earl J. Llama" were syndicated to
665 - your site, you could do so by creating a user account for Earl J.
666 - Llama, then adding the following line to the settings for the feed
667 - in Link Notes:
99 + your site, you could do so by creating a user account for Earl J. Llama,
100 + then adding the following line to the settings for the feed in Link
101 + Notes:
668 102
669 103 unfamiliar author: filter
670 104
671 - This will cause any posts from this feed that are not authored by
672 - Earl J. Llama to be discarded, and only the posts by Earl J. Llama
673 - will be syndicated. (If the setting is used on one specific feed, it
674 - will not affect how posts from other feeds are syndicated.)
105 + This will cause any posts from this feed that are not authored by Earl
106 + J. Llama to be discarded, and only the posts by Earl J. Llama will be
107 + syndicated. (If the setting is used on one specific feed, it will not
108 + affect how posts from other feeds are syndicated.)
675 109