All notable changes to this project will be documented in this file.
- Officially moved to PHP 7.4+ support!
- Package updates.
- Update WordPress Tested up to tag 6.1. Props @RubenMartins (#1477).
- Add filters for setting
object_id
andmb_object_type
and indo_scripts
- Allows overriding by plugins/libs. (Added to support the new CMB2 WooCommerce HPOS Orders extension) - Added a
cmb2_init_hooks
hook when hookup is called. - Addressed some security concerns with the unserialization process for the stored serialized
DateTime
field values (text_datetime_timestamp_timezone
field type only). (#1510) - [Development] Some build script improvements.
- [Development] Added some PHPCS/WPCS config.
- [Development] Added a phpcompatibility action. Props @jazzsequence (#1499, #1500).
- Fix some line-height issues with dashicon buttons. Fixes [#1443](
- Fix issue where image can be attached to wrong group after removing previous group. (#1473)
- Fixes issue where Select/Deselect all does not trigger change JS DOM events. Fixes #1504.
- Fix issue with date picker formatting. Fixes #1448.
- Sanitize URLs, defaulting to
https
. Props @paulschreiber (#1413). - Establish Cypress E2E Testing. Props @markjaquith (#1437).
- Updated the JS
shiftRows
functionality to be simpler, and fix issues with JS initialization. Fixes #1426 and #1431. - Updated various NPM dependencies for security issues.
- Update to prevent deprecation notice:
Required parameter $i follows optional parameter $args...
. Props @carloswph (#1417). - Make each date field more resilient to various date/timestamp values passed in (from REST API).
- Added
cmb2_tab_group_tabs
filter for adding arbitrary menu page urls to the cmb2 tabs, and move tab markup output to separate method,CMB2_Options_Hookup::options_page_tab_nav_output()
. Fixes #1407. - Limit use of italic, including removing from field descriptions. Fixes #1404.
- Add to list of valid image types from
get_allowed_mime_types()
, which makes SVGs more reliable when using the Safe SVG plugin. Fixes #1223.
- Fixes PHP warnings on repeatable ColorPicker with an array as default. Props @rubengc (#1340).
- Address PHP 7.4, compatibility issues with
func_get_args()
. Fixes #1389. - Better generated array key for cached fields, fixes issue where wrong field is found. Fixes #14053.
- Fix issue with options-pages being changed to register on a hook priority of
5
instead of the default10
, causing some back-compatibility issues. Fixes #1410.
- Added CODE_OF_CONDUCT.md file to meet GitHub Community standards. Props @RubenMartins (#1331).
- Add ability to define the page-registration admin menu hook priority for options pages. Fixes #1380.
- Ensure
enqueue wp-color-picker
is enqueued for color fields. Props @rubengc (#1339). - Fix empty name/id attributes on
'file_list'
buttons. Props @pgroot91 (#1347). - Fix
wysiwyg
field type not working in a group, by ensuring scripts properly enqueued. Props @yoren (#1361). - Fix
$object_id
doc block types in helper-functions.php. Fixes #1365. - Fix Metabox toggles visually broken with WP 5.5.x. Fixes #1382.
- Fix
PHP Deprecated: Required parameter $field_id follows optional parameter $type
, due to changes in PHP 8.0. Fixes #1396. - Fix PHP notice caused by
deprecated_param
method in PHP 7.4. Props @jonathanstegall (#1400).
- Added support for sortable columns by default, with ability to disable with
'column' => array( 'disable_sortable' => true )
. Props @RubenMartins (#1281). - New field type,
'taxonomy_select_hierarchical'
. Fixes #751 - New
text
,textarea
andwysiwyg
character counter options. For now, this feature is not available towysiwyg
field types within repeatable groups. Props @gyrus (#1276).- The new parameters:
'char_counter'
- Defaults to false, no counter. Set to true, orwords
to count words instead of characters.'char_max'
- integer. When defined, counter shows remaining characters/words.'char_max_enforce'
- boolean, default: false. Currently only applied (as maxlength attribute) totext
andtextarea
fields which use'characters'
for counter.
- You can also override the default text strings associated with these parameters:
'words_left_text'
- Default: "Words left"'words_text'
- Default: "Words"'characters_left_text'
- Default: "Characters left"'characters_text'
- Default: "Characters"'characters_truncated_text'
- Default: "Your text may be truncated."
- The new parameters:
- Update styling to be more compatible with WordPress 5.3. Props @galengidman (#1314)
- Add a new box parameter,
register_rest_field_cb
, which when used allows overriding the way CMB2 handles theregister_rest_field
callbacks, and defining your own REST prefix for your fields. See this PR comment for more context. - Cleanup by renaming
CMB2_hookup
toCMB2_Hookup
. Classes are case-insensitive, so this is a backwards-compatible change. Props @szepeviktor (#1330, #1328). - Validate composer.json for Travis CI. Props @szepeviktor (#1326).
- Added LICENSE file to meet GitHub Community standards. Props @RubenMartins (#1316).
- Add new
"cmb2_display_class_{$fieldtype}"
filter and'display_class'
field parameter to allow specifying the class to use to display the field (in admin columns, etc). - Update
CMB2_Types::_id()
to allow not appending the iterator attribute if a repeatable field. - Added
CMB2_Utils::concat_attrs()
test for nested arrays as data attributes. - Various updates per VIP feedback. Props @kevinlangleyjr, @mikeselander (#1255, #1257, #1259, #1261 #1262, and various direct commits. See #1260).
- Fix some issues with Travis. Props @anhskohbo (#1220).
- Javascript: Correctly pass the newly created row to the
cmb2_add_row
triggered event. - Various code-formatting and code documentation improvements. Props @tw2113.
- Don't exclude composer.json from the distribution. Props @johnbillion (#1225).
- Ignore some more directories in the distribution package. Props @johnbillion (#1226).
- Use
CMB2_Field::get_rest_value()
to get values for fields in the post REST API endpoints (#1284). - Fix issue where oEmbed fields' live-preview would not work if the field was added within a group, along with some other similarly related issues. Fixes #1157.
- Fix issue when using REST API for
file
andtext_datetime_timestamp_timezone
field types, the supporting field data was not provided (e.g. the file id forfile
field, and theutc
value for thetext_datetime_timestamp_timezone
field). Fixes https://wordpress.org/support/topic/cmb2-rest-api-image-file-field-as-an-object/. - Escaping Improvements to File Base and File Fields. Props @tomjn (#1296, #1297).
- Fix issue where repeatable CodeMirror textareas could not be clicked/draggged to highlight text. Props @JPry (#1300).
taxonomy_select_hierarchical
now saves to the correct location, the term relationships table. Props @latheva (#1307).- Fix issue (#1158) where default REST API endpoints (e.g.
/wp/v2/{post_type}
) would show all boxes for all custom post types even though not registered to the post-type. Props @Mte90 (#1238). - Update and cull npm dependencis. Fixes #1308.
- Fix some jshint issues.
- Updated the WordPress embeds URL references.
- Updates to account for WordPress 5.2 oEmbed changes.
- Fix to ensure date picker fields can have a default value. Fixes #1245.
- Added
function_exists( 'add_action' )
check to bootstrap file to ensure compatibility with composer usage. Props @salcode (#1271, #1270) - Corrected link to facetwp-cmb2 in README.md. Props @marcelreschke (#1248).
- Use
get_user_locale()
in admin area instead ofget_locale()
. Fixes #1267. CMB2::is_box_type()
now also checks for taxonomies if box is registered to "term" object type. This should fix some issues where CMB2 term meta was not showing up in REST API requests to the term endpoints.
- Updated PHPUnit version in composer.json. Props @slaFFik (#1204).
- Package.json: fix the need of global (old) grunt. Props @slaFFik (#1206).
- Add optional confirmation dialog to group field's Remove button. Example documented in the example functions file. Props @slaFFik (#1208).
- Add 'id' attribute on group field
.postbox
divs to ensure compatibility with scripts which expect ids there. Props @amans2k (#1108). - Make
CMB2_Option
properties accessible. (#1052) - New Before/After row hooks:
'cmb2_before_field_row'
,"cmb2_before_{$field_type}_field_row"
,"cmb2_after_{$field_type}_field_row"
,'cmb2_after_field_row'
. Props @rubengc (#953). - Introduce three new filters to filter field arguments:
'cmb2_field_defaults'
,'cmb2_field_arguments_raw'
,'cmb2_field_arguments'
. Props @jrfnl (#588).
- Remove superfluous method definitions. Props @tnorthcutt (#1200).
- Fix
rest_value_cb
registering of filter. Props @lipemat (#1212). - Do not trigger tinyMCE editor save for the activeEditor. Prevents cursor jump in Gutenberg. Fixes #1202
- Fix issue where making a field repeatable would generate a Javascript error because of missing sortable library. Props @slaFFik (#1216).
- Ensure value passed to
CMB2_Utils::filter_empty
fromCMB2::save_group_field
is always an array. (#1026) - Fix potential issue with test path location. Props @quasel (#463).
- Fix issue when the
core/editor
object does not exist (is undefined), causing incompatibility issues with Yoast and likely others. Fixes #1197
- Repeatable fields are now drag-sortable. Props @lipemat (#1142).
- Update the
sv_SE
translation. Props @edvind (#370). - QA/PHPCS cleanup. Props @tw2113 (#1179).
- Add optional
'mb_callback_args'
CMB2 box property which allows defining the$callback_args
passed intoadd_meta_box()
. This allows using defining the new Gutenberg/block-editor compatibility parameters. Fixes #1191 - Support any type of markup when customizing repeating group row. Props @lipemat (#1187).
- Add
cmb_init_pickers
andcmb_init_code_editors
Javascript events for allowing just-in-time configuration for pickers/editors. - Fix field descriptions color contrast ratio for better accessibility. h/t @rianrietveld. Fixes #1193.
- Add
CMB2_Field::get_rest_value()
method for sending value through several filters ('cmb2_get_rest_value'
,"cmb2_get_rest_value_{$field_type}"
,"cmb2_get_rest_value_for_{$field_id}"
) before sending to REST request.
- Fix the options page errors when using CMB2 in WordPress prior to 4.7. Props @manzoorwanijk (#1166).
- Fix occasonal fatal errors that can occur by using callback functions directly vs
call_user_func
. Props @manzoorwanijk (#1177). - Fix issue where
wysiwyg
fields' visual tab wouldn't save content on Gutenberg/block-editor posts. Props @staurand (#1190 fixes #1156). - Fix issue when
remove_default
wouldn't actually remove the default taxonomy metabox when box registration used an alternate box context. Props @lipemat (#1147).
- Do not enqueue/register WordPress code editor JS if there are no
textarea_code
fields registered on the page. Fixes #1110. - Do not set repeated
wysiwyg
field values to string "false" when boolean false. Fixes #1138 (again!).
- Do not set repeated field values to string "false" when boolean false. Fixes #1138.
-
Enable linking options pages via tabbed-navigation. Will output tabbed navigation for options-pages which share the same
'tab_group'
CMB2 box property. This snippet demonstrates how to create a top-level menu options page with multiple submenu pages, each with the tabbed navigation. To specify a different tab title than the options-page title, set the'tab_title'
CMB2 box property. See #301, #627. -
Complete the
zh-CN
translation. Props @uicestone (#1089). -
Update the
nl_NL
translation. Props @tammohaannl (#1101). -
Better display for white over transparent images (e.g. logos) by using a checkered background for images. (#1103)
-
Ability to disable the options autoload parameter via filter (
"cmb2_should_autoload_{$options_key}"
) or via a box parameter for'options-page'
box registrations ('autoload' => false,
). (#1093) -
'textarea_code'
field type now uses CodeMirror that is used by WordPress (#1096). A field can opt-out to return to the previous behavior by specifying an'options'
parameter:'options' => array( 'disable_codemirror' => true )
As with the other javascript-enabled fields, the code-editor defaults can be overridden via adata-codeeditor
attribute. E.g:'attributes' => array( 'data-codeeditor' => json_encode( array( 'codemirror' => array( 'mode' => 'css', ), ) ), ),
-
Improve/add comment info banners at top of CMB2 CSS files.
-
Added
resetBoxes
/resetBox
Javascript methods for resetting CMB2 box forms. -
Improved styles for fields in the new-term form.
-
New
CMB2_Boxes
methods for filtering instances ofCMB2
,CMB2_Boxes::get_by( $property, $optional_compare )
andCMB2_Boxes::filter_by( $property, $to_ignore = null )
.
- Fix the
'taxonomy_*'
fields when used for term fields/meta. Save the value to term-meta. - Clear the CMB2 fields when a term is added. Fixes #794.
- Repeated fields now use registered field defaults for values. Fixes #1137.
- Fixed the formatting for deprecated messages in the log.
- Prevent opening of media modal when clicking the file "Download" link. Fixes #1130.
- Updated Italian translation. Props @Mte90 (#1067).
- Starting with this release, we are fully switching to the more communicative and standard Semantic Versioning. (#1061).
- Update for compatibility with PHP 7.2 (e.g. fixes
Fatal error: Declaration of CMB2_Type_Colorpicker::render() must be compatible with CMB2_Type_Text::render($args = Array)...
). (#1070, #1074, #1075).
- Fix another issue (introduced in 2.2.6) with repeatable fields not being able to save additional fields. Props @anhskohbo (#1059, #1058).
- Only dequeue
jw-cmb2-rgba-picker-js
script (and enqueue ourwp-color-picker-alpha
) if it is actually found.
- Merge in the CMB2 RGBa Colorpicker field type functionality to the CMB2 colopicker field type. Adds the ability to add an alpha (transparency) slider to the colorpicker by adding the
'alpha'
option to the field options array. Thank you to JayWood for his work on his custom field type.
- Fix issue (introduced in 2.2.6) with complex fields set as repeatable not being able to save additional fields. Fixes #1054.
- Move the fetching of group label and description to after calling
'before_group'
parameter. - Allow using the
'render_row_cb'
param for group fields. Fixes #1041. - Allow resetting cached CMB2 field objects (new 3rd parameter to
CMB2::get_field()
). - Allow resetting cached callback results (
CMB2_Base::unset_param_callback_cache()
). - Persian translation provided by @reza-irdev (#1046).
- Added a
'message_cb'
box property, which allows defining a custom callback for adding options-save messages onoptions-page
boxes. An example has been added to example-functions.php. - Updated many the oembed-related unit tests to more reliably test the relevant parts, and not so much the actual success of the WordPress functions.
- Updated travis config to Install PHP5.2/5.3 on trusty for unit tests. Stolen from gutenberg/pull/2049. Intended to compensate for Travis removing support for PHP 5.2/5.3.
- Ensure
'file'
field type ID is removed from the database if the'file'
field type's value is empty (Support thread). - Fix JS errors when
user_can_richedit()
is false ("Disable the visual editor when writing" user option is checked, or various unsupported browsers). See #1031. - Fix issue where some European date formats (e.g.
F j, Y
) would not properly translate into jQuery UI date formats. Support thread - Fix repeating fields within repeating groups having the values/indexes incorrectly associated. Props @daggerhart (#1047). Fixes #1035, #348.
- Fixed multiple update messages on settings pages when CMB2 option pages were registered (#1049).
- Fix issue where using multiple oembed fields could cause incorrectly cached arguments to be used.
- Fix bug where
'select_all_button' => false
was not working for'taxonomy_multicheck'
field type (#1005).
- Update to instead initate CMB2 hookup via
"cmb2_init_hookup_{$cmb_id}"
hook. Allows plugins to unhook/rehook/etc.
- Spelling/Grammar fixes. Props @garrett-eclipse (#1012).
- Fix "PHP Strict Standards: Static function should not be abstract" notice.
- Add
CMB2_Utils::normalize_if_numeric()
to address problems when using floats as select/radio values. Fixes #869. See #1013. - Fix issues with apostrophes in money values. (e.g. in Swiss German the thousand separator is an apostrophe). Props @ocean90 (#1014, #1015).
- Provide public access to the
CMB2_Options_Hookup::$option_key
property. - Change the updated-settings notice query variable so that WordPress does not auto-add settings notices on top of ours.
- For settings pages, only output settings errors if WordPress does not do it by default (for sub-pages of
options-general.php
), and if the errors are not disabled via the'disable_settings_errors'
box property.
- Fix issue in 2.2.5 with non-sortable repeatable groups not having new groups values be emptied on creation/clone. Support thread
- Fix issue in 2.2.5 with options pages not saving when
'parent_slug'
box property was used. Fixes #1008.
- Fix issue in 2.2.5 which caused empty repeatable groups having the buttons set to have a disabled "Remove Group" button. Support thread
- Options pages are now first-class CMB2 citizens, and registering a box to show on an options page will automatically register the menu page and output the form on the page. See example. (The snippets in the snippet library will be updated to reflect this change)
- Improved Options Page styling. Props @anhskohbo (#1006).
- Improved cohesive styles for repeatable fields. Props @anhskohbo (#819).
- New field types,
'taxonomy_radio_hierarchical'
, and'taxonomy_multicheck_hierarchical'
, for displaying taxonomy options in a hierarchial layout. Props to eriktelepovsky for the working code. (#640) - Removing last repeat item row (and repeat group row) is now somewhat allowed in that the "remove" button simply resets the last item to empty. Fixes #312.
- Enable the additional media library modal filters. Fixes #873.
- Sanitize the attributes added via the
cmb2_group_wrap_attributes
filter. - New field parameter,
'query_args'
, which can be used by the'taxonomy_*'
fields. Provides ability to override the arguments passed toget_terms()
. - The
cmb2_can_save
filter now passes the CMB2 object as the 2nd parameter. Props @Arno33 (#994). - Update the file field type to work properly within a custom field context by allowing the passing of override arguments to
CMB2_Types::file()
method. - Many WordPress Code Standards improvements/updates. Props @bradp
- Include absolute paths when including the core php files. Props @anhskohbo (#998).
- Change language throught to reflect CMB2's move to its own organization.
- Break
CMB2_Field:options()
method apart to allow re-setting options from field params. Related: reaktivstudios/cmb2-flexible-content/pull/8. - New
CMB2:box_types()
method for getting the array of registered'object_types'
for a box. Ensures the return is an array. - Improved inline hooks documentation.
- Updated several CMB2 methods to return the CMB2 object (for method chaining). Methods include:
CMB2::show_form()
CMB2::render_form_open()
CMB2::render_form_close()
CMB2::render_group_row()
CMB2::render_hidden_fields()
CMB2::save_fields()
CMB2::process_fields()
CMB2::process_field()
CMB2::pre_process()
CMB2::after_save()
CMB2::add_fields()
- Update for
file
/file_list
fields to properly show a preview for SVG images. Fixes #874. - Fix and standardize inconsistent button classes. Update all buttons to use the
.button-secondary
class instead of the.button
class. This alleviates some front-end issues for themes which target the.button
class. This is a backwards-compatibility break. If your theme or plugin targets the.button
class within CMB2, you will need to update to use.button-secondary
. - Correct the before/after form hooks order. For more details see (#954).
- Fix regression with custom fields not properly repeating. Props @desrosj (#969). Fixes #901.
- Fix "Illegal string offset" notices when
CMB2_Option
methods are called when the option value is empty, as well as additional unit tests for theCMB2_Option
class. Props @anhskohbo (#993). - Fix bug where select fields or checkbox fields occasionally would retain previous group's value when adding new groups. Fixes #853.
- Fix JS to prevent meta keys with
|
or/
from breaking file fields. Props @lipemat (#1003). - Fix jQuery Migrate's
jQuery.fn.attr('value', val) no longer sets properties
warning. - Fix issue with CMB2 being too aggressive with stripping slashes from values. Fixes #981.
-
Modify
'taxonomy_*'
fields to return stored terms for non-post objects. -
Modify
CMB2::get_sanitized_values()
to return the sanitized'taxonomy_*'
field values. Also added"cmb2_return_taxonomy_values_{$cmb_id}"
filter to modify if'taxonomy_*'
field values are returned. Fixes #538. -
Allow outputting CMB2 boxes/fields in additional locations in the post-editor.
The new locations are:
form_top
,before_permalink
,after_title
, andafter_editor
These would be defined by setting the
context
property for your box:$cmb_demo = new_cmb2_box( array( ... 'context' => 'before_permalink', ) );
If it is preferred that the fields are output without the metabox, then omit the
'title'
property from the metabox registration array, and instead add'remove_box_wrap' => true,
. -
New field parameter,
'render_class'
, allowing you to override the default'CMB2_Type_Base'
class that is used when rendering the field. This provides interesting object-oriented ways to override default CMB2 behavior by subclassing the default class and overriding methods. The render class can also be overridden with the"cmb2_render_class_{$fieldtype}"
filter, which is passed the default render class name as well as theCMB2_Types
object, but this should be used sparingly, and within the context of your project's boxes/fields or you could break other plugins'/themes' CMB2 fields. -
Improvements to the
file
/file_list
fields javascript APIs, including using undersore templates. -
Small improvements to the styling for the
file_list
field type. -
New action hook,
cmb2_footer_enqueue
, which occurs after CMB2 enqueues its assets. -
New
CMB2_Utils
methods,get_available_image_sizes()
andget_named_size()
. Props @Cai333.
- Fix datepicker month/year dropdown text color. On windows, the option text was showing as white (invisible). Fixes #770.
- Repeatable WYSIWYG no longer breaks if
'quicktags'
param is set to false. Props @timburden (#797, #796). - Do not process title fields during group field save process.
- Fix issue where term-meta values were not being displayed for some users. Props @sbussetti (#763, #700).
- Fix issue where term meta would not be applied when using the new term form if multiple object types were specified. Props @ADC07 (#842, #841).
- Fix WordPress spinner styling when boxes/fields used on the frontend.
- Fix issue where clicking to remove a
file_list
item could occasionally remove the field row. (#828). - Fix issue where empty file field in group would still cause non-empty values to store to database. (#721).
- Make
file
/file_list
field preview images work with named sizes. Props @Cai333 (#848, #844). - Fix incorrect text-domain. (#798)
- Do not silence notices/errors in
CMB2_Utils::get_file_ext()
. - If
title
field type has no name value, then only output a span element (instead of a header element).
- Better styling for disabled group "X" buttons, and add title attr. Fixes #773.
- Use quotes for
label[for=""]
selector. FixedSyntax error, unrecognized expression
. Props @anhskohbo (#789). - Fix
ReferenceError: tinyMCE is not defined
javascript errors (happening when trying to remove a repeatable field/group). Fixes #790, and #730. - Fix REST API
'show_in_rest'
examples inexample-functions.php
. Any REST API boxes/fields must use the'cmb2_init'
hook (as opposed to the'cmb2_admin_init'
hook).
- CMB2 REST API! CMB2 now has WP REST API endpoints for displaying your boxes and fields data, as well as registers rest fields in the existing post, user, term, and comment endpoints (in the cmb2 namespace). Enabling the REST API for your boxes/fields is opt-in, meaning it will not be automatically enabled. For more info, check out the wiki.
- Small string improvement, move a period inside the translatable string. Props @pedro-mendonca (#672).
- Introduce the
'save_field'
boolean field parameter for disabling the saving of a field. Useful if you want to display the value of another field, or use a disabled/read-only field. Props @jamesgol (#674, #346, #500). - Update docblocks for
CMB2_Field::save_field_from_data()
andCMB2_Field::save_field()
. Props @jamesgol (#675). - More javascript events tied to the media modal actions (related to the
'file'
and 'file_list'
fields).'cmb_media_modal_init'
,'cmb_media_modal_open'
, and'cmb_media_modal_select'
. - All CMB2 JS events now also get the CMB2 JS object passed in the list of arguments.
- CMB2 JS object is now instantiated without stomping existing object, to enable extending.
- New field parameter for taxonomy fields,
'remove_default'
which allows disabling the default taxonomy metabox. Props @c3mdigital (#593). - Change
'row_classes'
to just'classes'
, to mirror the metabox'classes'
property. Also now accepts a'classes_cb'
parameter for specifying a callback which returns a string or array. The callback will receive$field_args
as the first argument, and the CMB2_Field$field
object as the second argument. ('row_classes'
will continue to work, but is deprecated) - Make wysiwyg editors work in the repeatable groups context. A standard repeatable (non-group) wysiwyg field is not supported (but will possibly be included in a future update). Props @johnsonpaul1014 (#26, #99, #260, #264, #356, #431, #462, #657, #693).
- Add an id to the heading tag in the title field. This allows linking to a particular title using the id.
- Internationalization improvements. Props ramiy (#696).
- Ensure that saving does not happen during a switch-to-blog session, as data would be saved to the wrong object. See more.
- Add
'cmb2_group_wrap_attributes'
filter to modifying the group wrap div's attributes. Filter gets passed an array of attributes and expects the return to be an array. Props jrfnl (#582). - Update the unit-tests README and inline docs. Props bobbingwide (#714, #715).
- Minor update to make naming-conventions consistent. Props ramiy (#718).
- Update files to be compatible with PHP7 CodeSniffer standards. Props ryanshoover (#719, #720).
- Make exception message translatable. Props ramiy (#724).
- Portuguese translation provided by @alvarogois and @pedro-mendonca - #709, #727.
- Stop using
$wp_version
global. Props ramiy (#731). - Closures (anonymous functions) are now supported for any box/field
'*_cb'
parameters. E.g.
...
'show_on_cb' => function( $cmb ) { return has_tag( 'cats', $cmb->object_id ); },
...
- If custom field types use a method and the Type object has not been instantiated, Try to guess the Type object and instantiate.
- Normalize WordPress root path (
ABSPATH
) and theme rooth path (get_theme_root()
). Props @rianbotha (#677, #676). - Fix issue with
'cmb2_remove_row'
Javascript callback for non-group row removal. Fixes #729). - Fix issue with missing assignment of variable (undefined variable). Props @anhskohbo (#779).
- Fix issue that kept CMB2 stylesheet from being enqueued when using the options-page snippets.
- Fix issue which caused the CMB2 column display styles to be enqueued in the wrong pages. Now only enqueues on admin pages with columns.
- You can now set admin post-listing columns with an extra field parameter,
'column' => true,
. If you want to dictate what position the column is, use'column' => array( 'position' => 2 ),
. If you want to dictate the column title (instead of using the field'name'
value), use'column' => array( 'name' => 'My Column' ),
. If you need to specify the column display callback, set the'display_cb'
parameter to a callback function. Columns work for post (all post-types), comment, user, and term object types. - Updated Datepicker styles using JJJ's "jQuery UI Datepicker CSS for WordPress", so props Props @stuttter, @johnjamesjacoby. Also cleaned up the timepicker styles (specifically the buttons) to more closely align with the datepicker and WordPress styles.
- CMB2 is now a lot more intelligent about where it is located in your installation. This update should solve almost all of the reasons to use the
'cmb2_meta_box_url'
filter (thought it will continue to work as expected). (#27, #118, #432, related wiki item) - Implement CMB2_Ajax as a singleton. Props jrfnl (#602).
- Add
classes
andclasses_cb
CMB2 box params which allows you to add additional classes to the cmb-wrap. Theclasses
parameter can take a string or array, and theclasses_cb
takes a callback which returns a string or array. The callback will receive$cmb
as an argument. These classes are also passed through a new filter,'cmb2_wrap_classes'
, which receives the array of classes as the first argument, and the CMB2 object as the second. Reported/requested in #364. - Make the
'title'
field type accept extra arguments. Props @vladolaru, @pixelgrade (#656). - Updated
cmb2_get_oembed()
function to NOT return the "remove" link, as it's intended for outputting the oembed only. This is a backwards-compatibility concern. If you were depending on the "remove" link, usecmb2_ajax()->get_oembed( $args )
instead. - New function,
cmb2_do_oembed()
', which is hooked to'cmb2_do_oembed'
, so you can usedo_action( 'cmb2_do_oembed', $args )
in your themes withoutfunction_exists()
checks. - New method,
CMB2:set_prop( $property, $value )
, for setting a CMB2 metabox object property. - The
CMB2_Field
object instances will now have acmb_id
property and aget_cmb
method to enable access to the field'sCMB2
parent object's instance, in places like field callbacks and filters (e.g.$cmb = $field->get_cmb();
). - Add a
data-fieldtype
attribute to the field rows for simpler identification in Javascript. - Moved each type in
CMB2_Types
to it's own class so that each field type can handle it's own field display, and added the infrastructure to maintainn back-compatibility. - New
CMB2_Utils
methods,notempty()
andfilter_empty()
, both of which considernull
,''
andfalse
as empty, but allow0
(for saving0
as a field value). - New
CMB2_Utils
public methods,get_url_from_dir()
,get_file_ext()
,get_file_name_from_path()
, andwp_at_least()
. - Add a
cmb_pre_init
Javascript event to allow overriding CMB2 defaults via JS.
- Fix issue with 'default' callback not being applied in all instances. Introduced new
CMB2_Field::get_default()
method, and'default_cb'
field parameter. Using the'default'
field parameter with a callback will be deprecated in the next few releases. (#572). - Be sure to call
CMB2_Field::row_classes()
for group field rows. Also, update CSS to use the "cmb-type-group" classname instead of "cmb-repeat-group-wrap". - Introduce new
'text'
and'text_cb'
field parameters for overriding CMB2 text strings instead of using the'options'
array. (#630) - Fix bug where the value of '0' could not be saved in group fields.
- Fix bug where a serialized empty array value in the database for a repeatable field would output as "Array".
- Allow for optional/empty money field. Props @jrfnl (#577).
- The
CMB2::$updated
parameter (which contains field ids for all fields updated during a save) now also correctly adds group field ids to the array.
- Fixes back-compatibility issue which could allow multiple CMB2 instances to load (causing fatal errors). (#520)
- Term Meta! As of WordPress 4.4, WordPress will have the ability to use term metadata. CMB2 will work with term meta out of the box. To do so, see the example cmb registration in the
yourprefix_register_taxonomy_metabox
function in example-functions.php. - New hooks which hook in after save field action:
'cmb2_save_field'
and"cmb2_save_field_{$field_id}"
. Props wpsmith (#475). - The "cmb2_sanitize_{$field_type}" hook now runs for every field type (not just custom types) so you can override the sanitization for all field types via a filter.
CMB2::show_form()
is now composed of 3 smaller methods,CMB2::render_form_open()
,CMB2::render_field()
,CMB2::render_form_close()
(#506).- RTL Style generated. Props @devinsays (#510).
- Properly scope date/time-pickers styling by adding a class to only cmb2 picker instances. (#527)
- Allow per-field overrides for the date/time/color picker options (wiki documentation: Modify Field Date, Time, or Color Picker options)
- Fix some inline documentation issues. Props @jrfnl (#579).
- Include
.gitattributes
file for excluding development resources when using Composer. Props @benoitchantre (#575, #53).
- Fixed issue with
'taxonomy_select'
field type where a term which evaluated falsey would not be displayed properly. Props adamcapriola (#477). - Fix issue with colorpickers not changing when sorting groups.
'show_option_none'
field parameter now works on taxonomy fields when explicitly setting to false.- Fix so the date/time-picker javascript respects the
'date_format'
and'time_format'
field parameters. Props @yivi (#39, #282, #300, #318, #330, #446, #498). - Fix a sometimes-broken unit test. Props JPry (#539).
- Fix issue with oembed fields not working correctly on options pages. (#542).
- Fix issue with repeatable field elements stealing focus from "submit" button.
- Fixes back-compatibility issue when adding fields array to the metabox registration. (#472)
- Make all CMB2::save_fields arguments optional to fall-back to
$_POST
data. Props JPry. - New filter,
cmb2_non_repeatable_fields
for adding additional fields to the blacklist of repeatable field-types. Props JPry (#430). - New recommended hook for adding metaboxes,
cmb2_admin_init
. Most metabox registration only needs to happen if in wp-admin, so there is no reason to register them when loading the front-end (and increase the memory usage).cmb2_init
still exists to register metaboxes that will be used on the front-end or used on both the front and back-end. Instances ofcmb2_init
in example-functions.php have been switched tocmb2_admin_init
. - Add
'render_row_cb'
field parameter for overriding the field render method. - Add
'label_cb'
field parameter for overriding the field label render method. - Allow
CMB2_Types::checkbox()
method to be more flexible for extending by taking an args array and an$is_checked
second argument. - More thorough unit tests. Props pglewis, (#447,#448).
- Update
CMB2_Utils::image_id_from_url
to be more reliable. Props wpscholar, (#453). cmb2_get_option
now takes a default fallback value as a third parameter.
- Address issue where
'file'
and'file_list'
field results were getting mixed. Props augustuswm (#382, #250, #296). - Fix long-standing issues with radio and multicheck fields in repeatable groups losing their values when new rows are added. (#341, #304, #263, #246, #150)
- Fixes issue where currently logged-in user's profile data would display in the "Add New User" screen fields. (#427)
- Fixes issue where radio values/selections would not always properly transfer when shifting rows (up/down). Props jamiechong (#429, #152).
- Fixes issue where repeatable groups display "Array" as the field values if group is left completely empty. (#332,#390).
- Fixes issue with
'file_list'
fields not saving properly when in repeatable groups display. Props jamiechong (#433,#187). - Update
'taxonomy_radio_inline'
and'taxonomy_multicheck_inline'
fields sanitization method to use the same method as the non-inline versions. Props superfreund (#454).
- Updated/Added many translations. Props fxbenard, (#203) and Mte90 for the Italian translation.
- Updated
'file_list'
field type to have a more intuitive selection in the media library, and updated the 'Use file' text in the button. Props SteveHoneyNZ (#357, #358). 'closed'
group field option parameter introduced in order to set the groups as collapsed by default. Requested in #391.- Added
"cmb2_{$object_type}_process_fields_{$cmb_id}"
hook for hooking in and modifying the metabox or fields before the fields are processed/sanitized for saving. - Added Comment Metabox support. Props GregLancaster71 (#238, #244).
- New `"cmb2_{$field_id}_is_valid_img_ext"`` filter for determining if a field value has a valid image file-type extension.
'multicheck_inline'
,'taxonomy_radio_inline'
, and'taxonomy_multicheck_inline'
field types were not outputting anything since it's value was not being returned. Props ediamin, (#367, (#405).'hidden'
type fields were not honoring the'show_on_cb'
callback. Props JPry, (commits).- Fixed: There was no minified cmb2-front.min.css file.
- Fallback for fatal error with invalid timezone. Props ryanduff (#385).
- Fix issues with deleting a row from repeatable group. Props yuks (#387).
- Ensure value passed to
strtotime
inmake_valid_time_stamp
is cast to a string. Props vajrasar (#389). - Fixed issue with Windows IIS and bundling CMB2 in the theme. Props DevinWalker, (#400, #401)
- Fix color-picker field not enqueueing the colorpicker script. (#333)
- Ability to use non-repeatable group fields by setting the
'repeatable'
field param tofalse
when registering a group field type. Props marcusbattle, (#159). - Add and enqeueue a front-end specific CSS file which adds additional styles which are typically covered by wp-admin css. (#311)
- Better handling of the CMB2 javascript (and CSS) required dependencies array. Dependencies are now only added conditionally based on the field types that are actually visible. (#136)
- THIS IS A BREAKING CHANGE: The
group
field type's'show_on_cb'
parameter now receives theCMB2_Field
object instance as an argument instead of theCMB2
instance. If you're using the'show_on_cb'
parameter for agroup
field, please adjust accordingly. note: you can still retrieve theCMB2
instance via thecmb2_get_metabox
helper function. - New dynamic hook,
"cmb2_save_{$object_type}_fields_{$this->cmb_id}"
, to complement the existing"cmb2_save_{$object_type}_fields"
hook. - New CMB2 parameter,
enqueue_js
, to disable the enqueueing of the CMB2 Javascript. - German translation provided by Friedhelm Jost.
- Fix incorrect repeatable group title number. (#310)
- Fix obscure bug which prevented group field arguments from being passed to the sub-fields (like
show_names
andcontext
). - Fixed occasional issue when adding a group row, the previous row's content would be cloned. (#257)
- New metabox/form parameter,
show_on_cb
, allows you to conditionally display a cmb metabox/form via a callback. The$cmb
object gets passed as a parameter to the callback. This complements the'show_on_cb'
parameter that already exists for individual fields. Using this callback is similar to using the'cmb2_show_on'
filter, but only applies to that specific metabox and it is recommended to use this callback instead as it minimizes th risk that your filter will affect other metaboxes. - Taxonomy types no longer save a value. The value getting saved was causing confusion and is not meant to be used. To use the saved taxonomy data, you need to use the WordPress term api,
get_the_terms
,get_the_term_list
, etc. - Add
'multiple'
field parameter to store values in individual rows instead of serialized array. Will only work if field is not repeatable or a repeatable group. Props JohnyGoerend. (#262, #206, #45). - Portuguese (Brazil) translation provided by @lucascdsilva - #293.
- Spanish (Spain) translation updated by @yivi - #272.
- Added group field callback parameters,
'before_group'
,'before_group_row'
,'after_group_row'
,'after_group'
to complement the'before_row'
,'before'
,'after'
,'after_row'
field parameters. - Better styling for
title
fields andtitle
descriptions on options pages. - Add a
sanitization_cb
field parameter check for thegroup
field type. - Better function/file doc-blocks to provide better documentation for automated documentation tools. See: cmb2.io/api.
cmb2_print_metabox_form
,cmb2_metabox_form
, andcmb2_get_metabox_form
helper functions now accept two new parameters:- an
'object_type'
parameter to explictly set that in the$cmb
object. - an
'enqueue_js'
parameter to explicitly disable the CMB JS enqueue. This is handy if you're not planning on using any of the fields which require JS (like color/date pickers, wysiwyg, file, etc).
- an
- Fix issue with oembed fields in repeatable groups where changing video changed it for all fields in a group.
- Fix empty arrays (like in the group field) saving as a value.
- Move
'cmb2_override_meta_value'
and"cmb2_override_{$field_id}_meta_value"
filters to theCMB2_Field::get_data()
method so that the filters are applied every time the data is requested. THIS IS A BREAKING CHANGE: The parameters for those filters have changed a bit. Previously, the filters accepted 5 arguments,$value
,$object_id
,$field_args
,$object_type
,$field
. They have changed to accept 4 arguments instead,$value
,$object_id
,$args
,$field
, where$args
is an array that contains the following:- @type string $type The current object type
- @type int $id The current object ID
- @type string $field_id The ID of the field being requested
- @type bool $repeat Whether current field is repeatable
- @type bool $single Whether current field is a single database row
- Fix grouped fields display (first field was being repeated), broken in 2.0.3.
select
,radio
,radio_inline
field types now all accept the'show_option_none'
field parameter. This parameter allows you to set the text to display for showing a 'no selection' option. Default will befalse
, which means a 'none' option will not be added. Set totrue
to use the default text, 'None', or specify another value, i.e. 'No selection'.
- Fix back-compatibility when adding group field sub-fields via old array method (vs using the
CMB2:add_group_field()
method). Thanks to norcross for reporting. - Fix occasional jQuery issues with group-field indexes.
- New constant,
CMB2_DIR
, which stores the file-path to the CMB2 directory. text_date
,text_time
,text_date_timestamp
,text_datetime_timestamp
, andtext_datetime_timestamp_timezone
field types now take an arguments array so they can be extended by custom field types.- Removed auto-scroll when adding groups. To re-add the feature, use the snippet/plugin here. (#205)
- Updated Timepicker utilizing the @trentrichardson jQuery Timepicker add-on (https://github.com/trentrichardson/jQuery-Timepicker-Addon), and updated Datepicker styles. Props JonMasterson. (#204, #206, #45).
- Added a callback option for the field default value. The callback gets passed an array of all the field parameters as the first argument, and the field object as the second argument. (which means you can get the post id using
$field->object_id
). (#233). - New
CMB2::get_field()
method andcmb2_get_field
helper function for retrieving aCMB2_Field
object from the array of registered fields for a metabox. - New
CMB2::get_sanitized_values()
method andcmb2_get_metabox_sanitized_values
helper function for retrieving sanitized values from an array of values (usually$_POST
data). - New
'save_fields'
metabox parameter that can be used to disable (by setting'save_fields' => false
) the automatic saving of the fields when the form is submitted. These can be useful when you want to handle the saving of the fields yourself, or want to use submitted data for other purposes like generating new posts, or sending emails, etc.
- Fix commented out text_datetime_timestamp_timezone field registration example in
example-functions.php
. Props cliffordp, (#203). - Fix sidebar styling for money fields and fields with textareas. (#234)
- Fix
CMB2_Sanitize
class to properly use the stripslashed value (which was added in #162 but never used). Props dustyf, (#241).
- Use the more appropriate
add_meta_boxes
hook for hooking in metaboxes to post-edit screen. Thanks @inspiraaz for reporting. (#161) - Add a
row_classes
field param which allows you to add additional classes to the cmb-row wrap. This parameter can take a string, or array, or can take a callback that returns a string or array. The callback will receive$field_args
as the first argument, and the CMB2_Field$field
object as the second argument. Reported/requested in #68. - New constant,
CMB2_LOADED
, which you can use to check if CMB2 is loaded for your plugins/themes with CMB2 dependency. - New hooks,
cmb2_init_before_hookup
andcmb2_after_init
. - New API for adding metaboxes and fields, demonstrated in
example-functions.php
. In keeping with backwards-compatibility, thecmb2_meta_boxes
filter method will still work, but is not recommended. New API includesnew_cmb2_box
helper function to generate a new metabox, and returns a$cmb
object to add new fields (via theCMB2::add_field()
andCMB2::add_group_field()
methods). - New CMB2 method,
CMB2::remove_field()
. - New CMB2_Boxes method,
CMB2_Boxes::remove()
. - When clicking on a file/image in the
file
, orfile_list
type, the media modal will open with that image selected. Props johnsonpaul1014, (#120).
2.0.1 is the official version after beta, and includes all the changes from 2.0.0 (beta).
2.0.0 is the official version number for the transition to CMB2, and 2.0.1 is the official version after beta. It is a complete rewrite. Improvements and fixes are listed below. Note: This release requires WordPress 3.8+
- Converted
<table>
markup to more generic<div>
markup to be more extensible and allow easier styling. - Much better handling and display of repeatable groups.
- Entirely translation-ready with full translations in Spanish, French (Props @fredserva - #127), Finnish (Props @onnimonni - #108), Swedish (Props @EyesX - #141), and English.
- Add cmb fields to new user page. Props GioSensation, (#645).
- Improved and additional helper-functions.
- Added new features and translation for datepicker. Props kalicki, (#657).
- General code standards cleanup. Props gregrickaby, (#17 & others).
- Use SASS for development. Props gregrickaby, (#18).
- New
hidden
field type. - Ability to override text strings in fields via field options parameter.
- Added composer.json. Props nlemoine, (#19).
- New field 'hooks' can take static text/html or a callback.
- New
preview_size
parameter forfile
field type. Takes an array or named image size. - Empty index.php file to all folders (for more security). Props brunoramalho, (#41).
- Clean up styling. Props brunoramalho, (#43) and senicar.
- Collapsible field groups. Props cluke009, (#59).
- Allow for override of update/remove for CMB2_Field. Props sc0ttkclark, (#65).
- Use class button-disabled instead of disabled="disabled" for buttons. Props sc0ttkclark, (#66).
- New before/after dynamic form hooks.
- Larger unit test coverage. Props to @pmgarman for assistance. (#90 and #91)
- Added helper function to update an option. Props mAAdhaTTah, (#110).
- More JS hooks during repeat group shifting. Props AlchemyUnited, (#125).
- New metabox config option for defaulting to closed.
- New hooks,
cmb2_init
andcmb2_init_{$cmb_id}
.
- New mechanism to ensure CMB2 only loads the most recent version of CMB2 in your system. This fixes the issue where another bundled version could conflict or take precendent over your up-to-date version.
- Fix issue with field labels being hidden. Props mustardBees, (#48).
- Address issues with autoloading before autoloader is setup. Props JPry, (#56).
- Fixed 'show_on_cb' for field groups. Props marcusbattle, (#98).
- Make get_object_terms work with and without object caching. Props joshlevinson, (#105).
- Don't use
__DIR__
in example-functions.php to ensure PHP 5.2 compatibility. Props bryceadams, (#129). - Added support for radio input swapping in repeatable fields. Props DevinWalker, (#138, #149).
- Fix metabox form not being returned to caller. Props akshayagarwal, (#145).
- Run stripslashes before saving data, since WordPress forces magic quotes. Props clifgriffin, (#162).
- Localize Date, Time, and Color picker defaults so that they can be overridden via the
cmb_localized_data
filter. (#528) - Change third parameter for 'cmb_metabox_form' to be an args array. Optional arguments include
echo
,form_format
, andsave_button
. - Add support for
show_option_none
argument fortaxonomy_select
andtaxonomy_radio
field types. Also adds the following filters:cmb_all_or_nothing_types
,cmb_taxonomy_select_default_value
,cmb_taxonomy_select_{$this->_id()}_default_value
,cmb_taxonomy_radio_{$this->_id()}_default_value
,cmb_taxonomy_radio_default_value
. Props @pmgarman, (#569). - Make the list items in the
file_list
field type drag & drop sortable. Props twoelevenjay, (#603).
- Fixed typo in closing
</th>
tag. Props @CivicImages. (#616)
- Add support for custom date/time formats. Props @Scrent. (#506)
- Simplify
wysiwyg
escaping and allow it to be overridden via theescape_cb
parameter. (#491) - Add a 'Select/Deselect all' button for the
multicheck
field type. - Add title option for repeatable groups. Title field takes an optional replacement hash, "{#}" that will be replaced by the row number.
- New field parameter,
show_on_cb
, allows you to conditionally display a field via a callback. (#47) - Unit testing (the beginning). Props @brichards and @camdensegal.
- Fixed issue where remove file button wouldn't clear the url field. (#514)
wysiwyg
fields now allow underscores. Fixes some wysiwyg display issues in WordPress 3.8. Props @lswilson. (#491)- Nonce field should only be added once per page. (#521)
- Fix
in_array
issue when a post does not have any saved terms for a taxonomy multicheck. (#527) - Fixed error: 'Uninitialized string offset: 0 in cmb_Meta_Box_field.php...`. Props @DevinWalker. (#539, #549))
- Fix missing
file
field description. (#543, #547)
- Update
cmb_get_field_value
function as it was passing the parameters tocmb_get_field
in the wrong order. - Fix repeating fields not working correctly if meta key or prefix contained an integer. (#503)
- Fix issue with
cmb_Meta_Box_types.php
calling a missing method,image_id_from_url
. (#502)
- Radio button values were not showing saved value. (#500)
- Repeatable groups
- Support for more fields to be repeatable, including oEmbed field, and date, time, and color picker fields, etc.
- Codebase has been revamped to be more modular and object-oriented.
- New filter,
"cmb_{$element}_attributes"
for modifying an element's attributes. - Every field now supports an
attributes
parameter that takes an array of attributes. Read more. - Removed
cmb_std_filter
in favor ofcmb_default_filter
. THIS IS A BREAKING CHANGE - Better handling of labels in sidebar. They are now placed on top of the input rather than adjacent.
- Added i18n compatibility to text_money. props @ArchCarrier, (#485)
- New helper functions:
cmb_get_field
andcmb_get_field_value
for getting access to CMB's field object and/or value. - New JavaScript events,
cmb_add_row
andcmb_remove_row
for hooking in and manipulating the new row's data. - New filter,
cmb_localized_data
, for modifiying localized data passed to the CMB JS.
- Resolved occasional issue where only the first character of the label/value was diplayed. props @mustardBees, (#486)
- Change the way the
'cmb_validate_{$field['type']}'
filter works. It is now passed a null value vs saved value. If null is returned, default sanitization will follow. THIS IS A BREAKING CHANGE. If you're already using this filter, take note. - All field types that take an option array have been simplified to take
key => value
pairs (vsarray( 'name' => 'value', 'value' => 'key', )
). This effects the 'select', 'radio', 'radio_inline' field types. The 'multicheck' field type was already using thekey => value
format. Backwards compatibility has been maintained for those using the older style. - Added default value option for
taxonomy_select
field type. props @darlantc, (#473) - Added
preview_size
parameter forfile_list
field type. props @IgorCode, (#471) - Updated
file_list
images to be displayed horizontally instead of vertically. props @IgorCode, (#467) - Use
get_the_terms
where possible since the data is cached.
- Fixed wysiwyg escaping slashes. props @gregrickaby, (#465)
- Replaced
__DIR__
, asdirname( __FILE__ )
is easier to maintain back-compatibility. - Fixed missing table styling on new posts. props @mustardBees, (#438)
- Fix undeclared JS variable. @veelen, (#451)
- Fix
file_list
errors when removing all files and saving. - Set correct
object_id
to be used later incmb_show_on
filter. @lauravaq, (#445) - Fix sanitization recursion memeory issues.
- Now works with option pages and site settings. (view example in wiki)
- two filters to override the setting and getting of options,
cmb_override_option_get_$option_key
andcmb_override_option_save_$option_key
respectively. Handy for using plugins like WP Large Options (also here). - Improved styling on taxonomy (*tease*) and options pages and for new 3.8 admin UI.
- New sanitization class to sanitize data when saved.
- New callback field parameter,
sanitization_cb
, for performing your own sanitization. - new
cmb_Meta_Box_types::esc()
method that handles escaping data for display. - New callback field parameter,
escape_cb
, for performing your own data escaping, as well as a new filter,'cmb_types_esc_'. $field['type']
.
- Fixed wysiwyg editor button padding. props @corvannoorloos, (#391)
- A few php < 5.3 errors were addressed.
- Fields with quotation marks no longer break the input/textarea fields.
- metaboxes for Attachment pages now save correctly. Thanks @nciske for reporting. (#412)
- Occasionally fields wouldn't save because of the admin show_on filter.
- Smaller images loaded to the file field type will no longer be blown up larger than their dimensions.
- Added
text_datetime_timestamp_timezone
type, a datetime combo field with an additional timezone drop down, props @dessibelle - Added
select_timezone
type, a standalone time zone select dropdown. The time zone select can be used with standalonetext_datetime_timestamp
if desired. Props @dessibelle - Added
text_url
type, a basic url field. Props @dessibelle - Added
text_email
type, a basic email field. Props @dessibelle - Added ability to display metabox fields in frontend. Default is true, but can be overriden using the
cmb_allow_frontend filter
. If set to true, an entire metabox form can be output with thecmb_metabox_form( $meta_box, $object_id, $echo )
function. Props @dessibelle, @messenlehner & @jtsternberg. - Added hook
cmb_after_table
after all metabox output. Props @wpsmith file_list
now works like a repeatable field. Add as many files as you want. Props @coreymcollinstext
,text_small
,text_medium
,text_url
,text_email
, &text_money
fields now all have the option to be repeatable. Props @jtsternberg- Custom metaboxes can now be added for user meta. Add them on the user add/edit screen, or in a custom user profile edit page on the front-end. Props @tw2113, @jtsternberg
- Added field "before" and "after" options for each field. Solves issue with '$' not being the desired text_money monetary symbol, props @GaryJones
- Added filter for 'std' default fallback value, props @messenlehner
- Ensure oEmbed videos fit in their respective metaboxes, props @jtsternberg
- Fixed issue where an upload field with 'show_names' disabled wouldn't have the correct button label, props @jtsternberg
- Better file-extension check for images, props @GhostToast
- New filter,
cmb_valid_img_types
, for whitelisted image file-extensions, props @jtsternberg
- Added field type and field id classes to each cmb table row, props @jtsternberg
- Added post type comparison to prevent storing null values for taxonomy selectors, props @norcross
- Added
oEmbed
field type with ajax display, props @jtsternberg
- Note: This release requires WordPress 3.3+
- Cleaned up scripts being queued, props @jaredatch
- Cleaned up and reorganized jQuery, props @GaryJones
- Use $pagenow instead of custom $current_page, props @jaredatch
- Fixed CSS, removed inline styles, now all in style.css, props @jaredatch
- Fixed multicheck issues (issue #48), props @jaredatch
- Fixed jQuery UI datepicker CSS conflicting with WordPress UI elements, props @jaredatch
- Fixed zeros not saving in fields, props @GaryJones
- Fixed improper labels on radio and multicheck fields, props @jaredatch
- Fixed fields not rendering properly when in sidebar, props @jaredatch
- Fixed bug where datepicker triggers extra space after footer in Firefox (issue #14), props @jaredatch
- Added jQuery UI datepicker packaged with 3.3 core, props @jaredatch
- Added date time combo picker, props @jaredatch
- Added color picker, props @jaredatch
- Added readme.md markdown file, props @jaredatch
- Added jQuery timepicker, props @norcross
- Added 'raw' textarea to convert special HTML entities back to characters, props @norcross
- Added missing examples on example-functions.php, props @norcross
- Added the new wp_editor() function for the WYSIWYG dialog box, props @jcpry
- Created 'cmb_show_on' filter to define your own Show On Filters, props @billerickson
- Added page template show_on filter, props @billerickson
- Improvements to the 'file' field type, props @randyhoyt
- Allow for default values on 'radio' and 'radio_inline' field types, props @billerickson
- Enabled the ability to define your own custom field types (issue #28). props @randyhoyt
- Added the ability to limit metaboxes to certain posts by id. props @billerickson
- Fixed define to prevent notices. props @destos
- Added text_date_timestap option. props @andrewyno
- Fixed WYSIWYG paragraph breaking/spacing bug. props @wpsmith
- Added taxonomy_radio and taxonomies_select options. props @c3mdigital
- Fixed script causing the dashboard widgets to not be collapsible.
- Fixed various spacing and whitespace inconsistencies
- Think we have a release that is mostly working. We'll say the initial release :)