This ‘glue’ plugin makes it easier to translate with WPML content provided in fields created with Advanced Custom Fields.
See full descriptionVersion 2.1.5
Features
- Integrated the new features from WPML 4.7 (Advanced Translation Editor job layout, Translation Dashboard).
- Refactored the modals for translating field group labels.
- Implemented a fix to stop attaching untranslated field group labels to the first post translation job.
Fixes
- Fixed an issue where the taxonomy fields set to copy were not adjusting their values for translations.
- Fixed a bug preventing conversion of links inside repeaters.
- Fixed a bug preventing conversion of taxonomy fields under terms.
- Fixed an issue with the restriction for relationship and taxonomy fields targeting types set to display as translated when editing a translation using the native post editor.
- Fixed an issue with the spacing for links in Right-To-Left languages in the Edit Taxonomy screen.
Version 2.1.5-rc.1
No changes in relation to ACF Multilingual Beta 2
See changelog for ACF Multilingual 2.1.5 Beta 2
Version 2.1.5-b.2
Changes in relation to beta 1
- Internal links to the Translation Dashboard should open the right section.
- Fixed the taxonomy fields set to copy not adjusting their values for translations.
Version 2.1.5-b.1
Usability
- Integrated with the new Translation Management Dashboard.
- Refactored the modals for translating field group labels.
Fixes
- Fixed a bug preventing conversion of links inside Repeater fields.
- Fixed a bug with converting taxonomy fields under terms.
- Fixed grouping in the Advanced Translation Editor (ATE) for subfields that contain dashes in the name.
- Fixed the restriction for relationship and taxonomy fields targeting types set to display as translated when editing a translation using the native post editor.
- Fixed spacing for links on the Edit Taxonomy screen.
- [Performance] Skipped the fields and field groups translation on REST requests.
Version 2.1.4.2
- Fixed a fatal error introduced in ACFML 2.1.4 that occurred between ACF Pro and the ACF Extended add-on.
Version 2.1.4.1
- Fixed a fatal error introduced in ACFML 2.1.4 that occurred when adding fields to menu items in a menu containing a language switcher.
Version 2.1.4
- Introduced a new filter hook, acfml_should_translate_acf_entity, to skip translating field groups.
- Improved the format of ACF raw values written to translated posts.
- Improved the grouping of Flexible and Repeater fields in the new Advanced Translation Editor (ATE Gen 3).
- Fixed a fatal error caused by ACF fields that contain `NULL` or `NULL[]`.
- Fixed a compatibility issue with the ACF Extended preview feature.
- Fixed errors when registering string packages if the WPML setup is not complete.
- Fixed a bug in Option page detection when using a custom post_id
- Fixed a fatal error when calculating the hash for a field group with a Google Map field.
- [PHP 8.1+] Fixed a potential fatal error when synchronizing Repeater fields.
Version 2.1.3
- Fail gracefully when attempting to translate object labels without the expected data.
- Fixed a PHP «Deprecated: Using ${var} in strings is deprecated» notice in PHP 8.2.
- Ensure that translated posts retain the «post object» custom field format consistent with the original post.
- Added configuration for the new «Icon Picker» field type in ACF 6.3.
Version 2.1.2
- Fixed a bug in calculating the hash for a Repeater field with Post Object or True/False subfields.
Version 2.1.1
- Fixed a fatal error introduced in ACFML 2.1.0 that occurred when displaying an ACF form on the front-end.
Version 2.1.0
Features
- Enabled translation for labels of custom post types and custom taxonomies.
- Enabled translation for labels on Options Pages.
- Locked internal post types that store data for ACF custom objects as «Not translatable».
- Added display of translation settings and status for custom objects created with ACF during editing.
- Prepared translation jobs for grouping in the next Advanced Translation Editor (ATE) release.
- Provided meaningful descriptions for ACF entity labels in ATE.
- Added support to automatically convert target links in WYSIWYG fields.
Fixes
- Improved performance on Options pages for sites with multiple field groups.
- Fixed admin notice regarding mixed translation modes on field groups assigned to native posts.
- Fixed the management of relational fields assigned to taxonomy terms and set to be copied to translations.
- Resolved a fatal error in admin notices when ACF is deactivated.
- Addressed an issue where ACFML, in combination with other plugins, could prevent content from displaying on the blog reader’s screen.
- Fixed the saving of multiple blocks with clone fields set to seamless display mode.
- Fixed a potential fatal error when the user modifies the PHP code to add Choice groups.
- Fixed a bug in reordering Repeater fields on translations and adding items in the middle.
- Fixed incorrect data type in the database when converting single ID fields.
- Resolved a PHP warning on the translated options page containing a Flexible field set to Copy.
- Fixed a rare error in ACF → Field Groups → Edit Field Group → Settings → Location Rules where the selected value for «Forms/Attachment» was lost.
- Fixed a rare issue in WPML → Settings → Custom Fields Translation where it attempted to locate a non-existent element in ACF.
- Added the missing translation support for the Repeater button label.
- Fixed the UI field locks not properly showing for sub-fields on Options page.
Version 2.0.5
- Fixed an issue with saving a post in the secondary language when having a repeater field with minimum rows validation set to 1.
- Fixed a bug with copying a gallery field when duplicating a post.
- Fixed a problem with synchronizing repeater fields on the options page when using taxonomy terms as IDs in the repeater field.
- Fixed an issue where a translatable field inside a «group» field set to copy would become locked even though it shouldn’t.
Version 2.0.4
Release notes
- Introduced the constant ACFML_EXCLUDE_FIELD_GROUP_STRINGS_IN_POST_JOBS.
- Improved the field group multilingual mode rendering for right-to-left (RTL) languages.
- Fixed a malformed translation file for French.
- Fixed an issue with custom code when field choices are defined by another field.
- Fixed the label display for required fields when it’s locked.
- Fixed a fatal error in Options page when using taxonomy term as object in single select field.
- Fixed a performance issue due to strings being repeatedly registered.
- Fixed the display of repeater fields when translating via the native editor, and acf-field-group is set to Translatable using the Expert mode.
Version 2.0.3
- Fixed an issue with a custom field displayed twice in the native WordPress editor when the «acf-field-group» post type is made translatable (and field groups are translated).
Version 2.0.2
- Fixed a bug with the taxonomy field not showing the terms in the native WordPress editor.
- Improved the migration command so it sets the «Expert» mode for inactive field groups.
Version 2.0.1
- Improved the migration process that happens when updating ACF Multilingual to version 2.0+ so that now, it skips setting the translation option for field groups with invalid IDs.
Version 2.0.0
Features
- Introduced a new field group multilingual mode to automatically preset field preferences.
- Added a notice to ask the admin to set the translation mode for his existing field groups on plugin activation.
- Added support for the new field group translation modes in local JSON files.
- Added the option for disabling WPML’s Advanced Translation Editor for posts with groups that have different fields per language.
- Added an automatic switch that enables or disables the repeater field sync feature based on the selected field group mode.
- Added the possibility to translate field group labels and field choices using WPML String Translation.
- Added a feature that includes untranslated field group strings in the first post translation job.
- Added a feature that locks field preferences on the WPML Settings page if they’re controlled by the field group mode.
- Added a check that locks ACF’s «acf-field-group» custom post type when it’s «not translatable» (recommended) and is not unlocked.
- Added a recommendation to make the «acf-field-group» custom post type not translatable if it already is set as translatable and not all groups are translated.
- Added a feature that makes sure that fields set to «Copy» are now pre-filled when creating a new translation with the native WordPress editor.
- Fields set to «Copy» are now read-only when editing a post translation using the native WordPress editor.
- Added a new section for the repeater synchronisation checkbox in the field group settings.
Fixes
- Once a custom field translation preference is changed, WPML will recalculate the translation status for all posts using this field.
- Fixed a bug related to synchronizing repeaters on the Options page when using checkboxes inside repeaters.
- Fixed a bug related to synchronizing repeaters on options pages.
- Fixed an issue with the Options pages when language code has more than two characters like «pt-br», for example.
- Fixed a bug that occurred when saving options and having several admin tabs open in different languages.
- Fixed a bug that occurred when single value in a gallery caused data to be corrupted in the translated languages for which the value should be copied.
- Fixed a bug where fields would not render on the front-end for translated post if the original post does not have any fields.
- Fixed an offset warning and an error on the ACF options page when there was only one language.
Misc
- Handled PHP 8.1 deprecation notices.
- Added interface translations for strings in German, Spanish, Italian, French, Dutch, Polish, Swedish, Japanese, Hebrew, Greek, Chinese, Portuguese.
- Changed the icon and tooltip text on the Field Group edit screen.
- Removed the tip to set the repeater field as «copy-once».
- Improved the description of the auto-scanning feature for ACF JSON field groups.
- [Expert Mode] When a field’s custom preference is not set, it will be set as «Do not translate» by default.
- Fixed the ACF Multilingual activation to make sure it is not displayed if ACF is inactive.
Version 2.0.0-rc.1
Features
- Introduced the field group multilingual mode to automatically preset field preferences.
- Added a new prompt for the admin to set the translation mode for their existing field groups on plugin activation.
- Added support for field group translation modes in local JSON files.
- Disable WPML’s Advanced Translation Editor for posts with groups that have different fields per language.
- Enable/disable the repeater field sync feature based on the field group mode.
- Added the possibility to translate field group labels and field choices using the WPML String Translation.
- Untranslated field group strings are now included in the first post translation job.
- Field preferences in WPML > Settings are now locked if it’s controlled by the field group mode.
- The «acf-field-group» custom post type is now locked when its translation setting is set to «not translatable» (recommended) and not unlocked.
- Added a recommendation to make the «acf-field-group» custom post type not translatable when it’s already translatable and not all groups are translated.
- Fields set to «copy» are now pre-filled when creating a new translation using the native WordPress editor.
- Fields set to «copy» are now read-only when editing a post translation using the native WordPress editor.
- The repeater synchronization checkbox is now displayed in its own section.
Fixes
- Once a custom field translation preference is changed, WPML will recalculate the translation status for all posts using this field.
- Fixed a bug synchronizing repeaters on options pages when using checkboxes inside repeaters.
- Fixed a bug synchronizing repeaters on options pages.
- Fixed an issue with options pages when language code has more than two characters like «pt-br».
- Fixed a bug when saving options and having several admin tabs open in different languages.
- Fixed a bug where a single value in a gallery causes data to be corrupted in the translated languages where the value is copied.
- Fixed a bug where fields do not render on the front-end for the translated post when the original post does not have any fields.
- Fixed an offset warning and error on the ACF options page when there is only one language.
Misc
- Handled PHP 8.1 deprecation notices.
- Added translations for strings in German, Spanish, Italian, French, Dutch, Polish, Swedish, Japanese, Hebrew, Greek, Chinese, and Portuguese.
- Changed the icon and tooltip text on the Field Group edit screen.
- Removed the tip to set the repeater field as «copy-once».
- Improved the description of the auto-scanning feature for ACF JSON field groups.
- [Legacy Mode] When a field’s custom preference is not set, it will be set to «do not translate» by default.
- Fixed an issue with displaying ACFML activation notice if ACF is inactive.
Version 2.0.0-beta1
Features
- Allow easy translation of field group labels and field choices with WPML String Translation
- Include untranslated field group strings in the first post translation job.
- Introducing a new field group mode selection to automatically preset field translation preferences.
- Lock field preferences on the WPML Settings page if it’s controlled by the field group mode.
- Lock the «acf-field-group» custom post type when it’s set to be «not translatable» (which is recommended) and is not unlocked.
Misc
- Handled PHP 8.1 deprecation notices.
- Changed the icon and tooltip text in Field Group edit screen.
- Removed the tip to set the repeater field as «copy-once».
Version 1.10.4
- Added support for ACF blocks registered with a custom namespace
- Updated hint messages on different admin screens in the interface
- [ACF 6.0] Fixed an issue where the field translation preference setting was showing twice when changing the type
- Added a notice with a documentation link when the plugin is activated
Version 1.10.3
Fixes
- Fixed a fatal error when saving an options page with a repeater field and a post object subfield.
Version 1.10.2
Fixes
- Fixed a bug related to synchronizing field preferences when updating them from the WPML → Settings page.
- Fixed a warning when saving Options pages with a group field.
Version 1.10.1
- Fixed an issue with duplicating a field group that contains a repeater field.
Version 1.10.0
Features:
- Added support for themes that include ACF.
- Added support for ACF Blocks with nested repeaters.
- Added a warning for untranslated field groups.
- Disabled the ability to edit fields set to Copy in the Options pages.
- Introduced an option in ACF settings to enable/disable automatic scanning of JSON files.
- Introduced a constant to disable repeater field order synchronization by default.
- Disabled the Advanced Translation Editor for ACF field groups.
- Added the ability to synchronize repeater fields in the Options pages.
Fixes:
- Fixed an issue with the field group edit section disappearing when revisiting the child page edit screen.
- Fixed an issue with checkboxes not being correctly disabled or not present in the taxonomy edit section.
- Added the checkbox to synchronize the order of translations for flexible fields.
- Rephrased the label for the option to synchronize order of translations with default language.
- Fixed an issue where widget fields do not appear on the secondary language.
Version 1.9.5
- Fixed and issue with missing attachment IDs in the Classic Translation Editor.
Version 1.9.4
Fixes
- Added possibility to stop scanning local fields for translation preferences (add
define( 'ACFML_SCAN_LOCAL_FIELDS', false );
into wp-config.php).
Version 1.9.3
Bug Fixes:
- Fixed an issue with the acf_form() function not creating new posts in secondary languages.
- Fixed a performance issue when importing from JSON file fields with preference set to Do nothing.
- Fixed an issue with field values missing when used in Elementor shortcodes.
Version 1.9.2
- Fixed database performance issues when site uses a field locally stored in JSON file.
Version 1.9.1
Fixes
- Fixed issues with null values in fields belonging to user profiles and taxonomies.
- Fixed issues with missing field values associated with taxonomy terms.
- Fixed issues with missing user field values in secondary languages.
- Fixed PHP notice about missing wpml_cf_preferences.
Version 1.9.0
Features
- Added synchronization for field translation preferences imported from PHP code.
- Added support for Repeater fields set to Copy on Options pages.
- Set default translation preferences for a new field to Copy.
- Added the ability to handle language information when exporting/importing field groups with JSON and PHP export/import tools.
- Added a check for WPML dependency.
Bug Fixes
- Fixed an issue with field group not displaying on a translated page when display rule uses page parent.
- Fields in Gutenberg block set to Copy once are no longer sent to translation with the Advanced Translation Editor.
- Enabled multilingual ACF option values for Option pages registered with custom post ID.
- Fixed link field translation when post has been translated with a Translation Service.
- Updated performance for custom field data synchronization between languages.
- Fixed an issue with copying field value every time when set to Copy Once but user wants to empty translated value.
- Field group display rules are checked now if user chooses not only original post, but also one of its translations.
Version 1.9.0-b.1
Features
- When exporting and importing fields between JSON and PHP, it is language aware: if field groups are set as a translatable post type, the data is exported with language information. When importing again, it is imported with the correct language as well.
- When exporting and importing fields between JSON and PHP, the fields maintain their associated translation preferences.
Fixes
- Added improvements for handling translation preferences in compounded field types (repeater field, flexible field): now default translation preference is Copy once.
- Fixed issues with translation preferences for fields in Gutenberg Blocks.
Version 1.8.2
- Changed suggested translation preference for Repeater and Flexible fields to Copy Once to avoid issues with disappearing or emptied subfields.
Version 1.8.1
- Fixed an issue with field values missing in the front-end when the field group is set as Translatable and consists of multiple fields, including media fields.
- Fixed an issue with translation preferences being ignored for strings in blocks when the post is being updated.
Version 1.8.0
Features
- Better recognition of active ACF plugin and of ACF loaded as the theme and other plugins library.
- Translated posts are no longer marked as needing an update when the author only shuffled repeater subfields.
- Translation preferences are applied to the fields in ACF Gutenberg Blocks.
Bugs
- Fixed overwriting ACF block translation when post ID is not set.
- Fixed fatal error with ACF Custom Database Tables extension.
- Fixed issue with field translation preferences not synchronizing when set to Don’t translate.
- Fixed issue with redirecting to Advanced Translation Editor when debugging is enabled.
- Support for Translation Preferences for strings inside repeater fields when used in ACF Blocks.
- Added migration for ACF Gutenberg Blocks strings settings between 1.7 and 1.8 version.
- Better handling for string types in ACF Blocks when displaying UI for translation in Translation Editor.
- ACF block strings can be registered now based on $_GET[‘trid’] value.
- Fixed PHP notices when downloading XLIFF translation job file.
- Values in link field type are converted to point to translated pages and posts.
- Fixed issue with field labels not displaying on the front-end when field groups are set as a Translatable post type.
Version 1.8.0-b.3
Features
- Improved recognition of the ACF plugin as active and loaded in the theme and other plugins library.
- Translated posts are no longer marked as needing update when the author only shuffled repeater subfields.
- Translation preferences are applied to the fields in ACF Gutenberg Blocks.
Bugs
- Fixed overwriting ACF block translation when post ID is not set.
- Fixed fatal error with ACF Custom Database Tables extension.
- Fixed issue with field translation preferences not synchronizing when set to Don’t translate.
- Fixed an issue with redirecting to Advanced Translation Editor when debugging is enabled.
- Added support for Translation Preferences for strings inside repeater fields when used in ACF Blocks.
- Added migration for ACF Gutenberg Blocks strings settings between 1.7 and 1.8 version.
- Improved handling of string types in ACF Blocks when displaying UI for translation in Translation Editor.
- Added ability to register ACF block strings based on $_GET[‘trid’] value.
- Fixed PHP notices when downloading XLIFF translation job file.
- Converted values in link field type to point to translated pages and posts.
- Fixed an issue with field labels not displaying in the front-end when field groups are set as a translatable post type.
Version 1.8.0-b.2
Fixes
- Added support for Translation Preferences for strings inside repeater fields when used in ACF Blocks.
Version 1.7.5
Fixes
- Reverted undue fixes from 1.7.4.
Version 1.7.4
Features
- Compatibilty with WordPress 5.6.
Version 1.7.4-b.1
Features
- Compatibilty with WordPress 5.6.
Version 1.8.0-b.1
Fixes
- Improved the ability to recognize if the ACF plugin is active and if ACF is included in a theme or another plugin’s library.
- Added the ability to apply translation preferences to the fields in ACF Gutenberg Blocks.
Version 1.7.3
- Fixed an issue with overwriting translation preferences for repeater fields when preferences were set on the post edit screen.
Version 1.7.2
- Removed field hints when field is displayed somewhere other than the Field Group editing screen.
- Checkbox to synchronize repeater subfields is now only displayed when a post has a repeater field.
- Translation preferences for flexible and repeater fields are visible again.
- Repeater synchronization checkbox state is saved and remains in that state after the next page load.
Version 1.7.1
- Fixed an issue where empty values are not changed into null for the Group field type.
Version 1.7.0
Features
- Repeater and flexible fields translation preferences are always set to Copy to ensure correct field handling during the translation.
- Synchronization for reordered fields runs explicitly on editors’ demand after selecting the checkbox to do so.
- Added support for compound field types used in ACF Gutenberg Blocks.
Fixes
- Fixed an issue with non-updated IDs in object fields during the translation with Translation Editors.
- Fixed a PHP notice when updating ACF options page fields without translation preferences set.
- Updated subfields’ translation preferences to respect the repeater field on ACF options pages.
- Fixed the PHP notice when trying to edit the ACF Options page and translation preferences are not set.
- Stopped displaying original fields value hint for repeater fields.
- Fixed an issue with an uncopied field’s values when fields are set to Copy Once.
Compatibility
- ACF Options Pages: updated relationship fields to store the relation to the object in the correct language.
Version 1.6.1
- Fixed an issue where copying a value between ACF fields in one post changed the values in the translated post into a JSON-like string.
Version 1.6.0
Features
- You can now copy custom field values associated with media.
- Hardened the data checking for synchronizing custom fields translation preferences, which prevents from running the check when the field object doesn’t have a correct field ID.
- Added support for translation preferences for fields associated with taxonomy terms.
- Added the ability to translate and display more than one ACF block.
- Added support for field translation preferences on the ACF Options Pages.
Fixes
- Improved the logic that checks whether to display a warning about not saved field translation preferences.
- Fixed a fatal error when WPML is not active.
- Fixed relationship fields not copying to translation when there are more than one related items.
Version 1.5.0
Features
- Code for field type resolving has been simplified which results in performance improvement.
- ACFML now automatically sets ACF system fields to «copy», preventing fields from not displaying on the front-end.
Fixes
- Repeater fields translated with Translation Editor are now correctly displayed on the front-end.
- Flexible fields with spaces in names are now correctly duplicated to other languages.
- Displaying duplicated fields in the Classic Translation Editor is not happening anymore.
- Fixed the issue with Numeric values not being translatable with the Translation Editor.
- Gallery fields inside repeater fields are now correctly copied during post duplication.
- Translated field labels are now correctly displayed on the front-end.
- Translated oEmbed field is now correctly displayed on the front-end.
Compatibility
- Ability to choose different media inside the flexible field.
- When translating Field Groups as post types, native WordPress editor is set as default.
Version 1.4.0
- Plugin covered with unit tests.
- Fixed PHP warnings that were logged when attachments and gallery fields are in use.
- Restored compatibility with WordPress multisite installations.
Version 1.3
- Added support for ACF Gutenberg Blocks.
- Reverted the ACF Options Pages handling to the old workflow (with switching language switcher on the Options page).
Version 1.2
- Fixed an issue with serialized galleries not being displayed.
- Fixed a fatal error call to undefined function acf_maybe_get_POST().
- Fixed issues with umlauts saved incorrectly.
- Fixed relationship fields not copying to translation when there are more than one related items.
- Changed the last parameter of the WPML_ACF_Field_Settings::field_value_updated() function to be optional.
- Added the GNU GPL license file.
- Fixed the translating ACF Options page (it can now be done using WPML String Translation).
- Fixed a fatal error that occurred when saving the page/product.
Version 1.1
- You can set field translation preferences directly on the Field Group edit screen.
- Possibility to hide ACFML field annotations by setting constant ACFML_HIDE_FIELD_ANNOTATIONS to boolean true.
Version 1.1-beta
- You can set field translation preferences directly on the Field Group edit screen.
- Possibility to hide ACFML field annotations by setting the ACFML_HIDE_FIELD_ANNOTATIONS constant to boolean true.
Version 1.0.4
- Better checking if ACF is active on Windows.
- Fixed translation of ACF Options Page.
- Fixed fatal error in field adnotations.
Version 1.0.3
- Fixed warning about foreach loop.
Version 1.0.2
- Fixed checking if ACF is active.
Version 1.0.1
- Fixed fatal error when ACF plugin disabled.
Version 1.0
- Fixed missing repeater field on translated posts with «display when post is…’ display rule.
- Fixed not displayed custom fields on post edit screen when Location rules wasn’t correctly resolved.
- Added field hints for ACF Pro.
- Human readable ACF field names in Multilingual Content Setup metbox.
- Removed PHP notices from Add Field Group screen.
- Automatically set field preferences for subfields – support for flexible field.
- Display WYSIWYG fields in Translation Editor – support for ACF Pro.
Version 0.9
- field group display rules are correctly applied for translated posts now
- automatically set translation preferences for repeater subfields based on repeater main field
- display original field value during the creation of translated post
- field set to copy-once is correctly synchronised between languages
- fixed display of custom post types and taxonomies in relationship select boxes when posts and/or taxonomies are set to «display as translated»
- taxonomy fields inside repeater field are correctly copied now during post duplication
- ACF attachments fields (images, galleries, files…) has translated metadata on secondary language pages
Version 0.9-b
Version 0.8
Version 0.8-b.1
- added support for WPML «display translated» mode
- fixed issue with reordering repeater field
- fixed enqueue scripts notices
- fixed support for WYSIWYG fields in Translation Editor
Version 0.7
- Fields are now sycnhronised also during standard post creation when has «Copy» set.
Version 0.6
- Introduced support for clone fields
Version 0.5.1
- Fixed impossible duplication of field groups
Version 0.5
- Fixed issue with field group overwriting: fields are no longer duplicated
- Fixed xliff file generation performance
- Fixed maximum nesting level error when duplicating repeater field
Version 0.4
- Fixed problem with returned wrong data type after conversion (one-item arrays returned as strings)
- Fixed fields disappearance when translating field groups
- Added support for Gallery field
Version 0.3
- added support for ACF Pro
- convert() method now returns original object id if translation is missing
- fixed not working repeater field
Version 0.2
- Moved fix about xliff support from WPML Translation Management to this plugin. If you use xliff files to send documents to translation, define WPML_ACF_XLIFF_SUPPORT to be true in wp-config.php file.
Version 0.1
- Initial release
- Fixes issues during post translation with field of types: Post Object, Page Link, Relationship, Taxonomy, Repeater