=== PlanetPlanet ===
Contributors: seindal
Donate Link: https://www.seindal.dk/
Tags: rss-aggregator
Requires at least: 5.8
Tested up to: 5.8
Requires PHP: 7.4
Stable tag: 0.13
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Convert a wordpress site into an RSS/Atom feed aggregator like the old
'planet' software.

== Description ==

The PlanetPlanet plugin will convert a wordpress site into an RSS/Atom
feed aggregator by regularly reading all the configured feeds and
importing the posts in the feeds to Wordpress posts.

The feeds are registered in the old Wordpress links/bookmarks section,
which is automatically reactivated. Feeds can be added, modified and
deleted there.

The imported posts contain title, excerpt and maybe content from the
feed items. Additional custom fields are added with some data that
doesn't intuitively map to WP posts. If the feed item has a featured
image, that is imported too.

Links to the imported posts redirect to the original post.

A post category is created automatically for each feed. The category
page redirects to the originating site.

Imported posts are purged automatically after a configurable period.

Importing and purging articles can be scheduled using wp-cron. Output
from scheduled actions can be mailed.

The plugin adds a WP-CLI command 'planet' with subcommands for listing
feeds, adding feeds, updating individual or all feeds, purging posts,
and scanning web pages for available feeds. This allows most
adminstration and actions to be run without using wp-cron.

Imlementation notes: feeds errors are counted in the link_rating
field, and the feed is marked not visible if it generates too many
errors.

== Installation ==

The plugin can be installed as any other plugin.
It requires not external setup.


== Configuration ==

The plugin adds a 'Planet Planet' submenu under Settings.

* How often to check feeds: the choices are from the WP
  scheduler. 'None' means no automatic updates. The site can still be
  updated through the WP-CLI interface.

* Discard posts older than this: the value can be anything the PHP
  class DateTime can parse into a past date, which includes values
  like '6 months ago'. Too old posts are never imported, and they're
  purged automatically. If the field is empty, even very old feed
  items are imported and never purged.

* Number of errors before feed is suspended: see below

* Email for updates: insert an email if you want the output from
  schedule actions (updates and purges) mailed to you. Leave empty for
  no mails.

* Level of detail in mails: should be self-evident.

* Timeout for feed requests: how long to wait for a reply from remote
  servers.

* User-Agent: some servers filter on the User-Agent header.

== Feed errors ==

Whenever a feed update fails, the error messages is recorded in the
'description' field for the feed in the WP links manager. The error
count is registered in the link rating field, so a higher rating means
more consecutive errors.

If a feed generates too many (configurable) consecutive errors, it is
marked as 'not visible'. It will not be updated any more. It can
always be reactivated in the links manager.

Old posts from a disabled feed are not removed. They can be easily
identifed through the post category for the feed.

The error count and the saved error message are reset with each
succesful update.

== Frequently Asked Questions ==

Nothing yet.

== Changelog ==

= 0.12 =
* First published version.

== Upgrade Notice ==

Nothing yet.

== Screenshots ==

The only visible part of this plugin is the setttings submenu.