Menu Adam R Brown

WP hooks navigation: Home/browseActions indexFilters index

Source View: get_ancestors

To save our bandwidth, we show only a snippet of code around each occurence of the hook. View complete file in SVN (without highlighting).

Understanding Source Code

The best way to understand what a hook does is to look at where it occurs in the source code.

Remember, this hook may occur in more than one file. Moreover, the hook's context may change from version to version.

Source View

This hook occurs 2 times in this file.

Line Code
3845  */
3846 function get_ancestors($object_id = 0, $object_type = '') {
3847      $object_id = (int) $object_id;
3848
3849      $ancestors = array();
3850
3851      if ( empty( $object_id ) ) {
3852
3853           /** This filter is documented in wp-includes/taxonomy.php */
3854           return apply_filters( 'get_ancestors', $ancestors, $object_id, $object_type );
3855      }
3856
3857      if ( is_taxonomy_hierarchical( $object_type ) ) {
3858           $term = get_term($object_id, $object_type);
3859           while ( ! is_wp_error($term) && ! empty( $term->parent ) && ! in_array( $term->parent, $ancestors ) ) {
3860                $ancestors[] = (int) $term->parent;
3861                $term = get_term($term->parent, $object_type);
3862           }
3863      } elseif ( post_type_exists( $object_type ) ) {
 
Line Code
3867      /**
3868       * Filter a given object's ancestors.
3869       *
3870       * @since 3.1.0
3871       *
3872       * @param array  $ancestors   An array of object ancestors.
3873       * @param int    $object_id   Object ID.
3874       * @param string $object_type Type of object.
3875       */
3876      return apply_filters( 'get_ancestors', $ancestors, $object_id, $object_type );
3877 }
3878
3879 /**
3880  * Returns the term's parent's term_ID
3881  *
3882  * @since 3.1.0
3883  *
3884  * @param int $term_id
3885  * @param string $taxonomy