https://github.com/cabrerahector/wordpress-popular-posts-feed
Adds a Popular Posts RSS feed to your WordPress powered site.
https://github.com/cabrerahector/wordpress-popular-posts-feed
feed plugin popular posts rss wordpress
Last synced: about 1 month ago
JSON representation
Adds a Popular Posts RSS feed to your WordPress powered site.
- Host: GitHub
- URL: https://github.com/cabrerahector/wordpress-popular-posts-feed
- Owner: cabrerahector
- License: gpl-3.0
- Created: 2018-09-11T16:52:34.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2026-02-11T20:04:20.000Z (about 2 months ago)
- Last Synced: 2026-02-12T04:25:51.880Z (about 1 month ago)
- Topics: feed, plugin, popular, posts, rss, wordpress
- Language: PHP
- Size: 34.2 KB
- Stars: 3
- Watchers: 1
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Popular Posts RSS feed for WordPress
Adds a Popular Posts RSS feed to your WordPress site.
----
## Table of contents
* [Description](https://github.com/cabrerahector/wordpress-popular-posts-feed#description)
* [Requirements](https://github.com/cabrerahector/wordpress-popular-posts-feed#requirements)
* [Installation](https://github.com/cabrerahector/wordpress-popular-posts-feed#installation)
* [Upgrading](https://github.com/cabrerahector/wordpress-popular-posts-feed#upgrading)
* [Customizing the feed](https://github.com/cabrerahector/wordpress-popular-posts-feed#customization)
* [Contributing](https://github.com/cabrerahector/wordpress-popular-posts-feed#contributing)
## Description
Popular Posts Feed is a [WordPress](https://wordpress.org/) plugin that adds a popular posts feed to your WordPress-powered web site.
## Requirements
* WordPress 6.2 or newer.
* PHP 7.4 or newer.
* [WP Popular Posts](https://wordpress.org/plugins/wordpress-popular-posts/) 5.0 or newer.
## Installation
1. Grab the zip file from the [latest release page](https://github.com/cabrerahector/wordpress-popular-posts-feed/releases/latest/) and then follow the [manual plugin installation instructions](https://wordpress.org/documentation/article/manage-plugins/#upload-via-wordpress-admin).
2. Go to **Plugins**, find the **Popular Posts Feed** plugin and click on **Activate** to enable it.
3. Go to **Settings > Permalinks** and click on **Save Changes** to flush WordPress' permalinks rules and have it detect the new feed.
4. Visit <your domain name>/feed/popular-posts/ using your browser. If everything went OK, you'll be able to see the popular posts feed right away.
## Upgrading
1. Go to the [latest release page](https://github.com/cabrerahector/wordpress-popular-posts-feed/releases/latest/) and download the attached zip file from the Assets section.
2. Deactivate and uninstall your current version of the **Popular Posts Feed** plugin.
3. [Manually install the plugin zip file you just downloaded](https://wordpress.org/documentation/article/manage-plugins/#upload-via-wordpress-admin).
4. Go to **Plugins** and activate the **Popular Posts Feed** plugin.
5. Go to **Settings > Permalinks** and click on **Save Changes** to flush WordPress' permalinks rules.
## Customization
The plugin includes various filter hooks that you can use to customize your popular posts RSS feed. Generally speaking though, the one you'll likely want to use is `popular_posts_feed_args`.
Hook into `popular_posts_feed_args` to:
- Change the number of items displayed in the feed.
- Change the post type (default is `post`).
- Have the feed return popular posts from a given taxonomy (`category`, `post_tag`, or even a custom taxonomy!)
- Change the Time Range (default is most popular posts from the past 7 days).
- Have the feed return popular posts from a given author.
- etcetera.
The `popular_posts_feed_args` accepts pretty much the same parameters used by the [wpp_get_mostpopular() template tag](https://github.com/cabrerahector/wordpress-popular-posts/wiki/2.-Template-tags#wpp_get_mostpopular) from the [WP Popular Posts plugin](https://wordpress.org/plugins/wordpress-popular-posts/).
Here's an example:
```php
/**
* Have the WPP feed display the 10 most popular posts
* from category ID 7 from the past 30 days.
*/
function wp3951_my_popular_feed_options( $args ){
$args['range'] = 'last30days';
$args['limit'] = 10;
$args['taxonomy'] = 'category';
$args['term_id'] = 7;
return $args;
}
add_filter('popular_posts_feed_args', 'wp3951_my_popular_feed_options', 10);
```
For more filter hooks, have a look at the `feed.php` file included with the plugin.
## Contributing
* If you have any ideas/suggestions/bug reports, and if there's not an issue filed for it already (see [issue tracker](https://github.com/cabrerahector/wordpress-popular-posts-feed/issues)), please [create an issue](https://github.com/cabrerahector/wordpress-popular-posts-feed/issues/new) so I can keep track of it.
* Developers can send [pull requests](https://help.github.com/articles/using-pull-requests) to suggest fixes / improvements to the source.