feedwordpress / readme.txt

readme.txt in FeedWordPress 2009.0612, at readme.txt

160 lines 7.6 KB

Raw Download Zip

1	=== FeedWordPress ===
2	Contributors: Charles Johnson
3	Donate link: http://projects.radgeek.com/feedwordpress/
4	Tags: syndication, aggregation, feed, atom, rss
5	Requires at least: 1.5
6	Tested up to: 2.8
7	Stable tag: 2009.0612
8
9	FeedWordPress syndicates content from feeds you choose into your WordPress weblog.
10
11	== Description ==
12
13	* Author: [Charles Johnson](http://radgeek.com/contact)
14	* Project URI: <http://projects.radgeek.com/feedwordpress>
15	* License: GPL 2. See License below for copyright jots and tittles.
16
17	FeedWordPress is an Atom/RSS aggregator for WordPress. It syndicates content
18	from feeds that you choose into your WordPress weblog; if you syndicate several
19	feeds then you can use WordPress's posts database and templating engine as the
20	back-end of an aggregation ("planet") website. It was developed, originally,
21	because I needed a more flexible replacement for [Planet](http://www.planetplanet.org/)
22	to use at [Feminist Blogs](http://feministblogs.org/).
23
24	FeedWordPress is designed with flexibility, ease of use, and ease of
25	configuration in mind. You'll need a working installation of WordPress or
26	WordPress MU (versions [2.7][], [2.6][], [2.5][], [2.3][], [2.2][], [2.1][], [2.0][] or
27	[1.5][]), and also FTP or SFTP access to your web host. The ability to create
28	cron jobs on your web host is helpful but not absolutely necessary. You don't
29	need to tweak any plain-text configuration files and you don't need shell
30	access to your web host to make it work. (Although, I should point out, web
31	hosts that don't offer shell access are bad web hosts.)
32
33	[2.7]: http://codex.wordpress.org/Version_2.7
34	[2.6]: http://codex.wordpress.org/Version_2.6
35	[2.5]: http://codex.wordpress.org/Version_2.5
36	[2.3]: http://codex.wordpress.org/Version_2.3
37	[2.2]: http://codex.wordpress.org/Version_2.2
38	[2.1]: http://codex.wordpress.org/Version_2.1
39	[2.0]: http://codex.wordpress.org/Version_2.0
40	[1.5]: http://codex.wordpress.org/Version_1.5
41
42	== Installation ==
43
44	To use FeedWordPress, you will need:
45
46	* an installed and configured copy of WordPress version 2.6.x, 2.5.x,
47	2.3.x, 2.2.x, 2.1.x, 2.0.x, or 1.5.x. (FeedWordPress will also work with
48	the equivalent versions of WordPress MU.)
49
50	* FTP or SFTP access to your web host
51
52	= New Installations =
53
54	1. Download the FeedWordPress archive in zip or gzipped tar format and
55	extract the files on your computer.
56
57	2. Create a new directory named `feedwordpress` in the `wp-content/plugins`
58	directory of your WordPress installation. Use an FTP or SFTP client to
59	upload the contents of your FeedWordPress archive to the new directory
60	that you just created on your web host.
61
62	3. Upgrade the copy of MagpieRSS packaged with WordPress by installing the
63	new copies of `rss.php` and `rss-functions.php` into the `wp-includes`
64	directory of your FeedWordPress installation. These files are stored in
65	the `MagpieRSS-upgrade` directory of your FeedWordPress archive. Strictly
66	speaking, upgrading MagpieRSS is optional; FeedWordPress will run
67	correctly without the upgrade. But if you hope to take advantage of
68	numerous bug fixes, or support for Atom 1.0, multiple post categories,
69	RSS enclosures, or multiple character encodings, then you need to
70	install the upgrade.
71
72	4. Log in to the WordPress Dashboard and activate the FeedWordPress plugin.
73
74	5. Once the plugin is activated, you can go to Syndication --> Options
75	and set (1) the link category that FeedWordPress will syndicate links
76	from (by default, "Contributors"), and (2) whether FeedWordPress will
77	use automatic updates or only manual updates.
78
79	5. Go to the main Syndication page to set up the list of sites that
80	you want FeedWordPress to syndicate onto your blog.
81
82	= Upgrades =
83
84	To upgrade an existing installation of FeedWordPress to version 2008.1030:
85
86	1. Download the FeedWordPress archive in zip or gzipped tar format and
87	extract the files on your computer.
88
89	2. If you are upgrading from version 0.98 or earlier, then you need to
90	create a new directory named `feedwordpress` in the `wp-content/plugins`
91	directory of your WordPress installation, and you also need to delete
92	your existing `wp-content/update-feeds.php` and
93	`wp-content/plugins/feedwordpress.php` files. The file structure for
94	FeedWordPress has changed and the files from your old version will not
95	be overwritten, which could cause conflicts if you leave them in place.
96
97	3. Upload the new PHP files to `wp-content/plugins/feedwordpress`,
98	overwriting any existing FeedWordPress files that are there. Also be
99	sure to upgrade the MagpieRSS module by uploading `rss.php` and
100	`rss-functions.php` from the `MagpieRSS-upgrade` directory in your
101	archive to the `wp-includes` directory of your WordPress installation.
102
103	3. If you are upgrading from version 0.96 or earlier, immediately log
104	in to the WordPress Dashboard, and go to Options --> Syndicated.
105	Follow the directions to launch the database upgrade procedure. The new
106	versions of FeedWordPress incorporate some long-needed improvements, but
107	old meta-data needs to be updated to prevent duplicate posts and other
108	possible maladies. If you're upgrading an existing installation, updates
109	and FeedWordPress template functions will not work until you've done
110	the upgrade. Then take a coffee break while the upgrade runs. It should,
111	hopefully, finish within a few minutes even on relatively large
112	databases.
113
114	4. If you are upgrading from version 0.98 or earlier, note that the old
115	`update-feeds.php` has been eliminated in favor of a (hopefully) more
116	humane method for automatic updating. If you used a cron job for
117	scheduled updates, it will not work anymore, but there is another,
118	simpler method which will. See [Setting Up Feed Updates](http://projects.radgeek.com/feedwordpress/install/#setting-up-feed-updates)
119	to get scheduled updates back on track.
120
121	5. Enjoy your new installation of FeedWordPress.
122
123	== Using and Customizing FeedWordPress ==
124
125	FeedWordPress has many options which can be accessed through the WordPress
126	Dashboard, and a lot of functionality accessible programmatically through
127	WordPress templates or plugins. For further documentation of the ins and
128	outs, see the documentation at the [FeedWordPress project homepage][].
129
130	[FeedWordPress project homepage]: http://projects.radgeek.com/feedwordpress/
131
132	== License ==
133
134	The FeedWordPress plugin is copyright © 2005-2007 by Charles Johnson. It uses
135	code derived or translated from:
136
137	- [wp-rss-aggregate.php][] by [Kellan Elliot-McCrea](kellan@protest.net)
138	- [MagpieRSS][] by [Kellan Elliot-McCrea](kellan@protest.net)
139	- [HTTP Navigator 2][] by [Keyvan Minoukadeh](keyvan@k1m.com)
140	- [Ultra-Liberal Feed Finder][] by [Mark Pilgrim](mark@diveintomark.org)
141
142	according to the terms of the [GNU General Public License][].
143
144	This program is free software; you can redistribute it and/or modify it under
145	the terms of the [GNU General Public License][] as published by the Free
146	Software Foundation; either version 2 of the License, or (at your option) any
147	later version.
148
149	This program is distributed in the hope that it will be useful, but WITHOUT ANY
150	WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
151	PARTICULAR PURPOSE. See the GNU General Public License for more details.
152
153	[wp-rss-aggregate.php]: http://laughingmeme.org/archives/002203.html
154	[MagpieRSS]: http://magpierss.sourceforge.net/
155	[HTTP Navigator 2]: http://www.keyvan.net/2004/11/16/http-navigator/
156	[Ultra-Liberal Feed Finder]: http://diveintomark.org/projects/feed_finder/
157
158	[GNU General Public License]: http://www.gnu.org/copyleft/gpl.html
159
160