Easeful Themes for ACF
| 开发者 | htmgarcia |
|---|---|
| 更新时间 | 2026年10月15日 10:44 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
the_field() calls and CSS for every layout, you pick a theme and arrange the fields on the field group's own edit screen, then render it anywhere with a shortcode or a single function call.
A theme is a set of design settings — spacing, borders, corner radius, shadow, text size, label style and colors. Start from a built-in theme or create your own under ACF → Themes, with a live preview as you adjust it.
Features
- Theme editor — under ACF → Themes: create, edit, duplicate and delete themes, with a live preview on sample content (every field type) or on one of your own field groups.
- Four built-in themes — Classic (light cards), Minimal (flat, bordered), Plain (no cards, just the fields and the space between them) and Midnight (dark). Duplicate one to make your own version.
- Per-group theme picker — in a new Design tab on the ACF field group edit screen.
- Per-field width — full, half, third or quarter of the row, no CSS required.
- Drag-and-drop field order — decide which fields show on the front end, in what order, and how wide each one is.
- Automatic display — add a group to any post matching its Location rules with no shortcode: before the content, after it, or between your fields, with the post content itself dragged into whatever spot in the field order you like (plain, or in a card like the fields around it).
- Theme-overridable templates — copy any template into your active theme to fully customize the markup, the same pattern used by WooCommerce.
- Works with ACF (free) and ACF PRO, including repeater, group and flexible content fields.
[easeful_themes_for_acf]shortcode andeaseful_themes_for_acf_the_group()/easeful_themes_for_acf_get_group()template tags.- No external requests, no CDN assets — everything ships with the plugin.
- Install and activate Easeful Themes for ACF alongside Advanced Custom Fields.
- Edit any ACF field group. A new Design tab appears in its Settings box.
- Choose a theme, and drag fields into the order you want — set each field's width and toggle any field off if you don't want it on the front end.
- To change how a theme looks, go to ACF → Themes. Built-in themes are read-only: duplicate one, adjust it with the live preview, and save.
- Render the group wherever you like:
[easeful_themes_for_acf group="group_xxxxxxxxxxxxx"]
or in a template file:
<?php easeful_themes_for_acf_the_group( 'group_xxxxxxxxxxxxx' ); ?>
If no post / post_id is supplied, the current post in the loop is used. Add theme="..." with a theme's key (shown on the Themes screen, e.g. minimal) to render with a different theme than the group's own.
Documentation
Step-by-step guides with screenshots, from picking a theme to customizing the markup, are in the Easeful Themes for ACF documentation. Most questions are answered there, so please check it before opening a support topic.
安装:
- Make sure Advanced Custom Fields (or ACF PRO) is installed and active.
- Upload the
easeful-themes-for-acffolder to/wp-content/plugins/, or install it through the Plugins screen in WordPress. - Activate Easeful Themes for ACF through the Plugins screen.
- Edit an ACF field group and pick its theme in the Design tab of its Settings box. Create or edit themes under ACF → Themes.
屏幕截图:
常见问题:
Does this work without Advanced Custom Fields?
No. Easeful Themes for ACF is an add-on for ACF and requires ACF (free) or ACF PRO to be installed and active. It will show an admin notice and stay dormant if ACF is missing.
Does this work with ACF field groups stored as local JSON or registered in PHP?
Rendering works for any field group ACF can resolve by its group key. The Design tab (theme and field order) appears on the field group's edit screen, which requires the group to exist in the database (ACF's normal "sync" step for JSON/PHP-registered groups).
Will this add unused CSS to my site?
One small stylesheet (a few KB), scoped to the plugin's own easeful-themes-for-acf classes so it never touches the rest of your page, plus one line of CSS variables per theme. Both load on every front-end page rather than only where a group is rendered, since a themed group can appear from a template tag as well as a shortcode and there's no reliable way to know in advance which pages will use one.
Can I customize the markup?
Yes. Copy any file from wp-content/plugins/easeful-themes-for-acf/templates/ into wp-content/themes/your-theme/easeful-themes-for-acf/ (keeping the same sub-folders) and edit it — your copy takes priority automatically, whichever theme a group uses. Style your markup with the plugin's CSS variables (e.g. var(--etfa-radius)) so it still follows the theme settings.
Rendered markup is escaped with the same tags and attributes WordPress allows in post content, plus <iframe> for embeds. If your copy outputs something beyond that — a <form>, inline SVG — allow it with the easeful_themes_for_acf_allowed_html filter, which receives and returns a wp_kses() allowed-HTML array:
add_filter( 'easeful_themes_for_acf_allowed_html', function ( $allowed ) { $allowed['form'] = array( 'action' => true, 'method' => true ); $allowed['input'] = array( 'type' => true, 'name' => true, 'value' => true ); return $allowed; } );
Does uninstalling the plugin delete my settings?
No. Easeful Themes for ACF never deletes your themes or field group designs (theme choice, field order) when you uninstall it. Deactivating, deleting, or reinstalling the plugin leaves everything exactly as you configured it.
Where can I get help?
Start with the documentation: its step-by-step guides cover setting up a field group, themes, layouts, automatic display and customizing the markup. If your question isn't answered there, open a topic in the plugin's support forum on WordPress.org.
更新日志:
- Initial release: theme editor with live preview and four built-in themes, field group Design tab, drag-and-drop field order, automatic display, shortcode and template tags.