danielebarchiesi@4: <?php
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * @file
danielebarchiesi@4:  * Module file for the entity API.
danielebarchiesi@4:  */
danielebarchiesi@4: 
danielebarchiesi@4: module_load_include('inc', 'entity', 'modules/callbacks');
danielebarchiesi@4: module_load_include('inc', 'entity', 'includes/entity.property');
danielebarchiesi@4: 
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Defines status codes used for exportable entities.
danielebarchiesi@4:  */
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * A bit flag used to let us know if an entity is in the database.
danielebarchiesi@4:  */
danielebarchiesi@4: 
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * A bit flag used to let us know if an entity has been customly defined.
danielebarchiesi@4:  */
danielebarchiesi@4: define('ENTITY_CUSTOM', 0x01);
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Deprecated, but still here for backward compatibility.
danielebarchiesi@4:  */
danielebarchiesi@4: define('ENTITY_IN_DB', 0x01);
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * A bit flag used to let us know if an entity is a 'default' in code.
danielebarchiesi@4:  */
danielebarchiesi@4: define('ENTITY_IN_CODE', 0x02);
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * A bit flag used to mark entities as overridden, e.g. they were originally
danielebarchiesi@4:  * definded in code and are saved now in the database. Same as
danielebarchiesi@4:  * (ENTITY_CUSTOM | ENTITY_IN_CODE).
danielebarchiesi@4:  */
danielebarchiesi@4: define('ENTITY_OVERRIDDEN', 0x03);
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * A bit flag used to mark entities as fixed, thus not changeable for any
danielebarchiesi@4:  * user.
danielebarchiesi@4:  */
danielebarchiesi@4: define('ENTITY_FIXED', 0x04 | 0x02);
danielebarchiesi@4: 
danielebarchiesi@4: 
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Determines whether for the given entity type a given operation is available.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @param $entity_type
danielebarchiesi@4:  *   The type of the entity.
danielebarchiesi@4:  * @param $op
danielebarchiesi@4:  *   One of 'create', 'view', 'save', 'delete', 'revision delete', 'access' or
danielebarchiesi@4:  *   'form'.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @return boolean
danielebarchiesi@4:  *   Whether the entity type supports the given operation.
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_type_supports($entity_type, $op) {
danielebarchiesi@4:   $info = entity_get_info($entity_type);
danielebarchiesi@4:   $keys = array(
danielebarchiesi@4:     'view' => 'view callback',
danielebarchiesi@4:     'create' => 'creation callback',
danielebarchiesi@4:     'delete' => 'deletion callback',
danielebarchiesi@4:     'revision delete' => 'revision deletion callback',
danielebarchiesi@4:     'save' => 'save callback',
danielebarchiesi@4:     'access' => 'access callback',
danielebarchiesi@4:     'form' => 'form callback'
danielebarchiesi@4:   );
danielebarchiesi@4:   if (isset($info[$keys[$op]])) {
danielebarchiesi@4:     return TRUE;
danielebarchiesi@4:   }
danielebarchiesi@4:   if ($op == 'revision delete') {
danielebarchiesi@4:     return in_array('EntityAPIControllerInterface', class_implements($info['controller class']));
danielebarchiesi@4:   }
danielebarchiesi@4:   if ($op == 'form') {
danielebarchiesi@4:     return (bool) entity_ui_controller($entity_type);
danielebarchiesi@4:   }
danielebarchiesi@4:   if ($op != 'access') {
danielebarchiesi@4:     return in_array('EntityAPIControllerInterface', class_implements($info['controller class']));
danielebarchiesi@4:   }
danielebarchiesi@4:   return FALSE;
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Menu loader function: load an entity from its path.
danielebarchiesi@4:  *
danielebarchiesi@4:  * This can be used to load entities of all types in menu paths:
danielebarchiesi@4:  *
danielebarchiesi@4:  * @code
danielebarchiesi@4:  * $items['myentity/%entity_object'] = array(
danielebarchiesi@4:  *   'load arguments' => array('myentity'),
danielebarchiesi@4:  *   'title' => ...,
danielebarchiesi@4:  *   'page callback' => ...,
danielebarchiesi@4:  *   'page arguments' => array(...),
danielebarchiesi@4:  *   'access arguments' => array(...),
danielebarchiesi@4:  * );
danielebarchiesi@4:  * @endcode
danielebarchiesi@4:  *
danielebarchiesi@4:  * @param $entity_id
danielebarchiesi@4:  *   The ID of the entity to load, passed by the menu URL.
danielebarchiesi@4:  * @param $entity_type
danielebarchiesi@4:  *   The type of the entity to load.
danielebarchiesi@4:  * @return
danielebarchiesi@4:  *   A fully loaded entity object, or FALSE in case of error.
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_object_load($entity_id, $entity_type) {
danielebarchiesi@4:   $entities = entity_load($entity_type, array($entity_id));
danielebarchiesi@4:   return reset($entities);
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Page callback to show links to add an entity of a specific bundle.
danielebarchiesi@4:  *
danielebarchiesi@4:  * Entity modules that provide a further description to their bundles may wish
danielebarchiesi@4:  * to implement their own version of this to show these.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @param $entity_type
danielebarchiesi@4:  *   The type of the entity.
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_ui_bundle_add_page($entity_type) {
danielebarchiesi@4:   // Set the title, as we're a MENU_LOCAL_ACTION and hence just get tab titles.
danielebarchiesi@4:   module_load_include('inc', 'entity', 'includes/entity.ui');
danielebarchiesi@4:   drupal_set_title(entity_ui_get_action_title('add', $entity_type));
danielebarchiesi@4: 
danielebarchiesi@4:   // Get entity info for our bundles.
danielebarchiesi@4:   $info = entity_get_info($entity_type);
danielebarchiesi@4:   $items = array();
danielebarchiesi@4:   foreach ($info['bundles'] as $bundle_name => $bundle_info) {
danielebarchiesi@4:     // Create an empty entity with just the bundle set to check for access.
danielebarchiesi@4:     $dummy_entity = entity_create($entity_type, array(
danielebarchiesi@4:       'bundle' => $bundle_name,
danielebarchiesi@4:     ));
danielebarchiesi@4:     // If modules use a uid, they can default to the current-user
danielebarchiesi@4:     // in their create() method on the storage controller.
danielebarchiesi@4:     if (entity_access('create', $entity_type, $dummy_entity, $account = NULL)) {
danielebarchiesi@4:       $add_path = $info['admin ui']['path'] . '/add/' . $bundle_name;
danielebarchiesi@4:       $items[] = l(t('Add @label', array('@label' => $bundle_info['label'])), $add_path);
danielebarchiesi@4:     }
danielebarchiesi@4:   }
danielebarchiesi@4:   return theme('item_list', array('items' => $items));
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Page callback to add an entity of a specific bundle.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @param $entity_type
danielebarchiesi@4:  *   The type of the entity.
danielebarchiesi@4:  * @param $bundle_name
danielebarchiesi@4:  *   The bundle machine name.
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_ui_get_bundle_add_form($entity_type, $bundle_name) {
danielebarchiesi@4:   $info = entity_get_info($entity_type);
danielebarchiesi@4:   $bundle_key = $info['entity keys']['bundle'];
danielebarchiesi@4: 
danielebarchiesi@4:   // Make a stub entity of the right bundle to pass to the entity_ui_get_form().
danielebarchiesi@4:   $values = array(
danielebarchiesi@4:     $bundle_key => $bundle_name,
danielebarchiesi@4:   );
danielebarchiesi@4:   $entity = entity_create($entity_type, $values);
danielebarchiesi@4: 
danielebarchiesi@4:   return entity_ui_get_form($entity_type, $entity, 'add');
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * A wrapper around entity_load() to load a single entity by name or numeric id.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @todo: Re-name entity_load() to entity_load_multiple() in d8 core and this
danielebarchiesi@4:  * to entity_load().
danielebarchiesi@4:  *
danielebarchiesi@4:  * @param $entity_type
danielebarchiesi@4:  *   The entity type to load, e.g. node or user.
danielebarchiesi@4:  * @param $id
danielebarchiesi@4:  *   The entity id, either the numeric id or the entity name. In case the entity
danielebarchiesi@4:  *   type has specified a name key, both the numeric id and the name may be
danielebarchiesi@4:  *   passed.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @return
danielebarchiesi@4:  *   The entity object, or FALSE.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @see entity_load()
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_load_single($entity_type, $id) {
danielebarchiesi@4:   $entities = entity_load($entity_type, array($id));
danielebarchiesi@4:   return reset($entities);
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * A wrapper around entity_load() to return entities keyed by name key if existing.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @param $entity_type
danielebarchiesi@4:  *   The entity type to load, e.g. node or user.
danielebarchiesi@4:  * @param $names
danielebarchiesi@4:  *   An array of entity names or ids, or FALSE to load all entities.
danielebarchiesi@4:  * @param $conditions
danielebarchiesi@4:  *   (deprecated) An associative array of conditions on the base table, where
danielebarchiesi@4:  *   the keys are the database fields and the values are the values those
danielebarchiesi@4:  *   fields must have. Instead, it is preferable to use EntityFieldQuery to
danielebarchiesi@4:  *   retrieve a list of entity IDs loadable by this function.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @return
danielebarchiesi@4:  *   An array of entity objects indexed by their names (or ids if the entity
danielebarchiesi@4:  *   type has no name key).
danielebarchiesi@4:  *
danielebarchiesi@4:  * @see entity_load()
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_load_multiple_by_name($entity_type, $names = FALSE, $conditions = array()) {
danielebarchiesi@4:   $entities = entity_load($entity_type, $names, $conditions);
danielebarchiesi@4:   $info = entity_get_info($entity_type);
danielebarchiesi@4:   if (!isset($info['entity keys']['name'])) {
danielebarchiesi@4:     return $entities;
danielebarchiesi@4:   }
danielebarchiesi@4:   return entity_key_array_by_property($entities, $info['entity keys']['name']);
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Permanently save an entity.
danielebarchiesi@4:  *
danielebarchiesi@4:  * In case of failures, an exception is thrown.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @param $entity_type
danielebarchiesi@4:  *   The type of the entity.
danielebarchiesi@4:  * @param $entity
danielebarchiesi@4:  *   The entity to save.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @return
danielebarchiesi@4:  *   For entity types provided by the CRUD API, SAVED_NEW or SAVED_UPDATED is
danielebarchiesi@4:  *   returned depending on the operation performed. If there is no information
danielebarchiesi@4:  *   how to save the entity, FALSE is returned.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @see entity_type_supports()
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_save($entity_type, $entity) {
danielebarchiesi@4:   $info = entity_get_info($entity_type);
danielebarchiesi@4:   if (method_exists($entity, 'save')) {
danielebarchiesi@4:     return $entity->save();
danielebarchiesi@4:   }
danielebarchiesi@4:   elseif (isset($info['save callback'])) {
danielebarchiesi@4:     $info['save callback']($entity);
danielebarchiesi@4:   }
danielebarchiesi@4:   elseif (in_array('EntityAPIControllerInterface', class_implements($info['controller class']))) {
danielebarchiesi@4:     return entity_get_controller($entity_type)->save($entity);
danielebarchiesi@4:   }
danielebarchiesi@4:   else {
danielebarchiesi@4:     return FALSE;
danielebarchiesi@4:   }
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Permanently delete the given entity.
danielebarchiesi@4:  *
danielebarchiesi@4:  * In case of failures, an exception is thrown.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @param $entity_type
danielebarchiesi@4:  *   The type of the entity.
danielebarchiesi@4:  * @param $id
danielebarchiesi@4:  *   The uniform identifier of the entity to delete.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @return
danielebarchiesi@4:  *   FALSE, if there were no information how to delete the entity.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @see entity_type_supports()
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_delete($entity_type, $id) {
danielebarchiesi@4:   return entity_delete_multiple($entity_type, array($id));
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Permanently delete multiple entities.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @param $entity_type
danielebarchiesi@4:  *   The type of the entity.
danielebarchiesi@4:  * @param $ids
danielebarchiesi@4:  *   An array of entity ids of the entities to delete. In case the entity makes
danielebarchiesi@4:  *   use of a name key, both the names or numeric ids may be passed.
danielebarchiesi@4:  * @return
danielebarchiesi@4:  *   FALSE if the given entity type isn't compatible to the CRUD API.
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_delete_multiple($entity_type, $ids) {
danielebarchiesi@4:   $info = entity_get_info($entity_type);
danielebarchiesi@4:   if (isset($info['deletion callback'])) {
danielebarchiesi@4:     foreach ($ids as $id) {
danielebarchiesi@4:       $info['deletion callback']($id);
danielebarchiesi@4:     }
danielebarchiesi@4:   }
danielebarchiesi@4:   elseif (in_array('EntityAPIControllerInterface', class_implements($info['controller class']))) {
danielebarchiesi@4:     entity_get_controller($entity_type)->delete($ids);
danielebarchiesi@4:   }
danielebarchiesi@4:   else {
danielebarchiesi@4:     return FALSE;
danielebarchiesi@4:   }
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Loads an entity revision.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @param $entity_type
danielebarchiesi@4:  *   The type of the entity.
danielebarchiesi@4:  * @param $revision_id
danielebarchiesi@4:  *   The id of the revision to load.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @return
danielebarchiesi@4:  *   The entity object, or FALSE if there is no entity with the given revision
danielebarchiesi@4:  *   id.
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_revision_load($entity_type, $revision_id) {
danielebarchiesi@4:   $info = entity_get_info($entity_type);
danielebarchiesi@4:   if (!empty($info['entity keys']['revision'])) {
danielebarchiesi@4:     $entity_revisions = entity_load($entity_type, FALSE, array($info['entity keys']['revision'] => $revision_id));
danielebarchiesi@4:     return reset($entity_revisions);
danielebarchiesi@4:   }
danielebarchiesi@4:   return FALSE;
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Deletes an entity revision.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @param $entity_type
danielebarchiesi@4:  *   The type of the entity.
danielebarchiesi@4:  * @param $revision_id
danielebarchiesi@4:  *   The revision ID to delete.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @return
danielebarchiesi@4:  *   TRUE if the entity revision could be deleted, FALSE otherwise.
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_revision_delete($entity_type, $revision_id) {
danielebarchiesi@4:   $info = entity_get_info($entity_type);
danielebarchiesi@4:   if (isset($info['revision deletion callback'])) {
danielebarchiesi@4:     return $info['revision deletion callback']($revision_id, $entity_type);
danielebarchiesi@4:   }
danielebarchiesi@4:   elseif (in_array('EntityAPIControllerRevisionableInterface', class_implements($info['controller class']))) {
danielebarchiesi@4:     return entity_get_controller($entity_type)->deleteRevision($revision_id);
danielebarchiesi@4:   }
danielebarchiesi@4:   return FALSE;
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Checks whether the given entity is the default revision.
danielebarchiesi@4:  *
danielebarchiesi@4:  * Note that newly created entities will always be created in default revision,
danielebarchiesi@4:  * thus TRUE is returned for not yet saved entities.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @param $entity_type
danielebarchiesi@4:  *   The type of the entity.
danielebarchiesi@4:  * @param $entity
danielebarchiesi@4:  *   The entity object to check.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @return boolean
danielebarchiesi@4:  *   A boolean indicating whether the entity is in default revision is returned.
danielebarchiesi@4:  *   If the entity is not revisionable or is new, TRUE is returned.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @see entity_revision_set_default()
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_revision_is_default($entity_type, $entity) {
danielebarchiesi@4:   $info = entity_get_info($entity_type);
danielebarchiesi@4:   if (empty($info['entity keys']['revision'])) {
danielebarchiesi@4:     return TRUE;
danielebarchiesi@4:   }
danielebarchiesi@4:   // Newly created entities will always be created in default revision.
danielebarchiesi@4:   if (!empty($entity->is_new) || empty($entity->{$info['entity keys']['id']})) {
danielebarchiesi@4:     return TRUE;
danielebarchiesi@4:   }
danielebarchiesi@4:   if (in_array('EntityAPIControllerRevisionableInterface', class_implements($info['controller class']))) {
danielebarchiesi@4:     $key = !empty($info['entity keys']['default revision']) ? $info['entity keys']['default revision'] : 'default_revision';
danielebarchiesi@4:     return !empty($entity->$key);
danielebarchiesi@4:   }
danielebarchiesi@4:   else {
danielebarchiesi@4:     // Else, just load the default entity and compare the ID. Usually, the
danielebarchiesi@4:     // entity should be already statically cached anyway.
danielebarchiesi@4:     $default = entity_load_single($entity_type, $entity->{$info['entity keys']['id']});
danielebarchiesi@4:     return $default->{$info['entity keys']['revision']} == $entity->{$info['entity keys']['revision']};
danielebarchiesi@4:   }
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Sets a given entity revision as default revision.
danielebarchiesi@4:  *
danielebarchiesi@4:  * Note that the default revision flag will only be supported by entity types
danielebarchiesi@4:  * based upon the EntityAPIController, i.e. implementing the
danielebarchiesi@4:  * EntityAPIControllerRevisionableInterface.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @param $entity_type
danielebarchiesi@4:  *   The type of the entity.
danielebarchiesi@4:  * @param $entity
danielebarchiesi@4:  *   The entity revision to update.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @see entity_revision_is_default()
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_revision_set_default($entity_type, $entity) {
danielebarchiesi@4:   $info = entity_get_info($entity_type);
danielebarchiesi@4:   if (!empty($info['entity keys']['revision'])) {
danielebarchiesi@4:     $key = !empty($info['entity keys']['default revision']) ? $info['entity keys']['default revision'] : 'default_revision';
danielebarchiesi@4:     $entity->$key = TRUE;
danielebarchiesi@4:   }
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Create a new entity object.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @param $entity_type
danielebarchiesi@4:  *   The type of the entity.
danielebarchiesi@4:  * @param $values
danielebarchiesi@4:  *   An array of values to set, keyed by property name. If the entity type has
danielebarchiesi@4:  *   bundles the bundle key has to be specified.
danielebarchiesi@4:  * @return
danielebarchiesi@4:  *   A new instance of the entity type or FALSE if there is no information for
danielebarchiesi@4:  *   the given entity type.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @see entity_type_supports()
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_create($entity_type, array $values) {
danielebarchiesi@4:   $info = entity_get_info($entity_type);
danielebarchiesi@4:   if (isset($info['creation callback'])) {
danielebarchiesi@4:     return $info['creation callback']($values, $entity_type);
danielebarchiesi@4:   }
danielebarchiesi@4:   elseif (in_array('EntityAPIControllerInterface', class_implements($info['controller class']))) {
danielebarchiesi@4:     return entity_get_controller($entity_type)->create($values);
danielebarchiesi@4:   }
danielebarchiesi@4:   return FALSE;
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Exports an entity.
danielebarchiesi@4:  *
danielebarchiesi@4:  * Note: Currently, this only works for entity types provided with the entity
danielebarchiesi@4:  * CRUD API.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @param $entity_type
danielebarchiesi@4:  *   The type of the entity.
danielebarchiesi@4:  * @param $entity
danielebarchiesi@4:  *   The entity to export.
danielebarchiesi@4:  * @param $prefix
danielebarchiesi@4:  *   An optional prefix for each line.
danielebarchiesi@4:  * @return
danielebarchiesi@4:  *   The exported entity as serialized string. The format is determined by the
danielebarchiesi@4:  *   respective entity controller, e.g. it is JSON for the EntityAPIController.
danielebarchiesi@4:  *   The output is suitable for entity_import().
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_export($entity_type, $entity, $prefix = '') {
danielebarchiesi@4:   if (method_exists($entity, 'export')) {
danielebarchiesi@4:     return $entity->export($prefix);
danielebarchiesi@4:   }
danielebarchiesi@4:   $info = entity_get_info($entity_type);
danielebarchiesi@4:   if (in_array('EntityAPIControllerInterface', class_implements($info['controller class']))) {
danielebarchiesi@4:     return entity_get_controller($entity_type)->export($entity, $prefix);
danielebarchiesi@4:   }
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Imports an entity.
danielebarchiesi@4:  *
danielebarchiesi@4:  * Note: Currently, this only works for entity types provided with the entity
danielebarchiesi@4:  * CRUD API.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @param $entity_type
danielebarchiesi@4:  *   The type of the entity.
danielebarchiesi@4:  * @param string $export
danielebarchiesi@4:  *   The string containing the serialized entity as produced by
danielebarchiesi@4:  *   entity_export().
danielebarchiesi@4:  * @return
danielebarchiesi@4:  *   The imported entity object not yet saved.
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_import($entity_type, $export) {
danielebarchiesi@4:   $info = entity_get_info($entity_type);
danielebarchiesi@4:   if (in_array('EntityAPIControllerInterface', class_implements($info['controller class']))) {
danielebarchiesi@4:     return entity_get_controller($entity_type)->import($export);
danielebarchiesi@4:   }
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Checks whether an entity type is fieldable.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @param $entity_type
danielebarchiesi@4:  *   The type of the entity.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @return
danielebarchiesi@4:  *   TRUE if the entity type is fieldable, FALSE otherwise.
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_type_is_fieldable($entity_type) {
danielebarchiesi@4:   $info = entity_get_info($entity_type);
danielebarchiesi@4:   return !empty($info['fieldable']);
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Builds a structured array representing the entity's content.
danielebarchiesi@4:  *
danielebarchiesi@4:  * The content built for the entity will vary depending on the $view_mode
danielebarchiesi@4:  * parameter.
danielebarchiesi@4:  *
danielebarchiesi@4:  * Note: Currently, this only works for entity types provided with the entity
danielebarchiesi@4:  * CRUD API.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @param $entity_type
danielebarchiesi@4:  *   The type of the entity.
danielebarchiesi@4:  * @param $entity
danielebarchiesi@4:  *   An entity object.
danielebarchiesi@4:  * @param $view_mode
danielebarchiesi@4:  *   A view mode as used by this entity type, e.g. 'full', 'teaser'...
danielebarchiesi@4:  * @param $langcode
danielebarchiesi@4:  *   (optional) A language code to use for rendering. Defaults to the global
danielebarchiesi@4:  *   content language of the current request.
danielebarchiesi@4:  * @return
danielebarchiesi@4:  *   The renderable array.
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_build_content($entity_type, $entity, $view_mode = 'full', $langcode = NULL) {
danielebarchiesi@4:   $info = entity_get_info($entity_type);
danielebarchiesi@4:   if (method_exists($entity, 'buildContent')) {
danielebarchiesi@4:     return $entity->buildContent($view_mode, $langcode);
danielebarchiesi@4:   }
danielebarchiesi@4:   elseif (in_array('EntityAPIControllerInterface', class_implements($info['controller class']))) {
danielebarchiesi@4:     return entity_get_controller($entity_type)->buildContent($entity, $view_mode, $langcode);
danielebarchiesi@4:   }
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Returns the entity identifier, i.e. the entities name or numeric id.
danielebarchiesi@4:  *
danielebarchiesi@4:  * Unlike entity_extract_ids() this function returns the name of the entity
danielebarchiesi@4:  * instead of the numeric id, in case the entity type has specified a name key.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @param $entity_type
danielebarchiesi@4:  *   The type of the entity.
danielebarchiesi@4:  * @param $entity
danielebarchiesi@4:  *   An entity object.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @see entity_extract_ids()
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_id($entity_type, $entity) {
danielebarchiesi@4:   if (method_exists($entity, 'identifier')) {
danielebarchiesi@4:     return $entity->identifier();
danielebarchiesi@4:   }
danielebarchiesi@4:   $info = entity_get_info($entity_type);
danielebarchiesi@4:   $key = isset($info['entity keys']['name']) ? $info['entity keys']['name'] : $info['entity keys']['id'];
danielebarchiesi@4:   return isset($entity->$key) ? $entity->$key : NULL;
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Generate an array for rendering the given entities.
danielebarchiesi@4:  *
danielebarchiesi@4:  * Entities being viewed, are generally expected to be fully-loaded entity
danielebarchiesi@4:  * objects, thus have their name or id key set. However, it is possible to
danielebarchiesi@4:  * view a single entity without any id, e.g. for generating a preview during
danielebarchiesi@4:  * creation.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @param $entity_type
danielebarchiesi@4:  *   The type of the entity.
danielebarchiesi@4:  * @param $entities
danielebarchiesi@4:  *   An array of entities to render.
danielebarchiesi@4:  * @param $view_mode
danielebarchiesi@4:  *   A view mode as used by this entity type, e.g. 'full', 'teaser'...
danielebarchiesi@4:  * @param $langcode
danielebarchiesi@4:  *   (optional) A language code to use for rendering. Defaults to the global
danielebarchiesi@4:  *   content language of the current request.
danielebarchiesi@4:  * @param $page
danielebarchiesi@4:  *   (optional) If set will control if the entity is rendered: if TRUE
danielebarchiesi@4:  *   the entity will be rendered without its title, so that it can be embeded
danielebarchiesi@4:  *   in another context. If FALSE the entity will be displayed with its title
danielebarchiesi@4:  *   in a mode suitable for lists.
danielebarchiesi@4:  *   If unset, the page mode will be enabled if the current path is the URI
danielebarchiesi@4:  *   of the entity, as returned by entity_uri().
danielebarchiesi@4:  *   This parameter is only supported for entities which controller is a
danielebarchiesi@4:  *   EntityAPIControllerInterface.
danielebarchiesi@4:  * @return
danielebarchiesi@4:  *   The renderable array, keyed by the entity type and by entity identifiers,
danielebarchiesi@4:  *   for which the entity name is used if existing - see entity_id(). If there
danielebarchiesi@4:  *   is no information on how to view an entity, FALSE is returned.
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_view($entity_type, $entities, $view_mode = 'full', $langcode = NULL, $page = NULL) {
danielebarchiesi@4:   $info = entity_get_info($entity_type);
danielebarchiesi@4:   if (isset($info['view callback'])) {
danielebarchiesi@4:     $entities = entity_key_array_by_property($entities, $info['entity keys']['id']);
danielebarchiesi@4:     return $info['view callback']($entities, $view_mode, $langcode, $entity_type);
danielebarchiesi@4:   }
danielebarchiesi@4:   elseif (in_array('EntityAPIControllerInterface', class_implements($info['controller class']))) {
danielebarchiesi@4:     return entity_get_controller($entity_type)->view($entities, $view_mode, $langcode, $page);
danielebarchiesi@4:   }
danielebarchiesi@4:   return FALSE;
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Determines whether the given user has access to an entity.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @param $op
danielebarchiesi@4:  *   The operation being performed. One of 'view', 'update', 'create' or
danielebarchiesi@4:  *   'delete'.
danielebarchiesi@4:  * @param $entity_type
danielebarchiesi@4:  *   The entity type of the entity to check for.
danielebarchiesi@4:  * @param $entity
danielebarchiesi@4:  *   Optionally an entity to check access for. If no entity is given, it will be
danielebarchiesi@4:  *   determined whether access is allowed for all entities of the given type.
danielebarchiesi@4:  * @param $account
danielebarchiesi@4:  *   The user to check for. Leave it to NULL to check for the global user.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @return boolean
danielebarchiesi@4:  *   Whether access is allowed or not. If the entity type does not specify any
danielebarchiesi@4:  *   access information, NULL is returned.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @see entity_type_supports()
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_access($op, $entity_type, $entity = NULL, $account = NULL) {
danielebarchiesi@4:   if (($info = entity_get_info()) && isset($info[$entity_type]['access callback'])) {
danielebarchiesi@4:     return $info[$entity_type]['access callback']($op, $entity, $account, $entity_type);
danielebarchiesi@4:   }
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Gets the edit form for any entity.
danielebarchiesi@4:  *
danielebarchiesi@4:  * This helper makes use of drupal_get_form() and the regular form builder
danielebarchiesi@4:  * function of the entity type to retrieve and process the form as usual.
danielebarchiesi@4:  *
danielebarchiesi@4:  * In order to use this helper to show an entity add form, the new entity object
danielebarchiesi@4:  * can be created via entity_create() or entity_property_values_create_entity().
danielebarchiesi@4:  *
danielebarchiesi@4:  * @param $entity_type
danielebarchiesi@4:  *   The type of the entity.
danielebarchiesi@4:  * @param $entity
danielebarchiesi@4:  *   The entity to show the edit form for.
danielebarchiesi@4:  * @return
danielebarchiesi@4:  *   The renderable array of the form. If there is no entity form or missing
danielebarchiesi@4:  *   metadata, FALSE is returned.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @see entity_type_supports()
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_form($entity_type, $entity) {
danielebarchiesi@4:   $info = entity_get_info($entity_type);
danielebarchiesi@4:   if (isset($info['form callback'])) {
danielebarchiesi@4:     return $info['form callback']($entity, $entity_type);
danielebarchiesi@4:   }
danielebarchiesi@4:   // If there is an UI controller, the providing module has to implement the
danielebarchiesi@4:   // entity form using entity_ui_get_form().
danielebarchiesi@4:   elseif (entity_ui_controller($entity_type)) {
danielebarchiesi@4:     return entity_metadata_form_entity_ui($entity, $entity_type);
danielebarchiesi@4:   }
danielebarchiesi@4:   return FALSE;
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Converts an array of entities to be keyed by the values of a given property.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @param array $entities
danielebarchiesi@4:  *   The array of entities to convert.
danielebarchiesi@4:  * @param $property
danielebarchiesi@4:  *   The name of entity property, by which the array should be keyed. To get
danielebarchiesi@4:  *   reasonable results, the property has to have unique values.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @return array
danielebarchiesi@4:  *   The same entities in the same order, but keyed by their $property values.
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_key_array_by_property(array $entities, $property) {
danielebarchiesi@4:   $ret = array();
danielebarchiesi@4:   foreach ($entities as $entity) {
danielebarchiesi@4:     $key = isset($entity->$property) ? $entity->$property : NULL;
danielebarchiesi@4:     $ret[$key] = $entity;
danielebarchiesi@4:   }
danielebarchiesi@4:   return $ret;
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Get the entity info for the entity types provided via the entity CRUD API.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @return
danielebarchiesi@4:  *  An array in the same format as entity_get_info(), containing the entities
danielebarchiesi@4:  *  whose controller class implements the EntityAPIControllerInterface.
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_crud_get_info() {
danielebarchiesi@4:   $types = array();
danielebarchiesi@4:   foreach (entity_get_info() as $type => $info) {
danielebarchiesi@4:     if (isset($info['controller class']) && in_array('EntityAPIControllerInterface', class_implements($info['controller class']))) {
danielebarchiesi@4:       $types[$type] = $info;
danielebarchiesi@4:     }
danielebarchiesi@4:   }
danielebarchiesi@4:   return $types;
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Checks if a given entity has a certain exportable status.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @param $entity_type
danielebarchiesi@4:  *   The type of the entity.
danielebarchiesi@4:  * @param $entity
danielebarchiesi@4:  *   The entity to check the status on.
danielebarchiesi@4:  * @param $status
danielebarchiesi@4:  *   The constant status like ENTITY_CUSTOM, ENTITY_IN_CODE, ENTITY_OVERRIDDEN
danielebarchiesi@4:  *   or ENTITY_FIXED.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @return
danielebarchiesi@4:  *   TRUE if the entity has the status, FALSE otherwise.
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_has_status($entity_type, $entity, $status) {
danielebarchiesi@4:   $info = entity_get_info($entity_type);
danielebarchiesi@4:   $status_key = empty($info['entity keys']['status']) ? 'status' : $info['entity keys']['status'];
danielebarchiesi@4:   return isset($entity->{$status_key}) && ($entity->{$status_key} & $status) == $status;
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Export a variable. Copied from ctools.
danielebarchiesi@4:  *
danielebarchiesi@4:  * This is a replacement for var_export(), allowing us to more nicely
danielebarchiesi@4:  * format exports. It will recurse down into arrays and will try to
danielebarchiesi@4:  * properly export bools when it can.
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_var_export($var, $prefix = '') {
danielebarchiesi@4:   if (is_array($var)) {
danielebarchiesi@4:     if (empty($var)) {
danielebarchiesi@4:       $output = 'array()';
danielebarchiesi@4:     }
danielebarchiesi@4:     else {
danielebarchiesi@4:       $output = "array(\n";
danielebarchiesi@4:       foreach ($var as $key => $value) {
danielebarchiesi@4:         $output .= "  '$key' => " . entity_var_export($value, '  ') . ",\n";
danielebarchiesi@4:       }
danielebarchiesi@4:       $output .= ')';
danielebarchiesi@4:     }
danielebarchiesi@4:   }
danielebarchiesi@4:   elseif (is_bool($var)) {
danielebarchiesi@4:     $output = $var ? 'TRUE' : 'FALSE';
danielebarchiesi@4:   }
danielebarchiesi@4:   else {
danielebarchiesi@4:     $output = var_export($var, TRUE);
danielebarchiesi@4:   }
danielebarchiesi@4: 
danielebarchiesi@4:   if ($prefix) {
danielebarchiesi@4:     $output = str_replace("\n", "\n$prefix", $output);
danielebarchiesi@4:   }
danielebarchiesi@4:   return $output;
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Export a variable in pretty formatted JSON.
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_var_json_export($var, $prefix = '') {
danielebarchiesi@4:   if (is_array($var) && $var) {
danielebarchiesi@4:     // Defines whether we use a JSON array or object.
danielebarchiesi@4:     $use_array = ($var == array_values($var));
danielebarchiesi@4:     $output = $use_array ? "[" : "{";
danielebarchiesi@4: 
danielebarchiesi@4:     foreach ($var as $key => $value) {
danielebarchiesi@4:       if ($use_array) {
danielebarchiesi@4:         $values[] = entity_var_json_export($value, '  ');
danielebarchiesi@4:       }
danielebarchiesi@4:       else {
danielebarchiesi@4:         $values[] = entity_var_json_export((string) $key, '  ') . ' : ' . entity_var_json_export($value, '  ');
danielebarchiesi@4:       }
danielebarchiesi@4:     }
danielebarchiesi@4:     // Use several lines for long content. However for objects with a single
danielebarchiesi@4:     // entry keep the key in the first line.
danielebarchiesi@4:     if (strlen($content = implode(', ', $values)) > 70 && ($use_array || count($values) > 1)) {
danielebarchiesi@4:       $output .= "\n  " . implode(",\n  ", $values) . "\n";
danielebarchiesi@4:     }
danielebarchiesi@4:     elseif (strpos($content, "\n") !== FALSE) {
danielebarchiesi@4:       $output .= " " . $content . "\n";
danielebarchiesi@4:     }
danielebarchiesi@4:     else {
danielebarchiesi@4:       $output .= " " . $content . ' ';
danielebarchiesi@4:     }
danielebarchiesi@4:     $output .= $use_array ? ']' : '}';
danielebarchiesi@4:   }
danielebarchiesi@4:   else {
danielebarchiesi@4:     $output = drupal_json_encode($var);
danielebarchiesi@4:   }
danielebarchiesi@4: 
danielebarchiesi@4:   if ($prefix) {
danielebarchiesi@4:     $output = str_replace("\n", "\n$prefix", $output);
danielebarchiesi@4:   }
danielebarchiesi@4:   return $output;
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Rebuild the default entities provided in code.
danielebarchiesi@4:  *
danielebarchiesi@4:  * Exportable entities provided in code get saved to the database once a module
danielebarchiesi@4:  * providing defaults in code is activated. This allows module and entity_load()
danielebarchiesi@4:  * to easily deal with exportable entities just by relying on the database.
danielebarchiesi@4:  *
danielebarchiesi@4:  * The defaults get rebuilt if the cache is cleared or new modules providing
danielebarchiesi@4:  * defaults are enabled, such that the defaults in the database are up to date.
danielebarchiesi@4:  * A default entity gets updated with the latest defaults in code during rebuild
danielebarchiesi@4:  * as long as the default has not been overridden. Once a module providing
danielebarchiesi@4:  * defaults is disabled, its default entities get removed from the database
danielebarchiesi@4:  * unless they have been overridden. In that case the overridden entity is left
danielebarchiesi@4:  * in the database, but its status gets updated to 'custom'.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @param $entity_types
danielebarchiesi@4:  *   (optional) If specified, only the defaults of the given entity types are
danielebarchiesi@4:  *   rebuilt.
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_defaults_rebuild($entity_types = NULL) {
danielebarchiesi@4:   if (!isset($entity_types)) {
danielebarchiesi@4:     $entity_types = array();
danielebarchiesi@4:     foreach (entity_crud_get_info() as $type => $info) {
danielebarchiesi@4:       if (!empty($info['exportable'])) {
danielebarchiesi@4:         $entity_types[] = $type;
danielebarchiesi@4:       }
danielebarchiesi@4:     };
danielebarchiesi@4:   }
danielebarchiesi@4:   foreach ($entity_types as $type) {
danielebarchiesi@4:     _entity_defaults_rebuild($type);
danielebarchiesi@4:   }
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Actually rebuild the defaults of a given entity type.
danielebarchiesi@4:  */
danielebarchiesi@4: function _entity_defaults_rebuild($entity_type) {
danielebarchiesi@4:   if (lock_acquire('entity_rebuild_' . $entity_type)) {
danielebarchiesi@4:     $info = entity_get_info($entity_type);
danielebarchiesi@4:     $hook = isset($info['export']['default hook']) ? $info['export']['default hook'] : 'default_' . $entity_type;
danielebarchiesi@4:     $keys = $info['entity keys'] + array('module' => 'module', 'status' => 'status', 'name' => $info['entity keys']['id']);
danielebarchiesi@4: 
danielebarchiesi@4:     // Check for the existence of the module and status columns.
danielebarchiesi@4:     if (!in_array($keys['status'], $info['schema_fields_sql']['base table']) || !in_array($keys['module'], $info['schema_fields_sql']['base table'])) {
danielebarchiesi@4:       trigger_error("Missing database columns for the exportable entity $entity_type as defined by entity_exportable_schema_fields(). Update the according module and run update.php!", E_USER_WARNING);
danielebarchiesi@4:       return;
danielebarchiesi@4:     }
danielebarchiesi@4: 
danielebarchiesi@4:     // Invoke the hook and collect default entities.
danielebarchiesi@4:     $entities = array();
danielebarchiesi@4:     foreach (module_implements($hook) as $module) {
danielebarchiesi@4:       foreach ((array) module_invoke($module, $hook) as $name => $entity) {
danielebarchiesi@4:         $entity->{$keys['name']} = $name;
danielebarchiesi@4:         $entity->{$keys['module']} = $module;
danielebarchiesi@4:         $entities[$name] = $entity;
danielebarchiesi@4:       }
danielebarchiesi@4:     }
danielebarchiesi@4:     drupal_alter($hook, $entities);
danielebarchiesi@4: 
danielebarchiesi@4:     // Check for defaults that disappeared.
danielebarchiesi@4:     $existing_defaults = entity_load_multiple_by_name($entity_type, FALSE, array($keys['status'] => array(ENTITY_OVERRIDDEN, ENTITY_IN_CODE, ENTITY_FIXED)));
danielebarchiesi@4: 
danielebarchiesi@4:     foreach ($existing_defaults as $name => $entity) {
danielebarchiesi@4:       if (empty($entities[$name])) {
danielebarchiesi@4:         $entity->is_rebuild = TRUE;
danielebarchiesi@4:         if (entity_has_status($entity_type, $entity, ENTITY_OVERRIDDEN)) {
danielebarchiesi@4:           $entity->{$keys['status']} = ENTITY_CUSTOM;
danielebarchiesi@4:           entity_save($entity_type, $entity);
danielebarchiesi@4:         }
danielebarchiesi@4:         else {
danielebarchiesi@4:           entity_delete($entity_type, $name);
danielebarchiesi@4:         }
danielebarchiesi@4:         unset($entity->is_rebuild);
danielebarchiesi@4:       }
danielebarchiesi@4:     }
danielebarchiesi@4: 
danielebarchiesi@4:     // Load all existing entities.
danielebarchiesi@4:     $existing_entities = entity_load_multiple_by_name($entity_type, array_keys($entities));
danielebarchiesi@4: 
danielebarchiesi@4:     foreach ($existing_entities as $name => $entity) {
danielebarchiesi@4:       if (entity_has_status($entity_type, $entity, ENTITY_CUSTOM)) {
danielebarchiesi@4:         // If the entity already exists but is not yet marked as overridden, we
danielebarchiesi@4:         // have to update the status.
danielebarchiesi@4:         if (!entity_has_status($entity_type, $entity, ENTITY_OVERRIDDEN)) {
danielebarchiesi@4:           $entity->{$keys['status']} |= ENTITY_OVERRIDDEN;
danielebarchiesi@4:           $entity->{$keys['module']} = $entities[$name]->{$keys['module']};
danielebarchiesi@4:           $entity->is_rebuild = TRUE;
danielebarchiesi@4:           entity_save($entity_type, $entity);
danielebarchiesi@4:           unset($entity->is_rebuild);
danielebarchiesi@4:         }
danielebarchiesi@4: 
danielebarchiesi@4:         // The entity is overridden, so we do not need to save the default.
danielebarchiesi@4:         unset($entities[$name]);
danielebarchiesi@4:       }
danielebarchiesi@4:     }
danielebarchiesi@4: 
danielebarchiesi@4:     // Save defaults.
danielebarchiesi@4:     $originals = array();
danielebarchiesi@4:     foreach ($entities as $name => $entity) {
danielebarchiesi@4:       if (!empty($existing_entities[$name])) {
danielebarchiesi@4:         // Make sure we are updating the existing default.
danielebarchiesi@4:         $entity->{$keys['id']} = $existing_entities[$name]->{$keys['id']};
danielebarchiesi@4:         unset($entity->is_new);
danielebarchiesi@4:       }
danielebarchiesi@4:       // Pre-populate $entity->original as we already have it. So we avoid
danielebarchiesi@4:       // loading it again.
danielebarchiesi@4:       $entity->original = !empty($existing_entities[$name]) ? $existing_entities[$name] : FALSE;
danielebarchiesi@4:       // Keep original entities for hook_{entity_type}_defaults_rebuild()
danielebarchiesi@4:       // implementations.
danielebarchiesi@4:       $originals[$name] = $entity->original;
danielebarchiesi@4: 
danielebarchiesi@4:       $entity->{$keys['status']} |= ENTITY_IN_CODE;
danielebarchiesi@4:       $entity->is_rebuild = TRUE;
danielebarchiesi@4:       entity_save($entity_type, $entity);
danielebarchiesi@4:       unset($entity->is_rebuild);
danielebarchiesi@4:     }
danielebarchiesi@4: 
danielebarchiesi@4:     // Invoke an entity type-specific hook so modules may apply changes, e.g.
danielebarchiesi@4:     // efficiently rebuild caches.
danielebarchiesi@4:     module_invoke_all($entity_type . '_defaults_rebuild', $entities, $originals);
danielebarchiesi@4: 
danielebarchiesi@4:     lock_release('entity_rebuild_' . $entity_type);
danielebarchiesi@4:   }
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Implements hook_modules_enabled().
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_modules_enabled($modules) {
danielebarchiesi@4:   foreach (_entity_modules_get_default_types($modules) as $type) {
danielebarchiesi@4:     _entity_defaults_rebuild($type);
danielebarchiesi@4:   }
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Implements hook_modules_disabled().
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_modules_disabled($modules) {
danielebarchiesi@4:   foreach (_entity_modules_get_default_types($modules) as $entity_type) {
danielebarchiesi@4:     $info = entity_get_info($entity_type);
danielebarchiesi@4: 
danielebarchiesi@4:     // Do nothing if the module providing the entity type has been disabled too.
danielebarchiesi@4:     if (isset($info['module']) && in_array($info['module'], $modules)) {
danielebarchiesi@4:       return;
danielebarchiesi@4:     }
danielebarchiesi@4: 
danielebarchiesi@4:     $keys = $info['entity keys'] + array('module' => 'module', 'status' => 'status', 'name' => $info['entity keys']['id']);
danielebarchiesi@4:     // Remove entities provided in code by one of the disabled modules.
danielebarchiesi@4:     $query = new EntityFieldQuery();
danielebarchiesi@4:     $query->entityCondition('entity_type', $entity_type, '=')
danielebarchiesi@4:           ->propertyCondition($keys['module'], $modules, 'IN')
danielebarchiesi@4:           ->propertyCondition($keys['status'], array(ENTITY_IN_CODE, ENTITY_FIXED), 'IN');
danielebarchiesi@4:     $result = $query->execute();
danielebarchiesi@4:     if (isset($result[$entity_type])) {
danielebarchiesi@4:       $entities = entity_load($entity_type, array_keys($result[$entity_type]));
danielebarchiesi@4:       entity_delete_multiple($entity_type, array_keys($entities));
danielebarchiesi@4:     }
danielebarchiesi@4: 
danielebarchiesi@4:     // Update overridden entities to be now custom.
danielebarchiesi@4:     $query = new EntityFieldQuery();
danielebarchiesi@4:     $query->entityCondition('entity_type', $entity_type, '=')
danielebarchiesi@4:           ->propertyCondition($keys['module'], $modules, 'IN')
danielebarchiesi@4:           ->propertyCondition($keys['status'], ENTITY_OVERRIDDEN, '=');
danielebarchiesi@4:     $result = $query->execute();
danielebarchiesi@4:     if (isset($result[$entity_type])) {
danielebarchiesi@4:       foreach (entity_load($entity_type, array_keys($result[$entity_type])) as $name => $entity) {
danielebarchiesi@4:         $entity->{$keys['status']} = ENTITY_CUSTOM;
danielebarchiesi@4:         $entity->{$keys['module']} = NULL;
danielebarchiesi@4:         entity_save($entity_type, $entity);
danielebarchiesi@4:       }
danielebarchiesi@4:     }
danielebarchiesi@4: 
danielebarchiesi@4:     // Rebuild the remaining defaults so any alterations of the disabled modules
danielebarchiesi@4:     // are gone.
danielebarchiesi@4:     _entity_defaults_rebuild($entity_type);
danielebarchiesi@4:   }
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Gets all entity types for which defaults are provided by the $modules.
danielebarchiesi@4:  */
danielebarchiesi@4: function _entity_modules_get_default_types($modules) {
danielebarchiesi@4:   $types = array();
danielebarchiesi@4:   foreach (entity_crud_get_info() as $entity_type => $info) {
danielebarchiesi@4:     if (!empty($info['exportable'])) {
danielebarchiesi@4:       $hook = isset($info['export']['default hook']) ? $info['export']['default hook'] : 'default_' . $entity_type;
danielebarchiesi@4:       foreach ($modules as $module) {
danielebarchiesi@4:         if (module_hook($module, $hook) || module_hook($module, $hook . '_alter')) {
danielebarchiesi@4:           $types[] = $entity_type;
danielebarchiesi@4:         }
danielebarchiesi@4:       }
danielebarchiesi@4:     }
danielebarchiesi@4:   }
danielebarchiesi@4:   return $types;
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Defines schema fields required for exportable entities.
danielebarchiesi@4:  *
danielebarchiesi@4:  * Warning: Do not call this function in your module's hook_schema()
danielebarchiesi@4:  * implementation or update functions. It is not safe to call functions of
danielebarchiesi@4:  * dependencies at this point. Instead of calling the function, just copy over
danielebarchiesi@4:  * the content.
danielebarchiesi@4:  * For more details see the issue http://drupal.org/node/1122812.
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_exportable_schema_fields($module_col = 'module', $status_col = 'status') {
danielebarchiesi@4:   return array(
danielebarchiesi@4:     $status_col => array(
danielebarchiesi@4:       'type' => 'int',
danielebarchiesi@4:       'not null' => TRUE,
danielebarchiesi@4:       // Set the default to ENTITY_CUSTOM without using the constant as it is
danielebarchiesi@4:       // not safe to use it at this point.
danielebarchiesi@4:       'default' => 0x01,
danielebarchiesi@4:       'size' => 'tiny',
danielebarchiesi@4:       'description' => 'The exportable status of the entity.',
danielebarchiesi@4:     ),
danielebarchiesi@4:     $module_col => array(
danielebarchiesi@4:       'description' => 'The name of the providing module if the entity has been defined in code.',
danielebarchiesi@4:       'type' => 'varchar',
danielebarchiesi@4:       'length' => 255,
danielebarchiesi@4:       'not null' => FALSE,
danielebarchiesi@4:     ),
danielebarchiesi@4:   );
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Implements hook_flush_caches().
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_flush_caches() {
danielebarchiesi@4:   entity_property_info_cache_clear();
danielebarchiesi@4:   // Re-build defaults in code, however skip it on the admin modules page. In
danielebarchiesi@4:   // case of enabling or disabling modules we already rebuild defaults in
danielebarchiesi@4:   // entity_modules_enabled() and entity_modules_disabled(), so we do not need
danielebarchiesi@4:   // to do it again.
danielebarchiesi@4:   if (current_path() != 'admin/modules/list/confirm') {
danielebarchiesi@4:     entity_defaults_rebuild();
danielebarchiesi@4:   }
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Implements hook_theme().
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_theme() {
danielebarchiesi@4:   // Build a pattern in the form of "(type1|type2|...)(\.|__)" such that all
danielebarchiesi@4:   // templates starting with an entity type or named like the entity type
danielebarchiesi@4:   // are found.
danielebarchiesi@4:   // This has to match the template suggestions provided in
danielebarchiesi@4:   // template_preprocess_entity().
danielebarchiesi@4:   $types = array_keys(entity_crud_get_info());
danielebarchiesi@4:   $pattern = '(' . implode('|', $types) . ')(\.|__)';
danielebarchiesi@4: 
danielebarchiesi@4:   return array(
danielebarchiesi@4:     'entity_status' => array(
danielebarchiesi@4:       'variables' => array('status' => NULL, 'html' => TRUE),
danielebarchiesi@4:       'file' => 'theme/entity.theme.inc',
danielebarchiesi@4:     ),
danielebarchiesi@4:     'entity' => array(
danielebarchiesi@4:       'render element' => 'elements',
danielebarchiesi@4:       'template' => 'entity',
danielebarchiesi@4:       'pattern' => $pattern,
danielebarchiesi@4:       'path' => drupal_get_path('module', 'entity') . '/theme',
danielebarchiesi@4:       'file' => 'entity.theme.inc',
danielebarchiesi@4:     ),
danielebarchiesi@4:     'entity_property' => array(
danielebarchiesi@4:       'render element' => 'elements',
danielebarchiesi@4:       'file' => 'theme/entity.theme.inc',
danielebarchiesi@4:     ),
danielebarchiesi@4:     'entity_ui_overview_item' => array(
danielebarchiesi@4:       'variables' => array('label' => NULL, 'entity_type' => NULL, 'url' => FALSE, 'name' => FALSE),
danielebarchiesi@4:       'file' => 'includes/entity.ui.inc'
danielebarchiesi@4:     ),
danielebarchiesi@4:   );
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Label callback that refers to the entity classes label method.
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_class_label($entity) {
danielebarchiesi@4:   return $entity->label();
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * URI callback that refers to the entity classes uri method.
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_class_uri($entity) {
danielebarchiesi@4:   return $entity->uri();
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Implements hook_file_download_access() for entity types provided by the CRUD API.
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_file_download_access($field, $entity_type, $entity) {
danielebarchiesi@4:   $info = entity_get_info($entity_type);
danielebarchiesi@4:   if (in_array('EntityAPIControllerInterface', class_implements($info['controller class']))) {
danielebarchiesi@4:     return entity_access('view', $entity_type, $entity);
danielebarchiesi@4:   }
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Determines the UI controller class for a given entity type.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @return EntityDefaultUIController
danielebarchiesi@4:  *   If a type is given, the controller for the given entity type. Else an array
danielebarchiesi@4:  *   of all enabled UI controllers keyed by entity type is returned.
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_ui_controller($type = NULL) {
danielebarchiesi@4:   $static = &drupal_static(__FUNCTION__);
danielebarchiesi@4: 
danielebarchiesi@4:   if (!isset($type)) {
danielebarchiesi@4:     // Invoke the function for each type to ensure we have fully populated the
danielebarchiesi@4:     // static variable.
danielebarchiesi@4:     foreach (entity_get_info() as $entity_type => $info) {
danielebarchiesi@4:       entity_ui_controller($entity_type);
danielebarchiesi@4:     }
danielebarchiesi@4:     return array_filter($static);
danielebarchiesi@4:   }
danielebarchiesi@4: 
danielebarchiesi@4:   if (!isset($static[$type])) {
danielebarchiesi@4:     $info = entity_get_info($type);
danielebarchiesi@4:     $class = isset($info['admin ui']['controller class']) ? $info['admin ui']['controller class'] : 'EntityDefaultUIController';
danielebarchiesi@4:     $static[$type] = (isset($info['admin ui']['path']) && $class) ? new $class($type, $info) : FALSE;
danielebarchiesi@4:   }
danielebarchiesi@4: 
danielebarchiesi@4:   return $static[$type];
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Implements hook_menu().
danielebarchiesi@4:  *
danielebarchiesi@4:  * @see EntityDefaultUIController::hook_menu()
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_menu() {
danielebarchiesi@4:   $items = array();
danielebarchiesi@4:   foreach (entity_ui_controller() as $controller) {
danielebarchiesi@4:     $items += $controller->hook_menu();
danielebarchiesi@4:   }
danielebarchiesi@4:   return $items;
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Implements hook_forms().
danielebarchiesi@4:  *
danielebarchiesi@4:  * @see EntityDefaultUIController::hook_forms()
danielebarchiesi@4:  * @see entity_ui_get_form()
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_forms($form_id, $args) {
danielebarchiesi@4:   // For efficiency only invoke an entity types controller, if a form of it is
danielebarchiesi@4:   // requested. Thus if the first (overview and operation form) or the third
danielebarchiesi@4:   // argument (edit form) is an entity type name, add in the types forms.
danielebarchiesi@4:   if (isset($args[0]) && is_string($args[0]) && entity_get_info($args[0])) {
danielebarchiesi@4:     $type = $args[0];
danielebarchiesi@4:   }
danielebarchiesi@4:   elseif (isset($args[2]) && is_string($args[2]) && entity_get_info($args[2])) {
danielebarchiesi@4:     $type = $args[2];
danielebarchiesi@4:   }
danielebarchiesi@4:   if (isset($type) && $controller = entity_ui_controller($type)) {
danielebarchiesi@4:     return $controller->hook_forms();
danielebarchiesi@4:   }
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * A wrapper around drupal_get_form() that helps building entity forms.
danielebarchiesi@4:  *
danielebarchiesi@4:  * This function may be used by entities to build their entity form. It has to
danielebarchiesi@4:  * be used instead of calling drupal_get_form().
danielebarchiesi@4:  * Entity forms built with this helper receive useful defaults suiting for
danielebarchiesi@4:  * editing a single entity, whereas the special cases of adding and cloning
danielebarchiesi@4:  * of entities are supported too.
danielebarchiesi@4:  *
danielebarchiesi@4:  * While this function is intended to be used to get entity forms for entities
danielebarchiesi@4:  * using the entity ui controller, it may be used for entity types not using
danielebarchiesi@4:  * the ui controller too.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @param $entity_type
danielebarchiesi@4:  *   The entity type for which to get the form.
danielebarchiesi@4:  * @param $entity
danielebarchiesi@4:  *   The entity for which to return the form.
danielebarchiesi@4:  *   If $op is 'add' the entity has to be either initialized before calling this
danielebarchiesi@4:  *   function, or NULL may be passed. If NULL is passed, an entity will be
danielebarchiesi@4:  *   initialized with empty values using entity_create(). Thus entities, for
danielebarchiesi@4:  *   which this is problematic have to care to pass in an initialized entity.
danielebarchiesi@4:  * @param $op
danielebarchiesi@4:  *   (optional) One of 'edit', 'add' or 'clone'. Defaults to edit.
danielebarchiesi@4:  * @param $form_state
danielebarchiesi@4:  *   (optional) A pre-populated form state, e.g. to add in form include files.
danielebarchiesi@4:  *   See entity_metadata_form_entity_ui().
danielebarchiesi@4:  *
danielebarchiesi@4:  * @return
danielebarchiesi@4:  *   The fully built and processed form, ready to be rendered.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @see EntityDefaultUIController::hook_forms()
danielebarchiesi@4:  * @see entity_ui_form_submit_build_entity()
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_ui_get_form($entity_type, $entity, $op = 'edit', $form_state = array()) {
danielebarchiesi@4:   if (isset($entity)) {
danielebarchiesi@4:     list(, , $bundle) = entity_extract_ids($entity_type, $entity);
danielebarchiesi@4:   }
danielebarchiesi@4:   $form_id = (!isset($bundle) || $bundle == $entity_type) ? $entity_type . '_form' : $entity_type . '_edit_' . $bundle . '_form';
danielebarchiesi@4: 
danielebarchiesi@4:   if (!isset($entity) && $op == 'add') {
danielebarchiesi@4:     $entity = entity_create($entity_type, array());
danielebarchiesi@4:   }
danielebarchiesi@4: 
danielebarchiesi@4:   // Do not use drupal_get_form(), but invoke drupal_build_form() ourself so
danielebarchiesi@4:   // we can prepulate the form state.
danielebarchiesi@4:   $form_state['wrapper_callback'] = 'entity_ui_main_form_defaults';
danielebarchiesi@4:   $form_state['entity_type'] = $entity_type;
danielebarchiesi@4:   form_load_include($form_state, 'inc', 'entity', 'includes/entity.ui');
danielebarchiesi@4: 
danielebarchiesi@4:   // Handle cloning. We cannot do that in the wrapper callback as it is too late
danielebarchiesi@4:   // for changing arguments.
danielebarchiesi@4:   if ($op == 'clone') {
danielebarchiesi@4:     $entity = entity_ui_clone_entity($entity_type, $entity);
danielebarchiesi@4:   }
danielebarchiesi@4: 
danielebarchiesi@4:   // We don't pass the entity type as first parameter, as the implementing
danielebarchiesi@4:   // module knows the type anyway. However, in order to allow for efficient
danielebarchiesi@4:   // hook_forms() implementiations we append the entity type as last argument,
danielebarchiesi@4:   // which the module implementing the form constructor may safely ignore.
danielebarchiesi@4:   // @see entity_forms()
danielebarchiesi@4:   $form_state['build_info']['args'] = array($entity, $op, $entity_type);
danielebarchiesi@4:   return drupal_build_form($form_id, $form_state);
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Helper for using i18n_string().
danielebarchiesi@4:  *
danielebarchiesi@4:  * @param $name
danielebarchiesi@4:  *   Textgroup and context glued with ':'.
danielebarchiesi@4:  * @param $default
danielebarchiesi@4:  *   String in default language. Default language may or may not be English.
danielebarchiesi@4:  * @param $langcode
danielebarchiesi@4:  *   (optional) The code of a certain language to translate the string into.
danielebarchiesi@4:  *   Defaults to the i18n_string() default, i.e. the current language.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @see i18n_string()
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_i18n_string($name, $default, $langcode = NULL) {
danielebarchiesi@4:   return function_exists('i18n_string') ? i18n_string($name, $default, array('langcode' => $langcode)) : $default;
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Implements hook_views_api().
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_views_api() {
danielebarchiesi@4:   return array(
danielebarchiesi@4:     'api' => '3.0-alpha1',
danielebarchiesi@4:     'path' => drupal_get_path('module', 'entity') . '/views',
danielebarchiesi@4:   );
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Implements hook_field_extra_fields().
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_field_extra_fields() {
danielebarchiesi@4:   // Invoke specified controllers for entity types provided by the CRUD API.
danielebarchiesi@4:   $items = array();
danielebarchiesi@4:   foreach (entity_crud_get_info() as $type => $info) {
danielebarchiesi@4:     if (!empty($info['extra fields controller class'])) {
danielebarchiesi@4:       $items = array_merge_recursive($items, entity_get_extra_fields_controller($type)->fieldExtraFields());
danielebarchiesi@4:     }
danielebarchiesi@4:   }
danielebarchiesi@4:   return $items;
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Gets the extra field controller class for a given entity type.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @return EntityExtraFieldsControllerInterface|false
danielebarchiesi@4:  *   The controller for the given entity type or FALSE if none is specified.
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_get_extra_fields_controller($type = NULL) {
danielebarchiesi@4:   $static = &drupal_static(__FUNCTION__);
danielebarchiesi@4: 
danielebarchiesi@4:   if (!isset($static[$type])) {
danielebarchiesi@4:     $static[$type] = FALSE;
danielebarchiesi@4:     $info = entity_get_info($type);
danielebarchiesi@4:     if (!empty($info['extra fields controller class'])) {
danielebarchiesi@4:       $static[$type] = new $info['extra fields controller class']($type);
danielebarchiesi@4:     }
danielebarchiesi@4:   }
danielebarchiesi@4:   return $static[$type];
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Returns a property wrapper for the given data.
danielebarchiesi@4:  *
danielebarchiesi@4:  * If an entity is wrapped, the wrapper can be used to retrieve further wrappers
danielebarchiesi@4:  * for the entitity properties. For that the wrapper support chaining, e.g. you
danielebarchiesi@4:  * can use a node wrapper to get the node authors mail address:
danielebarchiesi@4:  *
danielebarchiesi@4:  * @code
danielebarchiesi@4:  *   echo $wrappedNode->author->mail->value();
danielebarchiesi@4:  * @endcode
danielebarchiesi@4:  *
danielebarchiesi@4:  * @param $type
danielebarchiesi@4:  *   The type of the passed data.
danielebarchiesi@4:  * @param $data
danielebarchiesi@4:  *   The data to wrap. It may be set to NULL, so the wrapper can be used
danielebarchiesi@4:  *   without any data for getting information about properties.
danielebarchiesi@4:  * @param $info
danielebarchiesi@4:  *   (optional) Specify additional information for the passed data:
danielebarchiesi@4:  *    - langcode: (optional) If the data is language specific, its langauge
danielebarchiesi@4:  *      code. Defaults to NULL, what means language neutral.
danielebarchiesi@4:  *    - bundle: (optional) If an entity is wrapped but not passed, use this key
danielebarchiesi@4:  *      to specify the bundle to return a wrapper for.
danielebarchiesi@4:  *    - property info: (optional) May be used to use a wrapper with an arbitrary
danielebarchiesi@4:  *      data structure (type 'struct'). Use this key for specifying info about
danielebarchiesi@4:  *      properties in the same structure as used by hook_entity_property_info().
danielebarchiesi@4:  *    - property info alter: (optional) A callback for altering the property
danielebarchiesi@4:  *      info before it is utilized by the wrapper.
danielebarchiesi@4:  *    - property defaults: (optional) An array of defaults for the info of
danielebarchiesi@4:  *      each property of the wrapped data item.
danielebarchiesi@4:  * @return EntityMetadataWrapper
danielebarchiesi@4:  *   Dependend on the passed data the right wrapper is returned.
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_metadata_wrapper($type, $data = NULL, array $info = array()) {
danielebarchiesi@4:   if ($type == 'entity' || (($entity_info = entity_get_info()) && isset($entity_info[$type]))) {
danielebarchiesi@4:     // If the passed entity is the global $user, we load the user object by only
danielebarchiesi@4:     // passing on the user id. The global user is not a fully loaded entity.
danielebarchiesi@4:     if ($type == 'user' && is_object($data) && $data == $GLOBALS['user']) {
danielebarchiesi@4:       $data = $data->uid;
danielebarchiesi@4:     }
danielebarchiesi@4:     return new EntityDrupalWrapper($type, $data, $info);
danielebarchiesi@4:   }
danielebarchiesi@4:   elseif ($type == 'list' || entity_property_list_extract_type($type)) {
danielebarchiesi@4:     return new EntityListWrapper($type, $data, $info);
danielebarchiesi@4:   }
danielebarchiesi@4:   elseif (isset($info['property info'])) {
danielebarchiesi@4:     return new EntityStructureWrapper($type, $data, $info);
danielebarchiesi@4:   }
danielebarchiesi@4:   else {
danielebarchiesi@4:     return new EntityValueWrapper($type, $data, $info);
danielebarchiesi@4:   }
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Returns a metadata wrapper for accessing site-wide properties.
danielebarchiesi@4:  *
danielebarchiesi@4:  * Although there is no 'site' entity or such, modules may provide info about
danielebarchiesi@4:  * site-wide properties using hook_entity_property_info(). This function returns
danielebarchiesi@4:  * a wrapper for making use of this properties.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @return EntityMetadataWrapper
danielebarchiesi@4:  *   A wrapper for accessing site-wide properties.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @see entity_metadata_system_entity_property_info()
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_metadata_site_wrapper() {
danielebarchiesi@4:   $site_info = entity_get_property_info('site');
danielebarchiesi@4:   $info['property info'] = $site_info['properties'];
danielebarchiesi@4:   return entity_metadata_wrapper('site', FALSE, $info);
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Implements hook_module_implements_alter().
danielebarchiesi@4:  *
danielebarchiesi@4:  * Moves the hook_entity_info_alter() implementation to the bottom so it is
danielebarchiesi@4:  * invoked after all modules relying on the entity API.
danielebarchiesi@4:  * That way we ensure to run last and clear the field-info cache after the
danielebarchiesi@4:  * others added in their bundle information.
danielebarchiesi@4:  *
danielebarchiesi@4:  * @see entity_entity_info_alter()
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_module_implements_alter(&$implementations, $hook) {
danielebarchiesi@4:   if ($hook == 'entity_info_alter') {
danielebarchiesi@4:     // Move our hook implementation to the bottom.
danielebarchiesi@4:     $group = $implementations['entity'];
danielebarchiesi@4:     unset($implementations['entity']);
danielebarchiesi@4:     $implementations['entity'] = $group;
danielebarchiesi@4:   }
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Implements hook_entity_info_alter().
danielebarchiesi@4:  *
danielebarchiesi@4:  * @see entity_module_implements_alter()
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_entity_info_alter(&$entity_info) {
danielebarchiesi@4:   _entity_info_add_metadata($entity_info);
danielebarchiesi@4: 
danielebarchiesi@4:   // Populate a default value for the 'configuration' key of all entity types.
danielebarchiesi@4:   foreach ($entity_info as $type => $info) {
danielebarchiesi@4:     if (!isset($info['configuration'])) {
danielebarchiesi@4:       $entity_info[$type]['configuration'] = !empty($info['exportable']);
danielebarchiesi@4:     }
danielebarchiesi@4:   }
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Adds metadata and callbacks for core entities to the entity info.
danielebarchiesi@4:  */
danielebarchiesi@4: function _entity_info_add_metadata(&$entity_info) {
danielebarchiesi@4:   // Set plural labels.
danielebarchiesi@4:   $entity_info['node']['plural label'] = t('Nodes');
danielebarchiesi@4:   $entity_info['user']['plural label'] = t('Users');
danielebarchiesi@4:   $entity_info['file']['plural label'] = t('Files');
danielebarchiesi@4: 
danielebarchiesi@4:   // Set descriptions.
danielebarchiesi@4:   $entity_info['node']['description'] = t('Nodes represent the main site content items.');
danielebarchiesi@4:   $entity_info['user']['description'] = t('Users who have created accounts on your site.');
danielebarchiesi@4:   $entity_info['file']['description'] = t('Uploaded file.');
danielebarchiesi@4: 
danielebarchiesi@4:   // Set access callbacks.
danielebarchiesi@4:   $entity_info['node']['access callback'] = 'entity_metadata_no_hook_node_access';
danielebarchiesi@4:   $entity_info['user']['access callback'] = 'entity_metadata_user_access';
danielebarchiesi@4:   // File entity has it's own entity_access function.
danielebarchiesi@4:   if (!module_exists('file_entity')) {
danielebarchiesi@4:     $entity_info['file']['access callback'] = 'entity_metadata_file_access';
danielebarchiesi@4:   }
danielebarchiesi@4: 
danielebarchiesi@4:   // CRUD function callbacks.
danielebarchiesi@4:   $entity_info['node']['creation callback'] = 'entity_metadata_create_node';
danielebarchiesi@4:   $entity_info['node']['save callback'] = 'node_save';
danielebarchiesi@4:   $entity_info['node']['deletion callback'] = 'node_delete';
danielebarchiesi@4:   $entity_info['node']['revision deletion callback'] = 'node_revision_delete';
danielebarchiesi@4:   $entity_info['user']['creation callback'] = 'entity_metadata_create_object';
danielebarchiesi@4:   $entity_info['user']['save callback'] = 'entity_metadata_user_save';
danielebarchiesi@4:   $entity_info['user']['deletion callback'] = 'user_delete';
danielebarchiesi@4:   $entity_info['file']['save callback'] = 'file_save';
danielebarchiesi@4:   $entity_info['file']['deletion callback'] = 'entity_metadata_delete_file';
danielebarchiesi@4: 
danielebarchiesi@4:   // Form callbacks.
danielebarchiesi@4:   $entity_info['node']['form callback'] = 'entity_metadata_form_node';
danielebarchiesi@4:   $entity_info['user']['form callback'] = 'entity_metadata_form_user';
danielebarchiesi@4: 
danielebarchiesi@4:   // View callbacks.
danielebarchiesi@4:   $entity_info['node']['view callback'] = 'entity_metadata_view_node';
danielebarchiesi@4:   $entity_info['user']['view callback'] = 'entity_metadata_view_single';
danielebarchiesi@4: 
danielebarchiesi@4:   if (module_exists('comment')) {
danielebarchiesi@4:     $entity_info['comment']['plural label'] = t('Comments');
danielebarchiesi@4:     $entity_info['comment']['description'] = t('Remark or note that refers to a node.');
danielebarchiesi@4:     $entity_info['comment']['access callback'] = 'entity_metadata_comment_access';
danielebarchiesi@4:     $entity_info['comment']['creation callback'] = 'entity_metadata_create_comment';
danielebarchiesi@4:     $entity_info['comment']['save callback'] = 'comment_save';
danielebarchiesi@4:     $entity_info['comment']['deletion callback'] = 'comment_delete';
danielebarchiesi@4:     $entity_info['comment']['view callback'] = 'entity_metadata_view_comment';
danielebarchiesi@4:     $entity_info['comment']['form callback'] = 'entity_metadata_form_comment';
danielebarchiesi@4:   }
danielebarchiesi@4:   if (module_exists('taxonomy')) {
danielebarchiesi@4:     $entity_info['taxonomy_term']['plural label'] = t('Taxonomy terms');
danielebarchiesi@4:     $entity_info['taxonomy_term']['description'] = t('Taxonomy terms are used for classifying content.');
danielebarchiesi@4:     $entity_info['taxonomy_term']['access callback'] = 'entity_metadata_taxonomy_access';
danielebarchiesi@4:     $entity_info['taxonomy_term']['creation callback'] = 'entity_metadata_create_object';
danielebarchiesi@4:     $entity_info['taxonomy_term']['save callback'] = 'taxonomy_term_save';
danielebarchiesi@4:     $entity_info['taxonomy_term']['deletion callback'] = 'taxonomy_term_delete';
danielebarchiesi@4:     $entity_info['taxonomy_term']['view callback'] = 'entity_metadata_view_single';
danielebarchiesi@4:     $entity_info['taxonomy_term']['form callback'] = 'entity_metadata_form_taxonomy_term';
danielebarchiesi@4: 
danielebarchiesi@4:     $entity_info['taxonomy_vocabulary']['plural label'] = t('Taxonomy vocabularies');
danielebarchiesi@4:     $entity_info['taxonomy_vocabulary']['description'] = t('Vocabularies contain related taxonomy terms, which are used for classifying content.');
danielebarchiesi@4:     $entity_info['taxonomy_vocabulary']['access callback'] = 'entity_metadata_taxonomy_access';
danielebarchiesi@4:     $entity_info['taxonomy_vocabulary']['creation callback'] = 'entity_metadata_create_object';
danielebarchiesi@4:     $entity_info['taxonomy_vocabulary']['save callback'] = 'taxonomy_vocabulary_save';
danielebarchiesi@4:     $entity_info['taxonomy_vocabulary']['deletion callback'] = 'taxonomy_vocabulary_delete';
danielebarchiesi@4:     $entity_info['taxonomy_vocabulary']['form callback'] = 'entity_metadata_form_taxonomy_vocabulary';
danielebarchiesi@4:     // Token type mapping.
danielebarchiesi@4:     $entity_info['taxonomy_term']['token type'] = 'term';
danielebarchiesi@4:     $entity_info['taxonomy_vocabulary']['token type'] = 'vocabulary';
danielebarchiesi@4:   }
danielebarchiesi@4: }
danielebarchiesi@4: 
danielebarchiesi@4: /**
danielebarchiesi@4:  * Implements hook_ctools_plugin_directory().
danielebarchiesi@4:  */
danielebarchiesi@4: function entity_ctools_plugin_directory($module, $plugin) {
danielebarchiesi@4:   if ($module == 'ctools' && $plugin == 'content_types') {
danielebarchiesi@4:     return 'ctools/content_types';
danielebarchiesi@4:   }
danielebarchiesi@4: }