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

Descripción

Puede inyectar completamente cualquier personalización a la consulta antes de que se envíe, así como controlar la salida con un filtro.

El tipo de retorno varía según el valor pasado a $args['fields']. Consulte WP_Term_Query :: get_terms () para obtener más detalles. En todos los casos, un WP_Error El objeto se devolverá si se solicita una taxonomía no válida.

El filtro ‘get_terms’ se llamará cuando la caché tenga el término y pasará el término encontrado junto con la matriz de $ taxonomías y la matriz de $ args. Este filtro también se llama antes de que se pase la matriz de términos y pasará la matriz de términos, junto con las $ taxonomías y $ args.

El filtro ‘list_terms_exclusions’ pasa las exclusiones compiladas junto con los $ args.

El filtro ‘get_terms_orderby’ pasa el ORDER BY cláusula para la consulta junto con la matriz $ args.

Antes de 4.5.0, el primer parámetro de get_terms() era una taxonomía o lista de taxonomías:

$terms=get_terms('post_tag',array('hide_empty'=>false,));

Desde 4.5.0, las taxonomías deben pasarse a través del argumento ‘taxonomía’ en el $args formación:

$terms=get_terms(array('taxonomy'=>'post_tag','hide_empty'=>false,));

Parámetros

$ args

(formación|cuerda)(Opcional) Matriz o cadena de argumentos. Consulte WP_Term_Query :: __ construct () para obtener información sobre los argumentos aceptados.

Valor predeterminado: array ()

$ obsoleto

(formación|cuerda)(Opcional) Matriz de argumentos, cuando se utiliza el formato de parámetro de función heredado. Si está presente, este parámetro se interpretará como $args, y el primer parámetro de función se analizará como una taxonomía o matriz de taxonomías.

Valor por defecto: ”

Regreso

(WP_Term[]| int[]| cadena[]| cadena | WP_Error) Matriz de términos, un recuento de los mismos como una cadena numérica o WP_Error si alguna de las taxonomías no existe. Consulte la descripción de la función para obtener más información.

Fuente

Expediente: wp-includes / taxonomy.php

functionget_terms($args=array(),$deprecated='')

Relacionado

Usos

Usos Descripción
wp-includes / class-wp-term-query.php:WP_Term_Query :: __ construct ()

Constructor.
wp-includes / l10n.php:__ ()

Recupere la traducción de $ text.
wp-includes / functions.php:wp_parse_args ()

Fusiona argumentos definidos por el usuario en una matriz predeterminada.
wp-includes / taxonomy.php:get_terms

Filtra los términos encontrados.
wp-includes / taxonomy.php:taxonomy_exists ()

Determina si existe el nombre de la taxonomía.
wp-includes / plugin.php:aplicar_filtros ()

Llama a las funciones de devolución de llamada que se han agregado a un enlace de filtro.
wp-includes / class-wp-error.php:WP_Error :: __ construct ()

Inicializa el error.

Usado por

Usado por Descripción
wp-admin / includes / class-wp-posts-list-table.php:WP_Posts_List_Table :: formatos_dropdown ()

Muestra un menú desplegable de formatos para filtrar elementos.
wp-admin / includes / post.php:taxonomy_meta_box_sanitize_cb_input ()

Desinfecta los valores POST de un metabox de taxonomía de entrada.
wp-includes / rest-api / endpoints / class-wp-rest-terms-controller.php:WP_REST_Terms_Controller :: get_items ()

Recupera términos asociados con una taxonomía.
wp-includes / class-wp-term-query.php:WP_Term_Query :: get_terms ()

Recupera los resultados de la consulta.
wp-includes / class-wp-personalizar-nav-menus.php:WP_Customize_Nav_Menus :: search_available_items_query ()

Realiza consultas posteriores para la búsqueda de artículos disponibles.
wp-includes / class-wp-personalizar-nav-menus.php:WP_Customize_Nav_Menus :: load_available_items_query ()

Realiza las consultas de taxonomía y post_type para cargar elementos de menú disponibles.
wp-admin / includes / export.php:export_wp ()

