Meta Box Documentation
website·Indexed 38 days ago
https://docs.metabox.io/Documentation and tutorials for Meta Box, a framework for creating custom fields, custom post types, and custom taxonomies in WordPress. Includes guides on using extensions like MB Views, integrating with page builders such as Elementor, Oxygen, Bricks, and Breakdance, and managing data in the database.
What's inside Meta Box
- MB Views is a Meta Box extension used to create and customize WordPress templates using code. While it is frequently used to display data from custom fields created with Meta Box, it can be used to customize any WordPress template, including post types that do not have Meta Box fields.
Overview of MB Custom Table
MB Custom Table allows you to save custom field values into dedicated custom MySQL tables instead of the default WordPresswp_postmetatable. In a custom table, all custom fields for a single post are stored in one row, with each field mapped to a specific column. This architecture reduces the total number of rows in the database, improving performance as data grows and simplifying data management (viewing, editing, importing, and exporting).Overview of Meta Box framework
Meta Box is a framework for WordPress that allows users and developers to create custom post types and custom fields. It is designed to help manage structured data (such as event dates or locations) and build complex features for WordPress websites. The framework is extensible via various extensions that provide capabilities like front-end form submission, post relationships, custom table storage, conditional logic, and Gutenberg blocks.Overview of MB Frontend Submission
MB Frontend Submission allows developers to create front-end forms that enable users to submit data for WordPress posts (including standard post fields like title and content) and custom fields created via Meta Box. It supports custom table models and integrates with MB Group and MB Conditional Logic extensions.Overview of Meta Box Block Bindings
Block bindings allow you to connect Meta Box custom fields (from posts, terms, authors, or settings pages) directly to core Gutenberg blocks like Paragraph, Heading, Image, and Button. This enables dynamic data display on the front end without requiring PHP templates or custom blocks.
Requirements:
- WordPress 6.5+ for basic block bindings.
- WordPress 6.9+ for the visual Attributes panel in the block editor.
Overview of the Taxonomy field
The Taxonomy field allows users to select one or multiple taxonomy terms for a post. Unlike the 'Taxonomy Advanced' field, the Taxonomy field does not store data in the database; instead, it sets the post terms directly, acting as a replacement for the default WordPress Category or Tag meta boxes.Overview of MB Relationships
MB Relationships allows developers to connect posts, terms, and users in WordPress. It supports many-to-many, one-to-many, many-to-one, and one-to-one relationship types. Unlike standard meta-based connections, it uses a dedicated custom database table, which provides bidirectional querying capabilities, prevents pollution of meta tables, and improves performance.Overview of the oEmbed field
The oEmbed field provides a text input for entering media URLs (such as videos, audio, images, tweets, polls, and podcasts) from supported third-party services. It features a live preview of the media content directly below the field in the admin interface and simplifies displaying that media on the frontend of a WordPress site.Overview of the Meta Box Block Editor field
The block editor field creates an isolated, standalone Gutenberg block editor within meta boxes, settings pages, and other supported Meta Box objects. This allows users to edit content using the WordPress block editor experience in custom areas. Multiple block editor fields can exist on a single page without interfering with one another, and each can be configured with its own set of allowed blocks.Create a section separator using the Heading field
The Heading field is used to organize the admin interface by creating a simple<h4>heading with an optional description. Because it does not store a value, it is primarily used to separate other fields into logical sections for a better user experience.Manage data with Custom Models
Custom Models allow you to create data entities that mimic WordPress posts but are stored entirely in their own custom tables without needing to link to posts, terms, or users.
Pros: Better data structure, no interference with WP tables, full CRUD support, and compatibility with MB Admin Columns. Cons: No built-in front-end templates or permalinks (used primarily for data management), and limited compatibility with MB Relationships and MB Views.
Setup: Navigate to Meta Box > Custom Models > Add New (requires MB Builder, bundled in Meta Box Lite/AIO).
Understand the difference between Taxonomy and Taxonomy Advanced fields
The standard Taxonomy field does not store data in the database; it simply sets the post terms (acting as a replacement for the default WordPress Category or Tag meta boxes). In contrast, the Taxonomy Advanced field stores the selected terms' IDs in the database and does not automatically set the post terms.