Menu Adam R Brown

WP hooks navigation: Home/browseActions indexFilters index

Source View: edited_terms

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 4 times in this file.

Line Code
2417
2418                /**
2419                 * Fires immediately after the given terms are edited.
2420                 *
2421                 * @since 2.9.0
2422                 *
2423                 * @param int    $term_id  Term ID
2424                 * @param string $taxonomy Taxonomy slug.
2425                 */
2426                do_action( 'edited_terms', $alias->term_id, $taxonomy );
2427           }
2428      }
2429
2430      if ( $term_id = term_exists($slug) ) {
2431           $existing_term = $wpdb->get_row( $wpdb->prepare( "SELECT name FROM $wpdb->terms WHERE term_id = %d", $term_id), ARRAY_A );
2432           // We've got an existing term in the same taxonomy, which matches the name of the new term:
2433           if ( is_taxonomy_hierarchical($taxonomy) && $existing_term['name'] == $name && $exists = term_exists( (int) $term_id, $taxonomy ) ) {
2434                // Hierarchical, and it matches an existing term, Do not allow same "name" in the same level.
2435                $siblings = get_terms($taxonomy, array('fields' => 'names', 'get' => 'all', 'parent' => (int)$parent) );
 
Line Code
2466      // Seems unreachable, However, Is used in the case that a term name is provided, which sanitizes to an empty string.
2467      if ( empty($slug) ) {
2468           $slug = sanitize_title($slug, $term_id);
2469
2470           /** This action is documented in wp-includes/taxonomy.php */
2471           do_action( 'edit_terms', $term_id, $taxonomy );
2472           $wpdb->update( $wpdb->terms, compact( 'slug' ), compact( 'term_id' ) );
2473
2474           /** This action is documented in wp-includes/taxonomy.php */
2475           do_action( 'edited_terms', $term_id, $taxonomy );
2476      }
2477
2478      $tt_id = $wpdb->get_var( $wpdb->prepare( "SELECT tt.term_taxonomy_id FROM $wpdb->term_taxonomy AS tt INNER JOIN $wpdb->terms AS t ON tt.term_id = t.term_id WHERE tt.taxonomy = %s AND t.term_id = %d", $taxonomy, $term_id ) );
2479
2480      if ( !empty($tt_id) )
2481           return array('term_id' => $term_id, 'term_taxonomy_id' => $tt_id);
2482
2483      $wpdb->insert( $wpdb->term_taxonomy, compact( 'term_id', 'taxonomy', 'description', 'parent') + array( 'count' => 0 ) );
2484      $tt_id = (int) $wpdb->insert_id;
 
Line Code
2904           } else {
2905                // The alias isn't in a group, so let's create a new one and firstly add the alias term to it.
2906                $term_group = $wpdb->get_var("SELECT MAX(term_group) FROM $wpdb->terms") + 1;
2907
2908                /** This action is documented in wp-includes/taxonomy.php */
2909                do_action( 'edit_terms', $alias->term_id, $taxonomy );
2910                $wpdb->update( $wpdb->terms, compact('term_group'), array( 'term_id' => $alias->term_id ) );
2911
2912                /** This action is documented in wp-includes/taxonomy.php */
2913                do_action( 'edited_terms', $alias->term_id, $taxonomy );
2914           }
2915      }
2916
2917      /**
2918       * Filter the term parent.
2919       *
2920       * Hook to this filter to see if it will cause a hierarchy loop.
2921       *
2922       * @since 3.1.0
 
Line Code
2943      /** This action is documented in wp-includes/taxonomy.php */
2944      do_action( 'edit_terms', $term_id, $taxonomy );
2945      $wpdb->update($wpdb->terms, compact( 'name', 'slug', 'term_group' ), compact( 'term_id' ) );
2946      if ( empty($slug) ) {
2947           $slug = sanitize_title($name, $term_id);
2948           $wpdb->update( $wpdb->terms, compact( 'slug' ), compact( 'term_id' ) );
2949      }
2950
2951      /** This action is documented in wp-includes/taxonomy.php */
2952      do_action( 'edited_terms', $term_id, $taxonomy );
2953
2954      $tt_id = $wpdb->get_var( $wpdb->prepare( "SELECT tt.term_taxonomy_id FROM $wpdb->term_taxonomy AS tt INNER JOIN $wpdb->terms AS t ON tt.term_id = t.term_id WHERE tt.taxonomy = %s AND t.term_id = %d", $taxonomy, $term_id) );
2955
2956      /**
2957       * Fires immediate before a term-taxonomy relationship is updated.
2958       *
2959       * @since 2.9.0
2960       *
2961       * @param int    $tt_id    Term taxonomy ID.