| @@ -1,150 +1,109 @@ | ||
| 1 | 1 | Change Log |
| 2 | 2 | ========== |
| 3 | 3 | |
| 4 | -Changes from 0.95 to 0.96 | |
| 5 | - | |
| 6 | -* FEATURE: support has been added for enclosures in RSS 2.0 and Atom | |
| 7 | - 0.6+ newsfeeds. WordPress already supports adding enclosures to an | |
| 8 | - item; FeedWordPress merely gets the information on the enclosure | |
| 9 | - from the feed it is syndicating and plugs that information directly | |
| 10 | - into the WordPress database so that (among other things) that post | |
| 11 | - will have its enclosure listed in your blog's RSS 2 newsfeed. | |
| 12 | - | |
| 13 | - Note that enclosure support requires using the optional MagpieRSS | |
| 14 | - upgrade (i.e., replacing your `wp-includes/rss-functions.php` with `OPTIONAL/wp-includes/rss-functions.php` from the FWP archive) | |
| 15 | - | |
| 16 | -* FEATURE: for completeness's sake, there is now a feed setting, | |
| 17 | - `hardcode url`, that allows you to set the URI for the front page | |
| 18 | - of a contributor's website manually (that is, prevent it from being | |
| 19 | - automatically updated from the feed channel link on each update). To | |
| 20 | - set the URI manually, put a line like this in the Link Notes section | |
| 21 | - of a feed: | |
| 22 | - | |
| 23 | - hardcode url: yes | |
| 24 | - | |
| 25 | - You can also instruct FeedWordPress to use hardcoded URIs by default | |
| 26 | - on all feeds using Options --> Syndication | |
| 27 | - | |
| 28 | -* FEATURE: by default, when FeedWordPress finds new syndicated posts, | |
| 29 | - it (1) publishes them immediately, (2) turns comments off, and (3) | |
| 30 | - turns trackback / pingback pings off. You can now alter all three | |
| 31 | - default behaviors (e.g., to allow pings on syndicated posts, or to | |
| 32 | - send newly-syndicated posts to the draft pile for moderation) using | |
| 33 | - Options --> Syndication | |
| 34 | - | |
| 35 | - | |
| 36 | 4 | Changes from 0.91 to 0.95 |
| 37 | 5 | ------------------------- |
| 38 | 6 | |
| 39 | -* BUG FIX: Fixed an obscure bug in the handling of categories: | |
| 40 | - categories with trailing whitespace could cause categories with | |
| 41 | - duplicate names to be created. This no longer happens. While I was | |
| 42 | - at it I tightened up the operation of | |
| 43 | - 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. | |
| 44 | 11 | |
| 45 | 12 | * FEATURE DEPRECATED: the feed setting `hardcode categories` is now |
| 46 | - deprecated in favor of `unknown categories` (see below), which | |
| 47 | - allows you to strip off any syndication categories not already in | |
| 48 | - your database using `unknown categories: default` or `unknown | |
| 49 | - categories: filter`. If you have `hardcode categories: yes` set on a | |
| 50 | - feed, this will be treated as `unknown categories: default` (i.e., | |
| 51 | - no new categories will be added, but if a post doesn't match any of | |
| 52 | - the categories it will be added in the default category--usually | |
| 53 | - "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"). | |
| 54 | 20 | |
| 55 | 21 | * FEATURE: You can now set global defaults as to whether or not |
| 56 | - FeedWordPress will update the Link Name and Link Description | |
| 57 | - settings for feeds automatically from the feed title and feed | |
| 58 | - tagline. (By default, it does, as it has in past versions.) Whether | |
| 59 | - this behavior is turned on or off, you can still override the | |
| 60 | - default behavior using feed settings of `hardcode name: yes`, | |
| 61 | - `hardcode name: no`, `hardcode description: yes`, or `hardcode | |
| 62 | - 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`. | |
| 63 | 28 | |
| 64 | -* FEATURE: Users can now provide one or several "aliases" for an | |
| 65 | - author, just as they can for a category. For example, to make | |
| 66 | - FeedWordPress treat posts by "Joseph Cardinal Ratzinger" and "Pope | |
| 67 | - Benedict XVI" as by the same author, edit the user profile for Pope | |
| 68 | - 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: | |
| 69 | 34 | |
| 70 | 35 | a.k.a.: Joseph Cardinal Ratzinger |
| 71 | 36 | |
| 72 | - You can add several aliases, each on a line by itself. You can also | |
| 73 | - add any other text you like to the Profile without interfering with | |
| 74 | - 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. | |
| 75 | 40 | |
| 76 | -* FEATURE: Users can now choose how to handle syndicated posts that | |
| 77 | - are in unfamiliar categories or by unfamiliar authors (i.e., | |
| 78 | - categories or authors whose names are not yet in the WordPress | |
| 79 | - database). By default, FeedWordPress will (as before) create a new | |
| 80 | - category (or new author) and use it for the current post and any | |
| 81 | - future posts. This behavior can be changed, either for all feeds or | |
| 82 | - 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. | |
| 83 | 47 | |
| 84 | 48 | There are now three different options for an unfamiliar author: (1) |
| 85 | 49 | FeedWordPress can create a new author account and attribute the |
| 86 | - syndicated post to the new account; (2) FeedWordPress can attribute | |
| 87 | - the post to an author if the author's name is familiar, and to a | |
| 88 | - default author (currently, this means the Site Administrator | |
| 89 | - account) if it is not; (3) FeedWordPress can drop posts by | |
| 90 | - unfamiliar authors and syndicate only posts by authors who are | |
| 91 | - 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. | |
| 92 | 55 | |
| 93 | - There are, similarly, two different options for an unfamiliar | |
| 94 | - category: (1) FeedWordPress can create new categories and place the | |
| 95 | - syndicated post in them; (2) FeedWordPress can drop the unfamiliar | |
| 96 | - categories and place syndicated posts only in categories that it is | |
| 97 | - already familiar with. In addition, FeedWordPress 0.95 lets you | |
| 98 | - choose whether posts that are in *no* familiar categories should be | |
| 99 | - syndicated (and placed in the default category for the blog) or | |
| 100 | - 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. | |
| 101 | 63 | |
| 102 | - You can set the default behavior for both authors and categories | |
| 103 | - using the settings in Options --> Syndication. You can also set | |
| 104 | - different behavior for specific feeds by adding the `unfamiliar | |
| 105 | - author` and / or `unfamiliar categories` settings to the Link Notes | |
| 106 | - 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: | |
| 107 | 68 | |
| 108 | 69 | unfamiliar author: (create|default|filter) |
| 109 | 70 | unfamiliar categories: (create|default|filter) |
| 110 | 71 | |
| 111 | - A setting of `unfamiliar author: create` will make FeedWordPress | |
| 112 | - create new authors to match unfamiliar author names *for this feed | |
| 113 | - alone*. A setting of `unfamiliar author: default` will make it | |
| 114 | - assign posts from unfamiliar authors to the default user account. A | |
| 115 | - setting of `unfamiliar author: filter` will cause all posts (from | |
| 116 | - this feed alone) to be dropped unless they are by an author already | |
| 117 | - listed in the database. Similiarly, `unfamiliar categories: create` | |
| 118 | - will make FeedWordPress create new categories to match unfamiliar | |
| 119 | - category names *for this feed alone*; `unfamiliar categories: | |
| 120 | - 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 | |
| 121 | 82 | `unfamiliar categories: filter` will cause it to *both* drop any |
| 122 | - unfamiliar category names *and* to only syndicate posts that are | |
| 123 | - 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. | |
| 124 | 85 | |
| 125 | - These two new features allow users to do some coarse-grained | |
| 126 | - filtering without having to write a PHP filter. Specifically, they | |
| 127 | - offer an easy way for you to filter feeds by category or by author. | |
| 128 | - Suppose, for example, that you only wanted to syndicate posts that | |
| 129 | - your contributors place in the "Llamas" category. You could do so by | |
| 130 | - setting up your installation of WordPress so that the only category | |
| 131 | - in the database is "Llamas," and then use Options --> Syndication to | |
| 132 | - set "Unfamiliar categories" to "don't create new categories and | |
| 133 | - don't syndicate posts unless they match at least one familiar | |
| 134 | - category". Now, when you update, only posts in the "Llamas" category | |
| 135 | - 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. | |
| 136 | 96 | |
| 137 | 97 | Similarly, if you wanted to filter one particular feed so that only |
| 138 | 98 | posts by (for example) the author "Earl J. Llama" were syndicated to |
| 139 | - your site, you could do so by creating a user account for Earl J. | |
| 140 | - Llama, then adding the following line to the settings for the feed | |
| 141 | - 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: | |
| 142 | 102 | |
| 143 | 103 | unfamiliar author: filter |
| 144 | 104 | |
| 145 | - This will cause any posts from this feed that are not authored by | |
| 146 | - Earl J. Llama to be discarded, and only the posts by Earl J. Llama | |
| 147 | - will be syndicated. (If the setting is used on one specific feed, it | |
| 148 | - 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.) | |
| 149 | 109 | |
