Raeen Repeater Field for ACF
| 开发者 | moha12351 |
|---|---|
| 更新时间 | 2026年8月15日 02:42 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Raeen Repeater Field for ACF adds a native-feeling Repeater field type to the free version of Advanced Custom Fields (ACF). It stores data in the same flat postmeta format used by ACF Pro, so all standard template functions work out of the box.
Key Features:
- Three Layout Modes: Table, Block (card), and Row (stacked) layouts
- Drag & Drop Reordering: Intuitive row sorting powered by jQuery UI Sortable
- Row Operations: Add, remove, duplicate rows
- All ACF Free field types: Text, Textarea, Number, Email, URL, Image, File, WYSIWYG, Select, Radio, Checkbox, True/False, Date Picker, Color Picker, Link, and more
- Nested Repeaters: Repeater fields can contain other repeater fields
- get_field() compatible: Uses ACF Pro-compatible flat meta storage —
get_field(),have_rows(),the_row(), andget_sub_field()all work natively - ACF JSON Sync: Full compatibility with ACF's field group JSON export/import
- REST API Support: Exposes repeater data through the WordPress REST API
- Gutenberg & Classic Editor: Works in both editors
- Multisite Compatible: Network activatable
- Internationalization Ready: Full translation support (text domain:
raeen-repeater-field-for-acf) - Accessibility Ready: Proper ARIA labels and keyboard support
{field_name}→ row count (integer){field_name}_{i}_{sub_field_name}→ sub-field value for rowi_{field_name}_{i}_{sub_field_name}→ sub-field key reference
安装:
- Make sure Advanced Custom Fields (free, version 5.8+) is installed and activated.
- Upload the
raeen-repeater-field-for-acffolder to/wp-content/plugins/. - Activate the plugin through the Plugins menu in WordPress.
- Go to Custom Fields → Field Groups, edit a field group, and add a new Repeater field (under the Layout category).
- Add sub-fields to the repeater and save.
屏幕截图:
常见问题:
Does this require ACF Pro?
No. This plugin works exclusively with the free version of Advanced Custom Fields (5.8+). If ACF Pro is active, this plugin automatically defers to Pro's built-in repeater.
Will it conflict with ACF Pro?
No. If ACF Pro is detected (ACF_PRO constant is defined), the plugin disables itself and lets Pro handle the repeater field natively.
Can I nest repeaters?
Yes. Repeater fields can contain other repeater fields as sub-fields, with full drag-and-drop and all row operations.
Does get_field() work?
Yes. Data is stored in the same flat postmeta format as ACF Pro, so get_field(), have_rows(), the_row(), and get_sub_field() all work without any code changes.
Is it compatible with ACF JSON sync?
Yes. Full support for ACF's field group JSON export, import, and auto-sync.
What WYSIWYG / rich field support is there?
The plugin automatically detects rich field types (WYSIWYG, Gallery, etc.) and switches to the stacked Row layout to prevent display issues. TinyMCE editors are properly initialized, duplicated, and cleaned up when rows are added, duplicated, or removed.
更新日志:
1.0.3 - August 15, 2026
- Compliance: Resolved WordPress.org Guideline 4 compliance by providing detailed public repository documentation, build instructions, and embedding license & source file banners into all compiled JavaScript and CSS assets.
- Compliance: Corrected GitHub repository link to point to https://github.com/raeenzubair/repeater-field-for-acf.
- Enhancement: Standardized text domain to
raeen-repeater-field-for-acfacross all plugin headers and translation functions. - Fix: Updated PHPUnit test suite namespaces to
Raeen_Repeater\Testsand added standalone polyfills for local and CI testing. - Build: Updated Vite build pipeline to automatically prepend source metadata banners to generated distribution assets in
assets/dist/.
- Fix: Resolved fatal autoloader exception by explicitly loading built-in PSR-4 autoloader.
- Fix: Resolved duplicate field registration causing repeater field to render multiple times on edit screens.
- Fix: Resolved nested repeater add-row functionality by scoping clone template lookups and index replacements to parent repeaters.
- Fix: Resolved drag handle UI overlap with row numbers by increasing left column width.
- Enhancement: Enqueued frontend stylesheet for full acf_form() compatibility.
- Enhancement: Updated WordPress.org branding assets with animated GIF logo.
- Enhancement: Updated plugin display name to "Raeen Repeater Field for ACF" and text domain to repeater-field-for-acf to match WordPress.org plugin slug.
- Enhancement: Refactored code namespaces to Raeen_Repeater to prevent conflicts.
- Security: Hardened AJAX input handling and added strict nonce verification.
- Documentation: Documented open source repository and build instructions in readme.txt.
- Enhancement: Added full branding assets including logo, banner, screenshots, and GIF demo.
- Feature: Initial release of Repeater field for free Advanced Custom Fields (ACF 5.8+).
- Feature: Added three layout modes: Table, Block (card), and Row (stacked).
- Feature: Added drag-and-drop row sorting powered by jQuery UI Sortable.
- Feature: Added row operations (add, remove, duplicate, collapse/expand).
- Feature: Added WYSIWYG / TinyMCE editor support with automatic lifecycle management.
- Feature: ACF Pro-compatible flat meta storage (get_field, have_rows, the_row, get_sub_field).
- Feature: Added REST API endpoint integration.
- Feature: Added ACF JSON/PHP export and auto-sync support.
- Feature: Added nested repeater support and multisite compatibility.