This project is no longer actively maintained, please refer to CMB2 for meta-boxes.

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

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. support@humanmade.co.uk 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.

Minimum Requirements:

• PHP >= 5.4
• WP >= 4.1

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

Enhancements

• Added group field filter
• Cleaned up file upload styles
• Added Hindi translation (props @ajitbohra)
• Move all field classes to their own files
• Add min/max attributes to number input (props @shadvb)
• Use site language with Google Maps field (props @barryceelen)

Bug Fixes

• Filter all arguments, not just select ones
• Only attempt to call getimagesize() if the icon is local (props @joehoyle)
• Add Dutch and German translations (props @barryceelen)
• Align the file button vertically (props @ocean90)
• Fix for multiple wysiwyg fields not displaying in groups (props @tareiking)
• Fix incorrect gmap grouped field structure (props @dan-westall)
• Fix enqueuing of cmb-scripts (props @barryceelen)

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.