| 7 common.inc | entity_label($entity_type, $entity) |
| 8 entity.module | entity_label($entity_type, $entity) |
Returns the label of an entity.
See the 'label callback' component of the hook_entity_info() return value for more information.
Parameters
$entity_type: The entity type; e.g., 'node' or 'user'.
$entity: The entity for which to generate the label.
Return value
The entity label, or FALSE if not found.
1 call to entity_label()
File
- includes/
common.inc, line 7762 - Common functions that many Drupal modules will need to reference.
Code
function entity_label($entity_type, $entity) {
$label = FALSE;
$info = entity_get_info($entity_type);
if (isset($info['label callback']) && function_exists($info['label callback'])) {
$label = $info['label callback']($entity, $entity_type);
}
elseif (!empty($info['entity keys']['label']) && isset($entity->{$info['entity keys']['label']})) {
$label = $entity->{$info['entity keys']['label']};
}
return $label;
}
Login or register to post comments
Comments
Needs entity object
Don't forget that $entity must be the object of the entity - so if you do something like, entity_label('node', entity_load('node',array($id)));, it won't work because entity_load gives an array wrapper around the object(s): use something equivalent to entity_label('node', reset(entity_load('node',array($id)))); or entity_label('node', entity_load('node',array($id))[$id]);
Untrusted return value
The code receiving this result must ensure that check_plain() is called on it before it is printed to the page. Otherwise you could be making your module vulnerable to an XSS attack.