wp_ajax_add_tag()

Uses · 13

• check_ajax_referer()Verifies the Ajax request to prevent processing requests external of the blog.
• get_taxonomy()Retrieves the taxonomy object of $taxonomy.
• current_user_can()Returns whether the current user has the specified capability.
• wp_die()Kills WordPress execution and displays HTML page with an error message.
• wp_insert_term()Adds a new term to the database.
• is_wp_error()Checks whether the given variable is a WordPress Error.
• get_term()Gets all term data from database by term ID.
• __()Retrieves the translation of $text.
• _get_list_table()Fetches an instance of a WP_List_Table class.
• is_taxonomy_hierarchical()Determines whether the taxonomy object is hierarchical.
• get_ancestors()Gets an array of ancestor IDs for a given object.
• WP_Ajax_Response::__construct()Constructor - Passes args to WP_Ajax_Response::add().

Source

View on Trac ↗View on GitHub ↗

1110function wp_ajax_add_tag() {1111	check_ajax_referer( 'add-tag', '_wpnonce_add-tag' );1112 1113	$taxonomy        = ! empty( $_POST['taxonomy'] ) ? $_POST['taxonomy'] : 'post_tag';1114	$taxonomy_object = get_taxonomy( $taxonomy );1115 1116	if ( ! current_user_can( $taxonomy_object->cap->edit_terms ) ) {1117		wp_die( -1 );1118	}1119 1120	$response = new WP_Ajax_Response();1121 1122	$tag = wp_insert_term( $_POST['tag-name'], $taxonomy, $_POST );1123 1124	if ( $tag && ! is_wp_error( $tag ) ) {1125		$tag = get_term( $tag['term_id'], $taxonomy );1126	}1127 1128	if ( ! $tag || is_wp_error( $tag ) ) {1129		$message    = __( 'An error has occurred. Please reload the page and try again.' );1130		$error_code = 'error';1131 1132		if ( is_wp_error( $tag ) && $tag->get_error_message() ) {1133			$message = $tag->get_error_message();1134		}1135 1136		if ( is_wp_error( $tag ) && $tag->get_error_code() ) {1137			$error_code = $tag->get_error_code();1138		}1139 1140		$response->add(1141			array(1142				'what' => 'taxonomy',1143				'data' => new WP_Error( $error_code, $message ),1144			)1145		);1146		$response->send();1147	}1148 1149	$wp_list_table = _get_list_table( 'WP_Terms_List_Table', array( 'screen' => $_POST['screen'] ) );1150 1151	$level      = 0;1152	$no_parents = '';1153 1154	if ( is_taxonomy_hierarchical( $taxonomy ) ) {1155		$level = count( get_ancestors( $tag->term_id, $taxonomy, 'taxonomy' ) );1156		ob_start();1157		$wp_list_table->single_row( $tag, $level );1158		$no_parents = ob_get_clean();1159	}1160 1161	ob_start();1162	$wp_list_table->single_row( $tag );1163	$parents = ob_get_clean();1164 1165	require ABSPATH . 'wp-admin/includes/edit-tag-messages.php';1166 1167	$message = '';1168	if ( isset( $messages[ $taxonomy_object->name ][1] ) ) {1169		$message = $messages[ $taxonomy_object->name ][1];1170	} elseif ( isset( $messages['_item'][1] ) ) {1171		$message = $messages['_item'][1];1172	}1173 1174	$response->add(1175		array(1176			'what'         => 'taxonomy',1177			'data'         => $message,1178			'supplemental' => array(1179				'parents'   => $parents,1180				'noparents' => $no_parents,1181				'notice'    => $message,1182			),1183		)1184	);1185 1186	$response->add(1187		array(1188			'what'         => 'term',1189			'position'     => $level,

History

Introduced in 3.1.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.1.0 tag, from src/wp-admin/includes/ajax-actions.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.