Este equipo de especialistas pasados varios días de trabajo y recopilación de de información, hemos dado con los datos necesarios, nuestro deseo es que todo este artículo sea de utilidad en tu trabajo.
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. |
Si guardas algún impasse o disposición de regenerar nuestro enunciado te insinuamos escribir una crítica y con placer lo estudiaremos.