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
2468
2469                /**
2470                 * Fires immediately after the given terms are edited.
2471                 *
2472                 * @since 2.9.0
2473                 *
2474                 * @param int    $term_id  Term ID
2475                 * @param string $taxonomy Taxonomy slug.
2476                 */
2477                do_action( 'edited_terms', $alias->term_id, $taxonomy );
2478           }
2479      }
2480
2481      if ( $term_id = term_exists($slug) ) {
2482           $existing_term = $wpdb->get_row( $wpdb->prepare( "SELECT name FROM $wpdb->terms WHERE term_id = %d", $term_id), ARRAY_A );
2483           // We've got an existing term in the same taxonomy, which matches the name of the new term:
2484           if ( is_taxonomy_hierarchical($taxonomy) && $existing_term['name'] == $name && $exists = term_exists( (int) $term_id, $taxonomy ) ) {
2485                // Hierarchical, and it matches an existing term, Do not allow same "name" in the same level.
2486                $siblings = get_terms($taxonomy, array('fields' => 'names', 'get' => 'all', 'parent' => $parent ) );
 
Line Code
2520      // Seems unreachable, However, Is used in the case that a term name is provided, which sanitizes to an empty string.
2521      if ( empty($slug) ) {
2522           $slug = sanitize_title($slug, $term_id);
2523
2524           /** This action is documented in wp-includes/taxonomy.php */
2525           do_action( 'edit_terms', $term_id, $taxonomy );
2526           $wpdb->update( $wpdb->terms, compact( 'slug' ), compact( 'term_id' ) );
2527
2528           /** This action is documented in wp-includes/taxonomy.php */
2529           do_action( 'edited_terms', $term_id, $taxonomy );
2530      }
2531
2532      $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 ) );
2533
2534      if ( !empty($tt_id) ) {
2535           return array('term_id' => $term_id, 'term_taxonomy_id' => $tt_id);
2536      }
2537      $wpdb->insert( $wpdb->term_taxonomy, compact( 'term_id', 'taxonomy', 'description', 'parent') + array( 'count' => 0 ) );
2538      $tt_id = (int) $wpdb->insert_id;
 
Line Code
2966           } else {
2967                // The alias isn't in a group, so let's create a new one and firstly add the alias term to it.
2968                $term_group = $wpdb->get_var("SELECT MAX(term_group) FROM $wpdb->terms") + 1;
2969
2970                /** This action is documented in wp-includes/taxonomy.php */
2971                do_action( 'edit_terms', $alias->term_id, $taxonomy );
2972                $wpdb->update( $wpdb->terms, compact('term_group'), array( 'term_id' => $alias->term_id ) );
2973
2974                /** This action is documented in wp-includes/taxonomy.php */
2975                do_action( 'edited_terms', $alias->term_id, $taxonomy );
2976           }
2977
2978           $parsed_args['term_group'] = $term_group;
2979      }
2980
2981      /**
2982       * Filter the term parent.
2983       *
2984       * Hook to this filter to see if it will cause a hierarchy loop.
 
Line Code
3007      /** This action is documented in wp-includes/taxonomy.php */
3008      do_action( 'edit_terms', $term_id, $taxonomy );
3009      $wpdb->update($wpdb->terms, compact( 'name', 'slug', 'term_group' ), compact( 'term_id' ) );
3010      if ( empty($slug) ) {
3011           $slug = sanitize_title($name, $term_id);
3012           $wpdb->update( $wpdb->terms, compact( 'slug' ), compact( 'term_id' ) );
3013      }
3014
3015      /** This action is documented in wp-includes/taxonomy.php */
3016      do_action( 'edited_terms', $term_id, $taxonomy );
3017
3018      $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) );
3019
3020      /**
3021       * Fires immediate before a term-taxonomy relationship is updated.
3022       *
3023       * @since 2.9.0
3024       *
3025       * @param int    $tt_id    Term taxonomy ID.