Genera el archivo de exportación WXR para descargar.
wp-admin / includes / template.php:wp_terms_checklist ()

Genere una lista desordenada de elementos de entrada de casillas de verificación etiquetados con nombres de términos.
wp-admin / includes / template.php:wp_popular_terms_checklist ()

Recupere una lista de los términos más populares de la taxonomía especificada.
wp-admin / includes / template.php:wp_link_category_checklist ()

Genera un elemento de lista de verificación de categoría de enlace.
wp-admin / includes / ajax-actions.php:wp_ajax_get_tagcloud ()

Controlador Ajax para obtener una nube de etiquetas.
wp-admin / includes / ajax-actions.php:wp_ajax_ajax_tag_search ()

Controlador Ajax para la búsqueda de etiquetas.
wp-admin / includes / class-wp-terms-list-table.php:WP_Terms_List_Table :: display_rows_or_placeholder ()
wp-admin / includes / nav-menu.php:_wp_ajax_menu_quick_search ()

Imprime la respuesta adecuada a una búsqueda rápida de menú.
wp-admin / includes / nav-menu.php:wp_nav_menu_item_taxonomy_meta_box ()

Muestra un cuadro de meta para un elemento del menú de taxonomía.
wp-includes / class-walker-category.php:Walker_Category :: start_el ()

Inicia la salida del elemento.
wp-includes / category-template.php:wp_tag_cloud ()

Muestra una nube de etiquetas.
wp-includes / category-template.php:wp_dropdown_categories ()

Muestra o recupera la lista desplegable HTML de categorías.
wp-includes / category.php:get_tags ()

Recupera todas las etiquetas de publicación.
wp-includes / category.php:get_categories ()

Recupera una lista de objetos de categoría.
wp-includes / category.php:get_category_by_path ()

Recupera una categoría basada en la URL que contiene la categoría slug.
wp-includes / deprecated.php:get_all_category_ids ()

Recupera todos los ID de categoría.
wp-includes / widgets / class-wp-widget-links.php:WP_Widget_Links :: formulario ()

Muestra el formulario de configuración para el widget Vínculos.
wp-includes / taxonomy.php:_get_term_hierarchy ()

Recupera elementos secundarios de la taxonomía como identificadores de término.
wp-includes / taxonomy.php:wp_get_object_terms ()

Recupera los términos asociados con los objetos dados, en las taxonomías proporcionadas.
wp-includes / taxonomy.php:wp_insert_term ()

Agregue un nuevo término a la base de datos.
wp-includes / taxonomy.php:wp_count_terms ()

Cuente cuántos términos hay en taxonomía.
wp-includes / taxonomy.php:get_term_by ()

Obtenga todos los datos de Término de la base de datos por campo de Término y datos.
wp-includes / bookmark-template.php:wp_list_bookmarks ()

Recupere o haga eco de todos los marcadores.
wp-includes / nav-menu.php:wp_get_nav_menus ()

Devuelve todos los objetos del menú de navegación.
wp-includes / nav-menu.php:wp_get_nav_menu_items ()

Recupera todos los elementos del menú de un menú de navegación.
wp-includes / class-wp-xmlrpc-server.php:wp_xmlrpc_server :: wp_getTerms ()

Recupere todos los términos de una taxonomía.
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
4.8.0 Se introdujo el parámetro ‘suppress_filter’.
4.5.0 Se modificó la firma de la función para que $args La matriz se puede proporcionar como primer parámetro. Se introdujeron los parámetros ‘meta_key’ y ‘meta_value’. Introdujo la capacidad de ordenar los resultados por metadatos.
4.4.0 Se introdujo la capacidad de pasar ‘term_id’ como un alias de ‘id’ para el orderby parámetro. Se introdujeron los parámetros ‘meta_query’ y ‘update_term_meta_cache’. Convertido para devolver una lista de objetos WP_Term.
4.2.0 Se introdujeron los parámetros ‘nombre’ y ‘sin hijos’.
2.3.0 Introducido.