wpdk-terms.php

Go to the documentation of this file.

<?php
class WPDKTerm {

  public $count;
  public $description;
  public $name;
  public $parent;
  public $parent_term;
  public $slug;
  public $taxonomy;
  public $term_group;
  public $term_id;
  public $term_taxonomy_id;
  public $permalink;

  private function __construct( $term )
  {
    if ( !is_null( $term ) ) {
      $term_exists = term_exists( $term->name, $term->taxonomy, $term->parent );
      if ( $term_exists ) {
        foreach ( $term as $property => $value ) {
          $this->{$property} = $value;
        }
        $this->permalink = get_term_link( $term );
      }
    }
  }

  public static function term( $term, $taxonomy = false, $output = OBJECT, $filter = 'raw', $parent = false )
  {
    global $wpdb;

    if ( empty( $taxonomy ) ) {
      $sql = sprintf( 'SELECT t.*, tt.description, tt.taxonomy FROM %s AS t LEFT JOIN %s AS tt ON ( tt.term_id = t.term_id )', $wpdb->terms, $wpdb->term_taxonomy );
      if ( is_numeric( $term ) ) {
        $sql .= sprintf( ' WHERE t.term_id = %s', $term );
      }
      elseif ( is_string( $term ) ) {
        $sql .= sprintf( ' WHERE t.slug = "%s"', $term );
      }
      elseif ( is_object( $term ) ) {
        $sql .= sprintf( ' WHERE t.term_id = "%s"', $term->term_id );
      }
      else {
        return false;
      }

      $row = $wpdb->get_row( $sql );
      if ( is_null( $row ) ) {
        return false;
      }
      $term     = $row->term_id;
      $taxonomy = $row->taxonomy;
    }


    if ( is_object( $term ) || is_numeric( $term ) ) {
      $term = get_term( $term, $taxonomy, $output, $filter );
    }
    else {
      $by   = ( '%' === substr( $term, 0, 1 ) ) ? 'name' : 'slug';
      $term = ltrim( $term, '%' );
      $term = get_term_by( $by, $term, $taxonomy, $output, $filter );
    }

    if ( !is_wp_error( $term ) ) {
      $instance = new WPDKTerm( $term );
      /* Get a WPDKTerm object if $parent param is TRUE and a parent id exists. */
      if ( true === $parent && !empty( $instance->parent ) ) {
        $instance->term_parent = self::term( $instance->parent, $taxonomy );
      }
      return $instance;
    }
    return $term;
  }

  public function ancestor()
  {
    return $this->ancestorOfTerm( $this );
  }

  public static function ancestorOfTerm( WPDKterm $term )
  {

    $term_id = false;
    $result  = false;

    if ( is_a( $term, 'WPDKTerm' ) ) {
      $term_id = $term->term_id;
    }

    if ( !empty( $term_id ) ) {
      while ( !empty( $term->parent ) ) {
        $term   = self::term( $term->parent, $term->taxonomy );
        $result = self::term( $term->term_id, $term->taxonomy );
      }
    }
    return $result;
  }

}

class WPDKTerms {

  public $cache_domain;
  public $child_of;
  public $exclude;
  public $exclude_tree;
  public $fields;
  public $get;
  public $hide_empty;
  public $hierarchical;
  public $include;
  public $name__like;
  public $number;
  public $offset;
  public $order;
  public $orderby;
  public $pad_counts;
  public $parent;
  public $search;
  public $slug;
  private $_taxonomy;

  public function __construct( $taxonomy = 'category' )
  {
    $this->_taxonomy = $taxonomy;

    $defaults = array(
      'orderby'      => 'name',
      'order'        => 'ASC',
      'hide_empty'   => true,
      'exclude'      => array(),
      'exclude_tree' => array(),
      'include'      => array(),
      'number'       => '',
      'fields'       => 'all',
      'slug'         => '',
      'parent'       => '',
      'hierarchical' => true,
      'child_of'     => 0,
      'get'          => '',
      'name__like'   => '',
      'pad_counts'   => false,
      'offset'       => '',
      'search'       => '',
      'cache_domain' => 'core'
    );

    foreach ( $defaults as $property => $value ) {
      $this->{$property} = $value;
    }
  }

  public function terms()
  {
    $args = (array)$this;

    /* Remove private. */
    unset( $args['WPDKTerms_taxonomy'] );
    $terms = get_terms( $this->_taxonomy, $args );

    return $terms;
  }

  public function tree( $child_of = false )
  {
    if ( empty( $child_of ) ) {
      $args           = (array)$this;
      $args['parent'] = 0;
      unset( $args['WPDKTerms_taxonomy'] );
      $terms = get_terms( $this->_taxonomy, $args );
      foreach ( $terms as $term ) {
        $term->children = $this->tree( $term );
      }
    }
    else {
      $args             = (array)$this;
      $args['parent']   = $child_of->term_id;
      unset( $args['WPDKTerms_taxonomy'] );
      $terms = get_terms( $this->_taxonomy, $args );
      foreach ( $terms as $term ) {
        $term->children = $this->tree( $term );
      }
    }

    return $terms;
  }

  public function breadCrumbs( $term )
  {
    $from      = $this->term( $term );
    $stack     = array( $from );
    $id_parent = $from->parent;

    while ( !empty( $id_parent ) ) {
      $stack[]   = $term = $this->term( $id_parent );
      $id_parent = $term->parent;
    }

    return array_reverse( $stack );
  }

  public function term( $term )
  {
    $term = WPDKTerm::term( $term, $this->_taxonomy );

    return $term;

  }
}