Deprecate is_term, is_taxonomy, is_post_type for *_exists(). Props nacin. fixes #13747

git-svn-id: http://svn.automattic.com/wordpress/trunk@15220 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
ryan 2010-06-11 15:53:41 +00:00
parent 9eaf91db65
commit c614b6d0a2
9 changed files with 94 additions and 40 deletions

View File

@ -237,7 +237,7 @@ function _wp_ajax_add_hierarchical_term() {
$category_nicename = sanitize_title($cat_name);
if ( '' === $category_nicename )
continue;
if ( !($cat_id = is_term($cat_name, $taxonomy->name, $parent)) ) {
if ( !($cat_id = term_exists($cat_name, $taxonomy->name, $parent)) ) {
$new_term = wp_insert_term($cat_name, $taxonomy->name, array('parent' => $parent));
$cat_id = $new_term['term_id'];
}
@ -501,7 +501,7 @@ case 'add-link-category' : // On the Fly
$slug = sanitize_title($cat_name);
if ( '' === $slug )
continue;
if ( !$cat_id = is_term( $cat_name, 'link_category' ) ) {
if ( !$cat_id = term_exists( $cat_name, 'link_category' ) ) {
$cat_id = wp_insert_term( $cat_name, 'link_category' );
}
$cat_id = $cat_id['term_id'];

View File

@ -14,7 +14,7 @@ wp_reset_vars( array('action', 'tag', 'taxonomy', 'post_type') );
if ( empty($taxonomy) )
$taxonomy = 'post_tag';
if ( !is_taxonomy($taxonomy) )
if ( !taxonomy_exists($taxonomy) )
wp_die(__('Invalid taxonomy'));
$tax = get_taxonomy($taxonomy);

View File

@ -279,7 +279,7 @@ function _wp_ajax_menu_quick_search( $request = array() ) {
}
if ( 'get-post-item' == $type ) {
if ( get_post_type_object( $object_type ) ) {
if ( post_type_exists( $object_type ) ) {
if ( isset( $request['ID'] ) ) {
$object_id = (int) $request['ID'];
if ( 'markup' == $response_format ) {
@ -296,7 +296,7 @@ function _wp_ajax_menu_quick_search( $request = array() ) {
echo "\n";
}
}
} elseif ( is_taxonomy( $object_type ) ) {
} elseif ( taxonomy_exists( $object_type ) ) {
if ( isset( $request['ID'] ) ) {
$object_id = (int) $request['ID'];
if ( 'markup' == $response_format ) {

View File

@ -19,7 +19,7 @@
* @return unknown
*/
function category_exists($cat_name, $parent = 0) {
$id = is_term($cat_name, 'category', $parent);
$id = term_exists($cat_name, 'category', $parent);
if ( is_array($id) )
$id = $id['term_id'];
return $id;
@ -240,7 +240,7 @@ function get_terms_to_edit( $post_id, $taxonomy = 'post_tag' ) {
* @return unknown
*/
function tag_exists($tag_name) {
return is_term($tag_name, 'post_tag');
return term_exists($tag_name, 'post_tag');
}
/**
@ -264,7 +264,7 @@ function wp_create_tag($tag_name) {
* @return unknown
*/
function wp_create_term($tag_name, $taxonomy = 'post_tag') {
if ( $id = is_term($tag_name, $taxonomy) )
if ( $id = term_exists($tag_name, $taxonomy) )
return $id;
return wp_insert_term($tag_name, $taxonomy);

View File

@ -482,7 +482,7 @@ function wp_list_categories( $args = '' ) {
extract( $r );
if ( !is_taxonomy($taxonomy) )
if ( !taxonomy_exists($taxonomy) )
return false;
$categories = get_categories( $r );

View File

@ -1041,7 +1041,7 @@ class WP_Widget_Tag_Cloud extends WP_Widget {
}
function _get_current_taxonomy($instance) {
if ( !empty($instance['taxonomy']) && is_taxonomy($instance['taxonomy']) )
if ( !empty($instance['taxonomy']) && taxonomy_exists($instance['taxonomy']) )
return $instance['taxonomy'];
return 'post_tag';

View File

@ -2513,3 +2513,53 @@ function trackback_rdf($deprecated = '') {
_deprecated_function( __FUNCTION__, '3.0' );
return '';
}
/**
* Checks if a post type is registered.
*
* @since 3.0.0
* @deprecated 3.0.0
* @deprecated Use post_type_exists()
* @see post_type_exists()
*
* @param string Post type name
* @return bool Whether post type is registered.
*/
function is_post_type( $post_type ) {
_deprecated_function( __FUNCTION__, '3.0', 'post_type_exists()' );
return post_type_exists( $post_type );
}
/**
* Checks that the taxonomy name exists.
*
* @since 2.3.0
* @deprecated 3.0.0
* @deprecated Use taxonomy_exists()
* @see taxonomy_exists()
*
* @param string $taxonomy Name of taxonomy object
* @return bool Whether the taxonomy exists.
*/
function is_taxonomy( $taxonomy ) {
_deprecated_function( __FUNCTION__, '3.0', 'taxonomy_exists()' );
return taxonomy_exists( $post_type );
}
/**
* Check if Term exists.
*
* @since 2.3.0
* @deprecated 3.0.0
* @deprecated Use term_exists()
* @see term_exists()
*
* @param int|string $term The term to check
* @param string $taxonomy The taxonomy name to use
* @param int $parent ID of parent term under which to confine the exists search.
* @return mixed Get the term id or Term Object, if exists.
*/
function is_term( $term, $taxonomy = '', $parent = 0 ) {
_deprecated_function( __FUNCTION__, '3.0', 'term_exists()' );
return term_exists( $term, $taxonomy, $parent );
}

View File

@ -673,7 +673,7 @@ function get_post_stati( $args = array(), $output = 'names', $operator = 'and' )
* @return bool Whether post type is hierarchical.
*/
function is_post_type_hierarchical( $post_type ) {
if ( ! is_post_type( $post_type ) )
if ( ! post_type_exists( $post_type ) )
return false;
$post_type = get_post_type_object( $post_type );
@ -684,12 +684,12 @@ function is_post_type_hierarchical( $post_type ) {
* Checks if a post type is registered.
*
* @since 3.0.0
* @uses get_post_type()
* @uses get_post_type_object()
*
* @param string Post type name
* @return bool Whether post type is registered.
*/
function is_post_type( $post_type ) {
function post_type_exists( $post_type ) {
return (bool) get_post_type_object( $post_type );
}

View File

@ -142,7 +142,7 @@ function get_object_taxonomies($object, $output = 'names') {
* @since 2.3.0
*
* @uses $wp_taxonomies
* @uses is_taxonomy() Checks whether taxonomy exists
* @uses taxonomy_exists() Checks whether taxonomy exists
*
* @param string $taxonomy Name of taxonomy object to return
* @return object|bool The Taxonomy Object or false if $taxonomy doesn't exist
@ -150,7 +150,7 @@ function get_object_taxonomies($object, $output = 'names') {
function get_taxonomy( $taxonomy ) {
global $wp_taxonomies;
if ( ! is_taxonomy($taxonomy) )
if ( ! taxonomy_exists( $taxonomy ) )
return false;
return $wp_taxonomies[$taxonomy];
@ -159,19 +159,21 @@ function get_taxonomy( $taxonomy ) {
/**
* Checks that the taxonomy name exists.
*
* Formerly is_taxonomy(), introduced in 2.3.0.
*
* @package WordPress
* @subpackage Taxonomy
* @since 2.3.0
* @since 3.0.0
*
* @uses $wp_taxonomies
*
* @param string $taxonomy Name of taxonomy object
* @return bool Whether the taxonomy exists.
*/
function is_taxonomy( $taxonomy ) {
function taxonomy_exists( $taxonomy ) {
global $wp_taxonomies;
return isset($wp_taxonomies[$taxonomy]);
return isset( $wp_taxonomies[$taxonomy] );
}
/**
@ -186,14 +188,14 @@ function is_taxonomy( $taxonomy ) {
* @subpackage Taxonomy
* @since 2.3.0
*
* @uses is_taxonomy() Checks whether taxonomy exists
* @uses taxonomy_exists() Checks whether taxonomy exists
* @uses get_taxonomy() Used to get the taxonomy object
*
* @param string $taxonomy Name of taxonomy object
* @return bool Whether the taxonomy is hierarchical
*/
function is_taxonomy_hierarchical($taxonomy) {
if ( ! is_taxonomy($taxonomy) )
if ( ! taxonomy_exists($taxonomy) )
return false;
$taxonomy = get_taxonomy($taxonomy);
@ -208,7 +210,7 @@ function is_taxonomy_hierarchical($taxonomy) {
* parameter), along with strings for the taxonomy name and another string for
* the object type.
*
* Nothing is returned, so expect error maybe or use is_taxonomy() to check
* Nothing is returned, so expect error maybe or use taxonomy_exists() to check
* whether taxonomy exists.
*
* Optional $args contents:
@ -437,7 +439,7 @@ function get_objects_in_term( $term_ids, $taxonomies, $args = array() ) {
$taxonomies = array( $taxonomies );
foreach ( (array) $taxonomies as $taxonomy ) {
if ( ! is_taxonomy( $taxonomy ) )
if ( ! taxonomy_exists( $taxonomy ) )
return new WP_Error( 'invalid_taxonomy', __( 'Invalid Taxonomy' ) );
}
@ -509,7 +511,7 @@ function &get_term($term, $taxonomy, $output = OBJECT, $filter = 'raw') {
return $error;
}
if ( ! is_taxonomy($taxonomy) ) {
if ( ! taxonomy_exists($taxonomy) ) {
$error = new WP_Error('invalid_taxonomy', __('Invalid Taxonomy'));
return $error;
}
@ -576,7 +578,7 @@ function &get_term($term, $taxonomy, $output = OBJECT, $filter = 'raw') {
function get_term_by($field, $value, $taxonomy, $output = OBJECT, $filter = 'raw') {
global $wpdb;
if ( ! is_taxonomy($taxonomy) )
if ( ! taxonomy_exists($taxonomy) )
return false;
if ( 'slug' == $field ) {
@ -634,7 +636,7 @@ function get_term_by($field, $value, $taxonomy, $output = OBJECT, $filter = 'raw
* @return array|WP_Error List of Term Objects. WP_Error returned if $taxonomy does not exist
*/
function get_term_children( $term_id, $taxonomy ) {
if ( ! is_taxonomy($taxonomy) )
if ( ! taxonomy_exists($taxonomy) )
return new WP_Error('invalid_taxonomy', __('Invalid Taxonomy'));
$term_id = intval( $term_id );
@ -819,7 +821,7 @@ function &get_terms($taxonomies, $args = '') {
}
foreach ( (array) $taxonomies as $taxonomy ) {
if ( ! is_taxonomy($taxonomy) ) {
if ( ! taxonomy_exists($taxonomy) ) {
$error = & new WP_Error('invalid_taxonomy', __('Invalid Taxonomy'));
return $error;
}
@ -1071,9 +1073,11 @@ function &get_terms($taxonomies, $args = '') {
*
* Returns the index of a defined term, or 0 (false) if the term doesn't exist.
*
* Formerly is_term(), introduced in 2.3.0.
*
* @package WordPress
* @subpackage Taxonomy
* @since 2.3.0
* @since 3.0.0
*
* @uses $wpdb
*
@ -1082,7 +1086,7 @@ function &get_terms($taxonomies, $args = '') {
* @param int $parent ID of parent term under which to confine the exists search.
* @return mixed Get the term id or Term Object, if exists.
*/
function is_term($term, $taxonomy = '', $parent = 0) {
function term_exists($term, $taxonomy = '', $parent = 0) {
global $wpdb;
$select = "SELECT term_id FROM $wpdb->terms as t WHERE ";
@ -1343,7 +1347,7 @@ function wp_delete_term( $term, $taxonomy, $args = array() ) {
$term = (int) $term;
if ( ! $ids = is_term($term, $taxonomy) )
if ( ! $ids = term_exists($term, $taxonomy) )
return false;
if ( is_wp_error( $ids ) )
return $ids;
@ -1356,7 +1360,7 @@ function wp_delete_term( $term, $taxonomy, $args = array() ) {
if ( isset($default) ) {
$default = (int) $default;
if ( ! is_term($default, $taxonomy) )
if ( ! term_exists($default, $taxonomy) )
unset($default);
}
@ -1443,7 +1447,7 @@ function wp_get_object_terms($object_ids, $taxonomies, $args = array()) {
$taxonomies = array($taxonomies);
foreach ( (array) $taxonomies as $taxonomy ) {
if ( ! is_taxonomy($taxonomy) )
if ( ! taxonomy_exists($taxonomy) )
return new WP_Error('invalid_taxonomy', __('Invalid Taxonomy'));
}
@ -1581,7 +1585,7 @@ function wp_get_object_terms($object_ids, $taxonomies, $args = array()) {
function wp_insert_term( $term, $taxonomy, $args = array() ) {
global $wpdb;
if ( ! is_taxonomy($taxonomy) )
if ( ! taxonomy_exists($taxonomy) )
return new WP_Error('invalid_taxonomy', __('Invalid taxonomy'));
$term = apply_filters( 'pre_insert_term', $term, $taxonomy );
@ -1623,10 +1627,10 @@ function wp_insert_term( $term, $taxonomy, $args = array() ) {
}
}
if ( $term_id = is_term($slug) ) {
if ( $term_id = term_exists($slug) ) {
$existing_term = $wpdb->get_row( $wpdb->prepare( "SELECT name FROM $wpdb->terms WHERE term_id = %d", $term_id), ARRAY_A );
// We've got an existing term in the same taxonomy, which matches the name of the new term:
if ( is_taxonomy_hierarchical($taxonomy) && $existing_term['name'] == $name && is_term( (int) $term_id, $taxonomy ) ) {
if ( is_taxonomy_hierarchical($taxonomy) && $existing_term['name'] == $name && term_exists( (int) $term_id, $taxonomy ) ) {
// Hierarchical, and it matches an existing term, Do not allow same "name" in the same level.
$siblings = get_terms($taxonomy, array('fields' => 'names', 'get' => 'all', 'parent' => (int)$parent) );
if ( in_array($name, $siblings) ) {
@ -1643,7 +1647,7 @@ function wp_insert_term( $term, $taxonomy, $args = array() ) {
if ( false === $wpdb->insert( $wpdb->terms, compact( 'name', 'slug', 'term_group' ) ) )
return new WP_Error('db_insert_error', __('Could not insert term into the database'), $wpdb->last_error);
$term_id = (int) $wpdb->insert_id;
} elseif ( is_term( (int) $term_id, $taxonomy ) ) {
} elseif ( term_exists( (int) $term_id, $taxonomy ) ) {
// Same name, same slug.
return new WP_Error('term_exists', __('A term with the name provided already exists.'));
}
@ -1712,7 +1716,7 @@ function wp_set_object_terms($object_id, $terms, $taxonomy, $append = false) {
$object_id = (int) $object_id;
if ( ! is_taxonomy($taxonomy) )
if ( ! taxonomy_exists($taxonomy) )
return new WP_Error('invalid_taxonomy', __('Invalid Taxonomy'));
if ( !is_array($terms) )
@ -1730,7 +1734,7 @@ function wp_set_object_terms($object_id, $terms, $taxonomy, $append = false) {
if ( !strlen(trim($term)) )
continue;
if ( !$term_info = is_term($term, $taxonomy) ) {
if ( !$term_info = term_exists($term, $taxonomy) ) {
// Skip if a non-existent term ID is passed.
if ( is_int($term) )
continue;
@ -1805,7 +1809,7 @@ function wp_set_object_terms($object_id, $terms, $taxonomy, $append = false) {
function wp_unique_term_slug($slug, $term) {
global $wpdb;
if ( ! is_term( $slug ) )
if ( ! term_exists( $slug ) )
return $slug;
// If the taxonomy supports hierarchy and the term has a parent, make the slug unique
@ -1817,7 +1821,7 @@ function wp_unique_term_slug($slug, $term) {
if ( is_wp_error($parent_term) || empty($parent_term) )
break;
$slug .= '-' . $parent_term->slug;
if ( ! is_term( $slug ) )
if ( ! term_exists( $slug ) )
return $slug;
if ( empty($parent_term->parent) )
@ -1883,7 +1887,7 @@ function wp_unique_term_slug($slug, $term) {
function wp_update_term( $term_id, $taxonomy, $args = array() ) {
global $wpdb;
if ( ! is_taxonomy($taxonomy) )
if ( ! taxonomy_exists($taxonomy) )
return new WP_Error('invalid_taxonomy', __('Invalid taxonomy'));
$term_id = (int) $term_id;