Postqueue Feeds (WordPress-Plugin)

An RSS feed for every postqueue, in the order the queue is in.

This is an extension for Postqueue. Postqueue lets an editor arrange posts into a hand-sorted list; this plugin publishes each of those lists as an RSS feed, keeping the order intact.

• wordpress.org: https://wordpress.org/plugins/postqueue-feeds/
• Requires: WordPress 6.6, PHP 7.4, and the Postqueue plugin

Feed addresses

Both use the postqueue's slug:

https://example.com/feed/my-queue/
https://example.com/?feed=my-queue

Nothing needs setting up: activating the plugin rebuilds the rewrite rules, and the rule covers every queue slug at once — so a postqueue created later has its feed immediately.

Instructions up to version 1.0 told you to save the permalink settings after adding a queue. That was true then and is not any more.

The Feed column

Under Tools → Postqueues, where Postqueue lists the queues, this plugin adds a Feed column with each queue's address.

Postqueue knows nothing about feeds and needs no code for this. Its overview is a plain WP_List_Table, so the column goes in through the two hooks a column is added to any core list table with — manage_tools_page_tools-postqueue_columns and manage_tools_page_tools-postqueue_custom_column, see public/inc/postqueue-screen.php. Without this plugin the column is simply not there.

The address itself comes from core's get_feed_link(), which yields /feed/<slug>/ where permalinks are enabled and ?feed=<slug> where they are not — exactly the pair this plugin serves.

A queue used to be reachable as https://example.com/my-queue.xml as well. That is gone as of 2.0.0 — the rule behind it matched every .xml address on the site, so wp-sitemap.xml and sitemaps published by other plugins were answered with a feed and a 404.

Overriding the template

The feed is rendered from public/template/postqueue-feed-rss2.php, a copy of the RSS2 template WordPress ships. A theme can replace it with a file of the same name in a plugin-parts folder, or in any sub folder of one:

your-theme/plugin-parts/postqueue-feed-rss2.php
your-theme/plugin-parts/feeds/postqueue-feed-rss2.php

A child theme's copy wins over the parent theme's.

Public API

$plugin = postqueue_feeds_get_plugin();   // \PostqueueFeeds\Plugin

Repository layout

public/ is exactly what ships to wordpress.org; everything else is repository-only. postqueue-feeds-dev.php in the root loads public/, so the whole repository can be symlinked into wp-content/plugins during development.

Releases are cut by release-please and deployed to the wordpress.org SVN by GitHub Actions — see .github/WORKFLOWS.md. Contribution rules and the local setup are in CONTRIBUTING.md.

A note on the repository name

There is a second, older repository called ph-postqueue-feeds (2015, three commits). It was a separate first attempt at the same idea, never reached wordpress.org, and is not an ancestor of this code. This repository is the one behind the wordpress.org listing.

License

GPL-3.0-or-later — see LICENSE.