How To Open Easy Post Content in a Modal with Oxygen Builder

Published: August 11, 2019,  
Posted in: ,  

On a recent project, I struggled with trying to get a clients site opening custom post types from an Easy Posts query. They needed to allow users to view projects quickly and have a navigation.

See it in action below or visit https:/ :

I tried accessing various sources for help but the solution never quite did what I wanted.

After posting my struggle on the Official Oxygen User Facebook group, Briany Hearne helped with the following solution for which I am truly grateful.

Essentially I had a custom post type called projects with some custom ACF fields including an ACF gallery field for project images. I created a blank template that applied only to this custom post and inherited no other templates as I didn't want the footer and nav on these posts.

I also included the 'previous' and 'next' posts tags in the template as this would let users navigate between projects quickly.

Once the post template was complete, I went to where they would be viewed from.

1. Create a modal, style it how you wish. I added a modal to the page displaying the post query, which, in this case was Projects. I setup the modal so it displayed across all devices.

2. Use the click trigger to display the modal using the js-trigger-iframe class.

3. Add the following jQuery to a code block on the page displaying the post query.

jQuery( document ).ready( function($) { $('.js-trigger-iframe').click(function(){ $this = $(this); if ($this.attr('href') && $this.attr('target')){ $('iframe[name="' + $this.attr('target') + '"]').attr('src',$this.attr('href')); } }); $('.oxy-close-modal, .oxy-modal-backdrop').click(function(){ $('.ct-modal').find('iframe').removeAttr('src'); }); });

4. Add this to the code block html (content between the /* */ characters):

/* <iframe src="" width="100%" height="100%"></iframe> */

5. Make sure the code block is set to the same height as the modal container.

6. Add the class (js-trigger-iframe) to the easy post php template around the post link along with the target element below.


Essentially anything wrapped in the js-trigger-iframe class will open in an overlay once the modal has been added as above.

I can see a lot of use cases for this and it also has the bonus of being navigatable if the template showing the content has the previous and next tags included.

In order to make sure the modals were scrollable on mobile, I had to add this to the modal parent to enable it on IOS:

/* overflow:auto; -webkit-overflow-scrolling:touch; */

I will be keeping this post up to date in case of any code changes as I know it is something I will use on many clients sites.

Love to know in the comments if you find it useful.

10 comments on “How To Open Easy Post Content in a Modal with Oxygen Builder”

    1. Many thanks Ros. I keep meaning to share more as its a great way of referencing how I did things and I'm always happy to help others. Really you found it useful and appreciate you taking the time to comment.

  1. Hi,
    I'm having a few issues implementing this tutorial, would you be able to answer a couple of questions, I am 100% sure it is me doing something stupid

  2. Do you happen to have screen shots showing your progress on this? I get completely lost at step 3 and after 🙁 What do you mean by post query? I have a homepage with some blocks that they can click on. Once the modal opens, I wanted to display content from a specific post depending on the one they click on, but I'm not sure how to transfer this data. I'm probably lost at the "query" part. I'm using just the default posts WordPress has built in and I have some posts under a specific category.
    I'm not sure what you mean by the PHP template for the post as well since I'm using the default one.

  3. Hi. I'm a bit confused about step 5, where shall I insert {target="myiframe"} and what class shall I add.
    Another thing ... The modal overlay does pop up, but my ACF data won't show, is there something in the javascript I need to change for it to work?
    Regards Nanna

    1. Hi Nanna,
      I have updated the post to show actual screenshots of where to add the class.

      Once your ACF data is showing in the post source itself, it should appear in the modal.

      Hope you get sorted.


  4. Hi Amanda,
    first of all thank you for the tutorial. This is exactly what I've been looking for.
    One question though.
    Would you care to share how you implemented the portfolio filter?
    Thank you and have a wonderful day.


Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Get Notified Of New Posts
linkedin facebook pinterest youtube rss twitter instagram facebook-blank rss-blank linkedin-blank pinterest youtube twitter instagram