MetaForge Engine

MetaForge Engine is a high-performance WordPress custom field builder and modern Advanced Custom Fields engine 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.

• Seamless 1-Click Migration for Advanced Custom Fields: Seamlessly migrate existing Advanced Custom Fields field groups in a single click via MetaForge → Tools → Switch to MetaForge. The importer automatically converts existing 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

>

2. Nested Group Field Retrieval (Free)

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

php echo esc_html($contact_group['email']?? php echo esc_html($contact_group['phone']?? >

3. Programmatic Field Group Registration via PHP (Free)

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)

>

5. Flexible Content Layout Builder Dispatcher (MetaForge Pro)

php get_template_part('template-parts/blocks/'. >

20 Core Free Field Types

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

• Text: Single-line text with character counters, prepends/appends, and HTML5 validation.

• Textarea: Multi-line text with customizable row height and <br> or <p> auto-formatting.

• Number: Integer or floating decimal with min, max, and step boundaries.

• Range / Slider: Interactive slider UI for numeric values.

• Checkbox: Multi-value checkbox group with dynamic layout direction.

• Radio: Single-selection radio button list.

• True / False: Binary toggle switch with custom affirmative/negative labels.

• Link: Comprehensive URL picker supporting internal post selection, target, and link text.

• Button / CTA: Action button configurator with URL, label, styling, and target attributes.

• Color Picker: Iris-based color selector with hex and rgba support.

• Date & Time Picker: Customizable date, time, and datetime inputs with format presets.

• Image: Media modal selector returning structured array, image URL, or attachment ID.

• File: Secure media uploader supporting document and asset file types.

• WYSIWYG Editor: Full WordPress TinyMCE / visual rich-text editor.

• Select: Dropdown menu supporting single or multi-select with search filtering.

• Post Type Selector: Dynamic post picker with post type filtering and object return formats.

• Taxonomy: Term selector with dynamic AJAX bindings connected to post type selectors.

• User Selector: User profile picker filtered by user role and capabilities.

• Group: Nested associative subfield containers for structured object grouping.

• 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:

• Repeater: High-performance repeatable subfield matrix with drag-and-drop sorting.

• Flexible Content: Multi-layout modular block builder for dynamic page composition.

• Gallery: Multi-image batch uploader with drag-and-drop ordering.

• Relationship: Bidirectional post relational selector with live search filtering.

• oEmbed: Embed video, audio, and rich media with responsive aspect wrappers.

• Icon Picker: Visual vector icon selector.

• Code Snippet: Syntax-formatted read-only code display container for documentation and code block presentation.

• 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. 0+ Core AI Client ( wp_ai_client_prompt() ), allowing site administrators to use centralized AI providers configured under Settings > Connectors. 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.

• 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.

com/policies/terms-of-use/

com/policies/privacy-policy/

• 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.

com/legal/terms

com/legal/privacy

• 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.

dev/terms

com/privacy

• 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.

com/terms-of-use/

com/privacy-policy/

• 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.

html

html

• 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.

ai/terms

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

• 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.

• Create Custom Post Types & Taxonomies: Use the MetaForge → Post Types and MetaForge → Taxonomies menus to register custom content structures.

• 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.

• Setup Git JSON Sync: Enable JSON Sync under settings to commit field group definitions directly into your Git repository.