Fix Metabox Images Not Working in Divi Dynamic Content

Written by Dan Mossop

Divi includes a dynamic content feature allows, among other things, images to be loaded dynamically from custom fields set on a post. However, when using Metabox to handle custom fields, you might encounter an issue where images stored in Metabox fields fail to display within Divi modules. 

This happens because Metabox returns the "attachment ID" of an image rather than its URL, yet Divi modules require the image URL to render properly. This mismatch means your images won't show up in your modules.

Fix Metabox Images not Showing in Divi using PHP

The issue can be rectified with the following PHP code. The aim is to dynamically replace the attachment ID with the corresponding image URL only when a Divi module processes this meta field.:

class DB_Metabox_Dynamic_Content_Image_Fix {
	
    private $target_meta_key = 'single_image_rccjfnb6vmh'; // <-- Change this to your image field ID
   
    public function __construct() {
        add_filter('et_pb_module_shortcode_attributes', [$this, 'add_id_to_url_filter'], 10, 3);
        add_filter('et_module_shortcode_output', [$this, 'remove_id_to_url_filter'], 10, 3);
    }

    public function add_id_to_url_filter($attrs, $content, $module_slug) {
        // Add the filter only during Divi module processing
        add_filter('get_post_metadata', [$this, 'convert_attachment_id_to_url'], 10, 4);
        return $attrs;
    }

    public function convert_attachment_id_to_url($null, $object_id, $meta_key, $single) {
        static $already_converting = false;

        if ($already_converting || $meta_key !== $this->target_meta_key) {
            return $null;
        }

        $already_converting = true;
        $attachment_id = get_post_meta($object_id, $meta_key, true);
        $already_converting = false;

        if (!empty($attachment_id)) {
            $image_url = wp_get_attachment_url($attachment_id);
            return array($image_url);
        }

        return $null;
    }

    public function remove_id_to_url_filter($output, $render_slug, $instance) {
        // Remove the filter after the shortcode processing
        remove_filter('get_post_metadata', [$this, 'convert_attachment_id_to_url'], 10, 4);
        return $output;
    }
}

// Initialize the class
add_action('init', function() {
    new DB_Metabox_Dynamic_Content_Image_Fix();
});

You can add this code in the functions.php file of a child theme, or using a plugin such as Code Snippets.

Be sure to change the $target_meta_key value (at the point marked in the code) to the ID of the field you want to convert.

Notes:

  • The code is designed to work with the Metabox "Single Image" field type. 
  • The code applies only during the rendering of Divi modules on the front end. This ensures that other site areas remain unaffected, although it does mean that images won't appear in the Divi Visual Builder preview.

 

Do More with Divi Dynamic Content!

Enhance your site's flexibility with the Divi Dynamic Content Extended plugin. Perfect for solving issues like Metabox images not showing, this plugin allows you to unlock dynamic content in more module fields, streamlining the integration of data from ACF, Meta Box, and Pods settings pages. Make your Divi designs smarter and more efficient today.

About Dan Mossop

Dan is a Scottish-born web developer, now living in Brisbane with his wife and son. He has been sharing tips and helping users with Divi since 2014. He created Divi Booster, the first Divi plugin, and continues to develop it along with 20+ other Divi plugins. Dan has a PhD in Computer Science, a background in web security and likes a lot of stuff, 

0 Comments

Submit a Comment

Comments are manually moderated and approved at the time they are answered. A preview is shown while pending but may disappear if your are cookies cleared - don't worry though, the comment is still in the queue.

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

We may earn a commission when you visit links on our website.

Latest Posts

Set Custom CSS IDs for Individual Divi Accordion Items

Assigning unique CSS IDs to specific Divi Accordion items allows for precise control over styling, targeting, and linking within your page content. This ability is particularly useful when you want to apply custom designs or create anchor links to particular accordion...

Enable Swipe Navigation in the Divi Gallery Lightbox

Enabling swipe navigation in the Divi Gallery module's lightbox allows users to seamlessly browse through gallery images by swiping left or right, creating a more interactive and mobile-friendly experience. This functionality can significantly improve user engagement...

Disable Slide-In Animation for Divi Gallery Grid Images

Control how images appear in your Divi Gallery module by toggling the slide-in animation effect for grid layouts. Disabling the slide-in animation allows gallery images to load instantly and appear statically, providing a faster and distraction-free browsing...

Control Image Count Display in Divi Gallery Lightbox

Displaying or hiding the image count in the Divi Gallery module’s lightbox can help customize the user experience, depending on whether you want to give visitors an indication of gallery progress or prefer a cleaner, distraction-free view. The ability to toggle this...

Hide Gallery Image Titles in the Divi Lightbox Overlay

Displaying image titles in the lightbox overlay of the Divi Gallery module can sometimes be distracting or unnecessary, depending on your website’s design and user experience goals. Hiding these titles creates a cleaner and more focused viewing experience for visitors...

Random Posts