Title: Liuer Box
Author: liuer
Published: July 22, 2026
Last modified: July 22, 2026
---
Search plugins
# Liuer Box
By [liuer](https://profiles.wordpress.org/liuer/)
[Download](https://downloads.wordpress.org/plugin/liuer-box.1.0.0.zip)
* [Details](https://wordpress.org/plugins/liuer-box/#description)
* [Reviews](https://wordpress.org/plugins/liuer-box/#reviews)
* [Installation](https://wordpress.org/plugins/liuer-box/#installation)
* [Development](https://wordpress.org/plugins/liuer-box/#developers)
[Support](https://wordpress.org/support/plugin/liuer-box/)
## Description
Liuer Box lets you build custom fields for WordPress with a visual field-group builder,
while keeping data stored cleanly in native post/term/user meta and options.
* **Visual builder** — create Field Groups, add fields, drag to reorder, choose
where they appear. No code required.
* **Clean, native storage** — single fields are stored in one native meta row;
complex fields (repeater / gallery / link) are stored as a single JSON row instead
of many rows; global options are consolidated into a single `liuer_box_options`
row. Your database stays small.
* **22 field types** — text, textarea, number, email, url, password, range, select,
checkbox, radio, button group, true/false, WYSIWYG, image, gallery, file, oEmbed,
color, link, date/time, **post object** (pick one or more posts of a chosen post
type), and a nested **Repeater**, plus Tab and Message layout fields.
* **Locations** — Options Pages, Post types (meta boxes), Taxonomy terms, User
profiles, and Page Templates.
* **Repeater with nesting** — drag-sort rows, collapse, min/max, dynamic row labels,
repeaters inside repeaters.
* **Conditional logic** — show/hide a field based on another field’s value, evaluated
both client-side and server-side.
* **Field width & tabs** — lay fields out in columns and group them into tabs.
* **Multilingual ready** — per-post/term/user fields follow translations naturally;
global option fields can use language-scoped values for Polylang/WPML, with Polylang
string registration when available.
* **Developer friendly** — read values with `liuer_option()`, `liuer_field()`, `
liuer_term()`, `liuer_user()`; write them with `liuer_update_field()`, `liuer_update_term()`,`
liuer_update_user()`, `liuer_update_option()`; register groups in code with `
liuer_box_register()`.
#### Reading values in your theme
The getters return RAW values (use them for logic, arrays, attachment IDs and HTML
fields). Always escape on output:
```
$accent = liuer_option( 'accent' ); // Options page value
$logo = liuer_field( 'logo', null, $post_id ); // Post meta value (attachment ID)
$color = liuer_term( 'color', $term_id ); // Term meta value
$phone = liuer_user( 'phone', $user_id ); // User meta value
echo esc_html( liuer_field( 'subtitle' ) );
echo wp_get_attachment_image( liuer_field( 'logo' ), 'large' );
foreach ( (array) liuer_field( 'slides' ) as $row ) {
echo esc_html( $row['title'] );
}
```
#### Writing values from code
Setters mirror the getters and store in the same native format (arrays become one
JSON row). They store the value AS GIVEN, so sanitize your input first:
```
liuer_update_field( 'subtitle', sanitize_text_field( $text ), $post_id ); // post meta
liuer_update_field( 'logo', absint( $attachment_id ) ); // current post
liuer_update_field( 'slides', array( // array -> JSON row
array( 'title' => 'One' ),
array( 'title' => 'Two' ),
), $post_id );
liuer_update_term( 'color', '#025098', $term_id ); // term meta
liuer_update_user( 'phone', $phone, $user_id ); // user meta
liuer_update_option( 'accent', '#2271b1' ); // options page
```
#### Safe output helpers (auto-escaping)
Optional convenience helpers that echo already-escaped output, so you don’t have
to remember the right escaper:
```
liuer_e( 'subtitle' ); // echo esc_html() of a post field
liuer_attr_e( 'data_id' ); // echo esc_attr()
liuer_url_e( 'website' ); // echo esc_url()
liuer_img( 'logo', 'large' ); // echo a safe ![]()
from an attachment ID
liuer_wysiwyg( 'about' ); // echo with WordPress content filters
liuer_option_e( 'tagline' ); // same family for options
liuer_option_attr_e( 'accent' );
liuer_option_url_e( 'fanpage' );
liuer_option_img( 'logo', 'medium' );
```
## Installation
1. Upload the `liuer-box` folder to `/wp-content/plugins/`, or install the plugin
through the Plugins screen.
2. Activate the plugin through the **Plugins** screen.
3. Go to **Liuer Box Options Pages** to create an options page (optional), then **
Liuer Box Field Groups Add Group** to build your fields and choose where they
appear.
## FAQ
### Does it require any other plugin?
No. Liuer Box has zero plugin dependencies. It only uses WordPress core APIs plus
the bundled jQuery, wp.media and the WP color picker.
### Where is the data stored?
Schema (field definitions) live in a single option. Field values are stored natively:
single values as one post/term/user meta row; complex values (repeater, gallery,
link) as a single JSON meta row; global options consolidated into one `liuer_box_options`
row.
### Is it translation ready?
Yes. Per-object fields follow the translation of their post/term/user. Global option
fields can be marked “translatable” for Polylang/WPML language-scoped values, with
Polylang string registration when available.
### What happens to my data when I delete the plugin?
Data is intentionally preserved on uninstall so you don’t lose content if you reinstall.
## Reviews
There are no reviews for this plugin.
## Contributors & Developers
“Liuer Box” is open source software. The following people have contributed to this
plugin.
Contributors
* [ liuer ](https://profiles.wordpress.org/liuer/)
[Translate “Liuer Box” into your language.](https://translate.wordpress.org/projects/wp-plugins/liuer-box)
### Interested in development?
[Browse the code](https://plugins.trac.wordpress.org/browser/liuer-box/), check
out the [SVN repository](https://plugins.svn.wordpress.org/liuer-box/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/liuer-box/) by [RSS](https://plugins.trac.wordpress.org/log/liuer-box/?limit=100&mode=stop_on_copy&format=rss).
## Changelog
#### 1.0.0
* Initial release.
## Meta
* Version **1.0.0**
* Last updated **2 days ago**
* Active installations **Fewer than 10**
* WordPress version ** 6.0 or higher **
* Tested up to **7.0.2**
* PHP version ** 7.4 or higher **
* Tags
* [custom fields](https://wordpress.org/plugins/tags/custom-fields/)[Custom Meta](https://wordpress.org/plugins/tags/custom-meta/)
[meta box](https://wordpress.org/plugins/tags/meta-box/)[options page](https://wordpress.org/plugins/tags/options-page/)
[repeater](https://wordpress.org/plugins/tags/repeater/)
* [Advanced View](https://wordpress.org/plugins/liuer-box/advanced/)
## Ratings
No reviews have been submitted yet.
[Your review](https://wordpress.org/support/plugin/liuer-box/reviews/#new-post)
[See all reviews](https://wordpress.org/support/plugin/liuer-box/reviews/)
## Contributors
* [ liuer ](https://profiles.wordpress.org/liuer/)
## Support
Got something to say? Need help?
[View support forum](https://wordpress.org/support/plugin/liuer-box/)