tripal/tripal_chado/includes/fields/chado_linker__prop_adder.inc

<?php

class chado_linker__prop_adder extends TripalField {
  /**
   * @see TripalField::field_info()
   */
  function field_info() {
    return array(
      'label' => t('Add a Property Type'),
      'description' => t('This record may have any number of properties. Use
            this field to first add the type.'),
      'default_widget' => 'chado_linker__prop_adder_widget',
      'default_formatter' => 'hidden',
      'settings' => array(),
      'storage' => array(
        'type' => 'field_chado_storage',
        'module' => 'tripal_chado',
        'active' => TRUE
      ),
      'no_ui' => TRUE
    );
  }
  /**
   * @see TripalField::attach_info()
 */
  function attach_info($entity_type, $bundle, $target) {
    $field_info = array();

    $table_name = $target['data_table'];
    $type_table = $target['type_table'];
    $type_field = $target['field'];
    $cv_id      = $target['cv_id'];
    $cvterm_id  = $target['cvterm_id'];

    // If the linker table does not exists then we don't want to add attach.
    $prop_table = $table_name . 'prop';
    if (!chado_table_exists($prop_table)) {
      return $field_info;
    }

    // Initialize the field array.
    $field_info = array(
      'field_name' => $prop_table,
      'field_type' => 'chado_linker__prop_adder',
      'widget_type' => 'chado_linker__prop_adder_widget',
      'field_settings' => array(
        'base_table' => $table_name,
      ),
      'cardinality' => 1,
      'storage' => 'field_chado_storage',
      'widget_settings' => array('display_label' => 1),
      'description' => '',
      'label' => 'Additional Properties',
      'is_required' => 0,
      // This feld is never visible so there are no field settings for
      // Chado nor the semantic web.
    );
    return $field_info;
  }
  /**
   * @see TripalField::widget_info()
   */
  function widget_info() {
    return array(
      'label' => t('Add a Property'),
      'field types' => array('chado_linker__prop_adder'),
    );
  }
  /**
   * @see TripalField::widget_form()
   */
  function widget_form(&$widget, &$form, &$form_state,
      $field, $instance, $langcode, $items, $delta, $element) {

    // This field has no value field.  Just a fieldset for adding new properties.
    $widget['#element_validate'] = array('chado_linker__prop_adder_widget_validate');

    $widget['#type'] = 'fieldset';
    $widget['#title'] = $element['#title'];
    $widget['#description'] = $element['#description'];
    $widget['#group'] = 'entity_form_vtabs';

    $widget['kvproperty_instructions'] = array(
      '#type' => 'item',
      '#markup' => t('You may add additional properties to this form by
          providing a property name (from a vocabulary) in the field below
          and clicking the "Add Property" button.  This will add a
          new field to the form above for the property you entered.
          In the future, this field will be present for all records
          of this type.'),
    );
    $widget['value'] = array(
      '#title' => t('Property Type'),
      '#type' => 'textfield',
      '#description' => t("Please enter the type of property that you want to
          add.  As you type, suggestions will be provided."),
      '#autocomplete_path' => "admin/tripal/storage/chado/auto_name/cvterm/",
    );
    $widget['kvproperty_adder_link'] = array(
      '#type' => 'item',
      '#markup' => '<span class="kvproperty-adder-link">' . l('Add a term', 'admin/tripal/vocab/cvterm/add', array('attributes' => array('target' => '_blank'))) . '</span>',
    );
    // When this button is clicked, the form will be validated and submitted.
    // Therefore, we set custom submit and validate functions to override the
    // default form submit.  In the validate function we set the form_state
    // to rebuild the form so the submit function never actually gets called,
    // but we need it or Drupal will run the default validate anyway.
    // we also set #limit_validation_errors to empty so fields that
    // are required that don't have values won't generate warnings.
    $widget['kvproperty_adder_button'] = array(
      '#value' => t('Add Property'),
      '#type' => 'submit',
      '#name' => 'kvproperty_adder_button',
      '#limit_validation_errors' => array(array($field['field_name'])),
    );
  }

}
/**
 * Callback function for validating the chado_linker__prop_adder_widget.
 */
function chado_linker__prop_adder_widget_validate($element, &$form_state) {

  // Add the new field to the entity
  if (array_key_exists('triggering_element', $form_state) and
      $form_state['triggering_element']['#name'] == 'kvproperty_adder_button') {

        $form_state['rebuild'] = TRUE;
        $field_name = $element['#field_name'];
        $entity_type = $element['#entity']->type;
        $bundle = $element['#entity']->bundle;

        // Get the base table name from the field properties.
        $field = field_info_field($field_name);
        $base_table = $field['settings']['base_table'];

        // Get the term for the property
        $kvproperty = tripal_chado_get_field_form_values($field_name, $form_state);
        $term = chado_generate_var('cvterm', array('name' => $kvproperty), $options = array('return_array' => TRUE));

        if (count($term) == 1) {
          $prop_field_name = $field_name . '__' . $term[0]->cvterm_id;

          // The field name is the table name in this case. We want to get the
          // primary key as this should be the field that maps th the value.
          $schema = chado_get_schema($field_name);
          $pkey = $schema['primary key'][0];

          $field_info = array(
            'field_type' => 'kvproperty',
            'widget_type' => 'tripal_chado_kvproperty_widget',
            'field_settings' => array(
              'chado_table' => $field_name,
              'chado_column' => $pkey,
              'base_table' => $base_table,
            ),
            'storage' => 'field_chado_storage',
            'widget_settings' => array(),
            'description' => $term[0]->definition ? $term[0]->definition : '',
            'label' => ucfirst(preg_replace('/_/', ' ', $term[0]->name)),
            'is_required' => FALSE,
            // All properties are unlimited.
            'cardinality' => FIELD_CARDINALITY_UNLIMITED,
          );
          tripal_add_bundle_field($prop_field_name, $field_info, $entity_type, $bundle);
        }
        else if (count($term) > 1) {
          form_set_error(implode('][', $element ['#parents']) . '][value', t("This term is present in multiple vocabularies. Please select the appropriate one."));
        }
        else {
          form_set_error(implode('][', $element ['#parents']) . '][value', t("Please provide a property type to add."));
        }
      }
}