CMB2 is a developer's toolkit for building metaboxes, custom fields, and forms for WordPress that will blow your mind.
PHP CSS JavaScript Shell
Permalink
Failed to load latest commit information.
.github Create PULL_REQUEST_TEMPLATE.md Aug 17, 2016
css modifying the CSS to account for narrow screens (to match with core) Jan 16, 2017
images update files to be PHP7 compatible Aug 22, 2016
includes Update inline comment to use consistent language Jan 16, 2017
js Some cleanup and documentation updates Jan 16, 2017
languages updating `add_context_metabox` function name to be plural like the ot… Jan 16, 2017
tests Fix issue where empty file field in group would still cause non-empty… Jan 11, 2017
.gitattributes s/readme.md/README.md for consistency with other OS projects Jun 1, 2016
.gitignore Ignore apigen and add grun task for it Mar 3, 2016
.scrutinizer.yml update scrutinizer code-style settings Feb 15, 2015
.travis.yml Merge the CMB2 REST API! Squashed commit of the following: Oct 23, 2016
CHANGELOG.md Try to use consistent language Jan 16, 2017
CONTRIBUTING.md update changelog and add translation section to contributing.md Jun 2, 2015
Dockunit.json Add more dockunit test environments Feb 19, 2015
Gruntfile.js Create cmb2-ajax-embed tests group to exclude them Oct 21, 2016
README.md Update readme to more explicitly state objects supported. h/t @rzen Dec 21, 2016
bootstrap.php Merge the CMB2 REST API! Squashed commit of the following: Oct 23, 2016
composer.json Revert "Add autoload to composer.json" Mar 10, 2015
coverage.clover Add scrunitizer config Dec 18, 2014
example-functions.php Move REST API examples to separate metabox registration function, and… Oct 27, 2016
index.php update files to be PHP7 compatible Aug 22, 2016
init.php Re-trunk the init class Nov 8, 2016
package.json #399 Add grunt task for generating RTL stylesheets. Oct 30, 2015
phpunit.xml.dist Rename phpunit file so users can override. See: pods-framework/pods#2457 Mar 13, 2015
readme.txt Update readme to more explicitly state objects supported. h/t @rzen Dec 21, 2016

README.md

CMB2

Gitter Travis Scrutinizer Code Quality Scrutinizer Coverage Dockunit Status Project Stats

CMB2

Contributors: webdevstudios, jtsternberg, gregrickaby, tw2113, patrickgarman, JPry Donate link: http://webdevstudios.com
Tags: metaboxes, forms, fields, options, settings
Requires at least: 3.8.0
Tested up to: 4.7
Stable tag: 2.2.3.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Wordpress plugin Wordpress Wordpress rating

Complete contributors list found here: github.com/WebDevStudios/CMB2/graphs/contributors

Description

CMB2 is a developer's toolkit for building metaboxes, custom fields, and forms for WordPress that will blow your mind. Easily manage meta for posts, terms, users, comments, or create custom option pages.

Download plugin on wordpress.org

CMB2 is a complete rewrite of Custom Metaboxes and Fields for WordPress. To get started, please follow the examples in the included example-functions.php file and have a look at the basic usage instructions.

You can see a list of available field types here.

If you are coming from the original "Custom Metaboxes and Fields for WordPress" plugin, please read this post for the CMB2 background story.

Contribution

Development occurs on Github, and all contributions welcome. Please read the CONTRIBUTING doc for more details.

A complete list of all our awesome contributors found here: github.com/WebDevStudios/CMB2/graphs/contributors

Features:

Translation

3rd Party Resources

Custom Field Types

Other Helpful Resources

Links

Installation

If installing the plugin from wordpress.org:

  1. Upload the entire /CMB2 directory to the /wp-content/plugins/ directory.
  2. Activate CMB2 through the 'Plugins' menu in WordPress.
  3. Copy (and rename if desired) example-functions.php into to your theme or plugin's directory.
  4. Edit to only include the fields you need and rename the functions.
  5. Profit.

If including the library in your plugin or theme:

  1. Place the CMB2 directory inside of your theme or plugin.
  2. Copy (and rename if desired) example-functions.php into a folder above the CMB2 directory OR copy the entirety of its contents to your theme's functions.php file.
  3. Edit to only include the fields you need and rename the functions (CMB2 directory should be left unedited in order to easily update the library).
  4. Profit.

View CHANGELOG

Known Issues

  • Metabox containing WYSIWYG editor cannot be moved or used in a repeatable way at this time (this is a TinyMCE issue).
  • Not all fields work well in a repeatable group.