t('Field type'), 'class' => array(RESPONSIVE_PRIORITY_MEDIUM)), t('Used in'), ); $rows = array(); foreach ($instances as $entity_type => $type_bundles) { foreach ($type_bundles as $bundle => $bundle_instances) { foreach ($bundle_instances as $field_name => $instance) { $field = field_info_field($field_name); // Initialize the row if we encounter the field for the first time. if (!isset($rows[$field_name])) { $rows[$field_name]['class'] = $field['locked'] ? array('menu-disabled') : array(''); $rows[$field_name]['data'][0] = $field['locked'] ? t('@field_name (Locked)', array('@field_name' => $field_name)) : $field_name; $module_name = $field_types[$field['type']]['module']; $rows[$field_name]['data'][1] = $field_types[$field['type']]['label'] . ' ' . t('(module: !module)', array('!module' => $modules[$module_name]->info['name'])); } // Add the current instance. $admin_path = _field_ui_bundle_admin_path($entity_type, $bundle); $rows[$field_name]['data'][2][] = $admin_path ? l($bundles[$entity_type][$bundle]['label'], $admin_path . '/fields') : $bundles[$entity_type][$bundle]['label']; } } } foreach ($rows as $field_name => $cell) { $rows[$field_name]['data'][2] = implode(', ', $cell['data'][2]); } if (empty($rows)) { $output = t('No fields have been defined yet.'); } else { // Sort rows by field name. ksort($rows); $output = theme('table', array('header' => $header, 'rows' => $rows)); } return $output; } /** * Displays a message listing the inactive fields of a given bundle. */ function field_ui_inactive_message($entity_type, $bundle) { $inactive_instances = field_ui_inactive_instances($entity_type, $bundle); if (!empty($inactive_instances)) { $field_types = field_info_field_types(); $widget_types = field_info_widget_types(); foreach ($inactive_instances as $field_name => $instance) { $list[] = t('%field (@field_name) field requires the %widget_type widget provided by %widget_module module', array( '%field' => $instance['label'], '@field_name' => $instance['field_name'], '%widget_type' => isset($widget_types[$instance['widget']['type']]) ? $widget_types[$instance['widget']['type']]['label'] : $instance['widget']['type'], '%widget_module' => $instance['widget']['module'], )); } drupal_set_message(t('Inactive fields are not shown unless their providing modules are enabled. The following fields are not enabled: !list', array('!list' => theme('item_list', array('items' => $list)))), 'error'); } } /** * Determines the rendering order of an array representing a tree. * * Callback for array_reduce() within field_ui_table_pre_render(). */ function _field_ui_reduce_order($array, $a) { $array = !isset($array) ? array() : $array; if ($a['name']) { $array[] = $a['name']; } if (!empty($a['children'])) { uasort($a['children'], 'drupal_sort_weight'); $array = array_merge($array, array_reduce($a['children'], '_field_ui_reduce_order')); } return $array; } /** * Returns the region to which a row in the 'Manage fields' screen belongs. * * This function is used as a #region_callback in * Drupal\field_ui\DisplayOverview::form(). It is called during * field_ui_table_pre_render(). */ function field_ui_field_overview_row_region($row) { switch ($row['#row_type']) { case 'field': case 'extra_field': return 'content'; case 'add_new_field': // If no input in 'label', assume the row has not been dragged out of the // 'add new' section. return (!empty($row['label']['#value']) ? 'content' : 'hidden'); } } /** * Returns the region to which a row in the 'Manage display' screen belongs. * * This function is used as a #region_callback in * Drupal\field_ui\FieldOverview::form(), and is called during * field_ui_table_pre_render(). */ function field_ui_display_overview_row_region($row) { switch ($row['#row_type']) { case 'field': case 'extra_field': return ($row['format']['type']['#value'] == 'hidden' ? 'hidden' : 'content'); } } /** * Render API callback: Performs pre-render tasks on field_ui_table elements. * * This function is assigned as a #pre_render callback in * field_ui_element_info(). * * @see drupal_render(). */ function field_ui_table_pre_render($elements) { $js_settings = array(); // For each region, build the tree structure from the weight and parenting // data contained in the flat form structure, to determine row order and // indentation. $regions = $elements['#regions']; $tree = array('' => array('name' => '', 'children' => array())); $trees = array_fill_keys(array_keys($regions), $tree); $parents = array(); $list = drupal_map_assoc(element_children($elements)); // Iterate on rows until we can build a known tree path for all of them. while ($list) { foreach ($list as $name) { $row = &$elements[$name]; $parent = $row['parent_wrapper']['parent']['#value']; // Proceed if parent is known. if (empty($parent) || isset($parents[$parent])) { // Grab parent, and remove the row from the next iteration. $parents[$name] = $parent ? array_merge($parents[$parent], array($parent)) : array(); unset($list[$name]); // Determine the region for the row. $function = $row['#region_callback']; $region_name = $function($row); // Add the element in the tree. $target = &$trees[$region_name]['']; foreach ($parents[$name] as $key) { $target = &$target['children'][$key]; } $target['children'][$name] = array('name' => $name, 'weight' => $row['weight']['#value']); // Add tabledrag indentation to the first row cell. if ($depth = count($parents[$name])) { $children = element_children($row); $cell = current($children); $row[$cell]['#prefix'] = theme('indentation', array('size' => $depth)) . (isset($row[$cell]['#prefix']) ? $row[$cell]['#prefix'] : ''); } // Add row id and associate JS settings. $id = drupal_html_class($name); $row['#attributes']['id'] = $id; if (isset($row['#js_settings'])) { $row['#js_settings'] += array( 'rowHandler' => $row['#row_type'], 'name' => $name, 'region' => $region_name, ); $js_settings[$id] = $row['#js_settings']; } } } } // Determine rendering order from the tree structure. foreach ($regions as $region_name => $region) { $elements['#regions'][$region_name]['rows_order'] = array_reduce($trees[$region_name], '_field_ui_reduce_order'); } $elements['#attached']['js'][] = array( 'type' => 'setting', 'data' => array('fieldUIRowsData' => $js_settings), ); return $elements; } /** * Returns HTML for Field UI overview tables. * * @param $variables * An associative array containing: * - elements: An associative array containing a Form API structure to be * rendered as a table. * * @ingroup themeable */ function theme_field_ui_table($variables) { $elements = $variables['elements']; $table = array(); $js_settings = array(); // Add table headers and attributes. foreach (array('header', 'attributes') as $key) { if (isset($elements["#$key"])) { $table[$key] = $elements["#$key"]; } } // Determine the colspan to use for region rows, by checking the number of // columns in the headers. $columns_count = 0; foreach ($table['header'] as $header) { $columns_count += (is_array($header) && isset($header['colspan']) ? $header['colspan'] : 1); } // Render rows, region by region. foreach ($elements['#regions'] as $region_name => $region) { $region_name_class = drupal_html_class($region_name); // Add region rows. if (isset($region['title']) && empty($region['invisible'])) { $table['rows'][] = array( 'class' => array('region-title', 'region-' . $region_name_class . '-title'), 'no_striping' => TRUE, 'data' => array( array('data' => $region['title'], 'colspan' => $columns_count), ), ); } if (isset($region['message'])) { $class = (empty($region['rows_order']) ? 'region-empty' : 'region-populated'); $table['rows'][] = array( 'class' => array('region-message', 'region-' . $region_name_class . '-message', $class), 'no_striping' => TRUE, 'data' => array( array('data' => $region['message'], 'colspan' => $columns_count), ), ); } // Add form rows, in the order determined at pre-render time. foreach ($region['rows_order'] as $name) { $element = $elements[$name]; $row = array('data' => array()); if (isset($element['#attributes'])) { $row += $element['#attributes']; } // Render children as table cells. foreach (element_children($element) as $cell_key) { $child = &$element[$cell_key]; // Do not render a cell for children of #type 'value'. if (!(isset($child['#type']) && $child['#type'] == 'value')) { $cell = array('data' => drupal_render($child)); if (isset($child['#cell_attributes'])) { $cell += $child['#cell_attributes']; } $row['data'][] = $cell; } } $table['rows'][] = $row; } } return theme('table', $table); } /** * Returns the built and processed 'Manage fields' form of a bundle. * * The resulting form allows fields and pseudo-fields to be re-ordered. * * @param string $entity_type * The entity type for the fieldable entity. * @param string $bundle * The bundle for the fieldable entity. * * @return * The processed form for the given entity type and bundle. * * @see field_ui_menu() * @see field_ui_field_overview_form_validate() * @see field_ui_field_overview_form_submit() * @ingroup forms */ function field_ui_field_overview($entity_type, $bundle) { $bundle = field_extract_bundle($entity_type, $bundle); field_ui_inactive_message($entity_type, $bundle); $field_overview = new FieldOverview($entity_type, $bundle); $form_state = array(); $form_state['build_info']['callback'] = array($field_overview, 'form'); $form_state['build_info']['args'] = array($entity_type, $bundle); return drupal_build_form('field_ui_field_overview_form', $form_state); } /** * Render API callback: Checks if a field machine name is taken. * * @param $value * The machine name, not prefixed with 'field_'. * * @return * Whether or not the field machine name is taken. */ function _field_ui_field_name_exists($value) { // Prefix with 'field_'. $field_name = 'field_' . $value; // We need to check inactive fields as well, so we can't use // field_info_fields(). return (bool) field_read_fields(array('field_name' => $field_name), array('include_inactive' => TRUE)); } /** * Returns the built and processed 'Manage display' form of a bundle. * * The resulting form allows fields and pseudo-fields to be re-ordered. * * @param string $entity_type * The entity type for the fieldable entity. * @param string $bundle * The bundle for the fieldable entity. * @param string $view_mode * The view mode for the fieldable entity. * * @return * The processed form for the given entity type and bundle. * * @see field_ui_menu() * @see field_ui_display_overview_multistep_submit() * @see Drupal\field_ui\DisplayOverview::submit() * @ingroup forms */ function field_ui_display_overview($entity_type, $bundle, $view_mode) { $bundle = field_extract_bundle($entity_type, $bundle); field_ui_inactive_message($entity_type, $bundle); $display_overview = new DisplayOverview($entity_type, $bundle, $view_mode); $form_state = array(); $form_state['build_info']['callback'] = array($display_overview, 'form'); $form_state['build_info']['args'] = array($entity_type, $bundle, $view_mode); return drupal_build_form('field_ui_display_overview_form', $form_state); } /** * Populates display settings for a new view mode from the default view mode. * * When an administrator decides to use custom display settings for a view mode, * that view mode needs to be initialized with the display settings for the * 'default' view mode, which it was previously using. This helper function * adds the new custom display settings to this bundle's instances, and saves * them. It also modifies the passed-in $settings array, which the caller can * then save using field_bundle_settings(). * * @param $entity_type * The bundle's entity type. * @param $bundle * The bundle whose view mode is being customized. * @param $view_mode * The view mode that the administrator has set to use custom settings. * @param $settings * An associative array of bundle settings, as expected by * field_bundle_settings(). * * @see Drupal\field_ui\DisplayOverview::submit(). * @see field_bundle_settings() */ function _field_ui_add_default_view_mode_settings($entity_type, $bundle, $view_mode, &$settings) { // Update display settings for field instances. $instances = field_read_instances(array('entity_type' => $entity_type, 'bundle' => $bundle)); foreach ($instances as $instance) { // If this field instance has display settings defined for this view mode, // respect those settings. if (!isset($instance['display'][$view_mode])) { // The instance doesn't specify anything for this view mode, so use the // default display settings. $instance['display'][$view_mode] = $instance['display']['default']; field_update_instance($instance); } } // Update display settings for 'extra fields'. foreach (array_keys($settings['extra_fields']['display']) as $name) { if (!isset($settings['extra_fields']['display'][$name][$view_mode])) { $settings['extra_fields']['display'][$name][$view_mode] = $settings['extra_fields']['display'][$name]['default']; } } } /** * Returns an array of field_type options. */ function field_ui_field_type_options() { $options = &drupal_static(__FUNCTION__); if (!isset($options)) { $options = array(); $field_types = field_info_field_types(); $field_type_options = array(); foreach ($field_types as $name => $field_type) { // Skip field types which have no widget types, or should not be add via // uesr interface. if (field_ui_widget_type_options($name) && empty($field_type['no_ui'])) { $options[$name] = $field_type['label']; } } asort($options); } return $options; } /** * Returns an array of widget type options for a field type. * * If no field type is provided, returns a nested array of all widget types, * keyed by field type human name. */ function field_ui_widget_type_options($field_type = NULL, $by_label = FALSE) { $options = &drupal_static(__FUNCTION__); if (!isset($options)) { $options = array(); $field_types = field_info_field_types(); $widget_types = field_info_widget_types(); uasort($widget_types, 'drupal_sort_weight'); foreach ($widget_types as $name => $widget_type) { foreach ($widget_type['field_types'] as $widget_field_type) { // Check that the field type exists. if (isset($field_types[$widget_field_type])) { $options[$widget_field_type][$name] = $widget_type['label']; } } } } if (isset($field_type)) { return !empty($options[$field_type]) ? $options[$field_type] : array(); } if ($by_label) { $field_types = field_info_field_types(); $options_by_label = array(); foreach ($options as $field_type => $widgets) { $options_by_label[$field_types[$field_type]['label']] = $widgets; } return $options_by_label; } return $options; } /** * Returns an array of formatter options for a field type. * * If no field type is provided, returns a nested array of all formatters, keyed * by field type. */ function field_ui_formatter_options($field_type = NULL) { $options = &drupal_static(__FUNCTION__); if (!isset($options)) { $field_types = field_info_field_types(); $options = array(); foreach (field_info_formatter_types() as $name => $formatter) { foreach ($formatter['field_types'] as $formatter_field_type) { // Check that the field type exists. if (isset($field_types[$formatter_field_type])) { $options[$formatter_field_type][$name] = $formatter['label']; } } } } if ($field_type) { return !empty($options[$field_type]) ? $options[$field_type] : array(); } return $options; } /** * Returns an array of existing fields to be added to a bundle. */ function field_ui_existing_field_options($entity_type, $bundle) { $info = array(); $field_types = field_info_field_types(); foreach (field_info_instances() as $existing_entity_type => $bundles) { foreach ($bundles as $existing_bundle => $instances) { // No need to look in the current bundle. if (!($existing_bundle == $bundle && $existing_entity_type == $entity_type)) { foreach ($instances as $instance) { $field = field_info_field($instance['field_name']); // Don't show // - locked fields, // - fields already in the current bundle, // - fields that cannot be added to the entity type, // - fields that that shoud not be added via user interface. if (empty($field['locked']) && !field_info_instance($entity_type, $field['field_name'], $bundle) && (empty($field['entity_types']) || in_array($entity_type, $field['entity_types'])) && empty($field_types[$field['type']]['no_ui'])) { $info[$instance['field_name']] = array( 'type' => $field['type'], 'type_label' => $field_types[$field['type']]['label'], 'field' => $field['field_name'], 'label' => t($instance['label']), 'widget_type' => $instance['widget']['type'], ); } } } } } return $info; } /** * Form constructor for the field settings edit page. * * @see field_ui_menu() * @see field_ui_settings_form_submit() * @ingroups forms */ function field_ui_field_settings_form($form, &$form_state, $instance) { $bundle = $instance['bundle']; $entity_type = $instance['entity_type']; $field = field_info_field($instance['field_name']); drupal_set_title($instance['label']); $description = '
' . t('These settings apply to the %field field everywhere it is used. These settings impact the way that data is stored in the database and cannot be changed once data has been created.', array('%field' => $instance['label'])) . '
'; // Create a form structure for the field values. $form['field'] = array( '#type' => 'fieldset', '#title' => t('Field settings'), '#description' => $description, '#tree' => TRUE, ); // See if data already exists for this field. // If so, prevent changes to the field settings. $has_data = field_has_data($field); if ($has_data) { $form['field']['#description'] = ' ' . $form['field']['#description']; } // Build the non-configurable field values. $form['field']['field_name'] = array('#type' => 'value', '#value' => $field['field_name']); $form['field']['type'] = array('#type' => 'value', '#value' => $field['type']); $form['field']['module'] = array('#type' => 'value', '#value' => $field['module']); $form['field']['active'] = array('#type' => 'value', '#value' => $field['active']); // Add settings provided by the field module. The field module is // responsible for not returning settings that cannot be changed if // the field already has data. $form['field']['settings'] = array(); $additions = module_invoke($field['module'], 'field_settings_form', $field, $instance, $has_data); if (is_array($additions)) { $form['field']['settings'] = $additions; } if (empty($form['field']['settings'])) { $form['field']['settings'] = array( '#markup' => t('%field has no field settings.', array('%field' => $instance['label'])), ); } $form['#entity_type'] = $entity_type; $form['#bundle'] = $bundle; $form['actions'] = array('#type' => 'actions'); $form['actions']['submit'] = array('#type' => 'submit', '#value' => t('Save field settings')); return $form; } /** * Form submission handler for field_ui_field_settings_form(). */ function field_ui_field_settings_form_submit($form, &$form_state) { $form_values = $form_state['values']; $field_values = $form_values['field']; // Merge incoming form values into the existing field. $field = field_info_field($field_values['field_name']); $entity_type = $form['#entity_type']; $bundle = $form['#bundle']; $instance = field_info_instance($entity_type, $field['field_name'], $bundle); // Update the field. $field = array_merge($field, $field_values); try { field_update_field($field); drupal_set_message(t('Updated field %label field settings.', array('%label' => $instance['label']))); $form_state['redirect'] = field_ui_next_destination($entity_type, $bundle); } catch (Exception $e) { drupal_set_message(t('Attempt to update field %label failed: %message.', array('%label' => $instance['label'], '%message' => $e->getMessage())), 'error'); } } /** * Form constructor for the widget selection form. * * @see field_ui_menu() * @see field_ui_widget_type_form_submit() * @ingroup forms */ function field_ui_widget_type_form($form, &$form_state, FieldInstance $instance) { drupal_set_title($instance['label']); $bundle = $instance['bundle']; $entity_type = $instance['entity_type']; $field_name = $instance['field_name']; $field = field_info_field($field_name); $field_type = field_info_field_types($field['type']); $widget_definition = $instance->getWidget()->getDefinition(); $bundles = field_info_bundles(); $bundle_label = $bundles[$entity_type][$bundle]['label']; $form = array( '#bundle' => $bundle, '#entity_type' => $entity_type, '#field_name' => $field_name, ); $form['basic'] = array( '#type' => 'fieldset', '#title' => t('Change widget'), ); $form['basic']['widget_type'] = array( '#type' => 'select', '#title' => t('Widget type'), '#required' => TRUE, '#options' => field_ui_widget_type_options($field['type']), '#default_value' => $instance->getWidget()->getPluginId(), '#description' => t('The type of form element you would like to present to the user when creating this field in the %type type.', array('%type' => $bundle_label)), ); $form['actions'] = array('#type' => 'actions'); $form['actions']['submit'] = array('#type' => 'submit', '#value' => t('Continue')); $form['#validate'] = array(); $form['#submit'] = array('field_ui_widget_type_form_submit'); return $form; } /** * Form submission handler for field_ui_widget_type_form(). */ function field_ui_widget_type_form_submit($form, &$form_state) { $form_values = $form_state['values']; $bundle = $form['#bundle']; $entity_type = $form['#entity_type']; $field_name = $form['#field_name']; // Retrieve the stored instance settings to merge with the incoming values. $instance = field_read_instance($entity_type, $field_name, $bundle); // Set the right module information. $widget_type = field_info_widget_types($form_values['widget_type']); $widget_module = $widget_type['module']; $instance['widget']['type'] = $form_values['widget_type']; $instance['widget']['module'] = $widget_module; try { field_update_instance($instance); drupal_set_message(t('Changed the widget for field %label.', array('%label' => $instance['label']))); } catch (Exception $e) { drupal_set_message(t('There was a problem changing the widget for field %label.', array('%label' => $instance['label'])), 'error'); } $form_state['redirect'] = field_ui_next_destination($entity_type, $bundle); } /** * Form constructor for removing a field instance from a bundle. * * @see field_ui_menu() * @see field_ui_field_delete_form_submit() * @ingroup forms */ function field_ui_field_delete_form($form, &$form_state, $instance) { $bundle = $instance['bundle']; $entity_type = $instance['entity_type']; $field = field_info_field($instance['field_name']); $admin_path = _field_ui_bundle_admin_path($entity_type, $bundle); $form['entity_type'] = array('#type' => 'value', '#value' => $entity_type); $form['bundle'] = array('#type' => 'value', '#value' => $bundle); $form['field_name'] = array('#type' => 'value', '#value' => $field['field_name']); $output = confirm_form($form, t('Are you sure you want to delete the field %field?', array('%field' => $instance['label'])), $admin_path . '/fields', t('If you have any content left in this field, it will be lost. This action cannot be undone.'), t('Delete'), t('Cancel'), 'confirm' ); if ($field['locked']) { unset($output['actions']['submit']); $output['description']['#markup'] = t('This field is locked and cannot be deleted.'); } return $output; } /** * Form submission handler for field_ui_field_delete_form(). * * Removes a field instance from a bundle. If the field has no more instances, * it will be marked as deleted too. */ function field_ui_field_delete_form_submit($form, &$form_state) { $form_values = $form_state['values']; $field_name = $form_values['field_name']; $bundle = $form_values['bundle']; $entity_type = $form_values['entity_type']; $field = field_info_field($field_name); $instance = field_info_instance($entity_type, $field_name, $bundle); $bundles = field_info_bundles(); $bundle_label = $bundles[$entity_type][$bundle]['label']; if (!empty($bundle) && $field && !$field['locked'] && $form_values['confirm']) { field_delete_instance($instance); drupal_set_message(t('The field %field has been deleted from the %type content type.', array('%field' => $instance['label'], '%type' => $bundle_label))); } else { drupal_set_message(t('There was a problem removing the %field from the %type content type.', array('%field' => $instance['label'], '%type' => $bundle_label)), 'error'); } $admin_path = _field_ui_bundle_admin_path($entity_type, $bundle); $form_state['redirect'] = field_ui_get_destinations(array($admin_path . '/fields')); // Fields are purged on cron. However field module prevents disabling modules // when field types they provided are used in a field until it is fully // purged. In the case that a field has minimal or no content, a single call // to field_purge_batch() will remove it from the system. Call this with a // low batch limit to avoid administrators having to wait for cron runs when // removing instances that meet this criteria. field_purge_batch(10); } /** * Form constructor for the field instance settings form. * * @see field_ui_menu() * @see field_ui_field_edit_form_validate() * @see field_ui_field_edit_form_submit() * @see field_ui_field_edit_form_delete_submit() * @ingroup forms */ function field_ui_field_edit_form($form, &$form_state, $instance) { $bundle = $instance['bundle']; $entity_type = $instance['entity_type']; $field = field_info_field($instance['field_name']); drupal_set_title($instance['label']); $form['#field'] = $field; $form['#instance'] = $instance; // Create an arbitrary entity object (used by the 'default value' widget). $ids = (object) array('entity_type' => $instance['entity_type'], 'bundle' => $instance['bundle'], 'entity_id' => NULL); $form['#entity'] = _field_create_entity_from_ids($ids); $form['#entity']->field_ui_default_value = TRUE; if (!empty($field['locked'])) { $form['locked'] = array( '#markup' => t('The field %field is locked and cannot be edited.', array('%field' => $instance['label'])), ); return $form; } $field_type = field_info_field_types($field['type']); $widget_type = field_info_widget_types($instance['widget']['type']); $bundles = field_info_bundles(); // Create a form structure for the instance values. $form['instance'] = array( '#tree' => TRUE, '#type' => 'fieldset', '#title' => t('%type settings', array('%type' => $bundles[$entity_type][$bundle]['label'])), '#description' => t('These settings apply only to the %field field when used in the %type type.', array( '%field' => $instance['label'], '%type' => $bundles[$entity_type][$bundle]['label'], )), // Ensure field_ui_field_edit_instance_pre_render() gets called in addition // to, not instead of, the #pre_render function(s) needed by all fieldsets. '#pre_render' => array_merge(array('field_ui_field_edit_instance_pre_render'), element_info_property('fieldset', '#pre_render', array())), ); // Build the non-configurable instance values. $form['instance']['field_name'] = array( '#type' => 'value', '#value' => $instance['field_name'], ); $form['instance']['entity_type'] = array( '#type' => 'value', '#value' => $entity_type, ); $form['instance']['bundle'] = array( '#type' => 'value', '#value' => $bundle, ); $form['instance']['widget']['weight'] = array( '#type' => 'value', '#value' => !empty($instance['widget']['weight']) ? $instance['widget']['weight'] : 0, ); // Build the configurable instance values. $form['instance']['label'] = array( '#type' => 'textfield', '#title' => t('Label'), '#default_value' => !empty($instance['label']) ? $instance['label'] : $field['field_name'], '#required' => TRUE, '#weight' => -20, ); $form['instance']['description'] = array( '#type' => 'textarea', '#title' => t('Help text'), '#default_value' => !empty($instance['description']) ? $instance['description'] : '', '#rows' => 5, '#description' => t('Instructions to present to the user below this field on the editing form.' . t('These settings apply to the %field field everywhere it is used. Because the field already has data, some settings can no longer be changed.', array('%field' => $instance['label'])) . '
'; } else { $description = '' . t('These settings apply to the %field field everywhere it is used.', array('%field' => $instance['label'])) . '
'; } // Create a form structure for the field values. $form['field'] = array( '#type' => 'fieldset', '#collapsible' => TRUE, '#collapsed' => TRUE, '#title' => t('Global settings'), '#description' => $description, '#tree' => TRUE, ); // Build the configurable field values. $description = t('Maximum number of values users can enter for this field.'); if (field_behaviors_widget('multiple_values', $instance) == FIELD_BEHAVIOR_DEFAULT) { $description .= '