Wordpress wp_list_categories ()

Muestra o recupera la lista HTML de categorías.

Parámetros

$ args

(formación|cuerda)(Opcional)Matriz de argumentos opcionales. Consulte get_categories (), get_terms () y WP_Term_Query :: __ construct () para obtener información sobre los argumentos aceptados adicionales.

• ‘categoría_actual’
  (int | int[]) ID de categoría, o matriz de ID de categorías, que debería obtener la clase ‘current-cat’. Predeterminado 0.
• ‘profundidad’
  (En t) Profundidad de categoría. Se utiliza para la sangría de tabulación. Predeterminado 0.
• ‘eco’
  (bool | int) Ya sea para hacer eco o devolver el marcado generado. Acepta 0, 1 o sus equivalentes bool. Predeterminado 1.
• ‘excluir’
  (En t[]| cadena) Matriz o cadena separada por comas / espacios de ID de términos para excluir. Si $hierarchical es cierto, descendientes de $exclude también se excluirán los términos; ver $exclude_tree. Consulte get_terms ().
• ‘exclude_tree’
  (En t[]| cadena) Matriz o cadena separada por comas / espacios de ID de términos para excluir, junto con sus descendientes. Consulte get_terms ().
• ‘alimentación’
  (cuerda) Texto que se utilizará para el enlace de la fuente. Feed ‘predeterminado para todas las publicaciones archivadas bajo [cat name]’.
• ‘feed_image’
  (cuerda) URL de una imagen que se utilizará para el enlace de la fuente.
• ‘feed_type’
  (cuerda) Tipo de alimentación. Se utiliza para crear un enlace de alimentación. Consulte get_term_feed_link (). Cadena vacía predeterminada (alimentación predeterminada).
• ‘hide_title_if_empty’
  (bool) Ya sea para ocultar el $title_li elemento si no hay términos en la lista. Falso predeterminado (el título siempre se mostrará).
• ‘separador’
  (cuerda) Separador entre enlaces. Defecto
.
• ‘show_count’
  (bool | int) Si incluir recuentos de publicaciones. Acepta 0, 1 o sus equivalentes bool. Predeterminado 0.
• ‘show_option_all’
  (cuerda) Texto a mostrar para mostrar todas las categorías.
• ‘show_option_none’
  (cuerda) Texto para mostrar para la opción ‘sin categorías’. Por defecto ‘Sin categorías’.
• ‘estilo’
  (cuerda) El estilo utilizado para mostrar la lista de categorías. Si es ‘lista’, las categorías se generarán como una lista desordenada. Si se deja vacío u otro valor, las categorías se generarán separadas por
etiquetas. ‘Lista’ predeterminada.
• ‘taxonomía’
  (cuerda) Nombre de la taxonomía que se va a recuperar. ‘Categoría’ predeterminada.
• ‘title_li’
  (cuerda) Texto que se utilizará para el título de la lista
• elemento. Pase una cadena vacía para deshabilitar. ‘Categorías’ predeterminadas.
• ‘use_desc_for_title’
  (bool | int) Si se debe utilizar la descripción de la categoría como atributo de título. Acepta 0, 1 o sus equivalentes bool. Predeterminado 1.

Valor por defecto: ”

Regreso

(vacío | cadena | falso) No válido si el argumento ‘echo’ es verdadero, lista HTML de categorías si ‘echo’ es falso. Falso si la taxonomía no existe.

Más información

Si necesita una función que no formatee los resultados, intente get_categories ().

Uso

De forma predeterminada, wp_list_categories () muestra:

• Sin enlace a todas las categorías
• Ordena la lista de categorías por el nombre de la categoría en orden ascendente
• Se muestra en un estilo de lista desordenada
• No muestra el recuento de publicaciones
• Muestra solo categorías con publicaciones
• Establece el atributo de título en la descripción de categoría.
• No está restringido al niño_de ninguna categoría.
• No se ha utilizado ningún feed o imagen de feed
• No excluye ninguna categoría e incluye todas las categorías
• Muestra la categoría activa con el sufijo de clase CSS ‘current-cat’
• Muestra las categorías en forma jerárquica con sangría.
• Mostrar categoría como encabezado sobre la lista
• No se impone ningún LÍMITE SQL (‘número’ => 0 no se muestra arriba)
• Muestra (ecos) las categorías
• Sin límite de profundidad
• Todas las categorias.
• La lista se representa utilizando un nuevo objeto de caminante de la clase Walker_Category

Fuente

Expediente: wp-includes / category-template.php

functionwp_list_categories($args='')!$parsed_args['hide_title_if_empty']))$output.='';/**
	 * Filters the HTML output of a taxonomy list.
	 *
	 * @since 2.1.0
	 *
	 * @param string $output HTML output.
	 * @param array  $args   An array of taxonomy-listing arguments. See wp_list_categories()
	 *                       for information on accepted arguments.
	 */$html=apply_filters('wp_list_categories',$output,$args);if($parsed_args['echo'])echo$html;elsereturn$html;

Relacionado

Usos

Usado por

Registro de cambios