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