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