You are here

protected function TaxonomyTermController::buildQuery in Drupal 7

Builds the query to load the entity.

This has full revision support. For entities requiring special queries, the class can be extended, and the default query can be constructed by calling parent::buildQuery(). This is usually necessary when the object being loaded needs to be augmented with additional data from another table, such as loading node type into comments or vocabulary machine name into terms, however it can also support $conditions on different tables. See CommentController::buildQuery() or TaxonomyTermController::buildQuery() for examples.

Parameters

$ids: An array of entity IDs, or FALSE to load all entities.

$conditions: An array of conditions. Keys are field names on the entity's base table. Values will be compared for equality. All the comparisons will be ANDed together. This parameter is deprecated; use an EntityFieldQuery instead.

$revision_id: The ID of the revision to load, or FALSE if this query is asking for the most current revision(s).

Return value

SelectQuery A SelectQuery object for loading the entity.

Overrides DrupalDefaultEntityController::buildQuery

File

modules/taxonomy/taxonomy.module, line 1251
Enables the organization of content into categories.

Class

TaxonomyTermController
Controller class for taxonomy terms.

Code

protected function buildQuery($ids, $conditions = array(), $revision_id = FALSE) {
  $query = parent::buildQuery($ids, $conditions, $revision_id);
  $query
    ->addTag('translatable');
  $query
    ->addTag('taxonomy_term_access');

  // When name is passed as a condition use LIKE.
  if (isset($conditions['name'])) {
    $query_conditions =& $query
      ->conditions();
    foreach ($query_conditions as $key => $condition) {
      if (is_array($condition) && $condition['field'] == 'base.name') {
        $query_conditions[$key]['operator'] = 'LIKE';
        $query_conditions[$key]['value'] = db_like($query_conditions[$key]['value']);
      }
    }
  }

  // Add the machine name field from the {taxonomy_vocabulary} table.
  $query
    ->innerJoin('taxonomy_vocabulary', 'v', 'base.vid = v.vid');
  $query
    ->addField('v', 'machine_name', 'vocabulary_machine_name');
  return $query;
}