3, ); } /** * Implements hook_menu(). */ function tripal_entities_menu() { $items = array(); // The administative settings menu. $items['admin/tripal/bio_data'] = array( 'title' => 'Biological Data', 'description' => 'Tools for publishing, configurating and managing biological data.', 'page callback' => 'tripal_entities_admin_view', 'access arguments' => array('administer tripal data types'), 'file' => 'includes/tripal_entities.admin.inc', 'type' => MENU_NORMAL_ITEM, ); // The default tab. $items['admin/tripal/bio_data/default'] = array( 'title' => 'Biological Data', 'type' => MENU_DEFAULT_LOCAL_TASK, 'weight' => 1, ); $items['admin/tripal/bio_data/publish'] = array( 'title' => 'Publish', 'description' => 'Publish Data', 'page callback' => 'drupal_get_form', 'page arguments' => array('tripal_entities_admin_publish_form'), 'access arguments' => array('administer tripal data types'), 'file' => 'includes/tripal_entities.admin.inc', 'type' => MENU_LOCAL_TASK, 'weight' => 2 ); $items['admin/tripal/bio_data/access'] = array( 'title' => 'Access', 'description' => 'Set default access permissions for collections of data.', 'page callback' => 'drupal_get_form', 'page arguments' => array('tripal_entities_admin_access_form'), 'access arguments' => array('administer tripal data types'), 'file' => 'includes/tripal_entities.admin.inc', 'type' => MENU_LOCAL_TASK, 'weight' => 3 ); return $items; } /** * Implements hook_permission(). */ function tripal_entities_permission() { // We set up permisssions to manage entity types, manage all entities and the // permissions for each individual entity $permissions = array( 'administer tripal data types' => array( 'title' => t('Administer Tripal data types'), 'description' => t('Create and delete fields for Tripal data types, and set their permissions.'), ), 'administer tripal data' => array( 'title' => t('Administer Tripal data'), 'description' => t('Edit and delete all tripal data'), ), ); return $permissions; } /** * Implements hook_theme(). */ function tripal_entities_theme($existing, $type, $theme, $path) { return array( 'tripal_entity' => array( 'render element' => 'elements', 'template' => 'tripal_entity', 'path' => "$path/theme/templates" ), ); } /** * https://api.drupal.org/api/drupal/modules!rdf!rdf.module/group/rdf/7 */ function tripal_entities_rdf_mapping() { return array(); /* return array( 'type' => 'tripal_entity', 'bundle' => 'gene', 'mapping' => array( 'rdftype' => array('sioc:Item', 'foaf:Document'), 'title' => array( 'predicates' => array('dc:title'), ), 'uid' => array( 'predicates' => array('sioc:has_creator'), 'type' => 'rel', ), 'name' => array( 'predicates' => array('foaf:name'), ), 'uniquename' => array( 'predicates' => array('foaf:name'), ), 'organism_id' => array( 'predicates' => array('sioc:has_parent'), 'type' => 'rel' ) ), ); */ } // http://www.bluespark.com/blog/drupal-entities-part-3-programming-hello-drupal-entity // http://dikini.net/31.08.2010/entities_bundles_fields_and_field_instances /** * Implement hook_entity_info(). */ function tripal_entities_entity_info() { $entities = array(); // Get a list of published vocabularies from 'tripal_vocabulary $published_vocs = chado_generate_var('tripal_vocabulary', array('publish' => 1), array('return_array' => 1)); foreach ($published_vocs as $voc) { $entities[$voc->db_id->name] = array ( // A human readable label to identify our entity. 'label' => $voc->db_id->name . ' (' . $voc->cv_id->name . ')', 'plural label' => $voc->db_id->name . ' (' . $voc->cv_id->name . ')', // The entity class and controller class extend the classes provided by the // Entity API. 'entity class' => 'TripalEntity', 'controller class' => 'TripalEntityController', // The table for this entity defined in hook_schema() 'base table' => 'tripal_entity', // Returns the uri elements of an entity. 'uri callback' => 'tripal_entities_vocbulary_term_uri', // IF fieldable == FALSE, we can't attach fields. 'fieldable' => TRUE, // entity_keys tells the controller what database fields are used for key // functions. It is not required if we don't have bundles or revisions. // Here we do not support a revision, so that entity key is omitted. 'entity keys' => array ( 'id' => 'id', 'bundle' => 'bundle' ), 'bundle keys' => array ( 'bundle' => 'bundle' ), // Callback function for access to this entity. 'access callback' => 'tripal_entity_access', // FALSE disables caching. Caching functionality is handled by Drupal core. 'static cache' => FALSE, // Bundles are added in the hook_entities_info_alter() function. 'bundles' => array (), 'label callback' => 'tripal_entity_label', // The information below is used by the TripalEntityUIController // (which extends the EntityDefaultUIController). The admin_ui // key here is mean to appear on the 'Find Content' page of the // administrative menu. 'admin ui' => array ( 'path' => 'admin/content/bio_data', 'controller class' => 'TripalEntityUIController', 'menu wildcard' => '%tripal_entity', 'file' => 'includes/TripalEntityUIController.inc' ), 'view modes' => array ( 'full' => array ( 'label' => t ( 'Full content' ), 'custom settings' => FALSE ), 'teaser' => array ( 'label' => t ( 'Teaser' ), 'custom settings' => TRUE ) ) ); // The entity that holds information about the entity types. $entities [$voc->db_id->name . '_bundle'] = array ( 'label' => $voc->db_id->name . ' (' . $voc->cv_id->name . ') Data Type', 'entity class' => 'TripalBundle', 'controller class' => 'TripalBundleController', 'base table' => 'tripal_bundle', 'fieldable' => FALSE, 'exportable' => FALSE, 'entity keys' => array ( 'id' => 'id', 'name' => 'bundle', 'label' => 'label' ), 'access callback' => 'tripal_bundle_access', 'module' => 'tripal_entities', // Enable the entity API's admin UI. 'admin ui' => array ( 'path' => 'admin/structure/bio_data/' . $voc->db_id->name, 'controller class' => 'TripalBundleUIController', 'file' => 'includes/TripalBundleUIController.inc', 'menu wildcard' => '%tripal_bundle', ) ); } return $entities; } /** * Implements hook_entity_info_alter(). * * We are adding the info about the tripal data types via a hook to avoid a * recursion issue as loading the model types requires the entity info as well. * */ function tripal_entities_entity_info_alter(&$entity_info) { // Get a list of published terms from 'tripal_term $published_terms = chado_generate_var('tripal_term', array('publish' => 1), array('return_array' => 1)); foreach ($published_terms as $term) { // Bundles are alternative groups of fields or configuration // associated with a base entity type. // We want to dynamically add the bundles (or term types) to the entity. $cvterm = $term->cvterm_id; $entity_type = $cvterm->dbxref_id->db_id->name; $accession = $cvterm->dbxref_id->accession; $bundle_id = $entity_type . '_' . $accession; $label = preg_replace('/_/', ' ', ucwords($cvterm->name)); $entity_info[$entity_type]['bundles'][$bundle_id] = array ( 'label' => $label, 'admin' => array ( 'path' => 'admin/structure/bio_data/' . $entity_type . '/manage/%tripal_bundle', 'real path' => 'admin/structure/bio_data/' . $entity_type . '/manage/' . $bundle_id, 'bundle argument' => 5, 'access arguments' => array ( 'administer tripal data types' ) ) ); } } /** * Get published vocabularies as select options * @return multitype:NULL */ function tripal_entities_get_published_vocabularies_as_select_options() { $published_vocs = chado_generate_var('tripal_vocabulary', array('publish' => 1), array('return_array' => 1)); $options = array(); foreach ($published_vocs as $voc) { $options [$voc->cv_id->cv_id] = $voc->cv_id->name; } return $options; } /** * Get published terms as select options * @return multitype:NULL */ function tripal_entities_get_published_terms_as_select_options($cv_id = NULL) { $where = array('publish' => 1); $published_terms = chado_generate_var('tripal_term', $where, array('return_array' => 1)); $options = array(); foreach ($published_terms as $term) { if (!$cv_id) { $options [$term->cvterm_id->name] = $term->cvterm_id->name; } else { if ($term->cvterm_id->cv_id->cv_id == $cv_id) { $options [$term->cvterm_id->name] = $term->cvterm_id->name; } } } return $options; } /** * Menu argument loader; Load a tripal data type by string. * * @param $type * The machine-readable name of a tripal data type to load. * @return * A tripal data type array or FALSE if $type does not exist. */ function tripal_bundle_load($bundle_type, $reset = FALSE) { // Get the type of entity by the ID. $bundle_types = db_select('tripal_bundle', 'tdt') ->fields('tdt', array('id', 'type')) ->condition('bundle', $bundle_type) ->execute() ->fetchObject(); // Load the tripal_bundle entity. These entities are always the same // as an Tripal entity type but with a '_bundle' extension. $entity = entity_load($bundle_types->type . '_bundle', array($bundle_types->id), array(), $reset); return reset($entity); } /** * Fetch a tripal_entity object. Make sure that the wildcard you choose * in the tripal_entity entity definition fits the function name here. * * @param $id * Integer specifying the tripal_entity id. * @param $reset * A boolean indicating that the internal cache should be reset. * @return * A fully-loaded $tripal_entity object or FALSE if it cannot be loaded. * * @see tripal_entity_load_multiple() */ function tripal_entity_load($id, $reset = FALSE) { // Get the type of entity by the ID. $entity_type = db_select('tripal_entity', 'td') ->fields('td', array('type')) ->condition('id', $id) ->execute() ->fetchField(); // Load the entity. $entity = entity_load($entity_type, array($id), array(), $reset); return reset($entity); }