Adding Custom Divi Builder Pages Programmatically

Written by Dan Mossop

This post will show you how to programmatically add a Divi Builder page for use as a template in your child theme or custom functionality.

Step 1: Create Your Page Template

First, use the Divi page builder to create your page template. Add the sections and modules you want, and any default text. Save the page.

Step 2: Retrieve the Page Layout Code

To get the code Divi uses to represent the page layout you can use the WordPress revisions mechanism. After saving your page, use the revisions feature in WordPress to retrieve the shortcode structure for the page. You can compare revisions and copy the shortcode content.

Step 3: Add Code

Now add the following PHP code wherever you wish to use it (e.g. in the functions.php file of your child theme):

function divibooster_add_divi_page() {
    $title = 'My Custom Divi Page';
    $content = <<<END
[et_pb_section fb_built="1"][et_pb_row][et_pb_column type="4_4"][et_pb_text admin_label="Text" background_layout="light" text_orientation="left"]
My custom Divi page content.
[/et_pb_text][/et_pb_column][/et_pb_row][/et_pb_section]
END;

    $title = sanitize_text_field($title);

    // Check if the page already exists
    if (!get_page_by_title($title, 'OBJECT', 'page')) {
        $page = array(
            'post_title'   => $title,
            'post_content' => $content,
            'post_status'  => 'publish',
            'post_type'    => 'page',
        );

        $page_id = wp_insert_post($page);
        
        if ($page_id) {
            // Enable the Divi Builder on this page
            update_post_meta($page_id, '_et_pb_use_builder', 'on');
        }
    }
}

add_action('admin_init', 'divibooster_add_divi_page');

Important Notes

  • Efficiency: The admin_init hook is used in the example, which runs when the admin interface is initialized. For better efficiency, you may want to change this to suit your needs, such as running it on child theme activation.
  • Simple Title Check: The code performs a simple check based on the page title to determine if it has already been inserted. If the title is manually changed, the page will be re-inserted. Depending on your use case, you may need a more robust check.

Using the Inserted Page

Once the page is inserted via the code, it can be accessed and used like any normal Divi page. Simply locate the page in your WordPress admin area, edit it with the Divi Builder, and use it as needed.

Run PHP Code Directly in your Divi Layouts

Unlock endless customization, automation, and dynamic functionality by seamlessly adding PHP code to your Divi pages and posts with the Divi PHP Code Module. Style, preview, and debug your PHP creations directly in the visual builder with robust error handling and enhanced security.

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 From Divi Booster

Enable Automatic Looping for YouTube Videos in the Divi Video Module

Enabling automatic looping for YouTube videos in your Divi video module ensures that content plays seamlessly and continuously without interruption. This feature can enhance user engagement, highlight key information, or create dynamic visual effects on your website....

Hide Video Controls in Divi Video Module

Disabling YouTube video controls in the Divi Video Module helps create a seamless, distraction-free viewing experience for your site visitors. This approach is useful when you want full control over how your video content appears and is interacted with on the page, or...

Mute YouTube Videos by Default in the Divi Video Module

In the Divi Video Module, starting your YouTube videos muted by default can create a more user-friendly browsing experience on your webpage. It is particularly beneficial for reducing distractions, enhancing visitor engagement, and providing a seamless content preview...

Autoplay Videos in Divi Video Module

Enabling videos in your Divi video module to start playing automatically can enhance both the site's design and user engagement. To ensure full compatibility with browser requirements, such as Chrome's autoplay policy, it's often necessary to start your videos muted...

How to Add the Post Status in Divi's Dynamic Content

Divi's Dynamic Content feature is great for enhancing your post/page templates with post-specific information. While Divi includes an option to show information such as the Post Created Date using Dynamic Content, there is no equivalent option for the Post Status....

Random Divi Posts