Description

This is a Gutenberg block that pulls posts from an RSS feed.

You can see a demo version of the plugin on https://aatanasov.net/example-rss-feed/

The plugin uses the fetch_feed WordPress function to display the entries from a feed on your website (https://codex.wordpress.org/Function_Reference/fetch_feed).

Requirements

Gutenberg has to be installed on your WordPress instance in order to use this plugin.

Configuration

Once the plugin is installed, you’ll first need to enter the URL of your feed URL. There is a helpful button for validating the feed URL. If there is something wrong, an error will appear.

Here are the available feed options:
1. Number of posts to be shown on the front-end. The default number is 10.
1. Whether to show the descriptions of the posts on the front-end.
1. Whether to show the dates of the posts on the front-end.

WordPress Hooks

There are a few WordPress hooks that allows you to modify the output. All of them are related to the front-end.

Actions

grf_before_items -- called before displaying the feed on your site.

grf_before_item -- called before each feed entry.

grf_after_item -- called after each feed entry.

grf_after_items -- called after all listed entries.

Filters

grf_frontend_output -- allows you to modify the HTML markup that will be displayed on the site.<h3>Front-end error messages</h3>

In case, a feed isn’t configured or it isn’t a valid one, the following messages might appear on the page that uses the custom block:
– Missing feed URL: Please set the URL of the RSS feed through the WordPress dashboard.
– Incorrect feed: Please make sure the provided URL is a valid feed.
– No posts: No feed items found.