Files
Pod2CPT/readme.txt
T
2026-08-24 08:46:51 -05:00

51 lines
2.3 KiB
Plaintext

=== Podcast RSS to CPT ===
Contributors: rss2cpt
Tags: podcast, rss, importer, custom post type
Requires at least: 6.2
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Import a podcast RSS feed into a configurable WordPress custom post type.
== Description ==
Podcast RSS to CPT imports existing and newly published podcast episodes using WordPress's bundled feed parser and WP-Cron. It can use the included Podcast Episode post type or any registered post type that supports the fields you need. Imports default to bounded batches of 25 new or changed episodes and automatically continue while scheduling is enabled.
Imported data includes the title, full synopsis, excerpt, publication date, episode page URL, enclosure/audio URL and type, duration, season, episode number, explicit flag, source identifiers, and episode artwork. Artwork can be added to the media library and assigned as the featured image.
== Installation ==
1. Copy this directory into `wp-content/plugins/podcast-rss-to-cpt`.
2. Activate Podcast RSS to CPT.
3. Open Settings > Podcast RSS Import.
4. Add the feed URL, select a target post type, and save.
5. Use Run import now for the initial import. WP-Cron will check for new or changed episodes on the selected schedule.
== Imported metadata ==
Themes and integrations can use these protected post meta keys:
* `_rss2cpt_source_id`
* `_rss2cpt_source_key`
* `_rss2cpt_feed_url`
* `_rss2cpt_episode_url`
* `_rss2cpt_audio_url`
* `_rss2cpt_audio_type`
* `_rss2cpt_audio_length`
* `_rss2cpt_duration`
* `_rss2cpt_duration_seconds`
* `_rss2cpt_season`
* `_rss2cpt_episode_number`
* `_rss2cpt_episode_type`
* `_rss2cpt_explicit`
* `_rss2cpt_image_url`
* `_rss2cpt_creator`
Episode fields are registered with types for the configured post type. Public episode fields are available through the WordPress REST API; internal deduplication fingerprints remain private. Enable “Refresh feed-owned fields” if publisher changes should overwrite the imported title, synopsis, excerpt, date, status, author, metadata, and artwork; it is off by default to preserve editorial changes.
== Notes ==
WP-Cron runs when the site receives traffic. For reliable publishing schedules, invoke `wp-cron.php` from a real system cron. Removing the plugin keeps imported posts and downloaded media but removes plugin settings.