REST API Post Embeds

Description

This plugin allows you to use the jeherve_post_embed shortcode to embed posts from your site or others’ anywhere on your site.

When creating the shortcode, you can use any of the 20 shortcode parameters to make sure the embed will include the posts you want to display, and will look the way you want it to look.

Important: You can only pull posts from 3 different types of sites:

  • WordPress.com sites.
  • Sites using the Jetpack plugin, with the JSON API module.
  • Sites using the REST API plugin, by adding wpapi="true" to your shortcode parameters.

Questions, problems?

Take a look at the Installation and FAQ tabs here. If that doesn’t help, post in the support forums.

Want to contribute with a patch?

Join me on GitHub!

FAQ

Can I insert the shortcode directly in my theme?

Yes, you can use the do_shortcode function to do so. You can read more about it here.

I get the following error instead of my post list: `We cannot load blog data at this time`.

See the instructions here.

Are there other ways for me to customize the post embed list?

Yes! The plugin includes quite a few filters you can use to customize the post list. You can browse the plugin’s source code to find out more.

  • jeherve_post_embed_blog_id allows you to specify a custom blog ID or normalized Jetpack or WordPress.com site URL.
  • jeherve_post_embed_base_api_url allows you to specify another REST API URL where you’ll get your posts from. It defaults to the WordPress.com REST API.
  • jeherve_post_embed_query_url allows you to change the final URL (including the options you’ve set in the shortcode parameters) used to query posts.
  • jeherve_post_embed_post_loop allows you to build your own post loop from the data you get from the API.
  • jeherve_post_embed_image_params allows you to specify custom Photon parameters applied to the Featured Images. It accepts an array of parameters. The accepted parameters are available here.
  • jeherve_post_embed_article_layout allows you to filter the layout of a single article in the list.
  • jeherve_post_embed_featured_image allows you to replace the Featured Image used for each post.
  • jeherve_post_embed_posts_cache allows you to control how long the post list is cached.
  • jeherve_post_embed_featured_cache allows you to control how long the featured images are cached.
  • jeherve_post_embed_term_cache allows you to control how long the terms are cached.

Reviews

Good Plugin, Helpful Developer

JohnNadeau

Works great!

This plugin has a lot of options & flexibility. Be sure to review the available parameters in both the Installation and FAQ sections.

Developer is simply awesome!

Read all 1 review

Changelog

1.4.0

Release Date: November 17, 2016

  • WP REST API: replace the filter param by top level query parameters. This makes category and tag filtering work again.
  • Handle all Posts Types, including Pages, in the WP REST API.
  • Coding Standards cleanup.
  • Make sure the number of posts option is respected when using the WP REST API.

1.3.3

Release Date: April 26, 2016

  • Make sure we don’t display Featured Images when the attribute isn’t set to true.

1.3.2

Release Date: March 14, 2016

  • Allow the WordPress.com REST API to get Custom Post Types.

1.3.1

Release Date: February 13, 2016

  • Ensure the plugin can be translated via WordPress.org.

1.3

Release Date: February 3, 2016

1.2.2

Release Date: September 21, 2015

  • Add more checks to avoid errors when returned posts don’t match query.

1.2.1

Release Date: August 26, 2015

  • Add more error messages when an API query doesn’t return expected results.
  • Make sure custom WP REST API queries are correct (square brackets should not be stripped from query URL).

1.2

Release Date: August 26, 2015

  • Use the media endpoint from the WP REST API to grab the featured image when available.
  • Refactor API queries to avoid caching responses from the APIs when they included an error.
  • Add a new filter, jeherve_post_embed_featured_image.
  • Add an additional embed style, embed-grid.
  • Include an uninstall.php to delete all transients created by the plugin when uninstalling it.

1.1

Releast Date: August 17, 2015

  • Add support for the WP REST API, thanks to the new wpapi shortcode parameter.
  • Refactor the plugin organization to make it easier to customize for third-party plugin developers.

1.0

Release Date: August 14, 2015

  • Initial release

Contributors & Developers

This is open source software. The following people have contributed to this plugin.

Contributors

Browse the code