MetaForge Engine

MetaForge Engine is a high-performance WordPress custom field builder and modern ACF alternative engineered for developers who demand clean architecture, fast execution, and guaranteed Zero Lock-In.

Whether you are building complex enterprise content models, structured UI components, nested data groups, or dynamic custom post types, MetaForge Engine delivers a visual field builder, a robust developer PHP API, and deep multi-provider AI assistance without database bloat or proprietary format traps.

Why WordPress Developers Choose MetaForge Engine

• WordPress Custom Field Builder with Clean Database Architecture: Create structured custom meta boxes across posts, pages, custom post types, taxonomy terms, user profiles, and global options pages. All metadata is stored in standard WordPress core tables (wp_postmeta, wp_termmeta, wp_options) without cryptic serialization or proprietary locks.
• 20 Core Free Field Types Included: Access 20 essential field types right out of the box—including nested Group containers, User Selectors, Post Type Selectors, dynamic Taxonomies, Date/Time pickers, Color pickers, Range sliders, and Buttons with zero artificial limits.
• Structured Nested Groups & Hierarchies: Build multi-level data models with unlimited nesting depth, memory-safe iteration, and clean PHP template syntax.
• Modern ACF Alternative with 1-Click Migration: Seamlessly migrate existing Advanced Custom Fields (ACF) field groups in a single click via MetaForge → Tools → Switch to MetaForge. The importer automatically converts ACF field groups into native MetaForge schemas, allowing developers to query fields using familiar, zero-lock-in metaforge_* template helpers (metaforge_get_field(), metaforge_have_rows(), metaforge_the_row()).
• WordPress Dynamic Fields & Relational Bindings: Connect custom post types with dynamic AJAX dependencies, taxonomy terms, bidirectional user selectors, and custom query sorting hooks (metaforge_post_order, metaforge_term_order).
• Visual Custom Post Type & Taxonomy Managers: Create and configure custom post types and hierarchical or tag taxonomies directly in the dashboard without writing code or installing extra plugins.
• Global Options Pages: Register site-wide settings panels for headers, footers, social links, and API credentials with full field group assignment.
• Gutenberg Block Bridge: Transform any field group into a native WordPress block (metaforge/ block registry) with zero React or JavaScript boilerplate. Customize block rendering using standard PHP template overrides (template-parts/blocks/{slug}.php).
• Enterprise Multi-Provider AI Core: Integrate OpenAI (ChatGPT & Responses API), Anthropic Claude, Google Gemini, Groq (Llama), DeepSeek, or OpenRouter to generate field groups, schemas, and realistic mock data from natural language prompts.
• Guaranteed Zero Lock-In: Built-in template functions (metaforge_get_field(), metaforge_have_rows(), etc.) are defensively wrapped with function_exists(). If MetaForge Engine is ever deactivated, your templates remain safe from fatal PHP errors, and all custom meta remains 100% accessible via native WordPress get_post_meta() calls.
• Extend with MetaForge Pro: Unlock 8 advanced field types including Repeaters with drag-and-drop ordering, Flexible Content modular layout builder, Gallery multi-image uploader, Relationship bidirectional selector, oEmbed, Icon Picker, Code Snippet container, and Accordion panels.

Developer PHP Template API & Real-World Examples

MetaForge Engine provides a developer-friendly PHP template API designed for fast theme and plugin development:

1. Standard Custom Meta Field Retrieval (Free)

<?php
// Retrieve a formatted custom field
$hero_title = metaforge_get_field('hero_title');
$hero_image = metaforge_get_field('hero_image'); // Returns formatted image array

if ($hero_title) : ?>
    <div class="hero-banner">
        <h1><?php echo esc_html($hero_title); ?></h1>
        <?php if (!empty($hero_image['url'])) : ?>
            <img src="<?php echo esc_url($hero_image['url']); ?>" alt="<?php echo esc_attr($hero_image['alt']); ?>" />
        <?php endif; ?>
    </div>
<?php endif; ?>

2. Nested Group Field Retrieval (Free)

<?php
// Retrieve nested associative subfields from a Group field
$contact_group = metaforge_get_field('contact_info');

if (!empty($contact_group)) : ?>
    <div class="contact-card">
        <p><strong>Email:</strong> <?php echo esc_html($contact_group['email'] ?? ''); ?></p>
        <p><strong>Phone:</strong> <?php echo esc_html($contact_group['phone'] ?? ''); ?></p>
    </div>
<?php endif; ?>

3. Programmatic Field Group Registration via PHP (Free)

