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.

  • Action hooks look like this: do_action( "hook_name" )
  • Filter hooks look like this: apply_filters( "hook_name", "what_to_filter" ).

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
4212  */
4213 function get_ancestors( $object_id = 0, $object_type = '', $resource_type = '' ) {
4214      $object_id = (int) $object_id;
4215
4216      $ancestors = array();
4217
4218      if ( empty( $object_id ) ) {
4219
4220           /** This filter is documented in wp-includes/taxonomy.php */
4221           return apply_filters( 'get_ancestors', $ancestors, $object_id, $object_type, $resource_type );
4222      }
4223
4224      if ( ! $resource_type ) {
4225           if ( is_taxonomy_hierarchical( $object_type ) ) {
4226                $resource_type = 'taxonomy';
4227           } elseif ( post_type_exists( $object_type ) ) {
4228                $resource_type = 'post_type';
4229           }
4230      }
 
Line Code
4244       *
4245       * @since 3.1.0
4246       * @since 4.1.1 Introduced the `$resource_type` parameter.
4247       *
4248       * @param array  $ancestors     An array of object ancestors.
4249       * @param int    $object_id     Object ID.
4250       * @param string $object_type   Type of object.
4251       * @param string $resource_type Type of resource $object_type is.
4252       */
4253      return apply_filters( 'get_ancestors', $ancestors, $object_id, $object_type, $resource_type );
4254 }
4255
4256 /**
4257  * Returns the term's parent's term_ID.
4258  *
4259  * @since 3.1.0
4260  *
4261  * @param int    $term_id  Term ID.
4262  * @param string $taxonomy Taxonomy name.