You are here

function locale_field_language_fallback in Drupal 7

Applies language fallback rules to the fields attached to the given entity.

Core language fallback rules simply check if fields have a field translation for the requested language code. If so the requested language is returned, otherwise all the fallback candidates are inspected to see if there is a field translation available in another language. By default this is called by locale_field_language_alter(), but this behavior can be disabled by setting the 'locale_field_language_fallback' variable to FALSE.

Parameters

$display_language: A reference to an array of language codes keyed by field name.

$entity: The entity to be displayed.

$langcode: The language code $entity has to be displayed in.

3 calls to locale_field_language_fallback()
field_test_field_language_alter in modules/field/tests/field_test.module
Implements hook_field_language_alter().
hook_field_language_alter in modules/field/field.api.php
Perform alterations on field_language() values.
locale_field_language_alter in modules/locale/locale.module
Implements hook_field_language_alter().
3 string references to 'locale_field_language_fallback'
hook_field_language_alter in modules/field/field.api.php
Perform alterations on field_language() values.
locale_field_language_alter in modules/locale/locale.module
Implements hook_field_language_alter().
locale_uninstall in modules/locale/locale.install
Implements hook_uninstall().

File

modules/locale/locale.module, line 496
Add language handling functionality and enables the translation of the user interface to languages other than English.

Code

function locale_field_language_fallback(&$display_language, $entity, $langcode) {

  // Lazily init fallback candidates to avoid unnecessary calls.
  $fallback_candidates = NULL;
  $field_languages = array();
  foreach ($display_language as $field_name => $field_language) {

    // If the requested language is defined for the current field use it,
    // otherwise search for a fallback value among the fallback candidates.
    if (isset($entity->{$field_name}[$langcode])) {
      $display_language[$field_name] = $langcode;
    }
    elseif (!empty($entity->{$field_name})) {
      if (!isset($fallback_candidates)) {
        require_once DRUPAL_ROOT . '/includes/language.inc';
        $fallback_candidates = language_fallback_get_candidates();
      }
      foreach ($fallback_candidates as $fallback_language) {
        if (isset($entity->{$field_name}[$fallback_language])) {
          $display_language[$field_name] = $fallback_language;
          break;
        }
      }
    }
  }
}