Description

MetricPage Builder represents a completely new way to construct WordPress pages. Instead of relying on bloated shortcodes or slow rendering pipelines, MetricPage Builder operates on a strict, schema-driven data model.

This plugin proves a new architecture for page builders:
* Sparse Documents: Data is stored incredibly efficiently.
* Regenerable Compile Cache: Pages are compiled Server-Side (SSR) for absolute maximum performance on the frontend.
* Thin Editor Library: A lightweight editor experience.
* Fragment Canvas Updates: Lightning-fast UI updates.

Who is this for?

For Developers & Agencies:
If you are tired of the “div soup”, slow performance, and unpredictable CSS output of traditional drag-and-drop page builders, MetricPage Builder is for you. Traditional builders often cause unexpectedly high database storage usage by saving massive amounts of metadata and bloated revision histories. MetricPage’s sparse documents solve this, storing only the raw data needed. You define the exact HTML structure and CSS inside your theme, and the builder simply acts as a rigid, ultra-lightweight data-entry UI.

For Clients & Content Creators:
Have a client that barely touches the backend? MetricPage Builder provides an impossible-to-break editing experience perfect for them. Instead of navigating a massive, complex UI with padding and margin controls, users simply fill out a clean form (e.g., “Heading”, “Image”, “Button text”). The builder perfectly compiles it into the developer’s approved design system, removing the learning curve entirely.

Installation

Upload the metric-builder folder to the /wp-content/plugins/ directory.
Activate the MetricPage Builder plugin through the ‘Plugins’ menu in WordPress.
Activate the companion Metric Theme Kit theme.
Navigate to Pages, and click Edit with Metric to launch the builder.

FAQ

Can I build my header and footer with Metric?

Yes. Go to Metric Header & Footer, add a header or footer and build it in the same builder as your pages. You can create as many as you like and choose where each appears with display conditions: entire site, front page, blog page, search, 404, author/date archives, all singular content, a post type (all or specific items), all archives, a post type archive, or a taxonomy (all or specific terms). Exclude rules win; otherwise the most specific match wins, and ties go to the most recently updated part. Pages with no match keep your theme’s default.

Your theme needs to print the part where it outputs its header or footer:

<?php if ( ! function_exists( 'metric_builder_part' ) || ! metric_builder_part( 'header' ) ) { get_template_part( 'header-default' ); } ?>

Themes can declare add_theme_support( 'metric-site-parts' ); and seed their own header/footer components with the metric_site_part_seed filter.

Does this replace the Block Editor (Gutenberg)?

Yes, MetricPage Builder acts as a complete alternative to the default editor on the pages you choose to edit with it.

Where is the data stored?

The raw schema data is stored efficiently in post meta. The compiled SSR output is held in a regenerable cache (object cache, transient, or a file under uploads/metricpage-builder/) and injected into the page through a the_content filter, so your site remains unbelievably fast.

Note: the compiled HTML is not written back into the post_content column. Plugins that analyse the raw column directly (for example some SEO content analysers) will not see the rendered body.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“MetricPage Builder” is open source software. The following people have contributed to this plugin.

Yujesh K C

Translate “MetricPage Builder” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.0.10

Changed: Default Single Post template layout order updated to Title -> Meta -> Featured Image -> Content -> Author Box -> Related Posts.
Layout: Added container padding to .metric-single and centered .metric-single-image with clean responsive max-width containment.
Fix: Eliminated PHP undefined array key notices in PostBlocks.php when image shape or content width attributes are omitted.

1.0.9

New: Single Post templates. Design how blog posts look in the Metric builder (Metric Theme Parts Single Posts) and choose which posts use each template. A ready-made default layout is included. Works with block and classic themes.
New: Post Title, Featured Image, Post Meta, Post Content and Author Box blocks, filled in for the post being viewed.
New: Author Box with social links. Authors add Facebook, X, Instagram, LinkedIn, YouTube and TikTok links under Users Profile.
New: Post List can show posts related to the current post (same category).
Changed: Metric Header & Footer is now Metric Theme Parts.
Fix: Post List grids show one column on phones, and pagination links point to the right page.
Fix: Post blocks stay empty on non-post pages; post embeds keep WordPress’s embed view; caches rebuild after security salts change.

1.0.8

New: Post List block. Show posts (or any public post type) in a grid or list, filtered by category and tag, with order, count, show/hide options and pagination. New posts appear without republishing the page.
Security: Shortcode markers in compiled pages are now signed, so marker text typed into content can never run a shortcode.
Developers: metric_register_dynamic_block() registers blocks rendered on every request; select fields accept enumLabels.

1.0.7

