Pārlūkot izejas kodu

Merge pull request #528 from tripal/523-relationship_formatters

Additional Relationship Formatter
chunhuaicheng 6 gadi atpakaļ
vecāks
revīzija
188a9f3eb6

+ 12 - 2
tripal_chado/includes/TripalFields/sbo__relationship/sbo__relationship.inc

@@ -304,12 +304,20 @@ class sbo__relationship extends ChadoField {
 
     // If the subject or object have a unqiuename then add that in for refernce.
     if (property_exists($relationship->$subject_id_key, 'uniquename')) {
-      $entity->{$field_name}['und'][$delta]['value']['local:relationship_subject']['data:0842'] = $relationship->$subject_id_key->uniquename;;
+      $entity->{$field_name}['und'][$delta]['value']['local:relationship_subject']['data:0842'] = $relationship->$subject_id_key->uniquename;
     }
     if (property_exists($relationship->$object_id_key, 'uniquename')) {
       $entity->{$field_name}['und'][$delta]['value']['local:relationship_object']['data:0842'] = $relationship->$object_id_key->uniquename;
     }
 
+    // If the subject or object have an organism then add that in for reference.
+    if (property_exists($relationship->$subject_id_key, 'organism_id')) {
+      $entity->{$field_name}['und'][$delta]['value']['local:relationship_subject']['OBI:0100026'] = $relationship->$subject_id_key->organism_id->genus . ' ' . $relationship->$subject_id_key->organism_id->species;
+    }
+    if (property_exists($relationship->$object_id_key, 'organism_id')) {
+      $entity->{$field_name}['und'][$delta]['value']['local:relationship_object']['OBI:0100026'] = $relationship->$object_id_key->organism_id->genus . ' ' . $relationship->$object_id_key->organism_id->species;
+    }
+
     // Add in the TripalEntity ids if these base records in the relationship
     // are published.
     if (property_exists($relationship->$subject_id_key, 'entity_id')) {
@@ -430,9 +438,11 @@ class sbo__relationship extends ChadoField {
         'type_id' => 1,
         $object_id_key => array(
           'type_id' => 1,
+          'organism_id' => 1,
         ),
         $subject_id_key  => array(
           'type_id' => 1,
+          'organism_id' => 1,
         ),
       ),
     );
@@ -974,4 +984,4 @@ class sbo__relationship extends ChadoField {
   public function queryOrder($query, $order) {
 
   }
-}
+}

+ 1 - 1
tripal_chado/includes/TripalFields/sbo__relationship/sbo__relationship_formatter.inc

