function field_bundle_settings

Gets or sets administratively defined bundle settings.

Parameters

string $entity_type: The type of $entity; e.g., 'node' or 'user'.

string $bundle: The bundle name.

array|null $settings: (optional) The settings to store, an associative array with the following elements:

  • view_modes: An associative array keyed by view mode, with the following key/value pairs:

    • custom_settings: Boolean specifying whether the view mode uses a dedicated set of display options (TRUE), or the 'default' options (FALSE). Defaults to FALSE.
  • extra_fields: An associative array containing the form and display settings for extra fields (also known as pseudo-fields):

    • form: An associative array whose keys are the names of extra fields, and whose values are associative arrays with the following elements:

      • weight: The weight of the extra field, determining its position on an entity form.
    • display: An associative array whose keys are the names of extra fields, and whose values are associative arrays keyed by the name of view modes. This array must include an item for the 'default' view mode. Each view mode sub-array contains the following elements:

      • weight: The weight of the extra field, determining its position when an entity is viewed.
      • visible: TRUE if the extra field is visible, FALSE otherwise.

Return value

array|null If no $settings are passed, the current settings are returned.

Related topics

Field API
Attaches custom data fields to Drupal entities.
7 calls to field_bundle_settings()
DisplayOverview::submit in drupal/core/modules/field_ui/lib/Drupal/field_ui/DisplayOverview.php
Overrides Drupal\field_ui\OverviewBase::submit().
FieldInfo::prepareExtraFields in drupal/core/modules/field/lib/Drupal/field/FieldInfo.php
Prepares 'extra fields' for the current run-time context.
FieldOverview::submit in drupal/core/modules/field_ui/lib/Drupal/field_ui/FieldOverview.php
Overrides Drupal\field_ui\OverviewBase::submit().
field_view_mode_settings in drupal/core/modules/field/field.module
Returns view mode settings in a given bundle.
standard_install in drupal/core/profiles/standard/standard.install
Implements hook_install().

... See full list

File

drupal/core/modules/field/field.module, line 672
Attach custom data fields to Drupal entities.

Code

function field_bundle_settings($entity_type, $bundle, $settings = NULL) {
  if (isset($settings)) {
    variable_set('field_bundle_settings_' . $entity_type . '__' . $bundle, $settings);
    field_info_cache_clear();
  }
  else {
    $settings = variable_get('field_bundle_settings_' . $entity_type . '__' . $bundle, array());
    $settings += array(
      'view_modes' => array(),
      'extra_fields' => array(),
    );
    $settings['extra_fields'] += array(
      'form' => array(),
      'display' => array(),
    );
    return $settings;
  }
}