=== Meta Box === Contributors: metabox, rilwis, fitwp, f-j-kaiser, funkatronic, PerWiklander, ruanmer, Omnicia Donate link: http://paypal.me/anhtnt Tags: meta-box, custom fields, custom field, meta, meta-boxes, admin, advanced, custom, edit, field, file, image, magic fields, matrix, more fields, Post, repeater, simple fields, text, textarea, type, cms, fields post Requires at least: 4.1 Tested up to: 4.7.3 Stable tag: 4.11 License: GPLv2 or later Meta Box plugin is a powerful, professional developer toolkit to create custom meta boxes and custom fields for WordPress. == Description == **Meta Box plugin is a powerful, professional toolkit for developers to create and handle everything related to custom meta boxes and custom fields for WordPress.** The plugin provides a **wide range of field types** and **a lot of options to for each field type**, which gives you unlimited possibility to control and customize the custom fields. With the extensions, you can easily build meta boxes not only for custom post types (default), but also for **settings page, user meta, term meta**. You can also display the fields the way you want with columns, tabs or groups. The plugin is built mostly for developers with a little coding, but if you prefer GUI for faster creating custom post types, meta boxes and custom fields, the plugin has extensions for that: [MB Custom Post Type](https://wordpress.org/plugins/mb-custom-post-type/) and [Meta Box Builder](https://metabox.io/plugins/meta-box-builder/). ### Features * Create custom meta boxes for posts, pages or any custom post type. * Create custom [settings pages or theme option page](https://metabox.io/plugins/mb-settings-page/). * Create custom meta boxes for [user profile pages](https://metabox.io/plugins/mb-user-meta/). * Create custom meta boxes for [taxonomy terms](https://metabox.io/plugins/mb-term-meta/). * Supports 40+ built-in [field types](https://metabox.io/docs/define-fields/) for all your needs (text, textarea, wysiwyg/editor, image, file, post, select, checkbox, radio buttons, date time picker, taxonomy, user, oembed and more to come!). You can also [create your own field type](https://metabox.io/docs/create-field-type/) easily. * Support cloning (repeatable) fields for most field types, including WYSIWYG/editor field. Also support [repeatable field groups](https://metabox.io/plugins/meta-box-group/). * Powerful [actions and filters](https://metabox.io/docs-category/reference/) that developers can build or change the appearance and behavior in the plugin. * Uses the [native WordPress meta data storage](https://metabox.io/docs/how-post-meta-is-saved-in-the-database/) and functions for ease of use and fast processing. * [Easily integrate with themes and plugins](https://metabox.io/docs/include-meta-box-plugin-themes/). * [Works with Composer](https://metabox.io/docs/using-meta-box-composer/) if you want to include the plugin in your project. * Compatible with WPML multilingual plugin (officially supported by WPML team). ### Documentation - [Getting Started](https://metabox.io/docs/getting-started/) - [Register Meta Boxes](https://metabox.io/docs/registering-meta-boxes/) - [Define Fields](https://metabox.io/docs/define-fields/) - [Get Meta Value](https://metabox.io/docs/get-meta-value/) See more documentation [here](https://metabox.io/docs/). ### Extensions - [MB User Meta](https://metabox.io/plugins/mb-user-meta/): Add custom fields to user profile (user meta) quickly with simple syntax. - [Meta Box Geolocation](https://metabox.io/plugins/meta-box-geolocation/): Automatically and instantly populate location data with the power of Google Maps Geolocation API. - [MB Admin Columns](https://metabox.io/plugins/mb-admin-columns/): Display custom fields in table columns in admin screens for All Posts (types). - [MB Term Meta](https://metabox.io/plugins/mb-term-meta/): Add meta data to categories, tags or any custom taxonomy with simple syntax. - [MB Settings Page](https://metabox.io/plugins/mb-settings-page/): Create settings pages for themes, plugins or websites with beautiful syntax. - [MB Custom Post Type](https://wordpress.org/plugins/mb-custom-post-type/): Create and manage custom post types and taxonomies easily in WordPress with an easy-to-use interface. - [Meta Box Yoast SEO](https://wordpress.org/plugins/meta-box-yoast-seo/): Add content of custom fields to Yoast SEO Content Analysis to have better/correct SEO score. - [Meta Box Text Limiter](https://wordpress.org/plugins/meta-box-text-limiter/): Limit the number of characters or words entered for text and textarea fields. - [Meta Box Conditional Logic](https://metabox.io/plugins/meta-box-conditional-logic/): Add visibility dependency for custom meta boxes and custom fields in WordPress. - [Meta Box Group](https://metabox.io/plugins/meta-box-group/): Create repeatable groups of custom fields for better appearance and structure. - [Meta Box Builder](https://metabox.io/plugins/meta-box-builder/): Create custom meta boxes and custom fields in WordPress using the drag-and-drop interface. - [Meta Box Template](https://metabox.io/plugins/meta-box-template/): Define custom meta boxes and custom fields easier with templates. - [Meta Box Tooltip](https://metabox.io/plugins/meta-box-tooltip/): Display help information for fields using beautiful tooltips. - [Meta Box Show Hide (Javascript)](https://metabox.io/plugins/meta-box-show-hide-javascript/): Toggle meta boxes by page template, post format, taxonomy (including category) via Javascript. - [Meta Box Tabs](https://metabox.io/plugins/meta-box-tabs/): Create tabs for meta boxes easily. Support 3 WordPress-native tab styles and tab icon. - [Meta Box Columns](https://metabox.io/plugins/meta-box-columns/): Display fields more beautiful by putting them into 12-columns grid. - [Meta Box Include Exclude](https://metabox.io/plugins/meta-box-include-exclude/): Show/hide meta boxes by ID, page template, taxonomy or custom function. See all extensions [here](https://metabox.io/plugins/). ### Plugin Links - [Project Page](https://metabox.io) - [Documentation](https://metabox.io/docs/) - [Report Bugs/Issues](https://github.com/rilwis/meta-box/issues) - [Premium Extensions](https://metabox.io) == Installation == 1. Unzip the download package 1. Upload `meta-box` to the `/wp-content/plugins/` directory 1. Activate the plugin through the 'Plugins' menu in WordPress To getting started with the plugin API, please read [this tutorial](https://metabox.io/docs/getting-started/). == Frequently Asked Questions == == Screenshots == 1. Text Fields 1. Basic Fields 1. Advanced Fields 1. File Image Upload Fields 1. Media Fields 1. Post Taxonomy Fields == Changelog == = 4.11 = * Code architecture update: * Add `object_id` property to the meta box object. Used to connect the meta box to the post object. Not heavily used yet. * Add RWMB_Meta_Box_Registry and RWMB_Field_Registry to store all registered meta boxes and fields. Used to future access these objects. Use internally only. 3rd-party code should not use it as it's still experimental and can change in the future. * Deprecated RWMB_Core::get_meta_boxes() due to the meta box registry above. This function was made for internally use only. 3rd-party code should not rely on it. * Add magic method __get to the meta box object to quick access to meta box configuration. * UI update: * Make the field label bold (similar to WordPress settings page). * Increase margin between fields and change color for remove clone button (also reduce minus size) * Remove style for checkbox (default is good). * Improve styles for checkbox/radio list * A little smaller padding for select box. Also remove default size for select[multiple] * Add a little space between the map canvas and the "Find Address" button * Media fields: * Media field update: Hidden field for media fields now no longer disabled. If media field js not loaded properly, code will default to hidden field and process accordingly. Issue #1088. * Better and simpler way to handle HTML file upload using `media_handle_upload` function. * Rewrite JS for "file", simpler and modular. Also fix bug when add/remove items that doesn't toggle the Add more link correctly. * Improve JS code for media field, using MediaList instead of item views (Backbone JS code). * Add support for image sizes in image_advanced and image_upload. Default is thumbnail. Fixes #425. * Clone: * Add new parameter `add_button` for the add new clone button text. Better than use filter. * Fix position for remove clone button in RTL languages * Update margin between clones and set clone placeholder = outer height of the cloned element. * Scripts and styles: * Check condition for enqueueing scripts & styles only in the admin. * Update the time picker library to the latest version (1.6.3) to supports "select" control for time picker. [See demo](http://trentrichardson.com/examples/timepicker/#slider_examples). * Better dependencies for date picker CSS, autocomplete field. * Other improvements: * Remove the static helper class because of a bad OOP code. * Fix get plugin URL symlink when plugin is put in a theme and symlinked. Props @tutv95. * Add support for "region" in the map field to limit autocomplete from wrong entries (to help preventing from entering wrong address or country). See https://developers.google.com/maps/documentation/geocoding/intro#RegionCodes = 4.10.4 = * Improvement: Add support for validate user edit and term edit forms (requires MB Term Meta or MB User Meta extension). * Improvement: Add new parameter `label_description` for fields to display a description below field label (name). * Improvement: Add support for edit custom fields in the media modal. Requires `post_type` set to `attachment` and `media_modal` set to true. [See demo](https://github.com/rilwis/meta-box/blob/master/demo/media-modal.php). * Improvement: For WPML users: Add support to hide fields in "Do not translate" mode and disable editing fields in "Copy" mode. * Fix: Users can't select same images for 2 different `image_advanced` fields. * Fix: `max_status` doesn't work. = 4.10.3 = * Fix: `force_delete` causes files to be deleted even when set to `false`. * Fix: `max_file_uploads` not working. = 4.10.2 = * Improvement: Add `max_file_size` to upload fields (`File_Upload`, `Image_Upload`, `Plupload_Image`). * Improvement: Add support for attributes for file input. * Improvement: Update Polish translation. * Improvement: Add translation support for Key and Value strings (@prop saqibsarwar). * Fix: Shorter width of email field vs. other fields (@prop saqibsarwar). * Fix: Fix cloneable datetime field with timestamp=true. * Fix: Remove margin bottom in select_advanced options. * Fix: Showing the correct selected value for select_advanced field when the option value contains '&' character. * Fix: Fix default values not working with taxonomy and taxonomy_advanced fields. = 4.10.1 = * Fix: Fix `image_upload` and `plupload_image` field when select images to upload. = 4.10 = * Improvement: Add `video` field type which allows users to upload or select video from the Media Library. See [demo](https://github.com/rilwis/meta-box/blob/master/demo/video.php). * Improvement: Update Turkish. Prop Emre Tuna . * Improvement: Use WP 4.6 date picker localization instead of JS localized file to reduce plugin size. * Improvement: Refactor the media fields for better performance. Add `change` event for item list when add, remove or reset. * Fix: `taxonomy_advanced` field now can be cloned. * Fix: Make localize_script works with WP 4.1. = 4.9.8 = * Fix: Quick fix for enqueueing validation script = 4.9.7 = * Improvement: Re-add change event on media fields to make Conditional Logic extension works with media fields. * Improvement: Add `rwmb_choice_label`, `rwmv_{$field_type}_choice_label` and `rwmb_{field_id}_choice_label` filters for post, user, taxonomy fields, allowing users to customize the labels of choice fields. * Improvement: Change coding styles to follow WordPress Coding Standards. * Various improvements to reduce duplicated code. * Fix: Map field now works in the frontend. * Fix: `std` now works for taxonomy fields. = 4.9.6 = * Fix: Wrong CSS selector when cloning wysiwyg field * Fix: Remove preview for oembed field when cloning * Fix: 'std' for taxonomy field now works = 4.9.5 = * Fix: Quick fix for wrong field wrapper class which causes color field to render incorrectly = 4.9.4 = * Fix: Quick fix for cloning bug = 4.9.3 = * Fix: Quick fix saving datetime field = 4.9.2 = * Fix: Quick fix validation = 4.9.1 = * Fix: Quick fix for `rwmb_meta()` to be better backward compatible = 4.9 = * Improvement: Update Chinese language. Add Chinese Taiwan. * Improvement: Add support for Google Maps API key. Default API key is added, however users should replace it with their own key. * Improvement: Add additional methods for jQuery validation module which makes it understand HTML5 "pattern" attribute. * Improvement: Fully WPML compatibility (supported by WPML team) * Improvement: Add placeholders for `key_value` field * Fix: Toggle remove clone buttons for nested groups. * Fix: Error on date field, not save * Fix: Add fix for date/datetime when both inline and timestamp used * Fix: Set default language for date/time picker. * Fix: rwmb_meta for images returns incorrect width/height * Fix: PHP warning when uploading files in Settings Pages extension. * Fix: Blank space in the footer when using plupload_image. * Fix: Cloning wysiwyg when deleting the 1st clone = 4.8.7 = * Improvement: Refactor the code to reduce the complexity in the fields' inheritance * Improvement: All HTML 5 input types (week, month, etc.) are supported * Improvement: Optimize the_value function, use recursive call to reduce nested loop. Sub-fields need to define format_single_value only. * Improvement: Use 1 single localization file for jQuery date picker for simplicity * Improvement: Add support for custom marker for map field (param `marker_icon`) in rwmb_meta function * Improvement: Add `limit` option for media fields in `rwmb_meta` function when retrieving meta value. * Improvement: Add `rwmb_option_label` filter for choice fields (user, post, taxonomy) so users can choose which object field is used as label * Improvement: Use `WP_User_Query` for user field which supports more options for querying * Improvement: Optimize code for oembed, also use esc_html__ for better security * Improvement: Compatibility with Meta Box Geolocation * Fix: Fix first option is auto selected in select_advanced field. * Fix: Fix clone issue for color in Meta Box Group extension. * Fix: Fix clone issue for image advanced in Meta Box Group extension. * Fix: Fix not parsing $args to array in helper functions. = 4.8.6 = * Improvement: Edit link on media items now opens edit modal * Improvement: Refresh map when sorting meta boxes. * Improvement: Wrap checkbox's description into a