HM Custom Meta Boxes for WordPress A framework for easily adding custom fields to the WordPress post edit page
A Human Made project. Maintained by @mikeselander.

Get the latest stable release

It includes several field types including WYSIWYG, media upload and dates (see wiki for a full list). It also supports repeatable and grouped fields.

This project is aimed at developers and is easily extended and customized. It takes a highly modular, Object Orientated approach, with each field as an extension of the CMB_Field abstract class.

The framework also features a basic layout engine for fields, allowing you to align fields to a simple 12 column grid.

Usage

• Download the latest release here or clone from master.
• Include the custom-meta-boxes.php framework file.
  • In your theme: include the CMB directory to your theme directory, and add require_once( 'Custom-Meta-Boxes/custom-meta-boxes.php' ); to functions.php
  • As an MU Plugin: Refer to the WordPress Codex here for more information
• Filter cmb_meta_boxes to add your own meta boxes. The wiki has more details and example code

Help

• For more information, including example code for usage of each field and instructions on how to create your own fields, refer to the Wiki.
• Not covered in the Wiki? Need more help? Get in touch. [email protected] or ping @mikeselander
• Found a bug? Feature requests? Create an issue - Thanks!

About

This plugin is maintained by Human Made Limited

It began as a fork of Custom Meta Boxes, but is no longer compatible.

Known Issues

• Some fields do not work well as repeatable fields.
• Some fields do not work well in repeatable groups.

Contribution Guidelines

See CONTRIBUTING.md

Changelog

1.1

• Added capability option to individual fields and groups

1.0.3

• Fix repeatable fields bugs (props @barryceelen )
• Fix gmaps field bug where key doesn't pass in correctly (props: @shadyvb )
• PHPUnit tests for repeatable fields
• Fix all minor WordPress VIP PHPCS errors/warnings
• Write and complete inline documentation/doc blocks

1.0.2

• Add google maps field
• Add hide_on field argument
• Add Composer support
• Enhancement - enable for attachments
• Fix bug with unattached images on custom post types
• Fix error in WYSIWYG
• Fix fields not getting correctly initialized if meta box is collapsed on page load
• Fix bug with page-template restricted meta boxes showing if the post hasn't been saved at all.
• Hook CMB in later - most post types & taxonomies should be registered then.
• Fix Issue where different default values are used on save and init.

1.0.1

• Fix bug - AJAX post select field displaying incorrect content.

1.0

• Initial stable version of the fork.