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.1
|
---|
7 | Stable tag: 2009.0707
|
---|
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.8][], [2.7][], [2.6][], [2.5][], [2.3][], [2.2][],
|
---|
27 | [2.1][], [2.0][] or [1.5][]), and also FTP or SFTP access to your web host. The
|
---|
28 | ability to create cron jobs on your web host is helpful but not absolutely
|
---|
29 | necessary. You *don't* need to tweak any plain-text configuration files and you
|
---|
30 | *don't* need shell access to your web host to make it work. (Although, I should
|
---|
31 | point out, web hosts that *don't* offer shell access are *bad web hosts*.)
|
---|
32 |
|
---|
33 | [2.8]: http://codex.wordpress.org/Version_2.8
|
---|
34 | [2.7]: http://codex.wordpress.org/Version_2.7
|
---|
35 | [2.6]: http://codex.wordpress.org/Version_2.6
|
---|
36 | [2.5]: http://codex.wordpress.org/Version_2.5
|
---|
37 | [2.3]: http://codex.wordpress.org/Version_2.3
|
---|
38 | [2.2]: http://codex.wordpress.org/Version_2.2
|
---|
39 | [2.1]: http://codex.wordpress.org/Version_2.1
|
---|
40 | [2.0]: http://codex.wordpress.org/Version_2.0
|
---|
41 | [1.5]: http://codex.wordpress.org/Version_1.5
|
---|
42 |
|
---|
43 | == Installation ==
|
---|
44 |
|
---|
45 | To use FeedWordPress, you will need:
|
---|
46 |
|
---|
47 | * an installed and configured copy of WordPress version 2.x, or 1.5.x.
|
---|
48 | (FeedWordPress will also work with the equivalent versions of WordPress
|
---|
49 | MU.)
|
---|
50 |
|
---|
51 | * FTP or SFTP access to your web host
|
---|
52 |
|
---|
53 | = New Installations =
|
---|
54 |
|
---|
55 | 1. Download the FeedWordPress archive and 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 |
|
---|