wpdb(); parent::__construct( $wpdb, $sitepress ); $this->taxonomy = $taxonomy; } /** * The returned array from this function is indexed as follows. * It holds an array of all terms to be displayed under [terms] * and the count of all terms matching the filter under [count]. * * The array under [terms] itself is index as such: * [trid][lang] * * It holds in itself the terms objects of the to be displayed terms. * These are ordered by their names alphabetically. * Also their objects are amended by the index $term->translation_of holding the term_taxonomy_id of their original element * and their level under $term->level in case of hierarchical terms. * * Also the index [trid][source_lang] holds the source language of the term group. * * @return array */ public function terms() { $attributes_to_select = array(); $icl_translations_table_name = $this->wpdb->prefix . 'icl_translations'; $attributes_to_select[ $this->wpdb->terms ] = array( 'alias' => 't', 'vars' => array( 'name', 'slug', 'term_id' ) ); $attributes_to_select[ $this->wpdb->term_taxonomy ] = array( 'alias' => 'tt', 'vars' => array( 'term_taxonomy_id', 'parent', 'description' ) ); $attributes_to_select[ $icl_translations_table_name ] = array( 'alias' => 'i', 'vars' => array( 'language_code', 'trid', 'source_language_code' ) ); $join_statements = array(); $as = $this->alias_statements( $attributes_to_select ); $join_statements[] = "{$as['t']} JOIN {$as['tt']} ON tt.term_id = t.term_id"; $join_statements[] = "{$as['i']} ON i.element_id = tt.term_taxonomy_id"; $from_clause = join( ' JOIN ', $join_statements ); $select_clause = $this->build_select_vars( $attributes_to_select ); $where_clause = $this->build_where_clause( $attributes_to_select ); $full_statement = "SELECT {$select_clause} FROM {$from_clause} WHERE {$where_clause}"; $all_terms = $this->wpdb->get_results( $full_statement ); // We are not going to add term meta support in 3.6.3. // if ( function_exists( 'get_term_meta' ) ) { // $all_terms = $this->add_metadata( $all_terms ); // } if ( $all_terms ) { $all_terms = $this->order_terms_list( $this->index_terms_array( $all_terms ) ); } return $all_terms; } /** * @param $terms array * Turn a numerical array of terms objects into an associative once, * holding the same terms, but indexed by their term_id. * * @return array */ private function index_terms_array( $terms ) { $terms_indexed = array(); foreach ( $terms as $term ) { $terms_indexed[ $term->term_id ] = $term; } return $terms_indexed; } /** * @param $trid_group array * @param $terms array * Transforms the term arrays generated by the Translation Tree class and turns them into * standard WordPress terms objects. * * @return mixed */ private function set_language_information( $trid_group, $terms ) { foreach ( $trid_group['elements'] as $lang => $term ) { $term_object = $terms[ $term['term_id'] ]; $term_object->level = $term['level']; $trid_group[ $lang ] = $term_object; } unset( $trid_group['elements'] ); return $trid_group; } /** * Orders a list of terms alphabetically and hierarchy-wise * * @param $terms array * * @return array */ private function order_terms_list( $terms ) { $terms_tree = new WPML_Translation_Tree( $this->sitepress, $this->taxonomy, $terms ); $ordered_terms = $terms_tree->get_alphabetically_ordered_list(); foreach ( $ordered_terms as $key => $trid_group ) { $ordered_terms[ $key ] = self::set_language_information( $trid_group, $terms ); } return $ordered_terms; } /** * @param $selects array * Generates a list of to be selected variables in an sql query. * * @return string */ private function build_select_vars( $selects ) { $output = ''; if ( is_array( $selects ) ) { $coarse_selects = array(); foreach ( $selects as $select ) { $vars = $select['vars']; $table = $select['alias']; foreach ( $vars as $key => $var ) { $vars[ $key ] = $table . '.' . $var; } $coarse_selects[] = join( ', ', $vars ); } $output = join( ', ', $coarse_selects ); } return $output; } /** * @param $selects array * Returns an array of alias statements to be used in SQL queries with joins. * * @return array */ private function alias_statements( $selects ) { $output = array(); foreach ( $selects as $key => $select ) { $output[ $select['alias'] ] = $key . ' AS ' . $select['alias']; } return $output; } private function build_where_clause( $selects ) { $where_clauses[] = $selects[ $this->wpdb->term_taxonomy ]['alias'] . $this->wpdb->prepare( ".taxonomy = %s ", $this->taxonomy ); $where_clauses[] = $selects[ $this->wpdb->prefix . 'icl_translations' ]['alias'] . $this->wpdb->prepare( ".element_type = %s ", 'tax_' . $this->taxonomy ); $where_clause = join( ' AND ', $where_clauses ); return $where_clause; } private function add_metadata( $all_terms ) { foreach ( $all_terms as $term ) { $meta_data = get_term_meta( $term->term_id ); foreach ( $meta_data as $meta_key => $meta_data ) { $term->meta_data[ $meta_key ] = $meta_data; } } return $all_terms; } }