| @@ -1,366 +1,7 @@ | ||
| 1 | 1 | FeedWordPress Change Log |
| 2 | 2 | ======================== |
| 3 | 3 | |
| 4 | -Changes from 0.993 to 2008.1030 | |
| 5 | - | |
| 6 | -* WORDPRESS 2.6 COMPATABILITY: FeedWordPress should now be compatible with | |
| 7 | - WordPress 2.6, and should work more or less seamlessly with the new post | |
| 8 | - revision system. A bug which caused multiple new revisions to be created | |
| 9 | - for posts on certain feeds, regardless of whether or not the item had | |
| 10 | - been updated, has been fixed. | |
| 11 | - | |
| 12 | -* INTERFACE IMPROVEMENTS: The user interface has been substantially | |
| 13 | - restyled to fit in better with the visual style of WordPress 2.5 and | |
| 14 | - 2.6. | |
| 15 | - | |
| 16 | -* YOUTUBE BUG FIXED: POSTS SYNDICATED THROUGH AN AUTOMATIC UPDATE ARE NO | |
| 17 | - LONGER STRIPPED OF `<OBJECT>` TAGS AND CERTAIN OTHER HTML ELEMENTS: Due | |
| 18 | - to the way that some versions of WordPress process posts that are | |
| 19 | - inserted into the database when no user is logged in, many users | |
| 20 | - experienced an issue where YouTube videos and other content using the | |
| 21 | - HTML `<object>` tag would be stripped out of posts that were syndicated | |
| 22 | - during an automatic update. (Posts that were syndicated through manual | |
| 23 | - updates from within the WordPress Dashboard were not affected, because | |
| 24 | - the issue does not arise when an update is executed under a logged-in | |
| 25 | - administrator's credentials.) This bug has now been fixed; YouTube | |
| 26 | - videos and other content using `<object>` tags should now appear | |
| 27 | - properly in syndicated posts, regardless of the way in which the post | |
| 28 | - was syndicated. | |
| 29 | - | |
| 30 | -* AJAX BUGS FIXED: Bugs which blocked the normal operation of WordPress | |
| 31 | - 2.5's AJAX interface elements when FeedWordPress was activated have been | |
| 32 | - fixed. | |
| 33 | - | |
| 34 | -* TAG SUPPORT: A couple of features have been introduced to take advantage | |
| 35 | - of the tagging features in WordPress 2.3.x, 2.5.x, and 2.6.x. Now, when | |
| 36 | - unfamiliar categories are encountered for posts on a feed, you can | |
| 37 | - choose for FeedWordPress (1) to drop the category; (2) to drop the | |
| 38 | - category and to filter out any post that does not match at least one | |
| 39 | - familiar category; (3) to create a new category with that name, or, | |
| 40 | - now, you can also have FeedWordPress (4) create a new *tag* with that | |
| 41 | - name. This option can be set site-wide under Syndication --> Options, | |
| 42 | - or it can be set on a feed-by-feed basis in a feed's Edit screen. | |
| 43 | - | |
| 44 | - In addition, you can now set particular tags to apply to all incoming | |
| 45 | - syndicated posts, under Syndication --> Options, or you can set tags | |
| 46 | - to apply to all incoming syndicated posts from a particular feed in that | |
| 47 | - feed's Edit screen. | |
| 48 | - | |
| 49 | -* FORMATTING FILTERS: There is a new option available under Syndication -> | |
| 50 | - Options which allows users to choose whether or not to expose syndicated | |
| 51 | - posts to being altered by formatting filters. By default, FeedWordPress | |
| 52 | - has always protected syndicated posts (which are already in display-ready | |
| 53 | - HTML when they are syndicated) from being reformatted by formatting | |
| 54 | - filters. However, this approach means that certain plugins which depend | |
| 55 | - on formatting filters (for example, to add "Share This" bars or relevant | |
| 56 | - links to the end of a post) are blocked from working on any syndicated | |
| 57 | - posts. If you want to use one of these plugins together with | |
| 58 | - FeedWordPress, you can now do so by changing the "Formatting Filters" | |
| 59 | - setting from "Protect" to "Expose." | |
| 60 | - | |
| 61 | -* **`<atom:source>` ELEMENTS NOW INCLUDED IN ATOM FEED:** Atom 1.0 provides | |
| 62 | - a standard method for aggregators to indicate information about the original source of | |
| 63 | - a syndicated post, using the `<atom:source>` element. FeedWordPress now | |
| 64 | - introduces standard `<atom:source>` elements including the title, homepage, and | |
| 65 | - feed URI of the source from which a syndicated post was syndicated. Cf. | |
| 66 | - <http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.source> | |
| 67 | - | |
| 68 | -* MODULARIZATION OF CODE: The code for different elements of FeedWordPress | |
| 69 | - has been broken out into several modules for easier inspection, | |
| 70 | - documentation, and maintenance of the code. | |
| 71 | - | |
| 72 | -* VERSIONING SCHEME CHANGED: FeedWordPress's feature set has proven stable | |
| 73 | - enough that it can now be removed from beta status; a good thing, since | |
| 74 | - I was very quickly running out of version numbers to use. New releases | |
| 75 | - of FeedWordPress will have version numbers based on the date of their | |
| 76 | - release. | |
| 77 | - | |
| 78 | -Changes from 0.992 to 0.993 | |
| 79 | - | |
| 80 | -* WORDPRESS 2.5.1 COMPATIBILITY: FeedWordPress should now be compatible | |
| 81 | - with WordPress 2.5.1. | |
| 82 | - | |
| 83 | -* WORDPRESS 2.5 INTERFACE IMPROVEMENTS: FeedWordPress's Dashboard | |
| 84 | - interface has undergone several cosmetic changes that should help it | |
| 85 | - integrate better with the WordPress Dashboard interface in WordPress | |
| 86 | - version 2.5.x. | |
| 87 | - | |
| 88 | -* SYNDICATED POSTS CAN BE MARKED AS "PENDING REVIEW": WordPress 2.3 users | |
| 89 | - can now take advantage of WordPress's new "Pending Review" features for | |
| 90 | - incoming syndicated posts. Posts marked as "Pending Review" are not | |
| 91 | - published immediately, but are marked as ready to be reviewed by an | |
| 92 | - Administrator or Editor, who can then choose to publish the post or | |
| 93 | - hold it back. If you want to review syndicated posts from a particular | |
| 94 | - feed, or from all feeds, before they are posted, then use | |
| 95 | - Syndication --> Syndicated Sites --> Edit or Syndication --> Options to | |
| 96 | - change the settings for handling new posts. | |
| 97 | - | |
| 98 | -* AWARE OF NEW URI FOR del.icio.us FEEDS: Previous releases of | |
| 99 | - FeedWordPress already automatically split del.icio.us tags up | |
| 100 | - appropriately appropriately when generating categories. (del.icio.us | |
| 101 | - feeds smoosh all the tags into a single `<dc:subject>` element, | |
| 102 | - separated by spaces; FeedWordPress un-smooshes them into multiple | |
| 103 | - categories by separating them at whitespace.) Unfortunately, del.icio.us | |
| 104 | - recently broke the existing behavior by changing host names for their | |
| 105 | - feeds from del.icio.us to feeds.delicious.com. Version 0.993 accounts | |
| 106 | - for the new host name and un-breaks the tag splitting. | |
| 107 | - | |
| 108 | -Changes from 0.991 to 0.992 | |
| 109 | -* AUTHOR RE-MAPPING: FeedWordPress now offers considerable control over | |
| 110 | - how author names on a feed are translated into usernames within the | |
| 111 | - WordPress database. When a post by an unrecognized author comes in, | |
| 112 | - Administrators can now specify any username as the default username to | |
| 113 | - assign the post to by setting the option in Syndication --> Options | |
| 114 | - (formerly FeedWordPress only allowed you to assign such posts to user | |
| 115 | - #1, the site administrator). Administrators can also create re-mapping | |
| 116 | - rules for particular feeds (under Syndication --> Syndicated Sites --> | |
| 117 | - Edit), so that (for example) any posts attributed to "Administrator" | |
| 118 | - on the feed <http://praxeology.net/blog/feed/> will be assigned to | |
| 119 | - a user named "Roderick T. Long," rather than a user named | |
| 120 | - "Administrator." These settings also allow administrators to filter out | |
| 121 | - posts by particular users, and to control what will happen when | |
| 122 | - FeedWordPress encounters a post by an unrecognized user on that | |
| 123 | - particular feed. | |
| 124 | - | |
| 125 | -* BUG RELATED TO URIS CONTAINING AMPERSAND CHARACTERS FIXED: A bug in | |
| 126 | - WordPress 2.x's handling of URIs in Blogroll links created problems for | |
| 127 | - updating any feeds whose URIs included an ampersand character, such as | |
| 128 | - Google News RSS feeds and other feeds that have multiple parameters | |
| 129 | - passed through HTTP GET. If you experienced this bug, the most likely | |
| 130 | - effect was that FeedWordPress simply would not import new posts from a | |
| 131 | - feed when instructred to do so, returning a "0 new posts" response. In | |
| 132 | - other cases, it might lead to unpredictable results from feed updates, | |
| 133 | - such as importing posts which were not contained in the feed being | |
| 134 | - syndicated, but which did appear elsewhere on the same website. This bug | |
| 135 | - has, hopefully, been resolved, by correcting for the bug in WordPress. | |
| 136 | - | |
| 137 | -Changes from 0.99 to 0.991 | |
| 138 | -* WORDPRESS MU COMPATABILITY: FeedWordPress should now be compatible with | |
| 139 | - recent releases of WordPress MU. Once FeedWordPress is made available | |
| 140 | - as a plugin, each individual blog can choose to activate FeedWordPress | |
| 141 | - and syndicate content from its own set of contributors. | |
| 142 | - | |
| 143 | -* DISPLAY OF MAGPIE WARNINGS: A number of MagpieRSS warnings or error | |
| 144 | - messages that were displayed when performing an automatic update are | |
| 145 | - no longer displayed, unless debugging parameters have been explicitly | |
| 146 | - enabled. | |
| 147 | - | |
| 148 | -* BUG RELATED TO INTERNATIONAL CHARACTERS IN AUTHOR NAMES FIXED: Due to a | |
| 149 | - subtle incompatability between the way that FeedWordPress generated new | |
| 150 | - user information, and the way that WordPress 2.0 and later added new | |
| 151 | - authors to the database, FeedWordPress might end up creating duplicate | |
| 152 | - authors, or throwing a critical error message, when it encountered | |
| 153 | - authors whose names included international characters. This | |
| 154 | - incompatability has now been fixed; hopefully, authors with | |
| 155 | - international characters in their names should now be handled properly. | |
| 156 | - | |
| 157 | -* media:content BUG IN MAGPIERSS FIXED: A bug in MagpieRSS's handling of | |
| 158 | - namespaced elements has been fixed. Among other things, this bug caused | |
| 159 | - items containing a Yahoo MediaRSS `<media:content>` element (such as | |
| 160 | - many of the feeds produced by wordpress.com) to be represented | |
| 161 | - incorrectly, with only a capital "A" where the content of the post | |
| 162 | - should have been. Feeds containing `<media:content>` elements should now | |
| 163 | - be syndicated correctly. | |
| 164 | - | |
| 165 | -* update_feedwordpress PARAMETER: You can now use an HTTP GET parameter | |
| 166 | - (`update_feedwordpress=1`) to request that FeedWordPress poll its feeds | |
| 167 | - for updates. When used together with a crontab or other means of | |
| 168 | - scheduling tasks, this means that you can keep your blog automatically | |
| 169 | - updated on a regular schedule, even if you do not choose to use the | |
| 170 | - cron-less automatic updates option. | |
| 171 | - | |
| 172 | -* Some minor interface-related bugs were also fixed. | |
| 173 | - | |
| 174 | - | |
| 175 | -Changes from 0.981 to 0.99 | |
| 176 | -Version 0.99 adds several significant new features, fixes some bugs, and | |
| 177 | -provides compatability with WordPress 2.2.x and 2.3.x. | |
| 178 | - | |
| 179 | -* WORDPRESS 2.2 AND 2.3 COMPATIBILITY: FeedWordPress should now be | |
| 180 | - compatible with WordPress version 2.2 and the upcoming WordPress | |
| 181 | - version 2.3. In particular, it has been tested extensively against | |
| 182 | - WordPress 2.2.3 and WordPress 2.3 Release Candidate 1. | |
| 183 | - | |
| 184 | -* AUTOMATIC UPDATES WITHOUT CRON: FeedWordPress now allows you to | |
| 185 | - automatically schedule checks for new posts without using external task | |
| 186 | - scheduling tools such as cron. In order to enable automatic updates, go | |
| 187 | - to **Syndication --> Options** and set "Check for new posts" to | |
| 188 | - "automatically." For details, see "Automatic Feed Updates" in | |
| 189 | - README.text. | |
| 190 | - | |
| 191 | - An important side-effect of the changes to the update system is that if | |
| 192 | - you were previously using the cron job and the `update-feeds.php` script | |
| 193 | - to schedule updates, you need to change your cron set-up. The old | |
| 194 | - `update-feeds.php` script no longer exists. Instead, if you wish to use | |
| 195 | - a cron job to guarantee updates on a particular schedule, you should | |
| 196 | - have the cron job fetch the front page of your blog (for example, by | |
| 197 | - using `curl http://www.zyx.com/blog/ > /dev/null`) instead of activating | |
| 198 | - the `update-feeds.php` script. If automatic updates have been enabled, | |
| 199 | - fetching the front page will automatically trigger the update process. | |
| 200 | - | |
| 201 | -* INTERFACE REORGANIZATION: All FeedWordPress functions are now located | |
| 202 | - under a top-level "Syndication" menu in the WordPress Dashboard. To | |
| 203 | - manage the list of syndicated sites, manually check for new posts on | |
| 204 | - one or more feeds, or syndicate a new site, you should use the main page | |
| 205 | - under **Syndication**. To change global settings for FeedWordPress, | |
| 206 | - you should use **Syndication --> Options**. | |
| 207 | - | |
| 208 | -* FILE STRUCTURE REORGANIZATION: Due to a combination of changing styles | |
| 209 | - for FeedWordPress plugins and lingering bugs in the FeedWordPress admin | |
| 210 | - menu code, the code for FeedWordPress is now contained in two different | |
| 211 | - PHP files, which should be installed together in a subdirectory of your | |
| 212 | - plugins directory named `feedwordpress`. (See README.text for | |
| 213 | - installation and upgrade instructions relating to the change.) | |
| 214 | - | |
| 215 | -* MULTIPLE CATEGORIES SETTING: Some feeds use non-standard methods to | |
| 216 | - indicate multiple categories within a single category element. (The most | |
| 217 | - popular site to do this is del.icio.us, which separates tags with a | |
| 218 | - space.) FeedWordPress now allows you to set an optional setting, for any | |
| 219 | - feed which does this, indicating the character or characters used to | |
| 220 | - divide multiple categories, using a Perl-compatible regular expression. | |
| 221 | - (In the case of del.icio.us feeds, FeedWordPress will automatically use | |
| 222 | - \s for the pattern without your having to do any further configuration.) | |
| 223 | - To turn this setting on, simply use the "Edit" link for the feed that | |
| 224 | - you want to turn it on for. | |
| 225 | - | |
| 226 | -* REGULAR EXPRESSION BUG FIXED: Eliminated a minor bug in the regular | |
| 227 | - expressions for e-mail addresses (used in parsing RSS `author` | |
| 228 | - elements), which could produce unsightly error messages for some users | |
| 229 | - parsing RSS 2.0 feeds. | |
| 230 | - | |
| 231 | -* DATE / UPDATE BUG FIXED: A bug in date handling was eliminated that may | |
| 232 | - have caused problems if any of (1) WordPress, or (2) PHP, or (3) your | |
| 233 | - web server, or (4) your MySQL server, has been set to use a different | |
| 234 | - time zone from the one that any of the others is set to use. If | |
| 235 | - FeedWordPress has not been properly updating updated posts, or has been | |
| 236 | - updating posts when there shouldn't be any changes for the update, this | |
| 237 | - release may solve that problem. | |
| 238 | - | |
| 239 | -* GOOGLE READER BUGS FIXED: A couple of bugs that made it difficult for | |
| 240 | - FeedWordPress to interact with Google Reader public feeds have been | |
| 241 | - fixed. Firstly, if you encountered an error message reading "There was a | |
| 242 | - problem adding the newsfeed. [SQL: ]" when you tried to add the feed, | |
| 243 | - the cause of this error has been fixed. Secondly, if you succeeded in | |
| 244 | - getting FeedWordPress to check a Google Reader feed, only to find that | |
| 245 | - the title of posts had junk squashed on to the end of them, that bug | |
| 246 | - has been fixed too. To fix this bug, you must install the newest version | |
| 247 | - of the optional MagpieRSS upgrade. | |
| 248 | - | |
| 249 | -* FILTER PARAMETERS: Due to an old, old bug in WordPress 1.5.0 (which was | |
| 250 | - what was available back when I first wrote the filter interface), | |
| 251 | - FeedWordPress has traditionally only passed one parameter to | |
| 252 | - syndicated_item and syndicated_post filters functions -- an array | |
| 253 | - containing either the Magpie representation of a syndicated item from | |
| 254 | - the feed, or the database representation of a post about to be inserted | |
| 255 | - into the WordPress database. If you needed information about the feed | |
| 256 | - that the item came from, this was accessible only through a pair of | |
| 257 | - global variables, $fwp_channel and $fwp_feedmeta. | |
| 258 | - | |
| 259 | - Since it's been a pretty long time since WordPress 1.5.0 was in | |
| 260 | - widespread usage, I have gone ahead and added an optional second | |
| 261 | - parameter to the invocation of the syndicated_item and syndicated_post | |
| 262 | - filters. If you have written a filter for FeedWordPress that uses either | |
| 263 | - of these hooks, you can now register that filter to accept 2 parameters. | |
| 264 | - If you do so, the second parameter will be a SyndicatedPost object, | |
| 265 | - which, among other things, allows you to access information about the | |
| 266 | - feed from which an item is syndicated using the $post->feed and the | |
| 267 | - $post->feedmeta elements (where $post is the name of the second | |
| 268 | - parameter). | |
| 269 | - | |
| 270 | - NOTE THAT THE OLD GLOBAL VARIABLES ARE STILL AVAILABLE, for the time | |
| 271 | - being at least, so existing filters will not break with the upgrade. | |
| 272 | - They should be considered deprecated, however, and may be eliminated in | |
| 273 | - the future. | |
| 274 | - | |
| 275 | -* FILTER CHANGE / BUGFIX: the array that is passed as the first argument | |
| 276 | - syndicated_post filters no longer is no longer backslash-escaped for | |
| 277 | - MySQL when filters are called. This was originally a bug, or an | |
| 278 | - oversight; the contents of the array should only be escaped for the | |
| 279 | - database *after* they have gone through all filters. IF YOU HAVE WRITTEN | |
| 280 | - ANY syndicated_post FILTERS THAT PRESUME THE OLD BEHAVIOR OF PASSING IN | |
| 281 | - STRINGS THAT ARE ALREADY BACKSLASH-ESCAPED, UPDATE YOUR FILTERS | |
| 282 | - ACCORDINGLY. | |
| 283 | - | |
| 284 | -* OTHER MINOR BUGFIXES AND INTERNAL CHANGES: The internal architecture of | |
| 285 | - FeedWordPress has been significantly changed to make the code more | |
| 286 | - modular and clean; hopefully this should help reduce the number of | |
| 287 | - compatibility updates that are needed, and make them easier and quicker | |
| 288 | - when they are needed. | |
| 289 | - | |
| 290 | -Changes from 0.98 to 0.981 | |
| 291 | -Version 0.981 is a narrowly targeted bugfix and compatibility release, whose | |
| 292 | -main purpose is to resolve a major outstanding problem: the incompatibility | |
| 293 | -between version 0.98 of WordPress and the recently released WordPress 2.1. | |
| 294 | - | |
| 295 | -* WORDPRESS 2.1 COMPATIBILITY: FeedWordPress is now compatible with | |
| 296 | - WordPress 2.1, as well as retaining its existing support for WordPress | |
| 297 | - 2.0 and 1.5. Incompatibilities that resulted in database warnings, fatal | |
| 298 | - errors, and which prevented FeedWordPress from syndicating new posts, | |
| 299 | - have been eliminated. | |
| 300 | - | |
| 301 | -* RSS-FUNCTIONS.PHP RENAMED TO RSS.PHP: if you use the upgraded MagpieRSS | |
| 302 | - replacement that's included with FeedWordPress, be sure to note that | |
| 303 | - there are now *two* files to upload from the `OPTIONAL/wp-includes` | |
| 304 | - subdirectory in order to carry out the upgrade: rss-functions.php and | |
| 305 | - rss.php. **It is necessary to upload both files**, due to a change in | |
| 306 | - the file naming scheme in WordPress 2.1, and it is necessary to do so | |
| 307 | - whether you are using WordPress 2.1 or not. If you only upload the | |
| 308 | - `rss-functions.php` file as in previous installations you will not have | |
| 309 | - a working copy of MagpieRSS; the rss.php file contains the actual code. | |
| 310 | - | |
| 311 | -* DATE BUG AFFECTING SOME PHP INSTALLATIONS RESOLVED: due to a subtle bug | |
| 312 | - in parse_w3cdtf(), some installations of PHP encountered problems with | |
| 313 | - FeedWordPress's attempt to date posts, which would cause some new posts | |
| 314 | - on Atom feeds to be dated as if they had apppeared in 1969 or 1970 | |
| 315 | - (thus, effectively, never appearing on front apge at all). This bug in | |
| 316 | - the date handling should now be fixed. | |
| 317 | - | |
| 318 | -* PHP <?=...?> SHORT FORM ELIMINATED: some installations of PHP do not | |
| 319 | - allow the <?=...?> short form for printing PHP values, which was used | |
| 320 | - extensively in the FeedWordPress interface code. Since this could cause | |
| 321 | - fatal errors for users with the wrong installation of PHP, the short | |
| 322 | - form has been replaced with full PHP echo statements, and is no longer | |
| 323 | - used in FeedWordPress. | |
| 324 | - | |
| 325 | -* BETTER USER INTERFACE INTEGRATION WITH WORDPRESS 2.x: Some minor changes | |
| 326 | - have been made to help the FeedWordPress interface pages blend in better | |
| 327 | - with the user interface when running under WordPress 2.x. | |
| 328 | - | |
| 329 | -* GLOBAL CATEGORIES BUG RESOLVED: a bug that prevented some users from | |
| 330 | - setting one or more categories to apply to syndicated posts from all | |
| 331 | - feeds (using the checkbox interface under Options --> Syndication) has | |
| 332 | - been resolved. | |
| 333 | - | |
| 334 | -Changes from 0.97 to 0.98 | |
| 335 | - | |
| 336 | -* WORDPRESS 2.0 COMPATIBILITY: This is a narrowly-targeted release to | |
| 337 | - solve a major outstanding problem. FeedWordPress is now compatible with | |
| 338 | - both WordPress 1.5 and WordPress 2.0. Incompatibilities that caused | |
| 339 | - fatal SQL errors, and a more subtle bug with off-kilter counts of posts | |
| 340 | - under a given category, have been resolved. FeedWordPress tests for | |
| 341 | - database schema using the global $wp_db_version variable (if null, then | |
| 342 | - we presume that we're dealing with WordPress 1.5). | |
| 343 | - | |
| 344 | - NOTE: I have **not** fully tested FeedWordPress with WordPress 2.0. | |
| 345 | - Further testing may reveal more bugs. However, you should now be able | |
| 346 | - to get at least basic FeedWordPress functionality up and running. | |
| 347 | - | |
| 348 | -* AUTHOR MATCHING: FeedWordPress tests several fields to see if it can | |
| 349 | - identify the author of the post as a user already in the WordPress user | |
| 350 | - database. In previous versions, it tested the user login, the nickname, | |
| 351 | - and tested for "aliases" listed in the Profile (see documentation). FWP | |
| 352 | - now also matches authors on the basis of e-mail address (*if* an e-mail | |
| 353 | - address is present). This is particularly helpful for formats such as | |
| 354 | - RSS 2.0, in which authors are primarily identified by e-mail addresses. | |
| 355 | - | |
| 356 | 4 | Changes from 0.96 to 0.97 |
| 357 | 5 | ------------------------- |
| 358 | 6 | |
| 359 | 7 | * INSTALLATION PROCEDURE: Some of the changes between 0.96 and 0.97 |
