function taxonomy_get_term_by_name
taxonomy_get_term_by_name($name, $vocabulary = NULL)
Try to map a string to an existing term, as for glossary use.
Provides a case-insensitive and trimmed mapping, to maximize the likelihood of a successful match.
Parameters
$name: Name of the term to search for.
$vocabulary: (optional) Vocabulary machine name to limit the search. Defaults to NULL.
Return value
An array of matching term objects.
File
- modules/taxonomy/taxonomy.module, line 1226
- Enables the organization of content into categories.
Code
function taxonomy_get_term_by_name($name, $vocabulary = NULL) { $conditions = array('name' => trim($name)); if (isset($vocabulary)) { $vocabularies = taxonomy_vocabulary_get_names(); if (isset($vocabularies[$vocabulary])) { $conditions['vid'] = $vocabularies[$vocabulary]->vid; } else { // Return an empty array when filtering by a non-existing vocabulary. return array(); } } return taxonomy_term_load_multiple(array(), $conditions); }
© 2001–2016 by the original authors
Licensed under the GNU General Public License, version 2 and later.
Drupal is a registered trademark of Dries Buytaert.
https://api.drupal.org/api/drupal/modules!taxonomy!taxonomy.module/function/taxonomy_get_term_by_name/7.x