| @@ -1,7 +1,207 @@ | ||
| 1 | 1 | FeedWordPress Change Log |
| 2 | 2 | ======================== |
| 3 | 3 | |
| 4 | +Changes from 0.99 to 0.991 | |
| 5 | +-------------------------- | |
| 6 | +* WORDPRESS MU COMPATABILITY: FeedWordPress should now be compatible with | |
| 7 | + recent releases of WordPress MU. Once FeedWordPress is made available | |
| 8 | + as a plugin, each individual blog can choose to activate FeedWordPress | |
| 9 | + and syndicate content from its own set of contributors. | |
| 10 | + | |
| 11 | +* DISPLAY OF MAGPIE WARNINGS: A number of MagpieRSS warnings or error | |
| 12 | + messages that were displayed when performing an automatic update are | |
| 13 | + no longer displayed, unless debugging parameters have been explicitly | |
| 14 | + enabled. | |
| 15 | + | |
| 16 | +* BUG RELATED TO INTERNATIONAL CHARACTERS IN AUTHOR NAMES FIXED: Due to a | |
| 17 | + subtle incompatability between the way that FeedWordPress generated new | |
| 18 | + user information, and the way that WordPress 2.0 and later added new | |
| 19 | + authors to the database, FeedWordPress might end up creating duplicate | |
| 20 | + authors, or throwing a critical error message, when it encountered | |
| 21 | + authors whose names included international characters. This | |
| 22 | + incompatability has now been fixed; hopefully, authors with | |
| 23 | + international characters in their names should now be handled properly. | |
| 24 | + | |
| 25 | +* media:content BUG IN MAGPIERSS FIXED: A bug in MagpieRSS's handling of | |
| 26 | + namespaced elements has been fixed. Among other things, this bug caused | |
| 27 | + items containing a Yahoo MediaRSS `<media:content>` element (such as | |
| 28 | + many of the feeds produced by wordpress.com) to be represented | |
| 29 | + incorrectly, with only a capital "A" where the content of the post | |
| 30 | + should have been. Feeds containing `<media:content>` elements should now | |
| 31 | + be syndicated correctly. | |
| 32 | + | |
| 33 | +* update_feedwordpress PARAMETER: You can now use an HTTP GET parameter | |
| 34 | + (`update_feedwordpress=1`) to request that FeedWordPress poll its feeds | |
| 35 | + for updates. When used together with a crontab or other means of | |
| 36 | + scheduling tasks, this means that you can keep your blog automatically | |
| 37 | + updated on a regular schedule, even if you do not choose to use the | |
| 38 | + cron-less automatic updates option. | |
| 39 | + | |
| 40 | +* Some minor interface-related bugs were also fixed. | |
| 41 | + | |
| 42 | + | |
| 43 | +Changes from 0.981 to 0.99 | |
| 44 | +-------------------------- | |
| 45 | +Version 0.99 adds several significant new features, fixes some bugs, and | |
| 46 | +provides compatability with WordPress 2.2.x and 2.3.x. | |
| 47 | + | |
| 48 | +* WORDPRESS 2.2 AND 2.3 COMPATIBILITY: FeedWordPress should now be | |
| 49 | + compatible with WordPress version 2.2 and the upcoming WordPress | |
| 50 | + version 2.3. In particular, it has been tested extensively against | |
| 51 | + WordPress 2.2.3 and WordPress 2.3 Release Candidate 1. | |
| 52 | + | |
| 53 | +* AUTOMATIC UPDATES WITHOUT CRON: FeedWordPress now allows you to | |
| 54 | + automatically schedule checks for new posts without using external task | |
| 55 | + scheduling tools such as cron. In order to enable automatic updates, go | |
| 56 | + to **Syndication --> Options** and set "Check for new posts" to | |
| 57 | + "automatically." For details, see "Automatic Feed Updates" in | |
| 58 | + README.text. | |
| 59 | + | |
| 60 | + An important side-effect of the changes to the update system is that if | |
| 61 | + you were previously using the cron job and the `update-feeds.php` script | |
| 62 | + to schedule updates, you need to change your cron set-up. The old | |
| 63 | + `update-feeds.php` script no longer exists. Instead, if you wish to use | |
| 64 | + a cron job to guarantee updates on a particular schedule, you should | |
| 65 | + have the cron job fetch the front page of your blog (for example, by | |
| 66 | + using `curl http://www.zyx.com/blog/ > /dev/null`) instead of activating | |
| 67 | + the `update-feeds.php` script. If automatic updates have been enabled, | |
| 68 | + fetching the front page will automatically trigger the update process. | |
| 69 | + | |
| 70 | +* INTERFACE REORGANIZATION: All FeedWordPress functions are now located | |
| 71 | + under a top-level "Syndication" menu in the WordPress Dashboard. To | |
| 72 | + manage the list of syndicated sites, manually check for new posts on | |
| 73 | + one or more feeds, or syndicate a new site, you should use the main page | |
| 74 | + under **Syndication**. To change global settings for FeedWordPress, | |
| 75 | + you should use **Syndication --> Options**. | |
| 76 | + | |
| 77 | +* FILE STRUCTURE REORGANIZATION: Due to a combination of changing styles | |
| 78 | + for FeedWordPress plugins and lingering bugs in the FeedWordPress admin | |
| 79 | + menu code, the code for FeedWordPress is now contained in two different | |
| 80 | + PHP files, which should be installed together in a subdirectory of your | |
| 81 | + plugins directory named `feedwordpress`. (See README.text for | |
| 82 | + installation and upgrade instructions relating to the change.) | |
| 83 | + | |
| 84 | +* MULTIPLE CATEGORIES SETTING: Some feeds use non-standard methods to | |
| 85 | + indicate multiple categories within a single category element. (The most | |
| 86 | + popular site to do this is del.icio.us, which separates tags with a | |
| 87 | + space.) FeedWordPress now allows you to set an optional setting, for any | |
| 88 | + feed which does this, indicating the character or characters used to | |
| 89 | + divide multiple categories, using a Perl-compatible regular expression. | |
| 90 | + (In the case of del.icio.us feeds, FeedWordPress will automatically use | |
| 91 | + \s for the pattern without your having to do any further configuration.) | |
| 92 | + To turn this setting on, simply use the "Edit" link for the feed that | |
| 93 | + you want to turn it on for. | |
| 94 | + | |
| 95 | +* REGULAR EXPRESSION BUG FIXED: Eliminated a minor bug in the regular | |
| 96 | + expressions for e-mail addresses (used in parsing RSS `author` | |
| 97 | + elements), which could produce unsightly error messages for some users | |
| 98 | + parsing RSS 2.0 feeds. | |
| 99 | + | |
| 100 | +* DATE / UPDATE BUG FIXED: A bug in date handling was eliminated that may | |
| 101 | + have caused problems if any of (1) WordPress, or (2) PHP, or (3) your | |
| 102 | + web server, or (4) your MySQL server, has been set to use a different | |
| 103 | + time zone from the one that any of the others is set to use. If | |
| 104 | + FeedWordPress has not been properly updating updated posts, or has been | |
| 105 | + updating posts when there shouldn't be any changes for the update, this | |
| 106 | + release may solve that problem. | |
| 107 | + | |
| 108 | +* GOOGLE READER BUGS FIXED: A couple of bugs that made it difficult for | |
| 109 | + FeedWordPress to interact with Google Reader public feeds have been | |
| 110 | + fixed. Firstly, if you encountered an error message reading "There was a | |
| 111 | + problem adding the newsfeed. [SQL: ]" when you tried to add the feed, | |
| 112 | + the cause of this error has been fixed. Secondly, if you succeeded in | |
| 113 | + getting FeedWordPress to check a Google Reader feed, only to find that | |
| 114 | + the title of posts had junk squashed on to the end of them, that bug | |
| 115 | + has been fixed too. To fix this bug, you must install the newest version | |
| 116 | + of the optional MagpieRSS upgrade. | |
| 117 | + | |
| 118 | +* FILTER PARAMETERS: Due to an old, old bug in WordPress 1.5.0 (which was | |
| 119 | + what was available back when I first wrote the filter interface), | |
| 120 | + FeedWordPress has traditionally only passed one parameter to | |
| 121 | + syndicated_item and syndicated_post filters functions -- an array | |
| 122 | + containing either the Magpie representation of a syndicated item from | |
| 123 | + the feed, or the database representation of a post about to be inserted | |
| 124 | + into the WordPress database. If you needed information about the feed | |
| 125 | + that the item came from, this was accessible only through a pair of | |
| 126 | + global variables, $fwp_channel and $fwp_feedmeta. | |
| 127 | + | |
| 128 | + Since it's been a pretty long time since WordPress 1.5.0 was in | |
| 129 | + widespread usage, I have gone ahead and added an optional second | |
| 130 | + parameter to the invocation of the syndicated_item and syndicated_post | |
| 131 | + filters. If you have written a filter for FeedWordPress that uses either | |
| 132 | + of these hooks, you can now register that filter to accept 2 parameters. | |
| 133 | + If you do so, the second parameter will be a SyndicatedPost object, | |
| 134 | + which, among other things, allows you to access information about the | |
| 135 | + feed from which an item is syndicated using the $post->feed and the | |
| 136 | + $post->feedmeta elements (where $post is the name of the second | |
| 137 | + parameter). | |
| 138 | + | |
| 139 | + NOTE THAT THE OLD GLOBAL VARIABLES ARE STILL AVAILABLE, for the time | |
| 140 | + being at least, so existing filters will not break with the upgrade. | |
| 141 | + They should be considered deprecated, however, and may be eliminated in | |
| 142 | + the future. | |
| 143 | + | |
| 144 | +* FILTER CHANGE / BUGFIX: the array that is passed as the first argument | |
| 145 | + syndicated_post filters no longer is no longer backslash-escaped for | |
| 146 | + MySQL when filters are called. This was originally a bug, or an | |
| 147 | + oversight; the contents of the array should only be escaped for the | |
| 148 | + database *after* they have gone through all filters. IF YOU HAVE WRITTEN | |
| 149 | + ANY syndicated_post FILTERS THAT PRESUME THE OLD BEHAVIOR OF PASSING IN | |
| 150 | + STRINGS THAT ARE ALREADY BACKSLASH-ESCAPED, UPDATE YOUR FILTERS | |
| 151 | + ACCORDINGLY. | |
| 152 | + | |
| 153 | +* OTHER MINOR BUGFIXES AND INTERNAL CHANGES: The internal architecture of | |
| 154 | + FeedWordPress has been significantly changed to make the code more | |
| 155 | + modular and clean; hopefully this should help reduce the number of | |
| 156 | + compatibility updates that are needed, and make them easier and quicker | |
| 157 | + when they are needed. | |
| 158 | + | |
| 159 | +Changes from 0.98 to 0.981 | |
| 160 | +-------------------------- | |
| 161 | +Version 0.981 is a narrowly targeted bugfix and compatibility release, whose | |
| 162 | +main purpose is to resolve a major outstanding problem: the incompatibility | |
| 163 | +between version 0.98 of WordPress and the recently released WordPress 2.1. | |
| 164 | + | |
| 165 | +* WORDPRESS 2.1 COMPATIBILITY: FeedWordPress is now compatible with | |
| 166 | + WordPress 2.1, as well as retaining its existing support for WordPress | |
| 167 | + 2.0 and 1.5. Incompatibilities that resulted in database warnings, fatal | |
| 168 | + errors, and which prevented FeedWordPress from syndicating new posts, | |
| 169 | + have been eliminated. | |
| 170 | + | |
| 171 | +* RSS-FUNCTIONS.PHP RENAMED TO RSS.PHP: if you use the upgraded MagpieRSS | |
| 172 | + replacement that's included with FeedWordPress, be sure to note that | |
| 173 | + there are now *two* files to upload from the `OPTIONAL/wp-includes` | |
| 174 | + subdirectory in order to carry out the upgrade: rss-functions.php and | |
| 175 | + rss.php. **It is necessary to upload both files**, due to a change in | |
| 176 | + the file naming scheme in WordPress 2.1, and it is necessary to do so | |
| 177 | + whether you are using WordPress 2.1 or not. If you only upload the | |
| 178 | + `rss-functions.php` file as in previous installations you will not have | |
| 179 | + a working copy of MagpieRSS; the rss.php file contains the actual code. | |
| 180 | + | |
| 181 | +* DATE BUG AFFECTING SOME PHP INSTALLATIONS RESOLVED: due to a subtle bug | |
| 182 | + in parse_w3cdtf(), some installations of PHP encountered problems with | |
| 183 | + FeedWordPress's attempt to date posts, which would cause some new posts | |
| 184 | + on Atom feeds to be dated as if they had apppeared in 1969 or 1970 | |
| 185 | + (thus, effectively, never appearing on front apge at all). This bug in | |
| 186 | + the date handling should now be fixed. | |
| 187 | + | |
| 188 | +* PHP <?=...?> SHORT FORM ELIMINATED: some installations of PHP do not | |
| 189 | + allow the <?=...?> short form for printing PHP values, which was used | |
| 190 | + extensively in the FeedWordPress interface code. Since this could cause | |
| 191 | + fatal errors for users with the wrong installation of PHP, the short | |
| 192 | + form has been replaced with full PHP echo statements, and is no longer | |
| 193 | + used in FeedWordPress. | |
| 194 | + | |
| 195 | +* BETTER USER INTERFACE INTEGRATION WITH WORDPRESS 2.x: Some minor changes | |
| 196 | + have been made to help the FeedWordPress interface pages blend in better | |
| 197 | + with the user interface when running under WordPress 2.x. | |
| 198 | + | |
| 199 | +* GLOBAL CATEGORIES BUG RESOLVED: a bug that prevented some users from | |
| 200 | + setting one or more categories to apply to syndicated posts from all | |
| 201 | + feeds (using the checkbox interface under Options --> Syndication) has | |
| 202 | + been resolved. | |
| 203 | + | |
| 4 | 204 | Changes from 0.97 to 0.98 |
| 5 | 205 | -------------------------- |
| 6 | 206 | |
| 7 | 207 | * WORDPRESS 2.0 COMPATIBILITY: This is a narrowly-targeted release to |