<?php
// Register field groups locally in theme or plugin functions.php
add_action('init', function () {
    if (function_exists('metaforge_add_local_field_group')) {
        metaforge_add_local_field_group([
            'key'      => 'group_property_details',
            'title'    => 'Property Specifications',
            'location' => [
                [
                    ['param' => 'post_type', 'operator' => '==', 'value' => 'property']
                ]
            ],
            'fields'   => [
                [
                    'key'   => 'field_prop_price',
                    'label' => 'Listing Price',
                    'name'  => 'listing_price',
                    'type'  => 'number',
                ],
                [
                    'key'   => 'field_prop_agent',
                    'label' => 'Assigned Agent',
                    'name'  => 'assigned_agent',
                    'type'  => 'user',
                ]
            ]
        ]);
    }
});

4. High-Performance Repeater Field Loop (MetaForge Pro)

<?php
// Loop through a repeater field using standard row syntax (Pro)
if (metaforge_have_rows('pricing_features')) : ?>
    <ul class="features-list">
        <?php while (metaforge_have_rows('pricing_features')) : metaforge_the_row(); ?>
            <li>
                <span class="icon"><?php echo esc_html(metaforge_get_sub_field('icon_class')); ?></span>
                <strong><?php echo esc_html(metaforge_get_sub_field('feature_title')); ?></strong>:
                <?php echo esc_html(metaforge_get_sub_field('feature_description')); ?>
            </li>
        <?php endwhile; ?>
    </ul>
    <?php metaforge_reset_rows(); ?>
<?php endif; ?>

5. Flexible Content Layout Builder Dispatcher (MetaForge Pro)

<?php
// Modular flexible layout builder dispatcher (Pro)
if (metaforge_have_rows('page_sections')) :
    while (metaforge_have_rows('page_sections')) : metaforge_the_row();
        $layout = metaforge_get_row_layout();
        // Dispatches to template-parts/blocks/{layout}.php
        get_template_part('template-parts/blocks/' . sanitize_file_name($layout));
    endwhile;
    metaforge_reset_rows();
endif;
?>

20 Core Free Field Types

MetaForge Engine includes 20 production-ready field types in the free core version:

1. Text: Single-line text with character counters, prepends/appends, and HTML5 validation.
2. Textarea: Multi-line text with customizable row height and <br> or <p> auto-formatting.
3. Number: Integer or floating decimal with min, max, and step boundaries.
4. Range / Slider: Interactive slider UI for numeric values.
5. Checkbox: Multi-value checkbox group with dynamic layout direction.
6. Radio: Single-selection radio button list.
7. True / False: Binary toggle switch with custom affirmative/negative labels.
8. Link: Comprehensive URL picker supporting internal post selection, target, and link text.
9. Button / CTA: Action button configurator with URL, label, styling, and target attributes.
10. Color Picker: Iris-based color selector with hex and rgba support.
11. Date & Time Picker: Customizable date, time, and datetime inputs with format presets.
12. Image: Media modal selector returning structured array, image URL, or attachment ID.
13. File: Secure media uploader supporting document and asset file types.
14. WYSIWYG Editor: Full WordPress TinyMCE / visual rich-text editor.
15. Select: Dropdown menu supporting single or multi-select with search filtering.
16. Post Type Selector: Dynamic post picker with post type filtering and object return formats.
17. Taxonomy: Term selector with dynamic AJAX bindings connected to post type selectors.
18. User Selector: User profile picker filtered by user role and capabilities.
19. Group: Nested associative subfield containers for structured object grouping.
20. Tab: Visual section dividers for organizing large meta boxes into clean tabs.

8 Advanced Fields in MetaForge Pro

Upgrade to MetaForge Pro to unlock 8 additional enterprise-grade field types:

1. Repeater: High-performance repeatable subfield matrix with drag-and-drop sorting.
2. Flexible Content: Multi-layout modular block builder for dynamic page composition.
3. Gallery: Multi-image batch uploader with drag-and-drop ordering.
4. Relationship: Bidirectional post relational selector with live search filtering.
5. oEmbed: Embed video, audio, and rich media with responsive aspect wrappers.
6. Icon Picker: Visual vector icon selector.
7. Code Snippet: Syntax-formatted read-only code display container for documentation and code block presentation.
8. Accordion: Collapsible interface panels for complex admin forms.

Complete WordPress Administration Suite

• Custom Post Type Manager: Register and configure custom post types with custom slugs, REST API exposure, dashicons, menu positioning, and hierarchical attributes.
• Custom Taxonomy Manager: Register hierarchical (category-like) and flat (tag-like) custom taxonomies mapped to any registered post type.
• Visual Drag-and-Drop Reordering: High-performance batch ordering engine for custom post types and taxonomy terms with query sorting hooks (metaforge_post_order, metaforge_term_order).
• Global Options Pages: Register custom options pages for site-wide settings (header, footer, social links, API credentials) backed by the metaforge_options post type.
• Role & Capability Manager: Configure custom WordPress user roles and fine-grained capability assignments (manage_metaforge).
• JSON Sync & Version Control: Automatically export field group schemas to .json files within your theme or plugin for Git version control and team synchronization.
• WP-CLI Integration: Execute wp metaforge sync in continuous integration and automated deployment scripts.
• Tools & System Logs: Built-in authenticated System Logs viewer, export/import tools, and 1-Click “Switch to MetaForge” competitor field group migration.

