Oxygen 3.9 is now available - see what's newlimited time special pricing available
docs PHP, CSS & JS

Easy Posts

Easy Posts makes it easy to display customizable lists of posts, pages, or any custom post type.

Add an Easy Posts to your page from +Add -> Helpers -> Easy Posts.


Various presets to display posts in list, grid, or masonry layouts are included with Oxygen.

Choose a preset from Load Settings From Preset to load a preset. The current settings for the Easy Posts will be overwritten by the preset.

To add your own presets to this list, simply adjust the settings in the Query, Styles, and Templates sections as you wish. Then enter a preset name in the Save current settings as preset box and click Save.


The query determines which posts will be displayed by Easy Posts.


The default query is generated by WordPress based on the URL you visit. Visiting the URL for your blog post archive will make WordPress generate a query that will return your blog posts. Visiting the URL for a real estate listing will make WordPress generate a query that will return that real estate listing.

This is all done automatically by WordPress.

You can override the default query by choosing custom or manual.


  • Post Type - choose the post types returned by the query, or manually specify IDs
  • Filtering - exclude posts that don't match the specified author or taxonomies
  • Order - the order the posts are displayed in - alphabetical, by date, etc.
  • Count - the number of posts to return


For complete control over the posts returned by query, you can manually specify WP_Query parameters.



Customize the styles for the title, meta, content, read more, and responsive behavior of the displayed posts.

Note: some styles are not applicable or not supported by certain preset templates.

D:Dropbox!upwork!manualsoxygen!TemplatingPosts Lists and Grids2.png


Template PHP

This code is used to render a single item in the list of posts output by the Easy Posts.

This code behaves as if it was running inside the WordPress loop and the_post() has already been called.

Customization of this code allows you to add any data you want, such as Custom Field values, to the Easy Posts output.

Template CSS

This code works in conjunction with the settings specified in the Styles section to control the way the list of posts is displayed.

%%EPID%% is replaced with the ID of the current Easy Posts element, which prevents different Easy Posts styles from conflicting with each other if multiple Easy Posts are used on the same page.


Pagination of an Easy Posts element is controlled by Reading Settings specified at Settings -> Reading in your WordPress admin panel.


Last modified: June 10, 2020
Copyright © 2021 Soflyy
linkedin facebook pinterest youtube rss twitter instagram facebook-blank rss-blank linkedin-blank pinterest youtube twitter instagram