REST API Post Embeds

Installation

1. Install the plugin either via the WordPress.org plugin directory, or by uploading the files to your server.
2. Edit the post or page where you want to embed posts.
3. Add the jeherve_post_embed shortcode.
4. Boom! Done.

Shortcode parameters

The jeherve_post_embed shortcode includes different parameters, listed below:

• url:
  • URl of the site from which you want to retrieve posts.
  • Accepts URLs (no need to specify the scheme).
  • Important: If you use the default method to get posts, the site youll pull posts from has to be hosted on WordPress.com, or use the Jetpack plugin with the JSON API module. If you use the WP REST API, the site has to use the WP REST API plugin, version 2 or above.
  • Defaults to your own site.
• wpapi:
  • Default to false.
  • Set to true to retrieve posts from a site using the WP REST API plugin.
• ignore_sticky_posts:
  • Default to false.
  • Use true or false to decide whether you want the embedded post list to include sticky posts.
• include_images:
  • Default to true.
  • When set to true, if the posts include a Featured Image, it will be displayed above the post.
• include_title:
  • Default to true.
  • Includes the post title.
• include_excerpt:
  • Default to true.
  • Includes an excerpt if it exists.
• include_content:
  • Default to false.
  • Includes the whole post content (including images).
• include_credits:
  • Default to true.
  • Includes a link at the bottom of the posts list, linking to the source where the posts were found.
  • That credit link wont be displayed if youre embedding posts from your own site.
• image_size:
  • Allows you to control the size of the Featured Image displayed above the posts, if youve set include_images to true.
  • For that option to work, youll need to use Jetpack on your site, as well as the Photon module.
  • Option should follow this format: width,height, width and height being the value in pixels.
  • By default, the images will be as wide as your themes $content_width value (reference).
• order:
  • Order in which the posts are displayed, desc or asc.
  • Default to DESC.
• order_by:
  • What should the posts be ordered by? The accepted values are as follows: modified (date modified), title,comment_count, ID, date.
  • Default is date.
  • When using the WP REST API, only the following values are allowed: date, relevance, id, include, title, slug.
• number:
  • Number of posts to display.
  • Default to the number of posts youve set under Settings > Reading in your dashboard.
  • If that number is higher than 100, the default changes to 20.
• before:
  • Only return posts dated before the specified date.
  • Default to none.
  • Use an ISO 8601 date format such as 2021-03-21.
• after:
  • Only return posts dated after the specified date.
  • Default to none.
  • Use an ISO 8601 date format such as 2021-03-21.
• tag:
  • Only return posts belonging to a specific tag name or tag slug.
  • Default to none.
• category:
  • Only return posts belonging to a specific category name or category slug.
  • Default to none.
• type:
  • Specify the post type.
  • Defaults to posts, use any to query for both posts and pages.
• exclude:
  • Excludes the specified post ID(s) from the response.
  • Accepts a comma-separated list of Post IDs.
  • Default to none.
  • Not available when using the WP REST API.
• author:
  • Specify posts from a given author ID.
  • Default to none.
• wrapper_class:
  • Add a class to the wrapper around the post list.
  • Default to none.
• headline:
  • Displays a headline inside an h3, before the post list.
  • Default to none.