PHPackages wordpressvn/wp-meta-box - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. wordpressvn/wp-meta-box ActiveLibrary wordpressvn/wp-meta-box ======================= Handy package to make creating WordPress meta boxes a breeze. 1.7.0(5mo ago)058GPL-3.0PHPPHP ^8.0 Since Mar 2Pushed 5mo ago1 watchersCompare [ Source](https://github.com/wordpressvn/wp-meta-box)[ Packagist](https://packagist.org/packages/wordpressvn/wp-meta-box)[ RSS](/packages/wordpressvn-wp-meta-box/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (7)DependenciesVersions (8)Used By (0) WP Meta Box =========== [](#wp-meta-box) This package aims to make it easier to create meta boxes for WordPress plugins. > ⚠️ Untill the first stable release, the API is subject to change. Use at your own risk. Installation ------------ [](#installation) ``` composer require wordpressvn/wp-meta-box ``` Usage ----- [](#usage) ### Basic example [](#basic-example) ``` use WPVNTeam\WPMetaBox\WPMetaBox; $meta_box = WPMetaBox::post('Post settings') ->set_post_type('post'); $meta_box->add_option('text', [ 'name' => 'name_of_option', 'label' => __('Label of option', 'textdomain'), 'description' => __('Some additional description', 'textdomain') ]); $meta_box->make(); // Or for taxonomies: $meta_box = WPMetaBox::taxonomy('Taxonomy settings') ->set_taxonomies(['category']); ``` ### Available types [](#available-types) - [Text](#text) - [Date](#date) - [Number](#number) - [Textarea](#textarea) - [Checkbox](#checkbox) - [Choices (Radio Buttons)](#choices-radio-buttons) - [Color](#color) - [Select](#select) - [Select2](#select2) - [Media](#media) - [Image](#image) - [Code Editor](#code-editor) - [WP Editor](#wp-editor) - [Repeater](#repeater) #### Text [](#text) ``` $meta_box->add_option('text', [ 'name' => 'name_of_option', 'label' => __('Label of option', 'textdomain') ]); ``` #### Date [](#date) ``` $meta_box->add_option('date', [ 'name' => 'name_of_option', 'label' => __('Label of option', 'textdomain') ]); ``` #### Number [](#number) ``` $meta_box->add_option('number', [ 'name' => 'name_of_option', 'label' => __('Label of option', 'textdomain') ]); ``` #### Textarea [](#textarea) ``` $meta_box->add_option('textarea', [ 'name' => 'name_of_option', 'label' => __('Label of option', 'textdomain') ]); ``` #### Checkbox [](#checkbox) ``` $meta_box->add_option('checkbox', [ 'name' => 'name_of_option', 'label' => __('Label of option', 'textdomain') ]); ``` #### Choices (radio buttons) [](#choices-radio-buttons) ``` $meta_box->add_option('checkbox', [ 'name' => 'name_of_option', 'label' => __('Label of option', 'textdomain'), 'options' => [ 1 => 'option 1', 2 => 'option 2' ] ]); ``` #### Color [](#color) ``` $meta_box->add_option('color', [ 'name' => 'name_of_option', 'label' => __('Label of option', 'textdomain') ]); ``` #### Select [](#select) ``` $meta_box->add_option('select', [ 'name' => 'name_of_option', 'label' => __('Label of option', 'textdomain'), 'options' => [ 1 => 'option 1', 2 => 'option 2' ] ]); ``` You can allow multiple values too. ``` $meta_box->add_option('select', [ 'name' => 'name_of_option', 'label' => __('Label of option', 'textdomain'), 'multiple' => true, 'options' => [ 1 => 'option 1', 2 => 'option 2' ] ]); ``` ### Select2 [](#select2) Select2 gives you a customizable select box with support for searching. You can use `select2` the same way you use the regular `select`. ``` $meta_box->add_option('select2', [ 'name' => 'name_of_option', 'label' => __('Label of option', 'textdomain'), 'options' => [ 1 => 'option 1', 2 => 'option 2' ] ]); ``` If you would like to search the options through ajax, you can do this by defining two callbacks (or function names). One for fetching and filtering the options and one for getting the value callback. The below example is using select2 to select a page. ``` $meta_box->add_option('select2', [ 'name' => 'name_of_option', 'label' => __('Label of option', 'textdomain'), 'ajax' => [ 'value' => function($pageId) { return get_the_title($pageId) ?? null; }, 'action' => function() { $results = array_reduce(get_posts(['post_type' => 'page', 's' => $_GET['q']]), function($item, $page) { $item[$page->ID] = $page->post_title; return $item; }, []); echo json_encode($results); die(); } ] ]); ``` You may allow multiple values by settings the `multiple` value in `config` to true. If you want to use the ajax functionality here, be sure to define value callback here as well. ``` $meta_box->add_option('select2', [ 'name' => 'name_of_option', 'label' => __('Label of option', 'textdomain'), 'multiple' => true, 'ajax' => [ 'value' => function($ids) { foreach($ids as $id) { $titles[$id] = get_the_title($id) ?? $id; } return $titles ?? []; }, 'action' => function() { $results = array_reduce(get_posts(['post_type' => 'page', 's' => $_GET['q']]), function($item, $page) { $item[$page->ID] = $page->post_title; return $item; }, []); echo json_encode($results); die(); } ] ]); ``` You can pass anything you'd like to the select2 configuration using `config`, the exception being the ajax part of the configuration. A list of options can be found [here](https://select2.org/configuration/options-api). The Select2 that comes with the package is loaded from the Cloudflare CDN. You can overwrite this using the `wmb_select2_assets` filter hook. #### Media [](#media) ``` $meta_box->add_option('media', [ 'name' => 'name_of_option', 'label' => __('Label of option', 'textdomain') ]); ``` #### Image [](#image) ``` $meta_box->add_option('image', [ 'name' => 'name_of_option', 'label' => __('Label of option', 'textdomain') ]); ``` #### Code editor [](#code-editor) ``` $meta_box->add_option('code-editor', [ 'name' => 'name_of_option', 'label' => __('Label of option', 'textdomain') ]); ``` #### WP Editor [](#wp-editor) ``` $meta_box->add_option('wp-editor', [ 'name' => 'name_of_option', 'label' => __('Label of option', 'textdomain') ]); ``` You can provide a `config` array to customize the editor. For more information on this config check out the [wp.editor documentation](https://codex.wordpress.org/Javascript_Reference/wp.editor). #### Repeater [](#repeater) Example of a gallery using the repeater option: ``` $meta_box->add_option('repeater', [ 'name' => 'gallery', 'label' => __('Gallery', 'textdomain'), ])->add_repeater_option('image', [ 'name' => 'image', 'label' => __('Image', 'textdomain'), ]); ``` Contributors ------------ [](#contributors) - [Jeffrey van Rossum](https://github.com/jeffreyvr) License ------- [](#license) MIT. Please see the [License File](/LICENSE) for more information. ### Health Score 36 — LowBetter than 82% of packages Maintenance70 Regular maintenance activity Popularity8 Limited adoption so far Community7 Small or concentrated contributor base Maturity51 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~105 days Total 7 Last Release 177d ago PHP version history (2 changes)1.0.0PHP ^7.4|^8.0 1.7.0PHP ^8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/e94123630d250ccc2fcf91fcf25ada2b6fee4879844e1b60ab1ec5e46c15a315?d=identicon)[wordpressvn](/maintainers/wordpressvn) --- Top Contributors [![wordpressvn](https://avatars.githubusercontent.com/u/45707210?v=4)](https://github.com/wordpressvn "wordpressvn (12 commits)") ### Embed Badge ![Health badge](/badges/wordpressvn-wp-meta-box/health.svg) ``` [![Health](https://phpackages.com/badges/wordpressvn-wp-meta-box/health.svg)](https://phpackages.com/packages/wordpressvn-wp-meta-box) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)