| @@ -1,197 +1,6 @@ | ||
| 1 | -FeedWordPress Change Log | |
| 2 | -======================== | |
| 3 | - | |
| 4 | -Changes from 0.97 to 0.98 | |
| 5 | - | |
| 6 | -* WORDPRESS 2.0 COMPATIBILITY: This is a narrowly-targeted release to | |
| 7 | - solve a major outstanding problem. FeedWordPress is now compatible with | |
| 8 | - both WordPress 1.5 and WordPress 2.0. Incompatibilities that caused | |
| 9 | - fatal SQL errors, and a more subtle bug with off-kilter counts of posts | |
| 10 | - under a given category, have been resolved. FeedWordPress tests for | |
| 11 | - database schema using the global $wp_db_version variable (if null, then | |
| 12 | - we presume that we're dealing with WordPress 1.5). | |
| 13 | - | |
| 14 | - NOTE: I have **not** fully tested FeedWordPress with WordPress 2.0. | |
| 15 | - Further testing may reveal more bugs. However, you should now be able | |
| 16 | - to get at least basic FeedWordPress functionality up and running. | |
| 17 | - | |
| 18 | -* AUTHOR MATCHING: FeedWordPress tests several fields to see if it can | |
| 19 | - identify the author of the post as a user already in the WordPress user | |
| 20 | - database. In previous versions, it tested the user login, the nickname, | |
| 21 | - and tested for "aliases" listed in the Profile (see documentation). FWP | |
| 22 | - now also matches authors on the basis of e-mail address (*if* an e-mail | |
| 23 | - address is present). This is particularly helpful for formats such as | |
| 24 | - RSS 2.0, in which authors are primarily identified by e-mail addresses. | |
| 25 | - | |
| 26 | -Changes from 0.96 to 0.97 | |
| 27 | - | |
| 28 | -* INSTALLATION PROCEDURE: Some of the changes between 0.96 and 0.97 | |
| 29 | - require upgrades to the meta-data stored by FeedWordPress to work | |
| 30 | - properly. Thus, if you are upgrading from 0.96 or earlier to 0.97, most | |
| 31 | - FeedWordPress operations (including updates and template functions) | |
| 32 | - WILL BE DISABLED until you run the upgrade procedure. Fortunately, | |
| 33 | - running the upgrade procedure is easy: just go to either Options --> | |
| 34 | - Syndication or Links --> Syndicated in the WordPress Dashboard and press | |
| 35 | - the button. | |
| 36 | - | |
| 37 | -* FEED FORMAT SUPPORT: Support has been added for the Atom 1.0 IETF | |
| 38 | - standard. Several other elements are also newly supported | |
| 39 | - (dcterms:created, dcterms:issued, dcterms:modified, dc:identifier, | |
| 40 | - proper support for the RSS 2.0 guid element, the RSS 2.0 author element, | |
| 41 | - the use of Atom author or Dublin Core dc:creator constructs at the feed | |
| 42 | - level to identify the author of individual items, etc.) | |
| 43 | - | |
| 44 | - N.B.: full support of several Atom 1.0 features, such as categories | |
| 45 | - and enclosures, requires you to install the optional rss-functions.php | |
| 46 | - upgrade in your wp-includes directory. | |
| 47 | - | |
| 48 | -* BUG FIX: Running `update-feeds.php` from command line or crontab | |
| 49 | - returned "I don't syndicate..." errors. It turns out that WordPress | |
| 50 | - sometimes tramples on the internal PHP superglobals that I depended on | |
| 51 | - to determine whether or not the script was being invoked from the | |
| 52 | - command line. This has been fixed (the variables are now checked | |
| 53 | - *before* WordPress can trample them). Note that `update-feeds.php` has | |
| 54 | - been thoroughly overhauled anyway; see below for details. | |
| 55 | - | |
| 56 | -* BUG FIX: Duplicate categories or author names. Fixed two bugs that could | |
| 57 | - create duplicate author and/or category names when the name contained | |
| 58 | - either (a) certain international characters (causing a mismatch between | |
| 59 | - MySQL and PHP's handling of lowercasing text), or (b) characters that | |
| 60 | - have a special meaning in regular expressions (causing MySQL errors when | |
| 61 | - looking for the author or category due to regexp syntax errors). These | |
| 62 | - should now be fixed thanks to careful escaping of names that go into | |
| 63 | - regular expressions and careful matching of lowercasing functions | |
| 64 | - (comparing results from PHP only to other results from PHP, and results | |
| 65 | - from MySQL only to other results from MySQL). | |
| 66 | - | |
| 67 | -* BUG FIX: Items dated Decembr 31, 1969 should appear less often. The | |
| 68 | - function for parsing W3C date-time format dates that ships with | |
| 69 | - MagpieRSS can only correctly parse fully-specified dates with a | |
| 70 | - fully-specified time, but valid W3C date-time format dates may omit the | |
| 71 | - time, the day of the month, or even the month. Some feeds in the wild | |
| 72 | - date their items with coarse-grained dates, so the optional | |
| 73 | - `rss-functions.php` upgrade now includes a more flexible parse_w3cdtf() | |
| 74 | - function that will work with both coarse-grained and fully-specified | |
| 75 | - dates. (If parts of the date or the time are omitted, they are filled in | |
| 76 | - with values based on the current time, so '2005-09-10' will be dated to | |
| 77 | - the current time on that day; '2004' will be dated to this day and time | |
| 78 | - one year ago. | |
| 79 | - | |
| 80 | - N.B.: This fix is only available in the optional `rss-functions.php` | |
| 81 | - upgrade. | |
| 82 | - | |
| 83 | -* BUG FIX: Evil use of HTTP GET has been undone. The WordPress interface | |
| 84 | - is riddled with inappropriate (non-idempotent) uses of HTTP GET queries | |
| 85 | - (ordinary links that make the server do something with significant | |
| 86 | - side-effects, such as deleting a post or a link from the database). | |
| 87 | - FeedWordPress did some of this too, especially in places where it aped | |
| 88 | - the WordPress interface (e.g. the "Delete" links in Links --> | |
| 89 | - Syndicated). That's bad business, though. I've changed the interface so | |
| 90 | - that all the examples of improper side-effects that I can find now | |
| 91 | - require an HTTP POST to take effect. I think I got pretty much | |
| 92 | - everything; if there's anything that I missed, let me know. | |
| 93 | - | |
| 94 | - Further reading: [Sam Ruby 2005-05-06: This Stuff Matters] (http://www.intertwingly.net/blog/2005/05/06/This-Stuff-Matters) | |
| 95 | - | |
| 96 | -* BUG FIX: Categories applied by `cats` setting should no longer prevent | |
| 97 | - category-based filtering from working. In FeedWordPress, you can (1) | |
| 98 | - apply certain categories to all syndicated posts, or all posts from | |
| 99 | - a particular feed; and (2) filter out all posts that don't match one | |
| 100 | - of the categories that are already in the WordPress database (allowing | |
| 101 | - for simple category-based filtering; just load up WordPress with the | |
| 102 | - categories you want to accept, and then tell FeedWordPress not to create | |
| 103 | - new ones). However, the way that (1) and (2) were implemented meant that | |
| 104 | - you couldn't effectively use them together; once you applied a known | |
| 105 | - category to all syndicated posts from a particular feed, it meant that | |
| 106 | - they'd have at least one familiar category (the category or categories | |
| 107 | - you were applying), and that would get all posts past the filter no | |
| 108 | - matter what categories they were originally from. | |
| 109 | - | |
| 110 | - Well, no longer. You can still apply categories to all syndicated posts | |
| 111 | - (using either Syndication --> Options, or the feed-level settings under | |
| 112 | - Links --> Syndicated). But these categories are not applied to the post | |
| 113 | - until *after* it has already passed by the "familiar categories" filter. | |
| 114 | - So now, if you want, you can do category filtering and *then* apply as | |
| 115 | - many categories as you please to all and only posts that pass the filter. | |
| 116 | - | |
| 117 | -* BUG FIX: Other minor typos and HTML gaffes were fixed along the way. | |
| 118 | - | |
| 119 | -* PERFORMANCE: get_feed_meta() no longer hits the database for information | |
| 120 | - on every call; it now caches link data in memory, so FeedWordPress only | |
| 121 | - goes to the database once for each syndicated link. This may | |
| 122 | - substantially improve performance if your database server resources | |
| 123 | - are tight and your templates make a lot of use of custom settings from | |
| 124 | - get_feed_meta(). | |
| 125 | - | |
| 126 | -* API CHANGE: Link ID numbers, rather than RSS URIs, are now used to | |
| 127 | - identify the feed from which a post is syndicated when you use template | |
| 128 | - functions such as get_feed_meta(). The practical upshot of this is you | |
| 129 | - can switch feeds, or change the feed address for a particular syndicated | |
| 130 | - site, without breaking your templates for all the posts that were | |
| 131 | - syndicated from the earlier URI. | |
| 132 | - | |
| 133 | -* API CHANGE: if you have plugins or templates that make use of the | |
| 134 | - get_feed_meta() function or the $fwp_feedmeta global, note that the | |
| 135 | - data formerly located under the `uri` and `name` fields is now located | |
| 136 | - under the `link/uri` field and the `link/name` field, respectively. Note | |
| 137 | - also that you can access the link ID number for any given feed under the | |
| 138 | - global $fwp_feedmeta['link/id'] (in plugins) or | |
| 139 | - get_feed_meta('link/id') (in a template in post contexts). | |
| 140 | - | |
| 141 | -* FEATURE: the settings for individual feeds can now be edited using a | |
| 142 | - humane interface (where formerly you had to tweak key-value pairs in the | |
| 143 | - Link Notes section). To edit settings for a feed, pick the feed that you | |
| 144 | - want under Links --> Syndicated and click the Edit link. | |
| 145 | - | |
| 146 | -* FEATURE: The "Unsubscribe" button (formerly "Delete") in Links --> | |
| 147 | - Syndicated now offers three options for unsubscribing from a feed: (1) | |
| 148 | - turning off the subscription without deleting the feed data or affecting | |
| 149 | - posts that were syndicated from the feed (this works by setting the Link | |
| 150 | - for the feed as "invisible"); (2) deleting the feed data and all of the | |
| 151 | - posts that were syndicated from the feed; or (3) deleting the feed data | |
| 152 | - and *keeping* the posts that were syndicated from the feed | |
| 153 | - setting the Link to "Invisible" (meaning that it will not be displayed | |
| 154 | - in lists of the site links on the front page, and it won't be checked | |
| 155 | - for updates; (2) deleting the Link and all of the posts that were | |
| 156 | - syndicated from its feed; or (3) deleting the feed data but keeping the | |
| 157 | - posts that were syndicated (which will henceforward be treated as if | |
| 158 | - they were local rather than syndicated posts). (Note that (1) is usually | |
| 159 | - the best option for aggregator sites, unless you want to clean up the | |
| 160 | - results of an error or a test.) | |
| 161 | - | |
| 162 | -* FEATURE / BUG FIX: If you have been receiving mysterious "I don't | |
| 163 | - syndicate...", or "(local) HTTP status code was not 200", or "(local) | |
| 164 | - transport error - could not open socket", or "parse error - not well | |
| 165 | - formed" errors, then this update may solve your problems, and if it does | |
| 166 | - *not* solve them, it will at least make the reasons for the problems | |
| 167 | - easier to understand. That's because I've overhauled the way that | |
| 168 | - FeedWordPress goes about updating feeds. | |
| 169 | - | |
| 170 | - If you use the command-line PHP scripting method to run scheduled | |
| 171 | - updates, then not much should change for you, except for fewer | |
| 172 | - mysterious errors. If you have done updates by sending periodic HTTP | |
| 173 | - requests to <http://your-blog.com/path/wp-content/update-feeds.php>, | |
| 174 | - then the details have changed somewhat; mostly in such a way as to make | |
| 175 | - things easier on you. See the README file or online documentation on | |
| 176 | - Staying Current for the details. | |
| 177 | - | |
| 178 | -* FEATURE: FeedWordPress now features a more sophisticated system for | |
| 179 | - timed updates. Instead of polling *every* subscribed feed for updates | |
| 180 | - *each* time `update-feeds.php` is run, FeedWordPress now keeps track of | |
| 181 | - the last time it polled each feed, and only polls them again after a | |
| 182 | - certain period of time has passed. The amount of time is normally set | |
| 183 | - randomly for each feed, in a period between 30 minutes and 2 hours (so | |
| 184 | - 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 | |
| 185 | - directly by the feed, which brings us to ... | |
| 186 | - | |
| 187 | -* FEATURE: FeedWordPress now respects the settings in the `ttl` and | |
| 188 | - Syndication Module RSS elements. Feeds with these elements set will not | |
| 189 | - be polled any more frequently than they indicate with these feeds unless | |
| 190 | - the user manually forces FeedWordPress to poll the feed (see Links --> | |
| 191 | - Syndicated --> Edit settings). | |
| 1 | +Change Log | |
| 2 | +========== | |
| 192 | 3 | |
| 193 | 4 | Changes from 0.95 to 0.96 |
| 194 | 5 | ------------------------- |
| 195 | 6 | |
