Download the PHP package pleb/acf-polylang-translatable-fields without Composer
On this page you can find all versions of the php package pleb/acf-polylang-translatable-fields. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download pleb/acf-polylang-translatable-fields
More information about pleb/acf-polylang-translatable-fields
Files in pleb/acf-polylang-translatable-fields
Package acf-polylang-translatable-fields
Short Description Adds translatable fields to ACF for non-translated contents using Polylang
License MIT
Homepage https://github.com/PierreLebedel/AcfPolylangTranslatableFields
Informations about the package acf-polylang-translatable-fields
ACF Polylang Translatable Field
This plugin adds some translatable fields to ACF for non-translated contents using Polylang
The problem
When using Polylang, each translatable post is duplicated, and that the one that matches to the users's language is displayed. The custom fields have to be filled for each post translation.
And when using qTanslate-XT, the post is not duplicate, but that's the field whitch get all translated values internally.
Sometimes, we want some duplicable post types, and some non-duplicable post types with translatable fields.
The solution
This plugin add some fields types to the ACF choices, and when the post form is submitted, that's the field himself whitch got all translated values. Internally, the values are saved with a qTranslate-like HTML comment format :
When filling in the fields, a tab will be displayed for each Polylang configured languages :
Installation
-
Download and unzip the package file to your
wp-content/plugins/
directory - Or install with Composer :
composer require pleb/acf-polylang-translatable-fields
Usage
Register fields
You have to choose your field type from the Polylang translatable group inside the ACF field type select box.
Each field type presents an additionational option, witch let you decide the empty translated value field behavior. You can choose between returning the empty value (like there is saved), and returning the default site language value instead.
Get values in your templates
The ACF get_field()
function returns to you the translated value in your current context Polylang language.
This function can take a boolean third parameter to allow you to get non-formatted values. In this case, you will receive an associative array of your field translations :
Update values
You can update a translated field from outside of the box by sending your values inside an associative array within ACF update_field
function :
The posted values will be merged with the others languages values.
Note your can also send your values with the 2 chars language slug instead of the 5 chars language locale :
If you send non-array value to the update_field
function, it is only the current context Polylang language (or the default site language if not applicable) that will be updated :