How a WordPress Divi Blog Was Rebuilt Using Custom Shortcodes and Grid Layouts
This article presents a technical field report on rebuilding the blog system for Rev6, a fitness and wellness platform built on WordPress with the Divi theme and hosted on Cloudways. The author explains the decision to avoid Divi’s built-in Blog module due to its limitations in handling custom markup, URL-based category routing, and membership-aware content. Instead, a modular architecture was created using custom shortcodes embedded in a child theme, each responsible for a specific feature such as blog sidebar navigation, sorting controls, post grids, author display elements, and related posts.
A key design decision was to use a single Theme Builder template for both the blog index and all category archive pages, with dynamic queries adjusting content based on context. This reduced duplication and improved maintainability. The article also highlights a major CSS grid issue where using an overly large span value created nearly 27,000 pixels of unintended whitespace due to phantom grid rows, emphasizing the importance of using named grid areas instead of arbitrary spans.
On the backend, the system includes custom author profile fields and a related-posts function that relies on category data and WordPress queries. A notable debugging case revealed that a supposed “bug” was actually caused by missing content rather than faulty code: a category contained only the current post, so exclusion logic returned no results.
The migration process from staging to production exposed deeper architectural issues, particularly the distinction between file-based changes (PHP, CSS, templates) and database-stored content (categories, module settings, post assignments). Additional complications arose from caching mechanisms that stripped unused CSS selectors, further complicating debugging. The author concludes that most production issues stem not from code errors but from data state, caching layers, and environment differences, reinforcing the importance of understanding WordPress as a hybrid system of code and database content.