=== 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.2 Stable tag: 4.10.4 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.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