readme.txt (22519B)
1 === Meta Box - WordPress Custom Fields Framework === 2 Contributors: elightup, metabox, rilwis, fitwp, f-j-kaiser, funkatronic, PerWiklander, ruanmer, Omnicia 3 Donate link: https://metabox.io/pricing/ 4 Tags: meta box, custom fields, custom post types, custom taxonomies, cpt, meta boxes, custom field, post type, taxonomy, meta, admin, advanced, custom, edit, field, file, image, magic fields, post types, more fields, post, repeater, simple fields, text, textarea, type, cms, fields post 5 Requires at least: 4.3 6 Requires PHP: 5.6 7 Tested up to: 5.8.1 8 Stable tag: 5.4.7 9 License: GPLv2 or later 10 11 Meta Box plugin is a powerful, professional developer toolkit to create custom meta boxes and custom fields for your custom post types in WordPress. 12 13 == Description == 14 15 **Meta Box is a powerful, professional, and lightweight toolkit for developers to create custom meta boxes and custom fields for any custom post type in WordPress.** 16 17 Meta Box helps you add [custom fields](https://metabox.io) and details on your website such as pages, posts, custom post types, forms and anywhere you want using over 40 different field types such as text, images, file upload, checkboxes, and more. 18 19 On top of that, each WordPress custom field type has extensive internal options for unlimited content possibilities. Complete customization and control is just a few clicks away. 20 21 Adding WordPress custom fields and custom meta boxes for custom post types is quick and painless: Select the field types you want in the user-friendly [Online Generator](https://metabox.io/online-generator/), then copy and paste the code into your child theme's `functions.php` file. 22 23 **Boom! All the power with none of the bloat.** 24 25 There are also free and premium extensions available to add enhanced capabilities. You can manage the display and organization of your WordPress custom fields, the conditions upon which they appear, and become the ultimate WordPress data wizard. 26 27 You can also check out the [full list of extensions](https://metabox.io/plugins/) and [MetaBox.io](https://metabox.io) for details. 28 29 ### Features 30 31 #### Create any type of metadata or custom fields in WordPress 32 33 That's right – any type. No matter where you need to insert custom data and features, Meta Box's WordPress custom fields have your back, and with infinite options to boot. 34 35 **Here are just a few of the data types you can customize:** 36 37 - Posts 38 - Pages 39 - Custom post types (you can also use our free plugin [MB Custom Post Types & Custom Taxonomies](https://metabox.io/plugins/custom-post-type/) to create custom post types and custom taxonomies) 40 - [Taxonomies](https://metabox.io/plugins/mb-term-meta/) 41 - [Settings pages](https://metabox.io/plugins/mb-settings-page/) 42 - [Theme option pages](https://metabox.io/plugins/mb-settings-page/) 43 - [User profile pages](https://metabox.io/plugins/mb-user-profile/) 44 - [Post comments](https://metabox.io/plugins/mb-comment-meta/) 45 - [And even more data types](https://docs.metabox.io/field-settings/) than Batman has tools on his utility belt. 46 47 #### A wide-range of field types and options 48 49 Take your standard WordPress custom field and imagine it infinitely expanded. That's how many options Meta Box gives you: 50 51 - Meta Box supports [40+ built-in WordPress custom field types](https://docs.metabox.io/field-settings/) for all your needs including text, textarea, WYSIWYG editor, image, file, post, select, checkbox, radio buttons, date/time picker, taxonomy, user, oembed and more to come. 52 - Not enough? You can also [effortlessly create your own field type](https://docs.metabox.io/custom-field-type/). 53 - Meta Box supports cloning fields for most field types including the WYSIWYG editor field. It also supports [repeatable field groups](https://metabox.io/plugins/meta-box-group/). 54 - Utilize WordPress' powerful [action](https://docs.metabox.io/actions/) and [filter](https://docs.metabox.io/filters/) system so you can build or change a site's appearance and behavior in the plugin. 55 56 #### It's developer-friendly 57 58 As a developer, you have enough on your plate. You shouldn't have to create an entirely new system for each project. Use Meta Box to your full advantage. 59 60 You can use Meta Box and its custom fields for any custom post type in WordPress on as many websites as you want so you can use it on client projects as well. 61 62 - Has an ultra-lightweight, yet powerful API that won't overload your site. 63 - Add only what you need instead of getting stuck with a bundle of features you don't even want that bloat your site. 64 - Meta Box [easily integrates with any theme and plugin](https://docs.metabox.io/integration/), and also [works with the Composer package dependency manager](https://docs.metabox.io/composer/). 65 - We use the [native WordPress meta data storage](https://docs.metabox.io/database/) and functions for ease of use and lightning-fast processing. 66 - It's compatible with WPML multilingual plugin, and is officially supported by the WPML team. 67 68 #### Don't love coding? You're in luck! 69 70 Meta Box is built mostly for developers since you need to copy and paste some code, but if you prefer a more visual system to create custom fields in WordPress, you can choose one or all of the extensions below: 71 72 - [MB Custom Post Types & Custom Taxonomies](https://wordpress.org/plugins/mb-custom-post-type/) 73 - [Meta Box – Beaver Themer Integrator](https://metabox.io/plugins/meta-box-beaver-themer-integrator/) 74 - [Meta Box Builder](https://metabox.io/plugins/meta-box-builder/) 75 76 The [Meta Box Builder extension](https://metabox.io/plugins/meta-box-builder/) has a ton of features to make quick work of any project: 77 78 - All the power of Meta Box without touching a single line of code. 79 - It's designer-friendly, lightweight and works at top-notch speeds. 80 - Create an unlimited amount of WordPress custom fields at lightning speeds and with a user-friendly drag-and-drop interface. 81 - Over 40 custom field types available that you can drag and drop to where you need ‘em. 82 - Export your custom fields and settings to PHP. Then, add it to a new site without needing to install this extension for an incredibly lightweight option. 83 - It has the goods with conditional logic, priority and context options ready and waiting. 84 85 ### Extensions 86 87 Speaking of extensions, there are a ton of free and premium ones available to further extend the already powerful core Meta Box plugin so you can supercharge your custom fields in WordPress. 88 89 You'll have ultimate control to add whatever meta box and custom fields in WordPress you could ever want. Then, you can tailor it all to fit your exact specifications. 90 91 #### Free Extensions 92 93 - [MB Custom Post Types & Custom Taxonomies](https://wordpress.org/plugins/mb-custom-post-type/): Create and manage custom post types and taxonomies quickly with an easy-to-use interface. 94 - [MB Relationships](https://wordpress.org/plugins/mb-relationships/): Create as many connections as you want from post-to-post or page-to-page. 95 - [Meta Box Yoast SEO](https://wordpress.org/plugins/meta-box-yoast-seo/): Add WordPress custom fields to Yoast SEO Content Analysis to generate more accurate SEO scores. 96 - [MB Rest API](https://metabox.io/plugins/mb-rest-api/): Pull all meta values from posts and terms into the WP REST API responses. 97 - [MB Comment Meta](https://wordpress.org/plugins/mb-comment-meta/): Add WordPress custom fields to comments in WordPress. It supports all field types and options. 98 - [MB Custom Taxonomy](https://metabox.io/plugins/custom-taxonomy/): Create and manage custom taxonomies in WordPress with a user-friendly interface. 99 - [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. 100 - [Meta Box – FacetWP Integrator](https://metabox.io/plugins/meta-box-facetwp-integrator/): Integrates Meta Box, and FacetWP to make WordPress custom fields searchable and filterable in the frontend. 101 - [Meta Box – Beaver Themer Integrator](https://metabox.io/plugins/meta-box-beaver-themer-integrator/): Integrates Meta Box, and Beaver Themer to show WordPress custom fields easier in the frontend. 102 103 #### Premium Extensions 104 105 - [MB Views](https://metabox.io/plugins/mb-views/): Outputing custom fields and build front-end templates for WordPress without touching theme files. 106 - [MB Blocks](https://metabox.io/plugins/mb-blocks/): Create custom Gutenberg blocks with PHP, using the same syntax in Meta Box. 107 - [Meta Box Builder](https://metabox.io/plugins/meta-box-builder/): Create custom meta boxes and custom fields in WordPress using a user-friendly drag-and-drop interface. 108 - [Meta Box Group](https://metabox.io/plugins/meta-box-group/): Create repeatable groups of WordPress custom fields for better appearance and structure. 109 - [MB Settings Page](https://metabox.io/plugins/mb-settings-page/): Create settings pages for themes, plugins or websites with beautiful syntax. 110 - [MB Term Meta](https://metabox.io/plugins/mb-term-meta/): Add meta data to categories, tags or any custom taxonomy with simple syntax. 111 - [Meta Box Conditional Logic](https://metabox.io/plugins/meta-box-conditional-logic/): Add visibility dependency for custom meta boxes and custom fields in WordPress. 112 - [Meta Box Include Exclude](https://metabox.io/plugins/meta-box-include-exclude/): Show or hide meta boxes by ID, page template, taxonomy, or custom function. 113 - [MB Frontend Submission](https://metabox.io/plugins/mb-frontend-submission/): Create frontend forms for users to submit custom content and embed them anywhere with a shortcode. 114 - [Meta Box Columns](https://metabox.io/plugins/meta-box-columns/): Display eye-catching custom fields in WordPress by putting them into 12-column grids. 115 - [Meta Box Tabs](https://metabox.io/plugins/meta-box-tabs/): Painlessly create tabs for meta boxes. There are 3 supported WordPress-native tab styles and icons. 116 - [MB Admin Columns](https://metabox.io/plugins/mb-admin-columns/): Display WordPress custom fields in table columns on admin screens for all post types. 117 - [MB Custom Table](https://metabox.io/plugins/mb-custom-table/): Save custom field data to custom tables instead of the default meta tables to reduce your database's size and increase its performance. 118 - [MB Revision](https://metabox.io/plugins/mb-revision/): Track changes to custom fields in WordPress with revisions. You can save, compare and restore the changes smoothly. 119 - [MB User Meta](https://metabox.io/plugins/mb-user-meta/): Quickly add WordPress custom fields to user profiles in the wp_usermeta table with simple syntax. 120 - [Meta Box Geolocation](https://metabox.io/plugins/meta-box-geolocation/): Automatically and instantly populate location data with the power of the Google Maps Geolocation API. 121 - [Meta Box Template](https://metabox.io/plugins/meta-box-template/): Make defining custom meta boxes and WordPress custom fields way easier with templates. 122 - [Meta Box Tooltip](https://metabox.io/plugins/meta-box-tooltip/): Display help information for custom fields in WordPress using beautiful tooltips. 123 - [Meta Box Show Hide](https://metabox.io/plugins/meta-box-show-hide-javascript/): Toggle meta boxes by page template, post format, taxonomy and category via JavaScript. 124 125 See all the available [extensions on the Meta Box website](https://metabox.io/plugins/). 126 127 ### Detailed Documentation 128 129 We won't leave you high and dry. 130 131 We provide regularly updated, and extensive documentation as well as tutorials on how to use MetaBox and custom fields in WordPress to your advantage as well as in the most efficient way possible. 132 133 Here are a few guides to quickly get you started with Meta Box and creating your own WordPress custom fields: 134 135 - [Quick Start Guide](https://docs.metabox.io/quick-start/) 136 - [Creating Meta Boxes](https://docs.metabox.io/creating-meta-boxes/) 137 - [Field Settings](https://docs.metabox.io/field-settings/) 138 - [Displaying Fields](https://docs.metabox.io/displaying-fields/) 139 140 Check out more on the [Meta Box Documentation](https://docs.metabox.io/) page. 141 142 == Installation == 143 144 From within WordPress 145 146 1. Visit **Plugins > Add New** 147 1. Search for **Meta Box** 148 1. Click the **Install Now** button to install the plugin 149 1. Click the **Activate** button to activate the plugin 150 151 Manually 152 153 1. Unzip the download package 154 1. Upload `meta-box` to the `/wp-content/plugins/` directory 155 1. Activate the plugin through the 'Plugins' menu in WordPress 156 157 To getting started with the plugin, please read the [Quick Start Guide](https://docs.metabox.io/quick-start/). 158 159 == Frequently Asked Questions == 160 161 == Screenshots == 162 1. Text Fields 163 1. Basic Fields 164 1. Advanced Fields 165 1. File Image Upload Fields 166 1. Media Fields 167 1. Post Taxonomy Fields 168 169 == Changelog == 170 171 = 5.4.7 - 2021-09-16 = 172 - Fix deleting files and images inside groups. 173 - Fix maxlength and pattern not working if not set inside attributes 174 - Fix not switching tabs for wysiwyg editors 175 - Fix unit for checkbox width 176 - Fix remove clone button on top of inputs 177 - Fix style for checked checkboxes on desktops 178 - Hide hidden field with custom class, not .hidden 179 180 = 5.4.6 - 2021-07-08 = 181 - Remove debug code 182 183 = 5.4.5 - 2021-07-08 = 184 - Fix styling issue for heading field and side meta boxes 185 186 = 5.4.4 - 2021-07-06 = 187 - Improve usability for time picker on mobile by adding +/- buttons 188 - Make all input, select, textarea 100% width 189 - Export clone functions to the global "rwmb" 190 191 = 5.4.3 - 2021-06-30 = 192 - Fix trailing comma in function call for PHP < 7.3 193 194 = 5.4.2 - 2021-06-29 = 195 - Improve style for media fields to reuse style/HTML markup. 196 - Make input, select, input group, select2, textarea full width on the side context. 197 - Improve style for button group when buttons don't have same width. 198 - Set better default options for date time pickers. 199 - Allow to output HTML in input prepend/append (ex. icon). 200 - Add filter `rwmb_dismiss_dashboard_widget` to dismiss dashboard widget. 201 202 = 5.4.1 - 2021-06-01 = 203 - Improve style for prepend, append text 204 - Improve style for select2 on mobiles 205 - Make select_tree extend select_advanced and respect select_advanced options 206 207 = 5.4.0 - 2021-05-08 = 208 - Shortcode: add `render_shortcodes` attribute (default true) to allow render inner shortcodes. 209 - File fields: allow to change uploaded file name when uploading to custom folder via `unique_filename_callback` setting 210 - Dashboard: add more video tutorials 211 - Image fields: fix actions (edit, delete) not visible on mobile 212 - Choice fields: fix not saving value if they contain quotes 213 - Datetime fields: fix not saving timestamp via REST API 214 215 = 5.3.10 - 2021-04-24 = 216 - Disable autocomplete for date/datetime fields 217 - Input list field: Fix label not working if contains HTML 218 - Fix multiple OSM on the same page 219 - Add auto update for solutions 220 - Fix various bugs for the wysiwyg editor field (mostly in blocks) and allows to pass tinyMCE/quicktags settings to the editor 221 222 = 5.3.9 - 2021-03-10 = 223 - Fix taxonomy_advanced doesn't load options in attachment with media_modal set to true. 224 - Fix `rwmb_{$field_id}_choice_label` not working for checkbox_list field type 225 - Fix clone_default not working for switch if set std = true 226 - Update jQueryUI styles to 1.12.1 227 228 = 5.3.8 - 2021-01-28 = 229 - Fix value not available when loaded in `map` and `osm` fields. 230 231 = 5.3.7 - 2021-01-11 = 232 - Fix editor not editable in Gutenberg 233 - Fix content in the visual tab of editors not saving 234 - Make required validation work for color, map, osm, switch, text-list fields 235 - Add dismiss action for dashboard news 236 237 = 5.3.6 - 2020-12-29 = 238 - Fix validation not working for image-select, image and wysiwyg fields 239 - Fix clone_default not working for switch 240 - Fix saving select field value when defining each option as an array 241 - Fix wysiwyg not editable in WP 5.6 242 243 = 5.3.5 - 2020-11-30 = 244 - Update color picker library to v3.0.0 and fix color picker with opacity not working in the Customizer (used with [MB Settings Page](https://metabox.io/plugins/mb-settings/page/)). 245 - Cache update requests 246 - Show (No title) in object fields if they don't have title 247 248 = 5.3.4 - 2020-09-23 = 249 - Add default title 250 - Update autoloader 251 - Bypass the validation when previewing in Gutenberg 252 - Add MB Views to the updater 253 - Update color picker script to latest version 2.1.4 254 - Fix missing labels for color field (wp 5.5.1) 255 - Fix preview is not generated 256 - Fix seamless style in WordPress 5.5 257 - Fix style for file_input field (description is inline with input field) 258 259 = 5.3.3 - 2020-07-21 = 260 - Hide Go Pro link for premium users 261 - Update intro and image for the Online Generator in the welcome page 262 263 = 5.3.2 - 2020-07-03 = 264 - Fix validation not working for media fields 265 - Add "add_to" option for media fields to allow adding new images to the beginning/end of the list 266 - Improve style for input & select on the sidebar 267 - Improve style for mobiles 268 269 = 5.3.1 - 2020-06-03 = 270 - Fix validation not working for multiple forms (front end) 271 - Fix PHP warning: Creating default object from empty value 272 - Fix cloning, sorting wysiwyg field when users disable visual editor 273 - Change color of switch based on admin color scheme 274 275 = 5.3.0 - 2020-05-11 = 276 - Add `rwmb_set_meta` function to set meta value. 277 - Add Gutenberg compatibility for validation. 278 - Fix wrong label output for switch when it's off. 279 280 = 5.2.10 - 2020-04-17 = 281 - Hotfix for getting meta value for checkbox list. 282 283 = 5.2.9 - 2020-04-17 = 284 - Fix cloning default value not working for some fields. 285 286 = 5.2.8 - 2020-04-06 = 287 288 **Added** 289 290 - Add option open info window in Google Maps when loaded 291 - Add `alpha_channel` & update style to background field 292 - Add support for custom Ajax parameters for object fields. 293 294 **Fixed** 295 296 - Fix validation rules still applied for hidden fields 297 - Fix `image_upload` field select files not working on iPhone 298 - Fix fatal error with Frontend Submission & Elementor 299 - Fix 'zoom' parameter not working for OSM field on the front end 300 301 **Changed** 302 303 - Remove languages folder. Load languages from translate.wordpress.org only 304 305 = 5.2.7 - 2020-02-07 = 306 307 - Fix warning in image field for metadata[‘sizes’]. 308 - Allow to quick define text fields with “name” attribute only. 309 310 = 5.2.6 - 2020-02-03 = 311 312 - Fix wrong tag when deploying 313 314 = 5.2.5 - 2020-02-03 = 315 316 **Fixed** 317 318 - Fix CSS in about page and add MB Core to list of premium plugins 319 - Fix edit icon not showing popup for image fields 320 - Fix OpenStreetMap not loading properly in tabs 321 322 **Changed** 323 324 - Replace date() with gmdate() 325 - Update style for input prepend/append for WordPress >= 5.3 326 327 **Added** 328 329 - Add custom trigger after validation for Tabs/Settings extensiosn to show error fields 330 - Add URL to all sizes in the returned value of helper functions for images 331 332 = 5.2.4 - 2019-12-11 = 333 334 **Added** 335 336 - Add hook `rwmb_field_registered` after a field is registered. 337 - Add (*) to required fields 338 339 **Changed** 340 341 - Remove required attribute for license input box. 342 - Don't redirect when bulk activate with other plugins. 343 344 **Fixed** 345 346 - Fix style for `select`, `select_advanced` fields in WordPress 5.3. 347 - Fix getting object fields for settings pages 348 349 = 5.2.3 - 2019-11-01 = 350 351 **Changed** 352 353 - Set clone=false if max_clone=1 354 - Shows only images in the selection popup for image field 355 - Hide license key 356 357 **Fixed** 358 359 - Fixed parsed terms in taxonomy advanced for MB Blocks 360 - Don't show date picker for readonly fields 361 - Fix warning when output empty background field value 362 - Fix empty meta value when save_field=false 363 364 = 5.2.2 - 2019-10-09 = 365 366 **Fixed** 367 368 - Fix sanitizing empty post field 369 - Fix post thumbnail not saving in MB Frontend Submission 370 - Fix undefined index for `image_select` field when using helper functions with no value. 371 - Fix JQMIGRATE: 'ready' event is deprecated 372 373 **Changed** 374 375 - Add styling for date picker, autocomplete, select2 to show in the Customizer (for MB Settings Page) 376 377 = 5.2.1 - 2019-09-26 = 378 379 **Fixed** 380 381 - Fix object fields show only selected items when field type is not select advanced 382 - Fix background field not saving position, attachment & size 383 - Fix undefined variable in media modal 384 - Fix non-unique input name for a non-cloneable file in a cloneable group 385 386 = 5.2.0 - 2019-09-18 = 387 388 **Added** 389 390 - Add ajax support for object fields. 391 - Add custom CSS class for meta box wrapper div. 392 393 **Changed** 394 395 - Improve file upload, making it works in groups. 396 - Optimize performance for cloning wysiwyg field. 397 - Bypass updates for embed extensions via TGMPA. 398 399 **Fixed** 400 401 - Fix PHP warning when using clone with date formatting. 402 - Fix file upload input not visible when clone a file field with uploaded files = max_file_uploads. 403 404 = 5.1.2 - 2019-08-29 = 405 406 **Fixed** 407 408 - Fix adding >= 2 blocks containing a wysiwyg field not rendering 409 - Fix CSS for wyswigy field in Gutenberg 410 - Do not show upgrade message in the Dashboard for premium users 411 - Fix media field is blank 412 - Fix cannot access to license page in Multisite 413 414 **Changed** 415 416 - Fire `change` and/or `mb_change` events when fields change to update custom blocks in real-time (requires [MB Blocks](https://metabox.io/plugins/mb-blocks/) extension) 417 418 = 5.1.1 - 2019-08-23 = 419 420 **Fixed** 421 422 - Fix sanitizing number always return 0 if it's blank 423 - Fix sanitizing URL 424 425 **Changed** 426 427 - Set default field 'type' to 'text', make it optional and help you write less code 428 - File/image fields: do not show add new file link if max_file_uploads = 1 429 430 = 5.1.0 - 2019-08-19 = 431 432 **Fixed** 433 434 - Fatal error with `RWMB_About::redirect()` 435 - Ensure change event fires when editors change 436 - Fix `rwmb_{$field_id}_choice_label` not working for cloneable fields 437 - Fix missing dependency (underscore) for datepicker JS 438 - Fix unindex notice for key_value field 439 - Fix alignment for video field 440 441 **Changed** 442 443 - Update notification sytem 444 - Improve sanitization for fields. See [documentation](https://docs.metabox.io/sanitization/) for details. 445 446 = 5.0.1 - 2019-07-25 = 447 448 **Fixed** 449 450 - Fix license notification always show 451 452 = 5.0.0 - 2019-07-24 = 453 454 **IMPORTANT:** Since version 5.0.0, the plugin requires PHP >= 5.3. If you use an older PHP version, please ask your host to upgrade or use an older version of Meta Box. 455 456 **Changed** 457 458 - New minimum PHP version is now 5.3. 459 - Rewrite all JavaScript to prepare for Gutenberg blocks 460 - Allow to create meta box with no fields. 461 462 **Added** 463 464 - Add the updater for auto update of premium extensions 465 - Add support for `user`, `settings_pages` in `rwmb_get_object_fields` 466 467 **Fixed** 468 469 - Fix warning for cloneable single image. 470 471 [See full changelog here](https://metabox.io/changelog/). 472 473 == Upgrade Notice == 474 475 Since version 5.0.0, the plugin requires PHP >= 5.3. If you use an older PHP version, please ask your host to upgrade or use an older version of Meta Box.