feedwordpress / ChangeLog.text

ChangeLog.text in FeedWordPress 0.95, at ChangeLog.text

110 lines 5.8 KB

Raw Download Zip

1	Change Log
2	==========
3
4	Changes from 0.91 to 0.95
5	-------------------------
6
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.
11
12	* 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").
20
21	* 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`.
28
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:
34
35	a.k.a.: Joseph Cardinal Ratzinger
36
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.
40
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.
47
48	There are now three different options for an unfamiliar author: (1)
49	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.
55
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.
63
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:
68
69	unfamiliar author: (create\|default\|filter)
70	unfamiliar categories: (create\|default\|filter)
71
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
82	`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.
85
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.
96
97	Similarly, if you wanted to filter one particular feed so that only
98	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:
102
103	unfamiliar author: filter
104
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.)
109
110