feedwordpress / ChangeLog.text

ChangeLog.text in FeedWordPress 0.96, at ChangeLog.text

151 lines 7.4 KB

Raw Download Zip

1	Change Log
2	==========
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
37	Changes from 0.91 to 0.95
38	-------------------------
39
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.
45
46	* FEATURE DEPRECATED: the feed setting `hardcode categories` is now
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").
55
56	* FEATURE: You can now set global defaults as to whether or not
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`.
64
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:
70
71	a.k.a.: Joseph Cardinal Ratzinger
72
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.
76
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.
84
85	There are now three different options for an unfamiliar author: (1)
86	FeedWordPress can create a new author account and attribute the
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.
93
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.
102
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:
108
109	unfamiliar author: (create\|default\|filter)
110	unfamiliar categories: (create\|default\|filter)
111
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
122	`unfamiliar categories: filter` will cause it to both drop any
123	unfamiliar category names and to only syndicate posts that are
124	placed in one or more familiar categories.
125
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.
137
138	Similarly, if you wanted to filter one particular feed so that only
139	posts by (for example) the author "Earl J. Llama" were syndicated to
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:
143
144	unfamiliar author: filter
145
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.)
150
151