Advanced Custom Fields Multilingual

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.

No changes in relation to ACF Multilingual Beta 2

See changelog for ACF Multilingual 2.1.5 Beta 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.

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.

• Fixed a fatal error introduced in ACFML 2.1.4 that occurred between ACF Pro and the ACF Extended add-on.

• 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.

• 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.

• 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.

• Fixed a bug in calculating the hash for a Repeater field with Post Object or True/False subfields.

• Fixed a fatal error introduced in ACFML 2.1.0 that occurred when displaying an ACF form on the front-end.

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.

• 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.

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.

• 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).

• 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.

• 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.

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.

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.

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”.

• 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

Fixes

• Fixed a fatal error when saving an options page with a repeater field and a post object subfield.

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.

• Fixed an issue with duplicating a field group that contains a repeater field.

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.

• Fixed and issue with missing attachment IDs in the Classic Translation Editor.

Fixes

• Added possibility to stop scanning local fields for translation preferences (add define( 'ACFML_SCAN_LOCAL_FIELDS', false ); into wp-config.php).

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.

• Fixed database performance issues when site uses a field locally stored in JSON file.

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.

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.

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.

• Changed suggested translation preference for Repeater and Flexible fields to Copy Once to avoid issues with disappearing or emptied subfields.

• 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.

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.

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.

Fixes

• Added support for Translation Preferences for strings inside repeater fields when used in ACF Blocks.

Fixes

• Reverted undue fixes from 1.7.4.

Features

• Compatibilty with WordPress 5.6.

Features

• Compatibilty with WordPress 5.6.

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.

• Fixed an issue with overwriting translation preferences for repeater fields when preferences were set on the post edit screen.

• 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.

• Fixed an issue where empty values are not changed into null for the Group field type.

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.

• 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.

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.

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.

• 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.

• Added support for ACF Gutenberg Blocks.
• Reverted the ACF Options Pages handling to the old workflow (with switching language switcher on the Options page).

• 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.

• 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.

• 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.

• Better checking if ACF is active on Windows.
• Fixed translation of ACF Options Page.
• Fixed fatal error in field adnotations.

• Fixed warning about foreach loop.

• Fixed checking if ACF is active.

• Fixed fatal error when ACF plugin disabled.

• 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.

• 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

• 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

• Fields are now sycnhronised also during standard post creation when has “Copy” set.

• Introduced support for clone fields

• Fixed impossible duplication of field groups

• 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

• 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

• added support for ACF Pro
• convert() method now returns original object id if translation is missing
• fixed not working repeater field

• 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.

• Initial release
• Fixes issues during post translation with field of types: Post Object, Page Link, Relationship, Taxonomy, Repeater