taxonomy_csv.term.api.inc in Taxonomy CSV import/export 6.4

Find, get and set full or detail term items.

File

taxonomy_csv.term.api.inc

<?php

/**
 * @file
 * Find, get and set full or detail term items.
 */

/**
 * Get a full term object by its id.
 *
 * @param $tid
 *   The term id to get.
 *
 * @return
 *   Found full term object.
 */
function taxonomy_csv_term_load($tid) {
  $term = db_fetch_object(db_query('SELECT * FROM {term_data} WHERE tid = %d', $tid));
  return $term ? taxonomy_csv_term_get_full($term) : FALSE;
}

/**
 * Load multiple full terms.
 *
 * This function can be used whenever to get more than one term from the
 * database is needed. Terms have their links (parents, relations and synonyms).
 *
 * @param $tids
 *   (Optional) An array of taxonomy term IDs.
 * @param $conditions
 *   An array of conditions to add to the query.
 *   Currently managed conditions: vid and ascendant order.
 *
 * @return
 *   An array of term objects eventually ordered.
 */
function taxonomy_csv_term_load_multiple($tids = array(), $conditions = array()) {
  $terms = array();

  // Flag use to determine if select query has already conditions.
  $flag = FALSE;

  // Prepare query for terms to be loaded.
  $sql = "\n    SELECT t.*\n    FROM {term_data} t\n  ";
  $args = array();
  if ($tids) {
    $sql .= ' WHERE (t.tid = %d' . str_repeat(' OR t.tid = %d', count($tids) - 1) . ')';
    $args += array_values($tids);
    $flag = TRUE;
  }
  if (isset($conditions['vid']) && $conditions['vid']) {
    $sql .= $flag ? ' AND ' : ' WHERE ';
    $sql .= '(t.vid = %d)';
    $args[] = $conditions['vid'];
    $flag = TRUE;
  }
  if (isset($conditions['order']) && $conditions['order']) {
    $sql .= ' ORDER BY %s ASC';
    $args[] = $conditions['order'];
  }
  $result = db_query($sql, $args);
  while ($term = db_fetch_object($result)) {
    $terms[] = taxonomy_csv_term_get_full($term);
  }
  return $terms;
}

/**
 * Complete a base term object.
 *
 * @param $term
 *   The base term object to complete.
 *
 * @return
 *   Found full term object.
 */
function taxonomy_csv_term_get_full($term) {
  if (isset($term->tid)) {
    $term->parents = taxonomy_csv_term_get_parents_tids($term->tid);
    $term->relations = taxonomy_csv_term_get_relations_tids($term->tid);
    $term->synonyms = taxonomy_get_synonyms($term->tid);

    // Check vocabulary because if there are specific fields, term needs to be
    // completed with them.
    $vocabulary_formats = taxonomy_csv_format_check_vocabulary($term->vid);
    foreach ($vocabulary_formats as $format) {
      $funcname = "taxonomy_csv_term_get_full_{$format}";
      $term = $funcname($term);
    }
    return $term;
  }

  // Else.
  return FALSE;
}

/**
 * Find and load a term.
 *
 * @param $term
 *   The term object to find. It's not necessarily a standard term object. It's
 *   an object which needs only a name and eventually a vid or a parent id. Of
 *   course, if tid is set, the found term is the existing one.
 * @param $all_vocabularies
 *   (Optional) Boolean. Search in all vocabularies or only in $term->vid
 *   vocabulary (default), which need to be set. Used with relations import.
 * @param $parent_tid
 *   (Optional) The direct parent term id where to restrict search.
 *   Used for structure import. Default to NULL (no parent restriction).
 *
 * @return
 *   Formatted found term object, or FALSE if not found or error.
 */
function taxonomy_csv_term_find($term, $all_vocabularies = FALSE, $parent_tid = NULL) {
  if (isset($term->tid) && $term->tid) {
    return taxonomy_csv_term_load($term->tid);
  }
  elseif (isset($term->name)) {
    $name = drupal_strtolower(trim($term->name));
    if (drupal_strlen($name)) {
      $sql = "\n        SELECT t.*, h.parent\n        FROM {term_data} t\n        INNER JOIN {term_hierarchy} h ON t.tid = h.tid\n        WHERE '%s' LIKE LOWER(t.name)\n      ";
      $args = array();
      $args[] = $name;
      if (isset($term->vid) && $term->vid && !$all_vocabularies) {
        $sql .= ' AND t.vid = %d';
        $args[] = $term->vid;
      }
      if ($parent_tid) {
        $sql .= ' AND h.parent = %d';
        $args[] = $parent_tid;
      }
      $sql .= ' ORDER BY t.tid ASC LIMIT 1';
      $term = db_fetch_object(db_query($sql, $args));
      if ($term) {
        return taxonomy_csv_term_get_full($term);
      }
    }
  }

  // Not found, or error (neither tid nor name).
  return FALSE;
}

/**
 * Find duplicate terms in a vocabulary or in all vocabularies.
 *
 * @param $vid
 *  (Optional) Vocabulary to check in.
 *
 * @return
 *  An array of term names, indexed by tid.
 */
