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

Published: November 25, 2020,  
Posted in: ,  

Post updated 26th November 2020

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 include navigation.

To see it in action, watch the video below or visit https:/ or :

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 header navigation on these posts.

I also included the 'previous' and 'next' posts tags in the template as this would let users navigate between posts 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.

$this = $(this); 
$href = $this.find('.oxy-post-title'); 
if ($href.attr('href') && $this.attr('target')){ 
$('iframe[name="' + $this.attr('target') + '"]').attr('src',$href.attr('href')); 
$('.oxy-close-modal, .oxy-modal-backdrop').click(function(){ 

4. Add this to the code block html :

<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.

14 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.


  5. Hello,
    After creating a shop archive using Repeater how would I add a button to open a modal containing all of the selected product info plus an add to cart button?
    At the moment it opens a modal for each product in the loop, each modal is stacked on top of the last!
    Any help would be greatly appreciated

    1. Hi there,
      Not sure how you would go about that but if I was doing it I would use the new lightbox feature in Oxy Extras. Not sure you have that but it would be the simplest solution in my opinion.

  6. I have called custom post data in new oxygen template and its working fine.
    But how to link that template to the new modal.

Leave a Reply to Amanda Lucas Cancel 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
Copyright © 2021 All Rights Reserved  |  By Itchy Fingers Design
twitterfacebookenvelopelinkedinxinglong-arrow-leftlong-arrow-rightpaper-planepinterest-pwhatsappcommentingchevron-down linkedin facebook pinterest youtube rss twitter instagram facebook-blank rss-blank linkedin-blank pinterest youtube twitter instagram