-
Notifications
You must be signed in to change notification settings - Fork 423
/
Copy pathreadme.txt
275 lines (200 loc) · 16 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
=== Meta Box ===
Contributors: elightup, metabox, rilwis, f-j-kaiser, funkatronic, PerWiklander, ruanmer, tanng
Donate link: https://metabox.io/pricing/
Tags: custom fields, custom post types, post type, custom taxonomies, meta box
Requires at least: 5.9
Requires PHP: 7.0
Tested up to: 6.7.1
Stable tag: 5.10.6
License: GPLv2 or later
Meta Box plugin is a powerful, professional developer toolkit to create custom meta boxes and custom fields for your custom post types in WordPress.
== Description ==
### WordPress custom fields plugin
[Meta Box](https://metabox.io) is a professional framework that makes building and customizing a website with dynamic data and content in WordPress fun and easy.
Meta Box helps you add [custom fields](https://metabox.io/series/custom-fields/) and dynamic data to posts, pages, custom post types, forms and anywhere you want using over 40+ different field types such as text, images, file upload, checkboxes, and more.
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.
> **Meta Box Lite**
> We recommend using [Meta Box Lite](https://metabox.io/lite/), a feature-rich free UI version of Meta Box that provides UI and all free features for managing custom fields and dynamic content on WordPress, including post types, taxonomies, custom fields, and relationships.
### Create any type of custom fields in WordPress
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.
**Here are just a few of the data types you can customize:**
- Posts
- Pages
- 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)
- [Taxonomies](https://metabox.io/plugins/mb-term-meta/)
- [Settings pages or Customizer sections](https://metabox.io/plugins/mb-settings-page/)
- [User profile pages](https://metabox.io/plugins/mb-user-profile/)
- [Post comments](https://metabox.io/plugins/mb-comment-meta/)
### A wide-range of field types and options
Take your standard WordPress custom field and imagine it infinitely expanded. That's how many options Meta Box gives you:
- Meta Box supports [40+ built-in WordPress custom field types](https://docs.metabox.io/fields/) 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.
- Not enough? You can also [effortlessly create your own field type](https://docs.metabox.io/custom-field-type/).
- 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/).
### It's developer-friendly
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.
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.
- Has an ultra-lightweight, yet powerful API that won't overload your site.
- Add only what you need instead of getting stuck with a bundle of features you don't even want that bloat your site.
- Meta Box [easily integrates with any theme and plugin](https://docs.metabox.io/integration/), and supports Composer!
- We use the [native WordPress meta data storage](https://docs.metabox.io/database/) and functions for ease of use and lightning-fast processing.
- Has a lot of [actions](https://docs.metabox.io/category/actions/) and [filters](https://docs.metabox.io/category/filters/) so you can build or change a site's appearance and behavior in the plugin.
### Don't love coding? You're in luck!
If you prefer a more visual system to create custom fields in WordPress, please use [Meta Box Lite](https://metabox.io/lite/), a feature-rich free UI version of Meta Box that provides:
- All the power of Meta Box without touching a single line of code.
- Designer-friendly, lightweight and work at top-notch speeds.
- 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.
### Free Extensions
- [MB ACF Migration](https://metabox.io/plugins/mb-acf-migration/): Migrate field groups and custom field data from Advanced Custom Fields (ACF) to Meta Box.
- [MB Comment Meta](https://metabox.io/plugins/mb-comment-meta/): Add WordPress custom fields to comments in WordPress.
- [MB Custom Post Types & Custom Taxonomies](https://metabox.io/plugins/custom-post-type/): Create and manage custom post types and taxonomies with UI.
- [MB Relationships](https://wordpress.org/plugins/mb-relationships/): Create as many connections as you want from post-to-post or page-to-page.
- [MB Rank Math](https://metabox.io/plugins/mb-rank-math/): Add content of custom fields to Rank Math Content Analysis to have better/correct SEO score.
- [MB Rest API](https://metabox.io/plugins/mb-rest-api/): Pull all meta values from posts and terms into the WP REST API responses.
- [MB Toolset Migration](https://metabox.io/plugins/mb-toolset-migration/): Migrate custom post types & taxonomies, field groups, custom field data, and relationships from Toolset to Meta Box.
- [MB Beaver Builder Integrator](https://metabox.io/plugins/meta-box-beaver-themer-integrator/): Integrates Meta Box and Beaver Themer to show custom fields on the frontend.
- [MB Elementor Integrator](https://metabox.io/plugins/mb-elementor-integrator/): Connect and display custom fields created by the Meta Box plugin in the Elementor's dynamic tags.
- [MB FacetWP Integrator](https://metabox.io/plugins/meta-box-facetwp-integrator/): Integrates Meta Box and FacetWP to make custom fields searchable and filterable.
- [MB Text Limiter](https://wordpress.org/plugins/meta-box-text-limiter/): Limit the number of characters or words entered for text and textarea fields.
- [MB Yoast SEO Integration](https://wordpress.org/plugins/meta-box-yoast-seo/): Add WordPress custom fields to Yoast SEO Content Analysis to generate more accurate SEO scores.
- [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.
### Premium Extensions
- [MB Admin Columns](https://metabox.io/plugins/mb-admin-columns/): Display WordPress custom fields in table columns in admin.
- [MB Blocks](https://metabox.io/plugins/mb-blocks/): Create custom Gutenberg blocks with PHP, using the same syntax in Meta Box.
- [MB Custom Table](https://metabox.io/plugins/mb-custom-table/): Save custom fields to custom tables instead of the default meta tables to reduce your database's size and increase its performance.
- [MB Frontend Submission](https://metabox.io/plugins/mb-frontend-submission/): Create frontend forms for users to submit posts.
- [MB Revision](https://metabox.io/plugins/mb-revision/): Track changes to custom fields in WordPress with revisions. You can compare and restore the changes smoothly.
- [MB Settings Page](https://metabox.io/plugins/mb-settings-page/): Create settings pages for themes, plugins or websites with beautiful syntax.
- [MB Term Meta](https://metabox.io/plugins/mb-term-meta/): Add custom fields to categories, tags or custom taxonomies.
- [MB User Meta](https://metabox.io/plugins/mb-user-meta/): Add custom fields to users.
- [MB Views](https://metabox.io/plugins/mb-views/): Outputting custom fields and build front-end templates for WordPress without touching theme files.
- [Meta Box Columns](https://metabox.io/plugins/meta-box-columns/): Display eye-catching custom fields in WordPress by putting them into 12-column grids.
- [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 Geolocation](https://metabox.io/plugins/meta-box-geolocation/): Automatically and instantly populate location data with the power of the Google Maps Geolocation API.
- [Meta Box Group](https://metabox.io/plugins/meta-box-group/): Create repeatable groups for better appearance and structure.
- [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.
- [Meta Box Show Hide](https://metabox.io/plugins/meta-box-show-hide-javascript/): Toggle meta boxes by page template, post format, taxonomy and category.
- [Meta Box Tabs](https://metabox.io/plugins/meta-box-tabs/): Painlessly create tabs for meta boxes with multiple styles and icons.
- [Meta Box Template](https://metabox.io/plugins/meta-box-template/): Make defining custom meta boxes and WordPress custom fields way easier with templates.
- [Meta Box Tooltip](https://metabox.io/plugins/meta-box-tooltip/): Display help information for custom fields with tooltips.
### Detailed Documentation
We provide regularly updated, and extensive [documentation](https://docs.metabox.io) as well as [tutorials](https://docs.metabox.io/tutorials/) on how to use MetaBox and custom fields in WordPress to your advantage as well as in the most efficient way possible.
Here are a few guides to quickly get you started with Meta Box and creating your own WordPress custom fields:
- [Introduction](https://docs.metabox.io/introduction/)
- [Custom post types](https://docs.metabox.io/custom-post-types/)
- [Custom fields](https://docs.metabox.io/custom-fields/)
- [Field settings](https://docs.metabox.io/field-settings/)
- [Displaying fields](https://docs.metabox.io/displaying-fields-with-code/)
### You might also like
If you like this plugin, you might also like our other WordPress products:
- [Slim SEO](https://wpslimseo.com) - A fast, lightweight and full-featured SEO plugin for WordPress with minimal configuration.
- [Slim SEO Schema](https://wpslimseo.com/products/slim-seo-schema/) - An advanced, powerful and flexible plugin to add schemas to WordPress.
- [Slim SEO Link Manager](https://wpslimseo.com/products/slim-seo-link-manager/) - Build internal link easier in WordPress with real-time reports.
- [GretaThemes](https://gretathemes.com) - Free and premium WordPress themes that clean, simple and just work.
- [Auto Listings](https://wpautolistings.com) - A car sale and dealership plugin for WordPress.
== Installation ==
We recommend using [Meta Box Lite](https://metabox.io/lite/), a feature-rich free UI version of Meta Box that provides UI and all free features for managing custom fields and dynamic content on WordPress, including post types, taxonomies, custom fields, and relationships.
To install Meta Box Lite, go to [this page](https://metabox.io/lite/) and download it.
If you want to use Meta Box, please follow these steps:
1. Visit **Plugins > Add New** inside your WordPress dashboard
1. Search for **Meta Box**
1. Click the **Install Now** button to install the plugin
1. Click the **Activate** button to activate the plugin
[Get started here](https://docs.metabox.io/introduction/).
== 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 ==
= 5.10.6 - 2025-01-11 =
- Fix validation for dash ids
- Fix datetime fields not showing inline picker inside groups
- Fix `label_description` not working for `fieldset_text`
- Fix field label div still show when no field name but with `label_description`
- Remove `image_select` field's JS, styling with CSS only
- Add gap for key value inputs
= 5.10.5 - 2024-12-16 =
- Make validation for add new terms work
- Improve styling of meta boxes on the sidebar in the block editor
- Improve style of input with prepend and append
- Fix maps/osm fields and geolocation not working with subfields in groups
- Fix select advanced becomes normal select with cloneable setting
- Fix validation
= 5.10.4 - 2024-11-20 =
- OSM/Map fields: add support for select field type
- Add `$url` to `rwmb_oembed_not_available_string` filter
- Small CSS improvements for file input, background & button group
- Fix not returning value for helper functions for images saving in a custom folder and using a custom table
= 5.10.3 - 2024-10-30 =
- fix: std after saving
- fix: field set text save empty values
- fix: subfield's id
= 5.10.2 - 2024-09-26 =
- Fix issue with conditional logic
- Fix error when removing default taxonomy meta box in the front end or with the block editor
- Fix missing .hidden on the front end for `checkbox_tree`
- Fix required attribute for `select_tree`
= 5.10.1 - 2024-09-07 =
- Fix issue with `clone_empty_start` (validation, now showing data for the 1st clone, broken `text_list` field, etc.)
= 5.10.0 - 2024-08-19 =
**Highlights:**
This version introduces new parameter for field: `clone_empty_start` that makes cloneable groups **not** showing inputs at first. When users want to enter data, they'll need to click the "+ Add new" button. This feature updates the UI and makes it cleaner.
See more details on our [blog post](https://metabox.io/clone-empty-start/).
Other changes:
- Replace `sprintf` with string concatenation in `RWMB_Field::show` to fix issues when `$field['before']` or `$field['after']` contains special characters (`%`). Props Daniel Haim.
- Fix mismatch filter params for `rwmb_meta` when no fields are found.
= 5.9.11 - 2024-07-10.0 =
- Make validation work for blocks
- Fix JavaScript validation error in site editor
- Set default minute step = 5 for datetime/time pickers
- Security fix for ajax getting posts
= 5.9.10 - 2024-07-02 =
- Fix modal not updating URL (when add new)
- Security fix for ajax get posts/users
= 5.9.9 - 2024-06-20 =
- Fix show hide checkbox tree
- Fix default value not display as selected time
- Fix datetime field not removing value when set inline & timestamp = true
= 5.9.8 - 2024-05-08 =
- Fix activation error on ajax request since WordPress 6.5
= 5.9.7 - 2024-04-18 =
- Revert fix for Meta Box Conditional Logic
= 5.9.6 - 2024-04-17 =
- Add progress bar for field `file_upload`
- Force returned value of sanitize color to string
- Enqueue assets for FSE and widget (with block editor) screens
- Fix jumping layout for Meta Box Conditional Logic
- Fix errors when using cloneable map/osm fields
= 5.9.5 - 2024-03-26 =
- Add `save_format` settings to `time` field
- Field icon SVG not displaying
= 5.9.4 - 2024-02-27 =
- Fix security issue when users set object id in the helper functions where they don't have permission to view (such as private posts)
= 5.9.3 - 2024-02-02 =
**Highlights:**
Fix security issue of the output shortcode `[rwmb_meta]` not escaping. Users can disable escaping (to revert the previous behavior) by adding this snippet:
`add_filter( 'rwmb_meta_shortcode_secure', '__return_false' );
// or
add_filter( 'rwmb_meta_shortcode_secure_{$field_id}', '__return_false' );`
Other changes:
- Fix compatibility with PHP 8.3
- Fix not showing more than 10 saved users or terms
= 5.9.2 - 2024-01-22 =
- Validation: fix PHP warning when fields has non-consecutive keys
- Icon field: fix custom icon not working
- Update jQuery Validation to 1.20.0. Props Maarten.
- Prepare css to be inlined. Props Maarten.
= 5.9.1 - 2023-12-25 =
- Fix preview posts not working in the block editor in WP 6.4.
- Icon field: allow to set relative path/URL for settings
- Icon field: add support for scanning CSS file (`icon_css` setting) and parsing CSS class
- Autocomplete field: fix not saving first value if the value is 0 (integer).
= 5.9.0 - 2023-11-22 =
**Highlights:**
Add new `icon` field type, which supports Font Awesome Free, Font Awesome Pro and custom icon set. Can be used with icon font with CSS file or with SVGs. See the [plugin docs](https://docs.metabox.io/fields/icon/) for how to use it.
The `icon` field type will be added to the new version of Meta Box Builder soon, which will allow you to configure its settings with UI.
[See full changelog here](https://metabox.io/changelog/).
== Upgrade Notice ==