[ Index ]

PHP Cross Reference of WordPress

title

Body

[close]

/wp-admin/includes/ -> taxonomy.php (summary)

WordPress Taxonomy Administration API.

File Size: 316 lines (8 kb)
Included or required:0 times
Referenced: 0 times
Includes or requires: 0 files

Defines 11 functions

  category_exists()
  get_category_to_edit()
  wp_create_category()
  wp_create_categories()
  wp_insert_category()
  wp_update_category()
  tag_exists()
  wp_create_tag()
  get_tags_to_edit()
  get_terms_to_edit()
  wp_create_term()

Functions
Functions that are not part of a class:

category_exists( $cat_name, $category_parent = null )   X-Ref
Check whether a category exists.

return: string|null Returns the category ID as a numeric string if the pairing exists, null if not.
param: int|string $cat_name        Category name.
param: int        $category_parent Optional. ID of parent category.
since: 2.0.0

get_category_to_edit( $id )   X-Ref
Get category object for given ID and 'edit' filter context.

return: object
param: int $id
since: 2.0.0

wp_create_category( $cat_name, $category_parent = 0 )   X-Ref
Add a new category to the database if it does not already exist.

return: int|WP_Error
param: int|string $cat_name        Category name.
param: int        $category_parent Optional. ID of parent category.
since: 2.0.0

wp_create_categories( $categories, $post_id = '' )   X-Ref
Create categories for the given post.

return: int[] Array of IDs of categories assigned to the given post.
param: string[] $categories Array of category names to create.
param: int      $post_id    Optional. The post ID. Default empty.
since: 2.0.0

wp_insert_category( $catarr, $wp_error = false )   X-Ref
Updates an existing Category or creates a new Category.

return: int|WP_Error The ID number of the new or updated Category on success. Zero or a WP_Error on failure,
param: array $catarr {
param: bool  $wp_error Optional. Default false.
since: 2.0.0
since: 2.5.0 $wp_error parameter was added.
since: 3.0.0 The 'taxonomy' argument was added.

wp_update_category( $catarr )   X-Ref
Aliases wp_insert_category() with minimal args.

If you want to update only some fields of an existing category, call this
function with only the new values set inside $catarr.

return: int|false The ID number of the new or updated Category on success. Zero or FALSE on failure.
param: array $catarr The 'cat_ID' value is required. All other keys are optional.
since: 2.0.0

tag_exists( $tag_name )   X-Ref
Check whether a post tag with a given name exists.

return: mixed Returns null if the term does not exist.
param: int|string $tag_name
since: 2.3.0

wp_create_tag( $tag_name )   X-Ref
Add a new tag to the database if it does not already exist.

return: array|WP_Error
param: int|string $tag_name
since: 2.3.0

get_tags_to_edit( $post_id, $taxonomy = 'post_tag' )   X-Ref
Get comma-separated list of tags available to edit.

return: string|false|WP_Error
param: int    $post_id
param: string $taxonomy Optional. The taxonomy for which to retrieve terms. Default 'post_tag'.
since: 2.3.0

get_terms_to_edit( $post_id, $taxonomy = 'post_tag' )   X-Ref
Get comma-separated list of terms available to edit for the given post ID.

return: string|false|WP_Error
param: int    $post_id
param: string $taxonomy Optional. The taxonomy for which to retrieve terms. Default 'post_tag'.
since: 2.8.0

wp_create_term( $tag_name, $taxonomy = 'post_tag' )   X-Ref
Add a new term to the database if it does not already exist.

return: array|WP_Error
param: string $tag_name The term name.
param: string $taxonomy Optional. The taxonomy within which to create the term. Default 'post_tag'.
since: 2.8.0



Generated: Thu Nov 21 01:00:03 2024 Cross-referenced by PHPXref 0.7.1