function taxonomy_csv_term_find_duplicate($vid = 0) {
  $terms = array();
  $sql = '
    SELECT t1.tid, t1.name
    FROM {term_data} t1
    LEFT OUTER JOIN {term_data} t2 ON t1.tid != t2.tid AND LOWER(t1.name) = LOWER(t2.name)
    WHERE t2.tid IS NOT NULL
  ';
  $args = array();
  if ($vid) {
    $sql .= ' AND t1.vid = %d AND t2.vid = %d ';
    $args[] = $vid;
  }
  $sql .= ' ORDER BY {t1.tid} ASC ';
  $result = db_query($sql, $args);
  while ($term = db_fetch_object($result)) {
    $terms[$term->tid] = $term->name;
  }
  return $terms;
}

/**
 * Return an array of all parents term ids of a given term id.
 */
function taxonomy_csv_term_get_parents_tids($tid) {
  return array_keys(taxonomy_get_parents($tid));
}

/**
 * Return an array of all parents term names of a given term id.
 */
function taxonomy_csv_term_get_parents_names($tid) {
  return array_keys(taxonomy_get_parents($tid, 'name'));
}

/**
 * Return an array of all children term ids of a given term id.
 */
function taxonomy_csv_term_get_children_tids($tid) {
  return array_keys(taxonomy_get_children($tid));
}

/**
 * Return an array of all children term names of a given term id.
 */
function taxonomy_csv_term_get_children_names($tid) {
  return array_keys(taxonomy_get_children($tid, 0, 'name'));
}

/**
 * Return an array of all related term ids of a given term id.
 */
function taxonomy_csv_term_get_relations_tids($tid) {
  return array_keys(taxonomy_get_related($tid));
}

/**
 * Return an array of all related term names of a given term id.
 */
function taxonomy_csv_term_get_relations_names($tid) {
  return array_keys(taxonomy_get_related($tid, 'name'));
}

/**
 * Save by reference an internally formatted term object.
 *
 * Drupal taxonomy_save_term uses a text area format to save synonyms.
 * This helper convert a synonym array into a string before using it.
 * It converts 'parents', such in Drupal 7, to 'parent' too.
 *
 * @param $term
 *   A term object to save by reference. Term is an object containing:
 *   - 'name'        : term name string,
 *   - 'vid'         : the vocabulary id,
 *   and eventually:
 *   - 'tid'         : term id in case of an update,
 *   - 'description' : description string,
 *   - 'weight'      : weight integer,
 *   - 'parents'     : array of first level parent tids,
 *   - 'relations'   : array of related tids,
 *   - 'synonyms'    : array of synonyms terms names strings,
 * @return
 *   Status value (SAVED_NEW or SAVED_UPDATED). Term is updated with its tid.
 */
function taxonomy_csv_term_save(&$term) {
  $term_to_save = (array) $term;
  if (isset($term->synonyms)) {
    $term_to_save['synonyms'] = implode("\n", $term->synonyms);
  }
  if (isset($term->parents)) {
    $term_to_save['parent'] = $term->parents;
    unset($term_to_save['parents']);
  }
  else {
    $term_to_save['parent'] = array(
      0,
    );
    $term->parents = array(
      0,
    );
  }

  // Term is automaticaly updated, because it's used by reference.
  // Return either SAVED_NEW or SAVED_UPDATED.
  $result = taxonomy_save_term($term_to_save);

  // Update term.
  $term->tid = $term_to_save['tid'];
  return $result;
}

/**
 * Calculate number of terms in a vocabulary or in all vocabularies.
 *
 * @todo Regular query.
 *
 * @param $vocabulary_id
 *   (Optional) Id of the chosen vocabulary. If not specified, count terms in
 *   all vocabularies.
 *
 * @return
 *   Number of terms in specified vocabulary or in all vocabularies.
 */
function taxonomy_csv_term_count_in_vocabulary($vocabulary_id = 0) {
  $sql = "\n    SELECT COUNT(*)\n    FROM {term_data}\n  ";
  $args = array();
  if ($vocabulary_id) {
    $sql .= ' WHERE vid = %d ';
    $args[] = $vocabulary_id;
  }
  return array_shift(db_fetch_array(db_query($sql, $args)));
}

Functions

Name	Description
taxonomy_csv_term_count_in_vocabulary	Calculate number of terms in a vocabulary or in all vocabularies.
taxonomy_csv_term_find	Find and load a term.
taxonomy_csv_term_find_duplicate	Find duplicate terms in a vocabulary or in all vocabularies.
taxonomy_csv_term_get_children_names	Return an array of all children term names of a given term id.
taxonomy_csv_term_get_children_tids	Return an array of all children term ids of a given term id.
taxonomy_csv_term_get_full	Complete a base term object.
taxonomy_csv_term_get_parents_names	Return an array of all parents term names of a given term id.
taxonomy_csv_term_get_parents_tids	Return an array of all parents term ids of a given term id.
taxonomy_csv_term_get_relations_names	Return an array of all related term names of a given term id.
taxonomy_csv_term_get_relations_tids	Return an array of all related term ids of a given term id.
taxonomy_csv_term_load	Get a full term object by its id.
taxonomy_csv_term_load_multiple	Load multiple full terms.
taxonomy_csv_term_save	Save by reference an internally formatted term object.