Security: All front-end output, including shortcode output, is filtered with wp_kses before it is returned to the_content. Form elements are allowed so shortcode forms keep working; the list can be extended with the metric_front_allowed_html filter.
Security: Settings inputs are sanitized field by field as they are read.
Fix: Publishing a header or footer from the Header & Footer list now publishes the latest builder changes.

1.0.6

Fix: Opening a page in the builder no longer changes the live page.
Fix: Autosaves are stored as a draft; visitors see changes only after Publish. Preview shows the draft.
Fix: Shortcode output such as forms is no longer stripped on pages, headers and footers.
Security: Free-form shortcodes and page structure changes (including nested components) are enforced server-side by capability.
Security: Builder document endpoints only accept supported post types; image paths can no longer resolve outside the uploads/content folders.

1.0.5

New: Metric Header & Footer. Build multiple headers and footers in the Metric builder and choose where each appears with Elementor-style display conditions. Includes new Site Header and Site Footer components. Replaces the removed file editor.
Security: Removed the Header & Footer file editor; the plugin no longer writes to theme or plugin folders.
Security: The builder screen now checks edit permission for the page and requires a nonce before converting a page to Metric.
Security: Publishing now requires the page type’s own publish capability.
Compiled cache and optimized images are stored in uploads/metricpage-builder/.
Admin CSS and JavaScript are loaded as enqueued files instead of inline tags.
Removed Google Fonts from the editor canvas; the canvas uses your theme’s fonts.
Removed site-specific defaults from Settings.
Added uninstall cleanup for plugin settings, capabilities and cache files.
New: Use Metric on Posts as well as Pages (filterable with metric_supported_post_types).
New: WordPress’s post-locking now protects the builder, so two people can no longer silently overwrite each other’s edits to the same page or header/footer.
New: Undo/redo in the builder (Ctrl/Cmd+Z, Ctrl/Cmd+Shift+Z).
New: Container component — group components into a responsive grid (columns can differ on desktop/tablet/mobile), with drag-and-drop nesting in the Page Structure sidebar and on the canvas, and a full Style tab (background color/image/gradient, padding, margin, border, shadow, alignment).
Fix: the editor canvas now shows every built-in component’s real styling while you edit (it previously loaded only the active theme’s CSS, not the plugin’s own).
Fix: <style> blocks shipped by theme-kit components were being stripped down to their bare CSS text and printed visibly on the page; also fixes any --custom-property inside them being corrupted into – characters.
The Container’s settings are now grouped into collapsible, Elementor-style sections (Layout, Background, Text, Border & shadow) plus a dedicated Advanced tab for spacing — instead of one long flat list.

1.0.4

Universal Plugin Components: Bundled 5 built-in core starter components (metric_hero, metric_text, metric_cards, metric_cta, metric_faq) and core-components.css so MetricPage Builder is 100% ready to use out-of-the-box on any WordPress theme.

1.0.3

Dynamic Drop Indicators: Real-time top/bottom position calculation during section dragging with blue indicator lines and centered badges on live iframe canvas and sidebar list.
Section Card Redesign: Overhauled structure sidebar section cards with modern white cards, subtle borders, elevated shadows, section type SVG icon badges, left-accent border indicators for active items, 6-dot drag handles, and interactive red trash icons.
Component Search UI: Upgraded component search input with inner SVG search icon, focus ring outline, and smooth background transitions.
Drag & Drop Reordering: Removed legacy up/down arrow buttons in favor of drag-and-drop section reordering and in-between drop insertion.
Import & Export UI: Reduced visual noise of Export and Import buttons in toolbar header using a subtle ghost button style.

1.0.2

Default Sections Tab: Editor opens with the Sections (Structure) tab active by default.
Page Import / Export: Full page schema JSON export and import capabilities in editor toolbar.
WordPress 7.1 Compatibility: Updated tested compatibility header to 7.1.
Plugin Check Compliance: Fixed PHPCS variable prefixing, input sanitization, and view template variable warnings.
Build Package Isolation: Moved all production ZIP build artifacts to /wp-content/builds/.

1.0.1

Global Settings Integration: Added global typography controls (H1-H6, paragraph, blockquote font sizes & line heights), brand color tokens, and border radius settings.
Compile Cache Clearance: Automatic compile cache flushing upon saving settings in WP Admin.
Admin Bar Action: Global “Clear Metric Cache” action button in WordPress admin bar.
Font Unit Presets: Quick font size unit preset toggles (px, rem, fluid) and auto-sanitization.

1.0.0

Initial release of MetricPage Builder featuring schema-driven data model, SSR compile pipeline, thin editor library, and regenerable SSR compile cache.