@@ -3,7 +3,7 @@
 class sbo__relationship_formatter extends ChadoFieldFormatter {
 
   // The default lable for this field.
-  public static $default_label = 'Relationship';
+  public static $default_label = 'Relationship Statements';
 
   // The list of field types for which this formatter is appropriate.
   public static $field_types = array('sbo__relationship');

+ 223 - 0
tripal_chado/includes/TripalFields/sbo__relationship_table/sbo__relationship_table_formatter.inc

@@ -0,0 +1,223 @@
+<?php
+
+class sbo__relationship_table_formatter extends ChadoFieldFormatter {
+
+  // The default lable for this field.
+  public static $default_label = 'Relationship Table by Type';
+
+  // The list of field types for which this formatter is appropriate.
+  public static $field_types = array('sbo__relationship');
+
+  public static $default_settings = array(
+    'subject_caption' => 'This @content_type is <em>@rel_type</em> the following:',
+    'object_caption' => 'The following are <em>@rel_type</em> this @content_type:',
+  );
+
+  /**
+   *
+   * @see TripalFieldFormatter::settingsForm()
+   */
+  public function settingsForm($view_mode, $form, &$form_state) {
+
+    $display = $this->instance['display'][$view_mode];
+    $settings = $display['settings'];
+
+    // Ensure the default are set if the value is not configured.
+    foreach ($this::$default_settings as $key => $value) {
+      if (!isset($settings[$key])) { $settings[$key] = $value; }
+    }
+
+    $element = array();
+    $element['subject_caption'] = array(
+      '#type' => 'textfield',
+      '#title' => 'Caption: where current entity is the subject.',
+      '#description' => 'This labels the relationship tables where the current entity is the subject of the relationship.',
+      '#default_value' => $settings['subject_caption'],
+    );
+
+    $element['object_caption'] = array(
+      '#type' => 'textfield',
+      '#title' => 'Caption: where current entity is the object.',
+      '#description' => 'This labels the relationship tables where the current entity is the object of the relationship.',
+      '#default_value' => $settings['object_caption'],
+    );
+
+    $element['tokens'] = array(
+      '#type' => 'item',
+      '#title' => 'Tokens',
+      '#markup' => 'The following tokens should be used in <strong>both the above captions</strong>:</p>
+                     <ul>
+                       <li>@rel_type: the type name of the current relationship.</li>
+                       <li>@content_type: the human-readable name of the content type for the current entity.</li>
+                     </ul>',
+    );
+
+    return $element;
+  }
+
+  /**
+   * @see TripalFieldFormatter::settingsSummary()
+   */
+  public function settingsSummary($view_mode) {
+    $display = $this->instance['display'][$view_mode];
+    $settings = $display['settings'];
+
+    // Ensure the default are set if the value is not configured.
+    foreach ($this::$default_settings as $key => $value) {
+      if (!isset($settings[$key])) { $settings[$key] = $value; }
+    }
+
+    $summary = t('<strong>Subject Caption:</strong> @subject<br><strong>Object Caption:</strong> @object',
+        array(
+          '@subject' => $settings['subject_caption'],
+          '@object' => $settings['object_caption'])
+        );
+
+    return $summary;
+  }
+
+  /**
+   *
+   * @see TripalFieldFormatter::view()
+   */
+  public function view(&$element, $entity_type, $entity, $langcode, $items, $display) {
+
+    // Get the settings and set defaults.
+    $settings = $display['settings'];
+    foreach ($this::$default_settings as $key => $value) {
+      if (!isset($settings[$key])) { $settings[$key] = $value; }
+    }
+
+    // Headers depending on which fields are available.
+    $headers = array(
+      'all' => array('Name', 'Unique Name', 'Species', 'Type'),
+      'nst' => array('Name', 'Species', 'Type'),
+      'nut' => array('Name', 'Unique Name', 'Type'),
+      'nt' => array('Name', 'Type'),
+    );
+
+    // This is an array of tables where each table corresponds to a relationship type.
+    // The header is the same for all tables and the caption includes a sentence
+    // stating the relationship type.
+    $tables = array();
+
+    // For each relationship...
+    foreach ($items as $delta => $item) {
+      if (empty($item['value'])) {
+        continue;
+      }
+
+      $subject_name = $item['value']['local:relationship_subject']['schema:name'];
+      $subject_uniquename = (isset($item['value']['local:relationship_subject']['data:0842'])) ? $item['value']['local:relationship_subject']['data:0842'] : NULL;
+      $subject_type = $item['value']['local:relationship_subject']['rdfs:type'];
+      $subject_species = (isset($item['value']['local:relationship_subject']['OBI:0100026'])) ? $item['value']['local:relationship_subject']['OBI:0100026'] : NULL;
+
+      $object_name = $item['value']['local:relationship_object']['schema:name'];
+      $object_uniquename = (isset($item['value']['local:relationship_object']['data:0842'])) ? $item['value']['local:relationship_object']['data:0842'] : NULL;
+      $object_type = $item['value']['local:relationship_object']['rdfs:type'];
+      $object_species = (isset($item['value']['local:relationship_object']['OBI:0100026'])) ? $item['value']['local:relationship_object']['OBI:0100026'] : NULL;
+
+      $relationship_type = $item['value']['local:relationship_type'];
+
+      // Make types more readable.
+      foreach(array('subject_type', 'object_type', 'relationship_type') as $var) {
+        $$var = ucwords(str_replace('_',' ', $$var));
+      }
+
+      // Handle some special cases.
+      // For mRNA objects we don't want to show the CDS, exons, 5' UTR, etc.
+      // we want to show the parent gene and the protein.
+      if ($object_type == 'mRNA' and
+          (in_array($subject_type, array('CDS', 'exon', 'five_prime_UTR', 'three_prime_UTR')))) {
+        continue;
+      }
+
+      // Set header type based on what values are available.
+      if (!isset($tables[$relationship_type])) {
+        $tables[$relationship_type]['header_type'] = 'all';
+        if ($subject_uniquename === NULL AND $subject_species === NULL) {
+          $tables[$relationship_type]['header_type'] = 'nt';
+        }
+        elseif ($subject_uniquename === NULL) {
+          $tables[$relationship_type]['header_type'] = 'nst';
+        }
+        elseif ($subject_species === NULL) {
+          $tables[$relationship_type]['header_type'] = 'nut';
+        }
+      }
+
+      // Convert the object/subject to a link if an entity exists for it.
+      if (array_key_exists('entity', $item['value']['local:relationship_object'])) {
+        list($entity_type, $object_entity_id) = explode(':', $item['value']['local:relationship_object']['entity']);
+        if ($object_entity_id != $entity->id) {
+          $object_name = l($object_name, 'bio_data/' . $object_entity_id);
+          if ($object_uniquename) { $object_uniquename = l($object_uniquename, 'bio_data/' . $object_entity_id); }
+        }
+      }
+      if (array_key_exists('entity', $item['value']['local:relationship_subject'])) {
+        list($entity_type, $subject_entity_id) = explode(':', $item['value']['local:relationship_subject']['entity']);
+        if ($subject_entity_id != $entity->id) {
+          $subject_name = l($subject_name, 'bio_data/' . $subject_entity_id);
+          if ($subject_uniquename) { $subject_uniquename = l($subject_uniquename, 'bio_data/' . $subject_entity_id); }
+        }
+      }
+
+      // Determine if the subject or object is the current entity.
+      $is_subject = TRUE;
+      if ($object_name == $entity->schema__name['und'][0]['value']) {
+        $is_subject = FALSE;
+      }
+
+
+      // Add the related entity to the tables array by type of relationship.
+      if ($is_subject) {
+        $tables[$relationship_type]['caption'] = t($settings['subject_caption'],
+          array('@rel_type' => $relationship_type, '@content_type' => $entity->rdfs__type['und'][0]['value']));
+
+        $row = array();
+        $row['name'] = $object_name;
+        if ($object_uniquename) { $row['uniquename'] = $object_uniquename; }
+        if ($object_species) { $row['species'] = $object_species; }
+        $row['type'] = $object_type;
+
+        $tables[$relationship_type]['rows'][] = $row;
+      }
+      else {
+        $tables[$relationship_type]['caption'] = t($settings['object_caption'],
+          array('@rel_type' => $relationship_type, '@content_type' => $entity->rdfs__type['und'][0]['value']));
+
+        $row = array();
+        $row['name'] = $subject_name;
+        if ($subject_uniquename) { $row['uniquename'] = $subject_uniquename; }
+        if ($subject_species) { $row['species'] = $subject_species; }
+        $row['type'] = $subject_type;
+
+        $tables[$relationship_type]['rows'][] = $row;
+      }
+    }
+
+    $element[0] = array(
+      '#type' => 'markup',
+      '#tree' => TRUE,
+    );
+
+    foreach ($tables as $relationship_type => $details) {
+
+      $table_id = 'sbo__relationship-'.$item['value']['local:relationship_subject']['rdfs:type']; //$this->getPagerElementID();
+      $element[0][$relationship_type] = array(
+        '#type' => 'markup',
+        '#theme' => 'table',
+        '#header' => $headers[ $details['header_type'] ],
+        '#rows' => $details['rows'],
+        '#caption' => $details['caption'],
+        '#sticky' => FALSE,
+        '#attributes' => array(
+          'class' => 'tripal-data-table',
+          'id' => $table_id,
+        ),
+      );
+    }
+  }
+}
+
+