Obtenga todos los datos de Término de la base de datos por campo de Término y datos.

Descripción

Advertencia: $ value no se escapa para el campo $ ‘nombre’. Debe hacerlo usted mismo, si es necesario.

El campo $ predeterminado es ‘id’, por lo tanto, también es posible usar nulo para campo, pero no se recomienda que lo haga.

Si $ value no existe, el valor devuelto será falso. Si existe $ taxonomía y existen combinaciones de $ campo y $ valor, se devolverá el término.

Esta función siempre devolverá el primer término que coincida con el $field$value$taxonomy combinación especificada en los parámetros. Si es probable que su consulta coincida con más de un término (como es probable que sea el caso cuando $field es ‘nombre’, por ejemplo), considere usar get_terms () en su lugar; de esa manera, obtendrá todos los términos coincidentes y podrá proporcionar su propia lógica para decidir cuál fue el previsto.

Ver también

  • sanitize_term_field (): El parámetro $ context enumera los valores disponibles para get_term_by () $ filter param.

Parámetros

$ campo

(cuerda)(Requerido)Puede ser ‘slug’, ‘name’, ‘id’ o ‘ID’ (term_id), o ‘term_taxonomy_id’.

$ valor

(cuerda|En t)(Requerido)Busque este valor de término.

$ taxonomía

(cuerda)(Opcional)Nombre de la taxonomía. Opcional, si $field es ‘term_taxonomy_id’.

Valor por defecto: ”

$ salida

(cuerda)(Opcional) El tipo de devolución requerido. Uno de OBJECT, ARRAY_A o ARRAY_N, que corresponden a un objeto WP_Term, una matriz asociativa o una matriz numérica, respectivamente.

Valor predeterminado: OBJETO

$ filtro

(cuerda)(Opcional) Cómo desinfectar los campos de términos.

Valor predeterminado: ‘crudo’

Regreso

(WP_Term | matriz | falso)Instancia (o matriz) de WP_Term en caso de éxito, según el $output valor. Falso si $taxonomy no existe o $term no fue encontrado.

Fuente

Expediente: wp-includes / taxonomy.php

functionget_term_by($field,$value,$taxonomy='',$output=OBJECT,$filter='raw')'ID'===$field

Relacionado

Usos

Usos Descripción
wp-includes / taxonomy.php:get_terms ()

Recupera los términos de una taxonomía o lista de taxonomías determinada.

wp-includes / taxonomy.php:taxonomy_exists ()

Determina si existe el nombre de la taxonomía.

wp-includes / taxonomy.php:get_term ()

Obtenga todos los datos de término de la base de datos por ID de término.

wp-includes / load.php:is_wp_error ()

Comprueba si la variable dada es un error de WordPress.

Usado por

Usado por Descripción
wp-includes / deprecated.php:get_linksbyname ()

Obtiene los enlaces asociados con la categoría $ cat_name.

wp-includes / deprecated.php:get_linkobjectsbyname ()

Obtiene una matriz de objetos de vínculo asociados con la categoría $ cat_name.

wp-includes / class-wp-query.php:WP_Query :: get_queried_object ()

Recupera el objeto consultado actualmente.

wp-includes / class-wp-query.php:WP_Query :: get_posts ()

Recupera una serie de publicaciones basadas en variables de consulta.

wp-includes / category.php:get_category_by_slug ()

Recupera un objeto de categoría por categoría slug.

wp-includes / category.php:get_cat_ID ()

Recupera el ID de una categoría de su nombre.

wp-includes / taxonomy.php:get_term_link ()

Genere un enlace permanente para un archivo de términos de taxonomía.

wp-includes / taxonomy.php:wp_unique_term_slug ()

Hará que slug sea único, si aún no lo es.

wp-includes / taxonomy.php:wp_update_term ()

Actualizar el término según los argumentos proporcionados.

wp-includes / taxonomy.php:wp_insert_term ()

Agregue un nuevo término a la base de datos.

wp-includes / revision.php:_wp_preview_terms_filter ()

Filtra la búsqueda de términos para establecer el formato de publicación.

wp-includes / bookmark.php:get_bookmarks ()

Recupera la lista de marcadores.

wp-incluye / post-formatos.php:get_post_format_link ()

Devuelve un enlace a un índice de formato de publicación.

wp-includes / nav-menu.php:wp_update_nav_menu_object ()

Guarde las propiedades de un menú o cree un nuevo menú con esas propiedades.

wp-includes / nav-menu.php:wp_get_nav_menu_object ()

Devuelve un objeto de menú de navegación.

wp-includes / class-wp-xmlrpc-server.php:wp_xmlrpc_server :: _ insert_post ()

Método auxiliar para wp_newPost () y wp_editPost (), que contiene lógica compartida.

Registro de cambios

Versión Descripción
5.5.0 Se agregó ‘ID’ como un alias de ‘id’ para el $field parámetro.
4.4.0 $taxonomy es opcional si $field es ‘term_taxonomy_id’. Convertido para devolver un objeto WP_Term si $output es OBJECT.
2.3.0 Introducido.