Using the plugin
Shortcodes and blocks
Three shortcodes and two Gutenberg blocks. All of them work on content that is already in your database — either imported by a rule or written by hand.
Embedding a live external RSS feed, fetched when the page renders, is a full-version feature. See Free vs Paid.
[echo-display-posts]
The main display shortcode: query posts and render them as a styled list, with control over which fields appear.
[echo-display-posts posts_per_page="5" include_excerpt="true" include_date="true"]Show only what one import rule produced. Rule IDs come from the ID column on RSS to Post Rules:
[echo-display-posts ruleid="0" posts_per_page="10" include_title="true" include_link="true"]Attributes
Query
author, category, id, ignore_sticky_posts, meta_key, meta_value, offset, order, orderby, post_parent, post_status, post_type, posts_per_page, tag, taxonomy, tax_term, tax_operator, tax_include_children, time, date, date_column, date_compare, date_format, date_query_before, date_query_after, date_query_column, date_query_compare, exclude_current, ruleid
Output fields
include_title, include_link, include_date, include_author, include_excerpt, include_content, simple_excerpt, excerpt_length, excerpt_more, excerpt_more_link, read_more_text, image_size, image_newline, category_display, category_label, link_to_source, no_posts_message, display_posts_off
Styling
title, title_color, title_font_size, excerpt_color, excerpt_font_size, content_class, wrapper, wrapper_class, wrapper_id
link_to_source="true" makes each headline link to the original article rather than to your local copy — the usual choice for an aggregator page.
[echo-list-posts]
A lighter alternative that renders a plain list.
[echo-list-posts type="post" posts="20" orderby="title" order="ASC"]| Attribute | Default | Meaning |
|---|---|---|
type | any | Post type |
order | ASC | ASC or DESC |
orderby | title | Any WP_Query orderby value |
posts | 50 | How many to list |
posts_per_page | 50 | Page size |
category | — | Category slug |
ruleid | — | Restrict to posts created by one import rule |
taxonomy_query | — | taxonomy:term filter |
ruleid matches the echo_parent_rule post meta that every generated post carries.
[echo-display-input]
Renders a front-end form that lets a visitor submit a URL and have it imported as a post. Optionally creates a WordPress user for the submitter at the same time.
[echo-display-input button="Import this article" new_user_role="contributor"]| Attribute | Default | Meaning |
|---|---|---|
placeholder | Input your URL | URL field placeholder |
button | Import Posts! | Submit button label |
show_category_input | off | Let the visitor choose a category |
category_selector | — | Restrict the category choices |
show_post_type_input | off | Let the visitor choose a post type |
new_user_role | contributor | Role given to a newly created submitter |
username_placeholder | Create a new user name | |
password_placeholder | Create a new user password | |
email_placeholder | Email address for new user | |
user_exists_message | User name/email address already exists | |
user_submit_message | Thank you for your submission | |
incomplete_credentials | You must fill in all fields | |
post_template | — | Content template for the generated post |
email_template, email_subject, email_address | — | Notification email sent on submission |
Review the role you grant with new_user_role, and moderate the resulting posts — set the relevant rule's post status to Draft or Pending rather than Published.
Gutenberg blocks
Two blocks are registered when the block editor is available (WordPress 5.0+):
| Block | Equivalent shortcode |
|---|---|
rss-feed-post-generator-echo/echo-display | [echo-display-posts] |
rss-feed-post-generator-echo/echo-list | [echo-list-posts] |
Both are registered behind a function_exists( 'register_block_type' ) guard, so the plugin still loads cleanly on pre-5.0 WordPress — the blocks simply are not there.
Find them in the block inserter by searching for echo.