{"id":334658,"date":"2026-07-07T14:19:41","date_gmt":"2026-07-07T14:19:41","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/layout-recompiler-for-brizy\/"},"modified":"2026-07-17T11:51:38","modified_gmt":"2026-07-17T11:51:38","slug":"layout-recompiler-for-brizy","status":"publish","type":"plugin","link":"https:\/\/es-ec.wordpress.org\/plugins\/layout-recompiler-for-brizy\/","author":21214404,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.4.4","stable_tag":"1.4.4","tested":"7.0.2","requires":"5.0","requires_php":"7.2","requires_plugins":null,"header_name":"Layout Recompiler for Brizy","header_author":"just another tech","header_description":"Recompiles all Brizy-enabled pages to fix broken layouts. Runs page-by-page using AJAX to prevent memory exhaustion and timeouts.","assets_banners_color":"deeef4","last_updated":"2026-07-17 11:51:38","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/justanothertech.online","header_plugin_uri":"","header_author_uri":"https:\/\/justanothertech.online","rating":0,"author_block_rating":0,"active_installs":20,"downloads":213,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.3.0":{"tag":"1.3.0","author":"ahabawel","date":"2026-07-07 20:42:07"},"1.4.0":{"tag":"1.4.0","author":"ahabawel","date":"2026-07-08 22:07:50"},"1.4.4":{"tag":"1.4.4","author":"ahabawel","date":"2026-07-17 11:51:38"}},"upgrade_notice":{"1.4.4":"<p>Adds blank placeholders for missing media and background-image sections when yellow placeholders are not desired.<\/p>","1.4.3":"<p>Adds a safe option to remove yellow placeholders created by the plugin.<\/p>","1.4.2":"<p>Improves missing media detection for Brizy beta rendered output.<\/p>","1.4.1":"<p>Fixes Brizy and Brizy Pro front-end asset URLs on subdirectory installs.<\/p>","1.4.0":"<p>Adds missing Brizy media scanning and safe yellow placeholder creation before recompilation.<\/p>","1.3.0":"<p>Enqueues JavaScript externally and maps internal hex UID titles to clear descriptions.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3599176,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3599176,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-772x250.png":{"filename":"banner-772x250.png","revision":3599176,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.3.0","1.4.0","1.4.4"],"block_files":[],"assets_screenshots":{"screenshot-1.jpg":{"filename":"screenshot-1.jpg","revision":3599176,"resolution":"1","location":"assets","locale":"","width":638,"height":478},"screenshot-2.jpg":{"filename":"screenshot-2.jpg","revision":3599176,"resolution":"2","location":"assets","locale":"","width":970,"height":660}},"screenshots":{"1":"Layout Recompiler appears under the WordPress Tools menu.","2":"The media scan report shows missing file paths, source links, and affected pages.","3":"The recompilation screen shows the start button, progress bar, and live process log."}},"plugin_section":[],"plugin_tags":[6410,483,4036,4155,3972],"plugin_category":[59],"plugin_contributors":[270483],"plugin_business_model":[],"class_list":["post-334658","plugin","type-plugin","status-publish","hentry","plugin_tags-builder","plugin_tags-fix","plugin_tags-layout","plugin_tags-migration","plugin_tags-tools","plugin_category-utilities-and-tools","plugin_contributors-ahabawel","plugin_committers-ahabawel"],"banners":{"banner":"https:\/\/ps.w.org\/layout-recompiler-for-brizy\/assets\/banner-772x250.png?rev=3599176","banner_2x":false,"banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/layout-recompiler-for-brizy\/assets\/icon-128x128.png?rev=3599176","icon_2x":"https:\/\/ps.w.org\/layout-recompiler-for-brizy\/assets\/icon-256x256.png?rev=3599176","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/layout-recompiler-for-brizy\/assets\/screenshot-1.jpg?rev=3599176","caption":"Layout Recompiler appears under the WordPress Tools menu."},{"src":"https:\/\/ps.w.org\/layout-recompiler-for-brizy\/assets\/screenshot-2.jpg?rev=3599176","caption":"The media scan report shows missing file paths, source links, and affected pages."}],"raw_content":"<!--section=description-->\n<p>If your website layout looks broken after a WordPress migration, host transfer, or plugin update, the cause is often that Brizy's compiled HTML\/CSS caches have fallen out of sync.<\/p>\n\n<p><strong>Layout Recompiler for Brizy<\/strong> solves this by triggering a clean recompilation of all pages built using Brizy.<\/p>\n\n<p>This plugin does not include license checks, trials, paid feature locks, usage quotas, or unlockable local features.<\/p>\n\n<h3>Key Features<\/h3>\n\n<ul>\n<li><strong>AJAX-Based Execution<\/strong>: Runs incrementally, compiling one page at a time. This keeps memory usage low and prevents common \"500 Internal Server Error\" or execution timeouts on low-memory servers (below 256MB).<\/li>\n<li><strong>Missing Brizy Media Scan<\/strong>: Checks Brizy pages one at a time for missing upload files, including rendered Brizy beta output, then shows the exact local paths, source links, and affected pages.<\/li>\n<li><strong>Missing Media Placeholders<\/strong>: Creates yellow or blank placeholder files only when the expected upload file is missing, and can remove yellow placeholders created by this tool if you no longer want them. It never overwrites real media files and does not change database content.<\/li>\n<li><strong>Safe Re-generation<\/strong>: The plugin reads your design templates in a read-only fashion (using JSON layouts stored in the database) and only updates the output HTML wrappers. Your database files and design structures are completely safe.<\/li>\n<li><strong>Real-time Logging<\/strong>: Displays a detailed progress bar and status feed in your admin area to show successful compilations or skipped layout assets.<\/li>\n<\/ul>\n\n<h3>Brizy Builder Dependency and Service Disclosure<\/h3>\n\n<p>This plugin requires the Brizy Builder plugin to be installed and active. It does not send data to any external service directly and does not make its own remote API requests.<\/p>\n\n<p>When you run the recompilation tool, this plugin calls Brizy Builder's local WordPress classes to recompile Brizy-enabled pages. Brizy Builder may use its own compiler URLs or download URLs as part of its normal compilation process. Any data handling, remote requests, terms, and privacy details for that process are controlled by Brizy Builder.<\/p>\n\n<p>When you run the missing media scan, the plugin may request the current site's own public page URL to inspect rendered Brizy markup. This same-site request is used only to detect missing media references that Brizy beta may generate at render time.<\/p>\n\n<p>Brizy Builder terms: https:\/\/www.brizy.io\/terms\nBrizy Builder privacy policy: https:\/\/www.brizy.io\/privacy-policy<\/p>\n\n<h3>Resolving Collapsed Page Widths (Blocksy Companion Conflict)<\/h3>\n\n<p>The Layout Recompiler can fix instances where full-width pages have suddenly collapsed to the default container width. If you are experiencing this layout issue due to a conflict with Blocksy Companion, follow these steps:<\/p>\n\n<ol>\n<li><strong>Deactivate Blocksy Companion Premium<\/strong> temporarily.<\/li>\n<li>Run the <strong>Layout Recompiler<\/strong> queue to completion (100%).<\/li>\n<li>Once finished, reactivate <strong>Blocksy Companion Premium<\/strong> and check the front-end of your site to see if the issue is resolved.<\/li>\n<\/ol>\n\n<p><em>Recommendations for Complex Sites<\/em>\nFor highly complex websites, we recommend temporarily disabling non-essential third-party plugins before running the recompilation process to ensure a clean execution. However:\n* <strong>WooCommerce Sites<\/strong>: If your website uses dynamic templates to generate shop pages, cart\/checkout areas, or product queries, <strong>WooCommerce<\/strong> and its essential related add-ons <em>must<\/em> remain active.\n* <strong>Dynamic Fields (ACF)<\/strong>: Similarly, if your layouts rely heavily on <strong>Advanced Custom Fields (ACF)<\/strong> or other dynamic content engines to fetch database fields, those plugins <em>must<\/em> remain enabled during recompilation.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Make sure the extracted plugin folder is named <code>layout-recompiler-for-brizy<\/code>. If you downloaded GitHub's automatic source archive, rename its <code>brizy-fix-main<\/code> folder before uploading it.<\/li>\n<li>Upload the <code>layout-recompiler-for-brizy<\/code> folder to your <code>\/wp-content\/plugins\/<\/code> directory.<\/li>\n<li>Activate <strong>Layout Recompiler for Brizy<\/strong> from your WordPress Plugins menu.<\/li>\n<li>Navigate to <strong>Tools &gt; Layout Recompiler<\/strong> in your WordPress Admin Sidebar.<\/li>\n<li>Optional: click <strong>Scan Missing Brizy Media<\/strong> to check for missing upload files, create yellow or blank placeholders, or remove yellow placeholders created by this tool.<\/li>\n<li>Click <strong>Start Recompilation<\/strong> and let the queue progress to 100%.<\/li>\n<\/ol>\n\n<p>You can watch the screencast here: https:\/\/youtu.be\/aOkBbAWAcWI<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"is%20it%20safe%20to%20use%3F\"><h3>Is it safe to use?<\/h3><\/dt>\n<dd><p>Yes. It only updates the output caches and HTML wrappers, without deleting or altering your design JSON templates or content. However, we always recommend making a backup first.<\/p><\/dd>\n<dt id=\"what%20should%20i%20do%20after%20compiling%3F\"><h3>What should I do after compiling?<\/h3><\/dt>\n<dd><p>Once the recompilation process is complete and you have verified that your layouts are fixed, you can safely deactivate and delete the plugin. It does not need to run continuously.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.4.4<\/h4>\n\n<ul>\n<li>Added blank placeholder creation for missing Brizy media when yellow fallback blocks are not desired.<\/li>\n<li>Blank placeholders can replace only plugin-created yellow placeholders or fill missing upload paths; real media files are never overwritten.<\/li>\n<li>Improves handling for Brizy background-image sections where removing a yellow placeholder can reveal the section fallback color.<\/li>\n<\/ul>\n\n<h4>1.4.3<\/h4>\n\n<ul>\n<li>Added an option to remove yellow placeholder files created by the plugin.<\/li>\n<li>Existing yellow placeholders are now detected during the media scan and clearly marked in the report.<\/li>\n<li>The create and remove placeholder actions run in small batches and never overwrite or delete real media files.<\/li>\n<\/ul>\n\n<h4>1.4.2<\/h4>\n\n<ul>\n<li>Improved Missing Brizy Media Scan so it can detect media references generated in rendered Brizy beta output.<\/li>\n<li>Fixed cases where the media scan reported no missing files even though the front end showed broken Brizy images.<\/li>\n<\/ul>\n\n<h4>1.4.1<\/h4>\n\n<ul>\n<li>Added compatibility handling for Brizy and Brizy Pro asset URLs on subdirectory WordPress installs.<\/li>\n<li>Fixed an issue where Brizy beta could load front-end CSS and JavaScript from duplicated paths, causing pages to appear unstyled.<\/li>\n<\/ul>\n\n<h4>1.4.0<\/h4>\n\n<ul>\n<li>Adds a missing Brizy media scanner with a clear report of missing local files, source links, and affected pages.<\/li>\n<li>Adds yellow placeholder creation for missing upload paths without overwriting existing files or changing database content.<\/li>\n<\/ul>\n\n<h4>1.3.0<\/h4>\n\n<ul>\n<li>Enqueues JavaScript externally and maps internal hex UID titles to clear descriptions.<\/li>\n<\/ul>","raw_excerpt":"Fixes broken Brizy layouts after a plugin update or site migration.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/es-ec.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/334658","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/es-ec.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/es-ec.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/es-ec.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=334658"}],"author":[{"embeddable":true,"href":"https:\/\/es-ec.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/ahabawel"}],"wp:attachment":[{"href":"https:\/\/es-ec.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=334658"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/es-ec.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=334658"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/es-ec.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=334658"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/es-ec.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=334658"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/es-ec.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=334658"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/es-ec.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=334658"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}