Handles multilingual fields.
Fields natively implement multilingual support, and all fields use the following structure:
$entity->{$field_name}[$langcode][$delta][$column_name];
Every field can hold a single or multiple value for each language code belonging to the available language codes set:
The available language codes for a particular field are returned by field_available_languages(). Whether a field is translatable is determined by calling field_is_translatable(), which checks the $field['translatable'] property returned by field_info_field() and whether the entity type the field is attached to supports translation.
By default, _field_invoke() and _field_invoke_multiple() process a field in all available languages, unless they are given a language code suggestion. Based on that suggestion, _field_language_suggestion() determines the languages to act on.
Most field_attach_*() functions act on all available language codes, except for the following:
The field language fallback logic relies on the global language fallback configuration. Therefore, the displayed field values can be in the requested language, but may be different if no values for the requested language are available. The default language fallback rules inspect all the enabled languages ordered by their weight. This behavior can be altered or even disabled by modules implementing hook_field_language_alter(), making it possible to choose the first approach. The display language for each field is returned by field_language().
See Field API for information about the other parts of the Field API.
Name | Location | Description |
---|---|---|
field_available_languages |
drupal/ |
Collects the available language codes for the given entity type and field. |
field_content_languages |
drupal/ |
Returns available content language codes. |
field_has_translation_handler |
drupal/ |
Checks if a module is registered as a translation handler for a given entity. |
field_is_translatable |
drupal/ |
Checks whether a field has language support. |
field_language |
drupal/ |
Returns the display language code for the fields attached to the given entity. |
field_language_fallback_enabled |
drupal/ |
Checks whether field language fallback is enabled. |
field_valid_language |
drupal/ |
Ensures that a given language code is valid. |
_field_language_suggestion |
drupal/ |
Process the language code suggestion based on the available language codes. |