External Services

MetaForge Engine integrates optional third-party AI service providers to power its AI Layout Assistant, Schema Generator, and Content Generation tools. MetaForge Engine supports the official WordPress 7.0+ Core AI Client (wp_ai_client_prompt()), allowing site administrators to use centralized AI providers configured under Settings > Connectors. For sites running earlier WordPress versions (WP 6.x) or users who wish to supply their own API keys, MetaForge Engine connects directly to user-configured LLM providers. These services are only invoked when a site administrator explicitly configures an API key under MetaForge -> AI Settings and initiates an AI generation action.

1. OpenAI API

* Service: OpenAI LLM APIs (ChatGPT & Responses API)
* Purpose: Powering natural language field schema generation and content creation.
* Data Sent: Admin-provided prompts and field structure context. No user PII is sent.
* Condition: Sent only when OpenAI is selected as the active AI provider in AI Settings and an AI action is triggered by an administrator.
* Terms of Service: https://openai.com/policies/terms-of-use/
* Privacy Policy: https://openai.com/policies/privacy-policy/

1. Anthropic Claude API

* Service: Anthropic Messages API
* Purpose: Powering natural language field schema generation and content creation.
* Data Sent: Admin-provided prompts and field structure context. No user PII is sent.
* Condition: Sent only when Anthropic is selected as the active AI provider in AI Settings and an AI action is triggered by an administrator.
* Terms of Service: https://www.anthropic.com/legal/terms
* Privacy Policy: https://www.anthropic.com/legal/privacy

1. Google Gemini API

* Service: Google Generative AI API
* Purpose: Powering natural language field schema generation and content creation.
* Data Sent: Admin-provided prompts and field structure context. No user PII is sent.
* Condition: Sent only when Google Gemini is selected as the active AI provider in AI Settings and an AI action is triggered by an administrator.
* Terms of Service: https://ai.google.dev/terms
* Privacy Policy: https://policies.google.com/privacy

1. Groq API

* Service: Groq LPU Inference Cloud API
* Purpose: Fast natural language field schema generation and content creation using open models.
* Data Sent: Admin-provided prompts and field structure context. No user PII is sent.
* Condition: Sent only when Groq is selected as the active AI provider in AI Settings and an AI action is triggered by an administrator.
* Terms of Service: https://groq.com/terms-of-use/
* Privacy Policy: https://groq.com/privacy-policy/

1. DeepSeek API

* Service: DeepSeek API
* Purpose: Powering natural language field schema generation and content creation.
* Data Sent: Admin-provided prompts and field structure context. No user PII is sent.
* Condition: Sent only when DeepSeek is selected as the active AI provider in AI Settings and an AI action is triggered by an administrator.
* Terms of Service: https://cdn.deepseek.com/policies/en-US/deepseek-terms-of-use.html
* Privacy Policy: https://cdn.deepseek.com/policies/en-US/deepseek-privacy-policy.html

1. OpenRouter API

* Service: OpenRouter LLM Gateway
* Purpose: Routing natural language prompts to user-selected AI models.
* Data Sent: Admin-provided prompts and field structure context. No user PII is sent.
* Condition: Sent only when OpenRouter is selected as the active AI provider in AI Settings and an AI action is triggered by an administrator.
* Terms of Service: https://openrouter.ai/terms
* Privacy Policy: https://openrouter.ai/privacy

Copyright and 3rd Party Libraries

MetaForge Engine bundles the following open-source third-party libraries:

• Select2:

  • Source: https://github.com/select2/select2
  • License: MIT (https://github.com/select2/select2/blob/master/LICENSE.md)
  • Copyright: (c) 2012-2020 Kevin Brown, Igor Vaynberg, and Select2 contributors

• SortableJS:

  • Source: https://github.com/SortableJS/Sortable
  • License: MIT (https://github.com/SortableJS/Sortable/blob/master/LICENSE)
  • Copyright: (c) 2019-2024 Lebedev Konstantin and SortableJS contributors

Post-Activation Setup

1. Configure AI Settings: Navigate to MetaForge → AI Settings and enter your API key (OpenAI, Anthropic, Gemini, Groq, DeepSeek, or OpenRouter), or define MetaForge_AI_API_KEY in wp-config.php.
2. Create Custom Post Types & Taxonomies: Use the MetaForge → Post Types and MetaForge → Taxonomies menus to register custom content structures.
3. Build Field Groups: Go to MetaForge → Field Groups to create new field groups or use the AI Layout Assistant to generate them from natural language.
4. Setup Git JSON Sync: Enable JSON Sync under settings to commit field group definitions directly into your Git repository.